层检查
概览
- 了解各个“层检查”查询关键字针对不同 PCB 层类型的返回结果。
- 查看常用层包含和排除查询的语法及使用示例。
- 理解顶层、底层、外层、信号层、锡膏层和阻焊层等相关函数之间的区别。
Query Helper 对话框中显示的 Layer Checks PCB 查询函数
本参考页面详细介绍了 PCB 和 PCB 库文档中可用的 Layer Checks 类别的查询语言关键字。要获取特定查询关键字的帮助，请使用以下可折叠部分，或在 Query Helper 或 Filter 面板中选中任意关键字（或在关键字内单击），然后按 F1 即可直接访问其对应部分。
OnBottom
概述
返回底层、底部丝印层、底部锡膏层和底部阻焊层上的所有对象。
语法
OnBottom : Boolean
使用示例
OnBottom
OnBottom = True
返回底层、底部丝印层、底部锡膏层和底部阻焊层上的所有对象。
Not OnBottom
OnBottom = False
返回所有except 位于底层、底部丝印层、底部锡膏层和底部阻焊层上的对象。
OnBottomLayer
概述
返回底层上的所有对象。
语法
OnBottomLayer : Boolean
使用示例
OnBottomLayer
OnBottomLayer = True
返回底层上的所有对象。
Not OnBottomLayer
OnBottomLayer = False
返回所有except 位于底层上的对象。
OnBottomPaste
概述
返回底部锡膏层上的所有对象，以及底层上的所有焊盘 – 返回后者是因为这些焊盘也会呈现在底部锡膏层上。
语法
OnBottomPaste : Boolean
使用示例
OnBottomPaste
OnBottomPaste = True
返回底部锡膏层上的所有对象，以及底层上的所有焊盘。
Not OnBottomPaste
OnBottomPaste = False
返回所有except 位于底部锡膏层上的对象，以及底层上的所有焊盘。
OnBottomSilkscreen
概述
返回底部丝印层上的所有对象。
语法
OnBottomSilkscreen : Boolean
使用示例
OnBottomSilkscreen
OnBottomSilkscreen = True
返回底部丝印层上的所有对象。
Not OnBottomSilkscreen
OnBottomSilkscreen = False
返回所有except 位于底部丝印层上的对象。
OnBottomSolderMask
概述
返回底部阻焊层上的所有对象、底层和多层上的所有焊盘，以及终止于底层的所有过孔。返回这些焊盘和过孔对象是因为它们也会呈现在底部阻焊层上。
语法
OnBottomSolderMask : Boolean
使用示例
OnBottomSolderMask
OnBottomSolderMask = True
返回底部阻焊层上的所有对象、底层和多层上的所有焊盘，以及终止于底层的所有过孔。
Not OnBottomSolderMask
OnBottomSolderMask = False
返回所有except 位于底部阻焊层上的对象、底层和多层上的所有焊盘，以及终止于底层的所有过孔。
OnCopper
概述
返回信号层、多层和内部平面层上的所有对象。
语法
OnCopper : Boolean
使用示例
OnCopper
OnCopper
返回信号层、多层和内部平面层上的所有对象。
Not OnCopper
OnCopper = False
返回所有except 位于信号层、多层和内部平面层上的对象。
OnInverted
概述
返回以下层上的所有对象：顶部锡膏层、底部锡膏层、顶部阻焊层、底部阻焊层和内部平面层（内部平面层 1–16）。这些层都具有“反相”或“负片”性质，因为这些层上的任何对象都会在锡膏钢网或阻焊膜上产生相应的开口，或形成相应的无铜区域（分别对应锡膏层、阻焊层和内部平面层）。
语法
OnInverted : Boolean
使用示例
OnInverted
OnInverted
返回以下层上的所有对象：顶部锡膏层、底部锡膏层、顶部阻焊层、底部阻焊层和内部平面层（内部平面层 1–16）。
Not OnInverted
OnInverted = False
返回所有except 位于以下层上的对象：顶部锡膏层、底部锡膏层、顶部阻焊层、底部阻焊层和内部平面层（内部平面层 1–16）。
OnMechanical
概述
返回任何已启用的机械层上的所有对象。
语法
OnMechanical : Boolean
使用示例
OnMechanical
OnMechanical
返回任何已启用的机械层上的所有对象。
Not OnMechanical
OnMechanical
返回所有except 位于任何已启用的机械层上的对象。
OnMid
概述
返回任何内部信号层上的所有对象。
语法
OnMid : Boolean
使用示例
OnMid
OnMid = True
返回任何内部信号层上的所有对象。
Not OnMid
OnMid = False
返回所有except 位于任何内部信号层上的对象。
OnMultiLayer
概述
返回多层上的所有对象。
语法
OnMultiLayer : Boolean
使用示例
OnMultiLayer
OnMultiLayer
返回多层上的所有对象。
Not OnMultiLayer
OnMultiLayer = False
返回所有except位于多层上的对象。
OnOutside
概述
返回外部信号层（即顶层和底层）上的所有对象。
语法
OnOutside : Boolean
使用示例
OnOutside
OnOutside = True
返回外部信号层（即顶层和底层）上的所有对象。
Not OnOutside
OnOutside = False
返回所有except位于外部信号层（即顶层和底层）上的对象。
注意
请注意，OnOutside 查询关键字不会返回放置在 Multi-Layer 层上的对象。使用 OnMultiLayer 查询关键字可定位 Multi-Layer 层上的对象；使用 ExistsOnLayer('Top Layer') Or ExistsOnLayer('Bottom Layer') 查询则可定位在 Top Layer 或 Bottom Layer 上具有形状的对象（包括 Multi-Layer 层上的对象）。
OnPaste
概述
返回顶层锡膏层和底层锡膏层上的所有对象，以及顶层和底层上的所有焊盘 – 返回这些层上的焊盘对象，是因为它们也分别呈现在顶层锡膏层和底层锡膏层上。
语法
OnPaste : Boolean
使用示例
OnPaste
OnPaste = True
返回顶层锡膏层和底层锡膏层上的所有对象，以及顶层和底层上的所有焊盘。
Not OnPaste
OnPaste = False
返回除以下对象以外的所有对象：except 顶层锡膏层和底层锡膏层上的对象，以及顶层和底层上的所有焊盘。
OnPlane
概述
返回内部平面层（内部平面层 1–16）上的所有对象。
语法
OnPlane : Boolean
使用示例
OnPlane
OnPlane = True
返回内部平面层（内部平面层 1–16）上的所有对象。
Not OnPlane
OnPlane = False
返回除以下对象以外的所有对象：except 内部平面层（内部平面层 1–16）上的对象。
OnSignal
概述
返回信号层和多层上的所有对象。
语法
OnSignal : Boolean
使用示例
OnSignal
OnSignal = True
返回信号层和多层上的所有对象。
Not OnSignal
OnSignal = False
返回除以下对象以外的所有对象：except 信号层和多层上的对象。
OnSilkscreen
概述
返回顶层丝印层和底层丝印层上的所有对象。
语法
OnSilkscreen : Boolean
使用示例
OnSilkscreen
OnSilkscreen = True
返回顶层丝印层和底层丝印层上的所有对象。
Not OnSilkscreen
OnSilkscreen = False
返回除以下对象以外的所有对象：except 顶层丝印层和底层丝印层上的对象。
OnSolderMask
概述
返回顶层阻焊层和底层阻焊层上的所有对象，顶层、底层和多层上的所有焊盘，以及所有起始于顶层或终止于底层的过孔。返回这些焊盘和过孔对象，是因为它们也分别呈现在顶层阻焊层或底层阻焊层上。
语法
OnSolderMask : Boolean
使用示例
OnSolderMask
OnSolderMask = True
返回顶层阻焊层和底层阻焊层上的所有对象，顶层、底层和多层上的所有焊盘，以及所有起始于顶层或终止于底层的过孔。
Not OnSolderMask
OnSolderMask = False
返回除以下对象以外的所有对象：except 顶层阻焊层和底层阻焊层上的对象，顶层、底层和多层上的所有焊盘，以及所有起始于顶层或终止于底层的过孔。
OnTop
概述
返回以下层上的所有对象：顶层、顶层丝印层、顶层锡膏层和顶层阻焊层。
语法
OnTop : Boolean
使用示例
OnTop
OnTop = True
返回以下层上的所有对象：顶层、顶层丝印层、顶层锡膏层和顶层阻焊层。
Not OnTop
OnTop = False
返回除以下对象以外的所有对象：except 顶层、顶层丝印层、顶层锡膏层和顶层阻焊层上的对象。
OnTopLayer
概述
返回顶层上的所有对象。
语法
OnTopLayer : Boolean
使用示例
OnTopLayer
OnTopLayer = True
返回顶层上的所有对象。
Not OnTopLayer
OnTopLayer = False
返回除以下对象以外的所有对象：except 顶层上的对象。
OnTopPaste
概述
返回顶层锡膏层上的所有对象，以及顶层上的所有焊盘 – 返回后者，是因为它们也呈现在顶层锡膏层上。
语法
OnTopPaste : Boolean
使用示例
OnTopPaste
OnTopPaste
返回顶层锡膏层上的所有对象，以及顶层上的所有焊盘。
Not OnTopPaste
OnTopPaste
返回除以下对象以外的所有对象：except 顶层锡膏层上的对象，以及顶层上的所有焊盘。
OnTopSilkscreen
概述
返回顶层丝印层上的所有对象。
语法
OnTopSilkscreen : Boolean
使用示例
OnTopSilkscreen
OnTopSilkscreen = True
返回顶层丝印层上的所有对象。
Not OnTopSilkscreen
OnTopSilkscreen = False
返回除以下对象以外的所有对象：except 顶层丝印层上的对象。
OnTopSolderMask
概述
返回顶层阻焊层上的所有对象，顶层和多层上的所有焊盘，以及所有起始于顶层的过孔。返回这些焊盘和过孔对象，是因为它们也呈现在顶层阻焊层上。
语法
OnTopSolderMask : Boolean
使用示例
OnTopSolderMask
OnTopSolderMask
返回顶层阻焊层上的所有对象，顶层和多层上的所有焊盘，以及所有起始于顶层的过孔。
Not OnTopSolderMask
OnTopSolderMask = False
返回除以下对象以外的所有对象：except 顶层阻焊层上的对象，顶层和多层上的所有焊盘，以及所有起始于顶层的过孔。
AI 翻译