Проверки членства

Функции запросов PCB, показанные в диалоговом окне Query Helper
На этой справочной странице подробно описаны ключевые слова языка запросов из категории Membership Checks , доступные в документах PCB и PCB Library в Altium Designer. Чтобы получить справку по конкретному ключевому слову запроса, используйте следующие сворачиваемые разделы или выделите (или щелкните внутри) нужное ключевое слово в Query Helper или на панели Filter, затем нажмите F1 , чтобы сразу перейти к соответствующему разделу.
AsMils
Сводка
Для числовых свойств объектов (например, высота, ширина, радиус и т. п.) это ключевое слово используется для преобразования текущего значения — измеренного в единицах по умолчанию рабочей области — в имперские единицы (mil), где 1 mil = 0,001 дюйма; затем полученное значение сравнивается со значением, введенным в выражении.
Синтаксис
AsMils(Keyword : Number) : Number
Примеры использования
AsMils(ArcRadius) = 250
Возвращает все объекты дуг, у которых Radius свойство равно 250mil.
AsMils(Height) Between 300 And 500
Возвращает все объекты компонентов, у которых Height свойство больше или равно 300mil и меньше или равно 500mil.
AsMils(PolygonGridSize) >= 10
Возвращает все объекты заливки полигона, у которых Grid Sizeсвойство больше или равно 10mil.
AsMils(Width) < 50
Возвращает все объекты дуг и дорожек, у которых Width свойство меньше 50mil.
AsMils(TraceLength) = 10
Возвращает все объекты дуг и дорожек, у которых Length свойство равно 10mil.
Note — из‑за проблемы в ПО, чтобы корректно определить TraceLength с использованием ключевого слова AsMils, перед выполнением запроса единицы платы должны быть установлены в mil.
AsMM
Сводка
Для числовых свойств объектов (например, высота, ширина, радиус и т. п.) это ключевое слово используется для преобразования текущего значения — измеренного в единицах по умолчанию рабочей области — в метрические единицы (мм), где 1 мм = 0,001 метра; затем полученное значение сравнивается со значением, введенным в выражении.
Синтаксис
AsMM(Keyword : Number) : Number
Примеры использования
AsMM(ArcRadius) = 6.35
Возвращает все объекты дуг, у которых Radius свойство равно 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Возвращает все объекты компонентов, у которых Height свойство больше или равно 7.62mm и меньше или равно 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Возвращает все объекты заливки полигона, у которых Grid Sizeсвойство больше или равно 0.254mm.
AsMM(Width) < 1.27
Возвращает все объекты дуг и дорожек, у которых Width свойство меньше 1.27mm.
AsMM(TraceLength) = 1
Возвращает все объекты дуг и дорожек, у которых Length свойство равно 1mm.
Note — из‑за проблемы в ПО, чтобы корректно определить TraceLength с использованием ключевого слова AsMM, перед выполнением запроса единицы платы должны быть установлены в mil.
ComponentInLayerClass
Сводка
Возвращает все объекты компонентов, у которых Layer свойство соответствует слою, входящему в указанный класс слоев (Layer Class).
Синтаксис
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов слоев, отсортированный по имени.
Примеры использования
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Возвращает все объекты компонентов, у которых Layer свойство соответствует слою, входящему в класс слоев TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Возвращает все объекты except компонентов, у которых Layer свойство соответствует слою, входящему в класс слоев BottomSide.
Примечание
Одинарные кавычки (') в начале и в конце строки ClassName обязательны.
ExistsOnLayer
Сводка
Возвращает все объекты, которые существуют на указанном слое.
Синтаксис
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer — это имя слоя в том виде, как оно отображается на вкладке Layers & Colors панели View Configuration.
Примеры использования
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Возвращает все объекты, которые существуют на Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Возвращает все объекты except, которые существуют на слое Mechanical 3.
Примечание
Одинарные кавычки (') в начале и в конце Layer обязательны.
HasFootprint
Сводка
Возвращает все объекты компонентов, у которых Footprint свойство соответствует запросу.
Синтаксис
HasFootprint(Footprint : String) : Boolean/Boolean_String
Примеры использования
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Возвращает все объекты компонентов, у которых Footprint свойство начинается с SIP и заканчивается на 0, а также содержит еще один промежуточный символ. Примеры подходящих посадочных мест: SIP10, SIP20 и SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Возвращает все объекты компонентов, у которых Footprint свойство начинается с DIP. Примеры подходящих посадочных мест: DIP8, DIP14 и DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Возвращает все объекты except компонентов, у которых Footprint свойство равно IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Возвращает все объекты компонентов, у которых Footprint свойство содержит символ 2. Примеры подходящих посадочных мест: 2012, 2N5001, IDC20 и HDR1X2.
Примечания
-
Одинарные кавычки (') в начале и в конце строки
Footprintобязательны. - Для каждого возвращенного объекта компонента также возвращаются связанные с ним дочерние объекты.
HasFootprintPad
Сводка
Возвращает все объекты площадок (pad), являющиеся дочерними объектами объектов компонентов с указанным Footprint, и при этом Name свойство площадки соответствует запросу.
Синтаксис
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Примеры использования
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Возвращает все объекты except площадок, у которых Name свойство равно 1, и которые являются дочерними объектами объектов компонентов, у которых Footprint свойство равно 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Возвращает все объекты площадок, у которых Name свойство равно 1, и которые являются дочерними объектами объектов компонентов, у которых Footprint свойство начинается с SIP, заканчивается на 0 и содержит еще один промежуточный символ. Примеры подходящих посадочных мест: SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Возвращает все объекты площадок, у которых Name свойство равно MNT и которые являются дочерними объектами объектов компонентов, у которых Footprint свойство начинается с DB. Примеры подходящих посадочных мест: DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Возвращает все объекты площадок, у которых Name свойство начинается с MN, и которые являются дочерними объектами any объекта компонента.
Примечания
-
Одинарные кавычки (') в начале и в конце строк
FootprintиNameобязательны. - Родительские объекты компонентов не возвращаются.
HasMaskExpansionOnLayer
Сводка
Возвращает все объекты дуг, заливок, площадок, регионов, дорожек и переходных отверстий (via), для которых на указанном слое заданы значения расширения паяльной пасты (Paste Mask Expansion, кроме via) или расширения паяльной маски (Solder Mask Expansion). Значения могут быть заданы вручную или взяты из соответствующего правила проектирования.
Синтаксис
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer — это имя слоя, как оно отображается в соответствующем разделе Layers на вкладке Layers & Colors панели View Configuration.
Примеры использования
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Возвращает все объекты дуг, заливок, площадок, регионов, дорожек и via, для которых на Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
заданы значения Paste Mask Expansion (кроме via) или Solder Mask Expansion.
Возвращает все объекты exceptдуг, заливок, площадок, регионов, дорожек и via, для которых на Bottom Layer заданы значения Paste Mask Expansion (кроме via) или Solder Mask Expansion.
Примечание
Одинарные кавычки (') в начале и в конце Layer обязательны.
HasPad
Сводка
Возвращает все объекты площадок (pad), у которых свойство полного имени соответствует запросу.
Синтаксис
HasPad(PadName : String) : Boolean/Boolean_String
Строка PadName задает полное имя, которому должна соответствовать площадка. Оно состоит из начальной подстроки, задающей Name свойство родительского компонента площадки (т. е. Designator компонента), за которой следует подстрока, задающая собственное Name свойство площадки (т. е. Designator площадки). Таким образом, формат: 'ParentComponentDesignator-PadDesignator'.
Примеры использования
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Возвращает все объекты except площадку, у которой Name свойство равно 1, и которая является дочерним объектом объекта компонента, у которого Name свойство равно C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Возвращает площадку, у которой Name свойство равно 11, и которая является дочерним объектом объекта компонента, у которого Name свойство равно U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Возвращает все объекты площадок, у которых Name свойство равно 11, и которые являются дочерними объектами объектов компонентов, у которых Name свойство начинается с U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Возвращает все объекты площадок, у которых Name свойство начинается с 1, и которые являются дочерними объектами any объекта компонента.
Примечание
Одинарные кавычки (') в начале и в конце строки PadName обязательны.
HasViaFeature
Сводка
Возвращает все объекты переходных отверстий (via), у которых свойство via feature соответствует запросу.
Синтаксис
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
Строка ViaFeature задает признак переходного отверстия (via feature), которому должно соответствовать переходное отверстие. Это может быть одно из следующих значений:
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Пример использования
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Возвращает все объекты except объект переходного отверстия, у которого свойство «признак переходного отверстия» равно Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Возвращает объект переходного отверстия, у которого свойство «признак переходного отверстия» равно Covering.
Примечание
Одиночные кавычки (') в начале и в конце строки ViaFeature являются обязательными.
HasViaType
Сводка
Возвращает все объекты переходных отверстий, у которых свойство «тип переходного отверстия» соответствует запросу.
Синтаксис
HasViaType(ViaType : String) : Boolean/Boolean_String
Строка ViaType задает свойство IPC 4761 Via Type, которому должно соответствовать переходное отверстие. Это может быть одно из следующих значений:
-
None -
Type 1a -
Type 1b -
Type 2a -
Type 2b -
Type 3a -
Type 3b -
Type 4a -
Type 4b -
Type 5 -
Type 6a -
Type 6b -
Type 7
Пример использования
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Возвращает все объекты except объект переходного отверстия, у которого свойство «признак переходного отверстия» равно Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Возвращает объект переходного отверстия, у которого свойство «признак переходного отверстия» равно Covering.
Примечание
Одиночные кавычки (') в начале и в конце строки ViaFeature являются обязательными.
InChannelClass
Сводка
Возвращает все объекты, связанные с объектами компонентов, которые являются членами указанного класса проектных каналов (Design Channel Class).
Синтаксис
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов проектных каналов, отсортированных по имени.
Пример использования
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Возвращает все объекты, связанные с объектами компонентов, которые являются членами класса проектных каналов Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Возвращает все объекты, связанные с объектами компонентов, которые являются членами либо класса проектных каналов Output channel, либо Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Возвращает все объекты, связанные с объектами компонентов, которые являются членами любого класса проектных каналов, у которого свойство Name начинается с Input.
Примечания
-
Одиночные кавычки (') в начале и в конце каждой строки
ClassNameявляются обязательными. - Также возвращаются родительские объекты компонентов.
InComponent
Сводка
Возвращает все объекты компонентов, у которых свойство Name соответствует запросу.
Синтаксис
InComponent(Name : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих компонентов, отсортированных по имени.
Пример использования
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Возвращает все объекты компонентов, у которых свойство Name равно U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Возвращает все объекты компонентов, у которых свойство Name равно U1, или U2, или J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Возвращает все объекты except объекты компонентов, у которых свойство Name равно IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Возвращает все объекты компонентов, у которых свойство Name начинается с U.
Примечания
-
Одиночные кавычки (') в начале и в конце строки
Nameявляются обязательными. - Для каждого возвращенного объекта компонента также возвращаются связанные с ним дочерние объекты.
InComponentClass
Сводка
Возвращает все объекты компонентов, которые являются членами указанного класса компонентов (Component Class).
Синтаксис
InComponentClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов компонентов, отсортированных по имени.
Пример использования
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Возвращает все объекты компонентов, которые являются членами класса компонентов TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Возвращает все объекты except объекты компонентов, которые являются членами класса компонентов BottomSideSMD.
Примечание
Одиночные кавычки (') в начале и в конце строки ClassName являются обязательными.
InDifferentialPair
Сводка
Возвращает все объекты, связанные с объектами дифференциальных пар, у которых свойство Name соответствует запросу.
Синтаксис
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих дифференциальных пар, отсортированных по имени.
Пример использования
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Возвращает все объекты, связанные с объектом дифференциальной пары, у которого свойство Name равно Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Возвращает все объекты, связанные с объектами дифференциальных пар, у которых свойство Name равно либо D0, либо D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Возвращает все объекты, связанные с объектами дифференциальных пар, у которых свойство Name начинается с Input.
Примечания
-
Одиночные кавычки (') в начале и в конце каждой строки
DifferentialPairNameявляются обязательными. - Также возвращаются родительские объекты дифференциальных пар.
InDifferentialPairClass
Сводка
Возвращает все объекты дифференциальных пар, которые являются членами указанного класса дифференциальных пар (Differential Pair Class).
Синтаксис
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих дифференциальных пар, отсортированных по имени.
Пример использования
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Возвращает все объекты дифференциальных пар, которые являются членами класса дифференциальных пар TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Возвращает все объекты except объекты дифференциальных пар, которые являются членами класса дифференциальных пар BottomSide.
Примечание
Одиночные кавычки (') в начале и в конце строки ClassName являются обязательными.
InDrillLayerPair
Сводка
Возвращает все объекты переходных отверстий, у которых свойство Drill Pair соответствует указанной паре слоев сверления (Drill Layer Pair).
Синтаксис
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Пример использования
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Возвращает все объекты переходных отверстий, у которых свойство Drill Pair соответствует паре слоев сверления Top Layer - Bottom Layer.
Not InDrillLayerPair('Top Layer - Signal Layer 1')
InDrillLayerPair('Top Layer - Signal Layer 1') = False
InDrillLayerPair('Top Layer - Signal Layer 1') = 'False'
Возвращает все объекты except объекты переходных отверстий, у которых свойство Drill Pair соответствует паре слоев сверления Top Layer - Signal Layer 1.
Примечания
- Свойство Drill Layer Pair определено только для объектов переходных отверстий.
-
Одиночные кавычки (') в начале и в конце строки
LayerPairявляются обязательными. -
Чтобы нацелиться на конкретный тип переходного отверстия, включите в запрос подходящую проверку типа объекта:
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaилиIsSkipVia.
Например, запрос:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Возвращает все объекты переходных отверстий, у которых свойство Drill Pair соответствует паре слоев сверленияTop Layer - Signal Layer 1И тип переходного отверстия равенµVia.
InFromTo
Сводка
Возвращает все объекты, связанные с объектом from-to, у которого свойства Net, From Pad и To Pad соответствуют запросу.
Хотя объекты from-to будут возвращаться на панели PCB List, чтобы увидеть их в рабочей области, потребуется применить запрос фильтра после перевода панели PCB в режим From-To Editor.
Синтаксис
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих from-to, отсортированных по имени.
Net_Name, From_Pad и To_Pad — все являются строками; единственные одиночные кавычки (') — это те, что показаны выше (непосредственно внутри самой внешней пары скобок).
Каждая из строк From_Pad и To_Pad задает полное имя, которому должна соответствовать площадка (pad). Оно состоит из начальной подстроки, задающей свойство Name родительского компонента площадки (т. е. позиционное обозначение компонента — Designator), за которой следует подстрока, задающая собственное свойство Name площадки (т. е. позиционное обозначение площадки — Designator). Таким образом, формат: 'ParentComponentDesignator-PadDesignator'.
Пример использования
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Возвращает все объекты, связанные с объектом from-to, у которого свойство Net равно VDD_XTAL, свойство From Pad равно C13-2, а свойство To Pad равно U1-8. (Таким образом, у площадки From свойство Name равно 2, а у ее родительского объекта компонента свойство Name равно C13. Аналогично, у площадки To свойство Name равно 8 а у ее родительского объекта компонента свойство Name равно U1).
Примечание
Также возвращаются родительские объекты from-to.
InFromToClass
Сводка
Возвращает все объекты from-to, которые являются членами указанного класса From To (From To Class).
Синтаксис
InFromToClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов from-to по имени.
Пример использования
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Возвращает все объекты from-to, которые являются членами класса From To Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Возвращает все объекты except объекты from-to, которые являются членами класса From To Bus Terminators.
Примечание
Одиночные кавычки (') в начале и в конце строки ClassName являются обязательными.
InLayerClass
Сводка
Возвращает все объекты, у которых свойство Layer соответствует слою, являющемуся членом указанного класса слоев (Layer Class).
Синтаксис
InLayerClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов слоев, отсортированных по имени.
Пример использования
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Возвращает все объекты, у которых свойство Layer соответствует слою, являющемуся членом класса слоев TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Возвращает все объекты except объекты, у которых свойство Layer соответствует слою, являющемуся членом класса слоев BottomSide.
Примечание
Одинарные кавычки (') в начале и в конце строки ClassName являются обязательными.
InLayerStackRegion
Сводка
Возвращает все объекты, чья опорная точка находится внутри указанного Board Region.
Синтаксис
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Пример использования
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Возвращает все объекты, чья опорная точка находится внутри области платы, у которой свойство Name равно Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Возвращает все объекты, чья опорная точка находится внутри области платы, у которой свойство Name равно Region1, или области платы, у которой свойство Name равно Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Возвращает все объекты except объекты, чья опорная точка находится внутри области платы, у которой свойство Name равно Region2.
Примечание
Одинарные кавычки (') в начале и в конце строки RegionName являются обязательными.
InNamedPolygon
Сводка
Возвращает все примитивные объекты, являющиеся дочерними для указанной заливки полигона.
Синтаксис
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих заливок полигонов, отсортированных по имени.
Пример использования
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Возвращает все примитивные объекты, являющиеся дочерними для заливки полигона, у которой свойство Name равно Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Возвращает все объекты except примитивные объекты, являющиеся дочерними для заливки полигона, у которой свойство Name равно Power3V3.
Примечания
-
Одинарные кавычки (') в начале и в конце строки
PolygonNameявляются обязательными. - Также возвращается родительский объект заливки полигона.
InNamedUnion
Сводка
Возвращает все объекты (родительские и дочерние), входящие в указанное объединение.
Синтаксис
InNamedUnion(UnionName : String) : Boolean/Boolean_String
Имена объединений назначаются автоматически, но их можно переименовать с помощью панели PCB в режиме Unions . При задании выражения запроса отображается всплывающий список всех существующих объединений, отсортированных по имени.
Пример использования
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Возвращает все объекты (родительские и дочерние), входящие в объединение с именем Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Возвращает все объекты except объекты (родительские и дочерние), входящие в объединение с именем Unions 1.
Примечание
Одинарные кавычки (') в начале и в конце строки UnionName являются обязательными.
InNet
Сводка
Возвращает все объекты, связанные с объектами цепей (Net), у которых свойство Name соответствует запросу.
Синтаксис
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих цепей, отсортированных по имени.
Пример использования
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Возвращает все объекты, связанные с объектом цепи (Net), у которого свойство Name равно Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Возвращает все объекты, связанные с объектами цепей (Net), у которых свойство Name равно либо D0, либо D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Возвращает все объекты, связанные с объектами цепей (Net), у которых свойство Name начинается с V.
Примечания
-
Одинарные кавычки (') в начале и в конце каждой строки
NetNameявляются обязательными. - Также возвращаются родительские объекты цепей (Net).
InNetClass
Сводка
Возвращает все цепи (и связанные с ними объекты), входящие в указанный класс цепей (Net Class).
Синтаксис
InNetClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов цепей, отсортированных по имени.
Пример использования
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Возвращает все цепи (и связанные с ними объекты), входящие в класс цепей Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Возвращает все объекты except цепи (и связанные с ними объекты), входящие в класс цепей Address Bus Nets.
Примечание
Одинарные кавычки (') в начале и в конце строки ClassName являются обязательными.
InPadClass
Сводка
Возвращает все объекты контактных площадок, входящие в указанный класс площадок (Pad Class).
Синтаксис
InPadClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов площадок, отсортированных по имени.
Пример использования
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Возвращает все объекты контактных площадок, входящие в класс площадок Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Возвращает все объекты except объекты контактных площадок, входящие в класс площадок Bottom Side Probe Pads.
Примечание
Одинарные кавычки (') в начале и в конце строки ClassName являются обязательными.
InPolygonClass
Сводка
Возвращает все объекты заливки полигонов, входящие в указанный класс полигонов (Polygon Class).
Синтаксис
InPolygonClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов полигонов, отсортированных по имени.
Пример использования
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Возвращает все объекты заливки полигонов, входящие в класс полигонов Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Возвращает все объекты except объекты заливки полигонов, входящие в класс полигонов Custom Polys.
Примечание
Одинарные кавычки (') в начале и в конце строки ClassName являются обязательными.
InRegion
Сводка
Возвращает все объекты, расположенные в пределах области, заданной запросом.
Синтаксис
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 и X2,Y2 задают координаты в файле PCB (Library). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы области — параметрами Y1 и Y2.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала или точки установки компонента) и в настоящее время всегда используют единицы mil (1 mil = 0,001 дюйма).
Пример использования
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Возвращает объекты, находящиеся внутри прямоугольной области, ограниченной X1 = 12700 и X2 = 13300, а также Y1 = 4700 и Y2 = 5000; эти координаты отсчитываются от абсолютного начала координат.
Примечания
- Родительские объекты компонентов, координат, размеров и цепей (Net) не возвращаются.
- Это ключевое слово является псевдонимом ключевого слова InRegionAbsolute.
InRegionAbsolute
Сводка
Возвращает все объекты, расположенные в пределах области, заданной запросом.
Синтаксис
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 и X2,Y2 задают координаты в файле PCB (Library). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы области — параметрами Y1 и Y2.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала или точки установки компонента) и в настоящее время всегда используют единицы mil (1 mil = 0,001 дюйма).
Пример использования
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Возвращает объекты, находящиеся внутри прямоугольной области, ограниченной X1 = 12700 и X2 = 13300, а также Y1 = 4700 и Y2 = 5000; эти координаты отсчитываются от абсолютного начала координат.
Примечания
- Родительские объекты компонентов, координат, размеров и цепей (Net) не возвращаются.
- Это ключевое слово является псевдонимом ключевого слова InRegion.
InRegionRelative
Сводка
Возвращает все объекты, расположенные в пределах области, заданной запросом.
Синтаксис
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 и X2,Y2 задают координаты в файле PCB (Library). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы области — параметрами Y1 и Y2.
Все координаты отсчитываются от пользовательского начала координат (для файлов PCB) или точки установки компонента (для файлов PCB Library), а не от абсолютного начала координат, и в настоящее время всегда используют единицы mil (1 mil = 0,001 дюйма).
Пример использования
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Возвращает объекты, находящиеся внутри прямоугольной области, ограниченной X1 = -700 и X2 = 1300, а также Y1 = -400 и Y2 = 1600; эти координаты отсчитываются от пользовательского начала координат (или точки установки компонента).
Примечание
Родительские объекты компонентов, координат, размеров и цепей (Net) не возвращаются.
InStructureClass
Сводка
Возвращает все родительские и дочерние объекты классов компонентов (Component Classes) и классов цепей (Net Classes), входящих в указанный класс структуры (Structure Class).
Синтаксис
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов структуры, отсортированных по имени.
Пример использования
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов (Component Classes) и классов цепей (Net Classes), входящих в класс структуры Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов (Component Classes) и классов цепей (Net Classes), входящих либо в классы структуры Output channel или Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов (Component Classes) и классов цепей (Net Classes), которые являются членами любого класса структуры (Structure Class), у которого Name свойство начинается с Input.
Примечание
Одиночные кавычки (') в начале и в конце каждой строки ClassName являются обязательными.
InUnion
Сводка
Возвращает все объекты (родительские и дочерние), которые входят в указанное объединение (union).
Синтаксис
InUnion(Union : Number) : Boolean/Boolean_String
Номера объединений назначаются автоматически. При задании выражения запроса отображается всплывающий список всех существующих объединений, отсортированных по номеру.
Пример использования
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Возвращает все объекты (родительские и дочерние), которые входят в объединение, которому присвоен номер 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Возвращает все объекты except объекты (родительские и дочерние), которые входят в объединение, которому присвоен номер 4.
InxSignal
Сводка
Возвращает все объекты, связанные с указанным xSignal.
Синтаксис
InxSignal(Name : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих xSignal, отсортированных по имени.
Пример использования
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Возвращает все объекты, связанные с xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Возвращает все объекты except объекты, связанные с xSignal DRAM_A0_PP1.
Примечание
Одиночные кавычки (') в начале и в конце строки Name являются обязательными.
InxSignalClass
Сводка
Возвращает все объекты xSignal, которые являются членами указанного класса xSignal.
Синтаксис
InxSignalClass(ClassName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих пользовательских классов xSignal, отсортированных по имени.
Пример использования
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Возвращает все объекты xSignal, которые являются членами класса xSignal PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Возвращает все объекты except объекты xSignal, которые являются членами класса xSignal PCIE.
Примечание
Одиночные кавычки (') в начале и в конце строки ClassName являются обязательными.
IsNamedPolygon
Сводка
Возвращает указанную заливку полигона.
Синтаксис
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих заливок полигонов, отсортированных по имени.
Пример использования
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Возвращает объект заливки полигона, у которого Name свойство равно Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Возвращает все объекты except объект заливки полигона, у которого Name свойство равно Power3V3.
Примечания
-
Одиночные кавычки (') в начале и в конце строки
PolygonNameявляются обязательными. -
Дочерние примитивные объекты возвращаемого объекта заливки полигона не возвращаются.
IsxSignal
Сводка
Возвращает объект xSignal с указанным именем.
Синтаксис
IsxSignal(Name : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих xSignal, отсортированных по имени.
Пример использования
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Возвращает xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Возвращает все объекты except xSignal DRAM_A0_PP1.
Примечание
Одиночные кавычки (') в начале и в конце строки Name являются обязательными.
OnGrid
Сводка
Возвращает все объекты, чьи свойства X1 и Y1 соответствуют запросу.
Синтаксис
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Каждый экземпляр Distance_String — это числовая строка, задающая расстояние в файле PCB (Library). Чтобы объект был возвращён, его свойство X1 должно быть целым кратным первого указанного расстояния, а свойство Y1 — целым кратным второго указанного расстояния.
X1 и Y1 задают координаты в файле PCB (Library). Чтобы объект был возвращён, его свойство X1 должно быть целым кратным первого указанного значения, а его свойство Y1 — целым кратным второго указанного значения.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала координат или точки вставки компонента) и в настоящее время всегда используют единицы mil (1 mil = 0,001 дюйма).
Пример использования
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Возвращает все объекты, у которых свойство X1 является целым кратным 25mil, а свойство Y1 является целым кратным 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Возвращает все объекты, у которых свойство X1 является целым кратным 5mil, а свойство Y1 является целым кратным 100mil.
OnLayer
Сводка
Возвращает все объекты, чьё Layer свойство соответствует запросу.
Синтаксис
OnLayer(Layer : String) : Boolean/Boolean_String
Layer — это имя слоя в том виде, как оно отображается на вкладке Layers & Colors панели View Configuration.
Пример использования
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Возвращает все объекты, чьё Layer свойство равно Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Возвращает все объекты except объекты, чьё Layer свойство соответствует слою Mechanical 3.
Примечания
-
Одиночные кавычки (') в начале и в конце
Layerявляются обязательными. -
Обратите внимание: объекты, размещённые на слое
Multi-Layer, будут возвращаться ключевым словом запросаOnLayerтолько при указании именно этого слоя, т.е. при использовании запросаOnLayer('Multi-Layer'). Объекты, размещённые на слоеMulti-Layer, не будут возвращаться ключевым словом запросаOnLayerпри указании другого слоя, на котором существуют формы (shapes) этих объектов. Используйте запросExistsOnLayer(Layer : String), чтобы выбирать объекты (включая объекты на слоеMulti-Layer), которые имеют формы на указанном слое.
TouchesRoom
Сводка
Возвращает объекты, которые полностью или частично находятся в области, занимаемой любым объектом комнаты (room) (правило ограничивающего ограничения), у которого Name свойство соответствует запросу.
Синтаксис
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих комнат, отсортированных по имени.
Пример использования
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Возвращает объекты, которые полностью или частично находятся в области, занимаемой любой комнатой, у которой Name свойство равно Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Возвращает объекты, которые полностью или частично находятся в областях, занимаемых любыми комнатами, у которых Name свойство равно COUT1 или COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Возвращает объекты, которые полностью или частично находятся в областях, занимаемых любыми комнатами, у которых Name свойство равно Monitor, или Auxilary, или Effects.
Примечания
-
Одиночные кавычки (') в начале и в конце каждой строки
RoomNameявляются обязательными. -
Родительские объекты координат, размеров и цепей (Net) не возвращаются.
WithinRoom
Сводка
Возвращает объекты, которые полностью находятся в области, занимаемой любым объектом комнаты (room) (правило ограничивающего ограничения), у которого Name свойство соответствует запросу.
Чтобы контактные площадки (pads) и переходные отверстия (vias) были возвращены, их центральные точки должны находиться внутри указанной комнаты (комнат).
Синтаксис
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
При задании выражения запроса отображается всплывающий список всех существующих комнат, отсортированных по имени.
Пример использования
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Возвращает объекты, которые полностью находятся в области, занимаемой любой комнатой, у которой Name свойство равно Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Возвращает объекты, которые полностью находятся в областях, занимаемых любой комнатой, у которой Name свойство равно COUT1 или COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Возвращает объекты, которые полностью находятся в областях, занимаемых любой комнатой, у которой Name свойство равно Monitor, или Auxilary, или Effects.
Примечания
-
Одиночные кавычки (') в начале и в конце каждой строки
RoomNameявляются обязательными. - Родительские объекты координат, размеров и цепей (Net) не возвращаются.