Проверки членства
Краткий обзор
- Вы узнаете, какие ключевые слова запросов категории Membership Checks доступны в Altium Designer и для чего используется каждое из них.
- Вы познакомитесь с правильным синтаксисом и примерами запросов для выбора объектов по единицам измерения, слоям, посадочным местам, контактным площадкам, расширению маски и особенностям переходных отверстий.
- Вы узнаете о важных нюансах использования, включая обязательные одинарные кавычки и особенности работы программы, которые могут влиять на результаты запросов.

Функции запросов Membership Checks для печатных плат, показанные в диалоговом окне Query Helper
На этой справочной странице подробно описаны ключевые слова языка запросов из категории Membership Checks , доступные в документах печатных плат и библиотек посадочных мест в Altium Designer. Чтобы получить справку по конкретному ключевому слову запроса, воспользуйтесь раскрывающимися разделами ниже или выделите ключевое слово (либо щелкните внутри него) в Query Helper или на панели Filter, затем нажмите F1 для быстрого перехода к соответствующему разделу.
AsMils
Описание
Для числовых свойств объектов (например, высоты, ширины, радиуса и т. д.) это ключевое слово используется для преобразования текущего значения, измеренного в единицах рабочего пространства по умолчанию, в имперские единицы — милы, где 1 мил = 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 перед выполнением запроса необходимо установить милы в качестве единиц измерения платы.
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 перед выполнением запроса необходимо установить милы в качестве единиц измерения платы.
ComponentInLayerClass
Описание
Возвращает все объекты-компоненты, у которых свойство Layer соответствует слою, входящему в указанный класс слоев.
Синтаксис
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
Описание
Возвращает все объекты-контактные площадки, которые являются дочерними объектами компонентов с указанным посадочным местом и у которых свойство 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
Краткое описание
Возвращает все объекты дуг, заливок, контактных площадок, областей, дорожек и переходных отверстий, для которых на указанном слое заданы значения расширения окна в маске паяльной пасты (кроме переходных отверстий) или паяльной маске. Значения могут быть заданы вручную или взяты из соответствующего правила проектирования.
Синтаксис
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer — имя слоя, отображаемое в соответствующем разделе Layers на вкладке Layers & Colors панели View Configuration.
Примеры использования
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Возвращает все объекты дуг, заливок, контактных площадок, областей, дорожек и переходных отверстий, для которых заданы значения расширения окна в маске паяльной пасты (кроме переходных отверстий) или паяльной маске для Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Возвращает все объекты except объекты дуг, заливок, контактных площадок, областей, дорожек и переходных отверстий, для которых заданы значения расширения окна в маске паяльной пасты (кроме переходных отверстий) или паяльной маске для Bottom Layer.
Примечание
Одинарные кавычки (') в начале и в конце Layer обязательны.
HasPad
Краткое описание
Возвращает все объекты контактных площадок, полное имя которых соответствует запросу.
Синтаксис
HasPad(PadName : String) : Boolean/Boolean_String
Строка PadName задаёт полное имя, которому должна соответствовать контактная площадка. Оно состоит из начальной подстроки, задающей свойство Name родительского компонента площадки (то есть позиционное обозначение компонента), и следующей за ней подстроки, задающей собственное свойство Name площадки (то есть обозначение площадки). Таким образом, используется формат '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
Краткое описание
Возвращает все объекты переходных отверстий, у которых свойство характеристики переходного отверстия соответствует запросу.
Синтаксис
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
Строка ViaFeature задаёт характеристику, которой должно соответствовать переходное отверстие. Допускается одно из следующих значений:
-
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
Краткое описание
Возвращает все объекты, связанные с объектами компонентов, входящими в указанный класс каналов проекта.
Синтаксис
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
Краткое описание
Возвращает все объекты компонентов, входящие в указанный класс компонентов.
Синтаксис
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
Краткое описание
Возвращает все объекты дифференциальных пар, входящие в указанный класс дифференциальных пар.
Синтаксис
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 соответствует указанной паре слоев сверления.
Синтаксис
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
Краткое описание
Возвращает все объекты, связанные с объектом связи «от–до», свойства Net, From Pad и To Pad которого соответствуют запросу.
Хотя объекты связей «от–до» отображаются на панели PCB List, для их просмотра в рабочей области необходимо применить запрос фильтра после переключения панели PCB в режим From-To Editor.
Синтаксис
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
При вводе выражения запроса отображается всплывающий список всех существующих связей «от–до», отсортированных по имени.
Net_Name, From_Pad и To_Pad — строки; одинарные кавычки (') используются только в показанных выше местах (непосредственно внутри внешней пары скобок).
Каждая из строк From_Pad и To_Pad задает полное имя, которому должна соответствовать контактная площадка. Оно состоит из начальной подстроки, задающей свойство Name родительского компонента контактной площадки (то есть позиционное обозначение компонента), за которой следует подстрока, задающая собственное свойство Name контактной площадки (то есть обозначение контактной площадки). Таким образом, используется формат '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'
Возвращает все объекты, связанные с объектом связи «от–до», у которого свойство Net имеет значение VDD_XTAL, свойство From Pad — C13-2, а свойство To Pad — U1-8. (Таким образом, у начальной контактной площадки свойство Name имеет значение 2, а у ее родительского компонента свойство Name имеет значение C13. Аналогично, у конечной контактной площадки свойство Name имеет значение 8, а у ее родительского компонента свойство Name имеет значение U1).
Примечание
Также возвращаются родительские объекты связей «от–до».
InFromToClass
Краткое описание
Возвращает все объекты связей «от–до», входящие в указанный класс связей «от–до».
Синтаксис
InFromToClass(ClassName : String) : Boolean/Boolean_String
При вводе выражения запроса отображается всплывающий список имен всех существующих пользовательских классов связей «от–до».
Примеры использования
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Возвращает все объекты связей «от–до», входящие в класс связей «от–до» Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Возвращает все объекты except объекты связей «от–до», входящие в класс связей «от–до» Bus Terminators.
Примечание
Одинарные кавычки (') в начале и конце строки ClassName обязательны.
InLayerClass
Краткое описание
Возвращает все объекты, у которых свойство Layer соответствует слою, входящему в указанный класс слоев.
Синтаксис
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
Краткое описание
Возвращает все объекты, связанные с объектами цепей, у которых свойство Name соответствует запросу.
Синтаксис
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
При вводе выражения запроса отображается всплывающий список всех существующих цепей, отсортированных по имени.
Примеры использования
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Возвращает все объекты, связанные с объектом цепи, у которого свойство Name имеет значение Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Возвращает все объекты, связанные с объектами цепей, у которых свойство Name имеет значение D0 или D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Возвращает все объекты, связанные с объектами цепей, у которых свойство Name начинается с V.
Примечания
-
Одинарные кавычки (') в начале и конце каждой строки
NetNameобязательны. - Родительские объекты цепей также возвращаются.
InNetClass
Краткое описание
Возвращает все цепи (и связанные с ними объекты), входящие в указанный класс цепей.
Синтаксис
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
Краткое описание
Возвращает все контактные площадки, входящие в указанный класс контактных площадок.
Синтаксис
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
Краткое описание
Возвращает все объекты полигональной заливки, входящие в указанный класс полигонов.
Синтаксис
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 задают координаты в файле печатной платы (библиотеки). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы — параметрами Y1 и Y2.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала координат или точки вставки компонента) и в настоящее время всегда задаются в милах (1 мил = 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; эти координаты отсчитываются от абсолютного начала координат.
Примечания
- Родительские объекты компонентов, координат, размеров и цепей не возвращаются.
- Это ключевое слово является псевдонимом ключевого слова InRegionAbsolute.
InRegionAbsolute
Краткое описание
Возвращает все объекты, расположенные внутри области, заданной запросом.
Синтаксис
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 и X2,Y2 задают координаты в файле печатной платы (библиотеки). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы — параметрами Y1 и Y2.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала координат или точки вставки компонента) и в настоящее время всегда задаются в милах (1 мил = 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; эти координаты отсчитываются от абсолютного начала координат.
Примечания
- Родительские объекты компонентов, координат, размеров и цепей не возвращаются.
- Это ключевое слово является псевдонимом ключевого слова InRegion.
InRegionRelative
Краткое описание
Возвращает все объекты, расположенные внутри области, заданной запросом.
Синтаксис
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 и X2,Y2 задают координаты в файле печатной платы (библиотеки). Левая и правая границы области задаются параметрами X1 и X2, а нижняя и верхняя границы — параметрами Y1 и Y2.
Все координаты отсчитываются от пользовательского начала координат (в файлах печатных плат) или точки вставки компонента (в файлах библиотек печатных плат), а не от абсолютного начала координат, и в настоящее время всегда задаются в милах (1 мил = 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; эти координаты отсчитываются от пользовательского начала координат (или точки вставки компонента).
Примечание
Родительские объекты компонентов, координат, размеров и цепей не возвращаются.
InStructureClass
Краткое описание
Возвращает все родительские и дочерние объекты классов компонентов и классов цепей, входящих в указанный структурный класс.
Синтаксис
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
При вводе выражения запроса отображается всплывающий список всех существующих пользовательских структурных классов, отсортированных по имени.
Примеры использования
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов и классов цепей, входящих в структурный класс Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов и классов цепей, входящих в структурный класс Output channel или Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Возвращает все родительские и дочерние объекты классов компонентов и классов цепей, входящих в любой структурный класс, у которого значение свойства Name начинается с Input.
Примечание
Одинарные кавычки (') в начале и конце каждой строки ClassName обязательны.
InUnion
Краткое описание
Возвращает все объекты (родительские и дочерние), входящие в указанное объединение.
Синтаксис
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 представляет собой числовую строку, задающую расстояние в файле печатной платы (библиотеки). Чтобы объект был возвращён, его свойство X1 должно быть целым кратным первого указанного расстояния, а свойство Y1 — целым кратным второго указанного расстояния.
X1 и Y1 задают координаты в файле печатной платы (библиотеки). Чтобы объект был возвращён, его свойство X1 должно быть целым кратным первого указанного значения, а свойство Y1 — целым кратным второго указанного значения.
Все координаты отсчитываются от абсолютного начала координат (а не от пользовательского начала координат или точки вставки компонента) и в настоящее время всегда выражаются в милах (1 мил = 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при указании другого слоя, на котором присутствует геометрия этих объектов. Используйте запросExistsOnLayer(Layer : String)для выбора объектов (включая объекты на слоеMulti-Layer), геометрия которых присутствует на указанном слое.
TouchesRoom
Краткое описание
Возвращает объекты, которые полностью или частично находятся в области, занимаемой любым объектом комнаты (правило ограничения размещения), свойство 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обязательны. -
Родительские объекты координат, размеров и цепей не возвращаются.
WithinRoom
Краткое описание
Возвращает объекты, которые полностью находятся в области, занимаемой любым объектом комнаты (правило ограничения размещения), свойство Name которого соответствует запросу.
Чтобы контактные площадки и переходные отверстия попали в результаты запроса, их центральные точки должны находиться внутри указанных комнат.
Синтаксис
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обязательны. - Родительские объекты координат, размеров и цепей не возвращаются.