Vérifications d’adhésion

Les fonctions de requête PCB affichées dans la boîte de dialogue
Cette page de référence détaille les mots-clés du langage de requête de la catégorie Membership Checks disponibles dans les documents PCB et PCB Library dans Altium Designer. Pour obtenir de l’aide sur un mot-clé de requête spécifique, utilisez les sections repliables suivantes ou surlignez (ou cliquez dans) n’importe quel mot-clé donné dans le Query Helper ou un panneau Filter, puis appuyez sur F1 pour accéder immédiatement à sa section.
AsMils
Résumé
Pour les propriétés numériques des objets (par ex. hauteur, largeur, rayon, etc.), ce mot-clé est utilisé pour convertir la valeur actuelle – mesurée dans les unités par défaut de l’espace de travail – en unités impériales - mil - où 1 mil = 0,001 pouce, qui est ensuite comparée à la valeur saisie dans l’expression.
Syntaxe
AsMils(Keyword : Number) : Number
Exemple d’utilisation
AsMils(ArcRadius) = 250
Retourne tous les objets arc ayant une propriété Radius qui est 250mil.
AsMils(Height) Between 300 And 500
Retourne tous les objets composant ayant une propriété Height supérieure ou égale à 300mil, et inférieure ou égale à 500mil.
AsMils(PolygonGridSize) >= 10
Retourne tous les objets de remplissage polygonal ayant une propriété Grid Size supérieure ou égale à 10mil.
AsMils(Width) < 50
Retourne tous les objets arc et piste ayant une propriété Width inférieure à 50mil.
AsMils(TraceLength) = 10
Retourne tous les objets arc et piste ayant une Length égale à 10mil.
Note - en raison d’un problème dans le logiciel, pour détecter correctement le TraceLength à l’aide du mot-clé AsMils, les unités de la carte doivent être définies sur mils avant d’exécuter la requête.
AsMM
Résumé
Pour les propriétés numériques des objets (par ex. hauteur, largeur, rayon, etc.), ce mot-clé est utilisé pour convertir la valeur actuelle – mesurée dans les unités par défaut de l’espace de travail – en unités métriques - mm - où 1mm = 0,001 mètre, qui est ensuite comparée à la valeur saisie dans l’expression.
Syntaxe
AsMM(Keyword : Number) : Number
Exemple d’utilisation
AsMM(ArcRadius) = 6.35
Retourne tous les objets arc ayant une propriété Radius qui est 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Retourne tous les objets composant ayant une propriété Height supérieure ou égale à 7.62mm, et inférieure ou égale à 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Retourne tous les objets de remplissage polygonal ayant une propriété Grid Size supérieure ou égale à 0.254mm.
AsMM(Width) < 1.27
Retourne tous les objets arc et piste ayant une propriété Width inférieure à 1.27mm.
AsMM(TraceLength) = 1
Retourne tous les objets arc et piste ayant une Length égale à 1mm.
Note - en raison d’un problème dans le logiciel, pour détecter correctement le TraceLength à l’aide du mot-clé AsMM, les unités de la carte doivent être définies sur mils avant d’exécuter la requête.
ComponentInLayerClass
Résumé
Retourne tous les objets composant dont la propriété Layer correspond à une couche membre de la classe de couches spécifiée.
Syntaxe
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de couches définies par l’utilisateur existantes est présentée, triée par nom.
Exemple d’utilisation
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Retourne tous les objets composant dont la propriété Layer correspond à une couche membre de la classe de couches TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Retourne tous les objets except objets composant dont la propriété Layer correspond à une couche membre de la classe de couches BottomSide.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
ExistsOnLayer
Résumé
Retourne tous les objets qui existent sur la couche spécifiée.
Syntaxe
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche tel qu’il apparaît dans l’onglet Layers & Colors du panneau View Configuration.
Exemple d’utilisation
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Retourne tous les objets qui existent sur la Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Retourne tous les objets except objets qui existent sur la couche Mechanical 3.
Remarque
Les apostrophes (') au début et à la fin de Layer sont obligatoires.
HasFootprint
Résumé
Retourne tous les objets composant dont la propriété Footprint satisfait à la requête.
Syntaxe
HasFootprint(Footprint : String) : Boolean/Boolean_String
Exemple d’utilisation
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Retourne tous les objets composant dont la propriété Footprint commence par SIP et se termine par 0, et inclut un autre caractère intermédiaire. Des exemples d’empreintes conformes incluent SIP10, SIP20 et SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Retourne tous les objets composant dont la propriété Footprint commence par DIP. Des exemples d’empreintes conformes incluent DIP8, DIP14 et DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Retourne tous les objets except objets composant dont la propriété Footprint est IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Retourne tous les objets composant dont la propriété Footprint inclut le caractère 2. Des exemples d’empreintes conformes incluent 2012, 2N5001, IDC20 et HDR1X2.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
Footprintsont obligatoires. - Pour chaque objet composant retourné, ses objets enfants associés sont également retournés.
HasFootprintPad
Résumé
Retourne tous les objets pastille qui sont des enfants d’objets composant avec l’empreinte spécifiée, et dont la propriété Name de la pastille satisfait à la requête.
Syntaxe
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Exemple d’utilisation
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Retourne tous les objets except objets pastille dont la propriété Name est 1, et qui sont des objets enfants d’objets composant dont la propriété Footprint est 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Retourne tous les objets pastille dont la propriété Name est 1, et qui sont des objets enfants d’objets composant dont la propriété Footprint commence par SIP, se termine par 0 et inclut un autre caractère intermédiaire. Des exemples d’empreintes conformes incluent SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Retourne tous les objets pastille dont la propriété Name est MNT et qui sont des objets enfants d’objets composant dont la propriété Footprint commence par DB. Des exemples d’empreintes conformes incluent DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Retourne tous les objets pastille dont la propriété Name commence par MN, et qui sont des objets enfants d’un any objet composant.
Remarques
-
Les apostrophes (') au début et à la fin des chaînes
FootprintetNamesont obligatoires. - Les objets composant parents ne sont pas retournés.
HasMaskExpansionOnLayer
Résumé
Retourne tous les objets arc, remplissage, pastille, région, piste et via qui ont des valeurs d’extension de masque de pâte (sauf via), ou d’extension de masque de soudure, définies pour la couche spécifiée. Les valeurs peuvent être définies manuellement ou reprises de la règle de conception définie applicable.
Syntaxe
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche, tel qu’il apparaît dans la section Layers applicable, dans l’onglet Layers & Colors du panneau View Configuration.
Exemple d’utilisation
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Retourne tous les objets arc, remplissage, pastille, région, piste et via qui ont des valeurs d’extension de masque de pâte (sauf via), ou d’extension de masque de soudure, définies pour la Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Retourne tous les objets except arc, remplissage, pastille, région, piste et via qui ont des valeurs d’extension de masque de pâte (sauf via), ou d’extension de masque de soudure, définies pour la Bottom Layer.
Remarque
Les apostrophes (') au début et à la fin de Layer sont obligatoires.
HasPad
Résumé
Retourne tous les objets pastille dont la propriété de nom complet satisfait à la requête.
Syntaxe
HasPad(PadName : String) : Boolean/Boolean_String
La chaîne PadName spécifie le nom complet auquel une pastille doit correspondre. Celui-ci se compose d’une sous-chaîne initiale qui spécifie la propriété Name du composant parent de la pastille (c.-à-d. le désignateur du composant), suivie d’une sous-chaîne qui spécifie la propriété Name propre à la pastille (c.-à-d. le désignateur de la pastille). Le format est donc 'ParentComponentDesignator-PadDesignator'.
Exemple d’utilisation
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Retourne tous les objets except l’objet pastille dont la propriété Name est 1, et qui est un objet enfant de l’objet composant dont la propriété Name est C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Retourne l’objet pastille dont la propriété Name est 11, et qui est un objet enfant de l’objet composant dont la propriété Name est U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Retourne tous les objets pastille dont la propriété Name est 11, et qui sont des objets enfants d’objets composant dont la propriété Name commence par U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Retourne tous les objets pastille dont la propriété Name commence par 1, et qui sont des objets enfants d’un any objet composant.
Remarque
Les apostrophes (') au début et à la fin de la chaîne PadName sont obligatoires.
HasViaFeature
Résumé
Retourne tous les objets via dont la propriété de caractéristique de via satisfait à la requête.
Syntaxe
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
La chaîne ViaFeature spécifie la caractéristique de via à laquelle un via doit correspondre. Cela peut être l’un des éléments suivants :
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Exemple d’utilisation
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Retourne tous les objets except l’objet via dont la propriété de caractéristique de via est Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Retourne l’objet via dont la propriété de caractéristique de via est Covering.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ViaFeature sont obligatoires.
HasViaType
Résumé
Retourne tous les objets via dont la propriété de type de via est conforme à la requête.
Syntaxe
HasViaType(ViaType : String) : Boolean/Boolean_String
La chaîne ViaType spécifie la propriété IPC 4761 Via Type à laquelle un via doit correspondre. Cela peut être l’un des éléments suivants :
-
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
Exemple d’utilisation
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Retourne tous les objets except l’objet via dont la propriété de caractéristique de via est Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Retourne l’objet via dont la propriété de caractéristique de via est Covering.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ViaFeature sont obligatoires.
InChannelClass
Résumé
Retourne tous les objets associés à des objets composant qui sont membres de la classe de canal de conception spécifiée.
Syntaxe
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de canaux de conception définies par l’utilisateur existantes, triées par nom, est affichée.
Exemple d’utilisation
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Retourne tous les objets associés à des objets composant qui sont membres de la classe de canal de conception Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Retourne tous les objets associés à des objets composant qui sont membres soit de la classe de canal de conception Output channel, soit de la classe de canal de conception Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Retourne tous les objets associés à des objets composant qui sont membres de toute classe de canal de conception dont la propriété Name commence par Input.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
ClassNamesont obligatoires. - Les objets composant parents sont également retournés.
InComponent
Résumé
Retourne tous les objets composant dont la propriété Name est conforme à la requête.
Syntaxe
InComponent(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les composants existants, triés par nom, est affichée.
Exemple d’utilisation
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Retourne tous les objets composant dont la propriété Name est U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Retourne tous les objets composant dont la propriété Name est U1, ou U2, ou J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Retourne tous les objets except objets composant dont la propriété Name est IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Retourne tous les objets composant dont la propriété Name commence par U.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
Namesont obligatoires. - Pour chaque objet composant retourné, ses objets enfants associés sont également retournés.
InComponentClass
Résumé
Retourne tous les objets composant qui sont membres de la classe de composants spécifiée.
Syntaxe
InComponentClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de composants définies par l’utilisateur existantes, triées par nom, est affichée.
Exemple d’utilisation
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Retourne tous les objets composant qui sont membres de la classe de composants TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Retourne tous les objets except objets composant qui sont membres de la classe de composants BottomSideSMD.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InDifferentialPair
Résumé
Retourne tous les objets associés à des objets paire différentielle dont la propriété Name est conforme à la requête.
Syntaxe
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les paires différentielles existantes, triées par nom, est affichée.
Exemple d’utilisation
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Retourne tous les objets associés à l’objet paire différentielle dont la propriété Name est Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Retourne tous les objets associés à des objets paire différentielle dont la propriété Name est soit D0, soit D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Retourne tous les objets associés à des objets paire différentielle dont la propriété Name commence par Input.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
DifferentialPairNamesont obligatoires. - Les objets paire différentielle parents sont également retournés.
InDifferentialPairClass
Résumé
Retourne tous les objets paire différentielle qui sont membres de la classe de paires différentielles spécifiée.
Syntaxe
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les paires différentielles existantes, triées par nom, est affichée.
Exemple d’utilisation
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Retourne tous les objets paire différentielle qui sont membres de la classe de paires différentielles TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Retourne tous les objets except objets paire différentielle qui sont membres de la classe de paires différentielles BottomSide.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InDrillLayerPair
Résumé
Retourne tous les objets via dont la propriété Drill Pair correspond à la paire de couches de perçage spécifiée.
Syntaxe
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Exemple d’utilisation
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Retourne tous les objets via dont la propriété Drill Pair correspond à la paire de couches de perçage 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'
Retourne tous les objets except objets via dont la propriété Drill Pair correspond à la paire de couches de perçage Top Layer - Signal Layer 1.
Remarques
- La propriété Drill Layer Pair n’est définie que pour les objets via.
-
Les apostrophes (') au début et à la fin de la chaîne
LayerPairsont obligatoires. -
Pour cibler un type spécifique de via, incluez une vérification appropriée du type d’objet dans la requête :
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaouIsSkipVia.
Par exemple, la requête :
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Retourne tous les objets via dont la propriété Drill Pair correspond à la paire de couches de perçageTop Layer - Signal Layer 1ET dont le type de via estµVia.
InFromTo
Résumé
Retourne tous les objets associés à un objet from-to dont les propriétés Net, From Pad et To Pad sont conformes à la requête.
Bien que les objets from-to soient retournés dans le panneau PCB List, pour les voir dans l’espace de travail, vous devrez appliquer la requête de filtre après avoir placé le panneau PCB en mode From-To Editor.
Syntaxe
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les from-tos existants, triés par nom, est affichée.
Net_Name, From_Pad et To_Pad sont tous des chaînes ; les seules apostrophes (') utilisées sont celles représentées ci-dessus (immédiatement à l’intérieur de la paire de parenthèses la plus externe).
Chacune des chaînes From_Pad et To_Pad spécifie le nom complet auquel une pastille doit correspondre. Celui-ci se compose d’une sous-chaîne initiale qui spécifie la propriété Name du composant parent de la pastille (c’est-à-dire le désignateur du composant), suivie d’une sous-chaîne qui spécifie la propriété Name propre à la pastille (c’est-à-dire le désignateur de la pastille). Le format est donc 'ParentComponentDesignator-PadDesignator'.
Exemple d’utilisation
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Retourne tous les objets associés à un objet from-to dont la propriété Net est VDD_XTAL, la propriété From Pad est C13-2, et la propriété To Pad est U1-8. (Ainsi, la pastille From a une propriété Name de 2, et son objet composant parent a une propriété Name de C13. De même, la pastille To a une propriété Name de 8 et son objet composant parent a une propriété Name de U1).
Remarque
Les objets from-to parents sont également retournés.
InFromToClass
Résumé
Retourne tous les objets from-to qui sont membres de la classe From To spécifiée.
Syntaxe
InFromToClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes from-to définies par l’utilisateur existantes, par nom, est affichée.
Exemple d’utilisation
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Retourne tous les objets from-to qui sont membres de la classe From To Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Retourne tous les objets except objets from-to qui sont membres de la classe From To Bus Terminators.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InLayerClass
Résumé
Retourne tous les objets dont la propriété Layer correspond à une couche qui est membre de la classe de couches spécifiée.
Syntaxe
InLayerClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de couches définies par l’utilisateur existantes, triées par nom, est affichée.
Exemple d’utilisation
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Retourne tous les objets dont la propriété Layer correspond à une couche qui est membre de la classe de couches TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Retourne tous les objets except objets dont la propriété Layer correspond à une couche qui est membre de la classe de couches BottomSide.
Remarque
Le caractère guillemet simple (') au début et à la fin de la chaîne ClassName est obligatoire.
InLayerStackRegion
Résumé
Renvoie tous les objets dont le point de référence se trouve dans le Board Region nommé.
Syntaxe
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Exemple d'utilisation
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Renvoie tous les objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Renvoie tous les objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region1, ou dans la région de carte dont la propriété Name est Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Renvoie tous les objets except objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region2.
Remarque
Les caractères guillemet simple (') au début et à la fin de la chaîne RegionName sont obligatoires.
InNamedPolygon
Résumé
Renvoie tous les objets primitifs qui sont des enfants du remplissage de polygone spécifié.
Syntaxe
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de tous les remplissages de polygone existants, triés par nom, est affichée.
Exemple d'utilisation
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Renvoie tous les objets primitifs qui sont des enfants du remplissage de polygone dont la propriété Name est Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Renvoie tous les objets except objets primitifs qui sont des enfants du remplissage de polygone dont la propriété Name est Power3V3.
Remarques
-
Les caractères guillemet simple (') au début et à la fin de la chaîne
PolygonNamesont obligatoires. - L'objet parent de remplissage de polygone est également renvoyé.
InNamedUnion
Résumé
Renvoie tous les objets (parent et enfants) qui font partie de l'union spécifiée.
Syntaxe
InNamedUnion(UnionName : String) : Boolean/Boolean_String
Les noms d'union sont attribués automatiquement, mais peuvent être renommés à l'aide du panneau PCB en mode Unions . Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les unions existantes, triées par nom, est affichée.
Exemple d'utilisation
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Renvoie tous les objets (parent et enfants) qui font partie de l'union dont le nom est Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Renvoie tous les objets except objets (parent et enfants) qui font partie de l'union dont le nom est Unions 1.
Remarque
Les caractères guillemet simple (') au début et à la fin de la chaîne UnionName sont obligatoires.
InNet
Résumé
Renvoie tous les objets associés aux objets Net dont la propriété Name est conforme à la requête.
Syntaxe
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de tous les nets existants, triés par nom, est affichée.
Exemple d'utilisation
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Renvoie tous les objets associés à l'objet Net dont la propriété Name est Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Renvoie tous les objets associés aux objets Net dont la propriété Name est soit D0, soit D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Renvoie tous les objets associés aux objets Net dont la propriété Name commence par V.
Remarques
-
Les caractères guillemet simple (') au début et à la fin de chaque chaîne
NetNamesont obligatoires. - Les objets Net parents sont également renvoyés.
InNetClass
Résumé
Renvoie tous les nets (et leurs objets associés) qui sont membres de la classe de nets spécifiée.
Syntaxe
InNetClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de nets définies par l'utilisateur, triées par nom, est affichée.
Exemple d'utilisation
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Renvoie tous les nets (et leurs objets associés) qui sont membres de la classe de nets Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Renvoie tous les objets except nets (et leurs objets associés) qui sont membres de la classe de nets Address Bus Nets.
Remarque
Les caractères guillemet simple (') au début et à la fin de la chaîne ClassName sont obligatoires.
InPadClass
Résumé
Renvoie tous les objets pad qui sont membres de la classe de pads spécifiée.
Syntaxe
InPadClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de pads définies par l'utilisateur, triées par nom, est affichée.
Exemple d'utilisation
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Renvoie tous les objets pad qui sont membres de la classe de pads Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Renvoie tous les objets except objets pad qui sont membres de la classe de pads Bottom Side Probe Pads.
Remarque
Les caractères guillemet simple (') au début et à la fin de la chaîne ClassName sont obligatoires.
InPolygonClass
Résumé
Renvoie tous les objets de remplissage de polygone qui sont membres de la classe de polygones spécifiée.
Syntaxe
InPolygonClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de polygones définies par l'utilisateur, triées par nom, est affichée.
Exemple d'utilisation
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Renvoie tous les objets de remplissage de polygone qui sont membres de la classe de polygones Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Renvoie tous les objets except objets de remplissage de polygone qui sont membres de la classe de polygones Custom Polys.
Remarque
Les caractères guillemet simple (') au début et à la fin de la chaîne ClassName sont obligatoires.
InRegion
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient des coordonnées dans le fichier PCB (Library). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure de la région sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l'origine absolue (et non à l'origine utilisateur ou au point d'insertion du composant) et, à l'heure actuelle, elles utilisent toujours des unités en mils (1 mil = 0,001 pouce).
Exemple d'utilisation
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = 12700 et X2 = 13300, et par Y1 = 4700 et Y2 = 5000 ; ces coordonnées sont référencées par rapport à l'origine absolue.
Remarques
- Les objets parent composant, coordonnée, cote et Net ne sont pas renvoyés.
- Ce mot-clé est un alias du mot-clé InRegionAbsolute.
InRegionAbsolute
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient des coordonnées dans le fichier PCB (Library). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure de la région sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l'origine absolue (et non à l'origine utilisateur ou au point d'insertion du composant) et, à l'heure actuelle, elles utilisent toujours des unités en mils (1 mil = 0,001 pouce).
Exemple d'utilisation
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = 12700 et X2 = 13300, et par Y1 = 4700 et Y2 = 5000 ; ces coordonnées sont référencées par rapport à l'origine absolue.
Remarques
- Les objets parent composant, coordonnée, cote et Net ne sont pas renvoyés.
- Ce mot-clé est un alias du mot-clé InRegion.
InRegionRelative
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient des coordonnées dans le fichier PCB (Library). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure de la région sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l'origine utilisateur (fichiers PCB) ou au point d'insertion du composant (fichiers de bibliothèque PCB), plutôt que par rapport à l'origine absolue, et à l'heure actuelle, elles utilisent toujours des unités en mils. (1 mil = 0,001 pouce).
Exemple d'utilisation
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = -700 et X2 = 1300, et par Y1 = -400 et Y2 = 1600 ; ces coordonnées sont référencées par rapport à l'origine utilisateur (ou au point d'insertion du composant).
Remarque
Les objets parent composant, coordonnée, cote et Net ne sont pas renvoyés.
InStructureClass
Résumé
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de la classe de structure spécifiée.
Syntaxe
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de structure définies par l'utilisateur, triées par nom, est affichée.
Exemple d'utilisation
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de la classe de structure Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres soit de la classe de structure Output channel, soit de la classe de structure Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Retourne tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de toute classe de structure dont la Name propriété commence par Input.
Remarque
Les guillemets simples (') au début et à la fin de chaque chaîne ClassName sont obligatoires.
InUnion
Résumé
Retourne tous les objets (parents et enfants) qui font partie de l’union spécifiée.
Syntaxe
InUnion(Union : Number) : Boolean/Boolean_String
Les numéros d’union sont attribués automatiquement. Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les unions existantes triées par numéro est affichée.
Exemple d’utilisation
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Retourne tous les objets (parents et enfants) qui font partie de l’union dont le numéro attribué est 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Retourne tous les objets except objets (parents et enfants) qui font partie de l’union dont le numéro attribué est 4.
InxSignal
Résumé
Retourne tous les objets associés au xSignal spécifié.
Syntaxe
InxSignal(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les xSignals existants triés par nom est affichée.
Exemple d’utilisation
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Retourne tous les objets associés au xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Retourne tous les objets except objets associés au xSignal DRAM_A0_PP1.
Remarque
Les guillemets simples (') au début et à la fin de la chaîne Name sont obligatoires.
InxSignalClass
Résumé
Retourne tous les objets xSignal qui sont membres de la classe xSignal spécifiée.
Syntaxe
InxSignalClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes xSignal définies par l’utilisateur et triées par nom est affichée.
Exemple d’utilisation
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Retourne tous les objets xSignal qui sont membres de la classe xSignal PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Retourne tous les objets except objets xSignal qui sont membres de la classe xSignal PCIE.
Remarque
Les guillemets simples (') au début et à la fin de la chaîne ClassName sont obligatoires.
IsNamedPolygon
Résumé
Retourne le remplissage de polygone spécifié.
Syntaxe
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les remplissages de polygone existants triés par nom est affichée.
Exemple d’utilisation
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Retourne l’objet de remplissage de polygone dont la Name propriété est Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Retourne tous les objets except l’objet de remplissage de polygone dont la Name propriété est Power3V3.
Remarques
-
Les guillemets simples (') au début et à la fin de la chaîne
PolygonNamesont obligatoires. -
Les objets primitifs enfants de l’objet de remplissage de polygone retourné ne sont pas retournés.
IsxSignal
Résumé
Retourne l’objet xSignal portant le nom spécifié.
Syntaxe
IsxSignal(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les xSignals existants triés par nom est affichée.
Exemple d’utilisation
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Retourne le xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Retourne tous les objets except le xSignal DRAM_A0_PP1.
Remarque
Les guillemets simples (') au début et à la fin de la chaîne Name sont obligatoires.
OnGrid
Résumé
Retourne tous les objets dont les propriétés X1 et Y1 sont conformes à la requête.
Syntaxe
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Chaque occurrence de Distance_String est une chaîne numérique qui spécifie une distance dans le fichier PCB (bibliothèque). Pour être retournée, la propriété X1 d’un objet doit être un multiple entier de la première distance spécifiée, et sa propriété Y1 doit être un multiple entier de la seconde distance spécifiée.
X1 et Y1 spécifient des coordonnées dans le fichier PCB (bibliothèque). Pour être retournée, la propriété X1 d’un objet doit être un multiple entier de la première valeur spécifiée, et sa propriété Y1 doit être un multiple entier de la seconde valeur spécifiée.
Toutes les coordonnées sont référencées à l’origine absolue (et non à l’origine utilisateur ni au point d’insertion du composant) et, à l’heure actuelle, elles utilisent toujours des unités en mils (1 mil = 0,001 pouce).
Exemple d’utilisation
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Retourne tous les objets dont la propriété X1 est un multiple entier de 25mil et dont la propriété Y1 est un multiple entier de 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Retourne tous les objets dont la propriété X1 est un multiple entier de 5mil et dont la propriété Y1 est un multiple entier de 100mil.
OnLayer
Résumé
Retourne tous les objets dont la Layer propriété est conforme à la requête.
Syntaxe
OnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche tel qu’il apparaît dans l’onglet Layers & Colors du panneau View Configuration.
Exemple d’utilisation
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Retourne tous les objets dont la Layer propriété est Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Retourne tous les objets except objets dont la Layer propriété correspond à la couche Mechanical 3.
Remarques
-
Les guillemets simples (') au début et à la fin de
Layersont obligatoires. -
Notez que les objets placés sur la couche
Multi-Layerseront retournés par le mot-clé de requêteOnLayeruniquement lors de la spécification de cette couche particulière, c’est-à-dire lors de l’utilisation de la requêteOnLayer('Multi-Layer'). Les objets placés sur la coucheMulti-Layerne seront pas retournés par le mot-clé de requêteOnLayerlorsqu’une autre couche sur laquelle existent les formes de ces objets est spécifiée. Utilisez la requêteExistsOnLayer(Layer : String)pour cibler les objets (y compris les objets sur la coucheMulti-Layer) qui ont des formes sur la couche spécifiée.
TouchesRoom
Résumé
Retourne les objets qui résident totalement ou partiellement dans la région occupée par tout objet room (règle de contrainte de confinement) dont la Name propriété est conforme à la requête.
Syntaxe
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les rooms existantes triées par nom est affichée.
Exemple d’utilisation
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Retourne les objets qui résident totalement ou partiellement dans la région occupée par toute Room dont la Name propriété est Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Retourne les objets qui résident totalement ou partiellement dans les régions occupées par toutes les Rooms dont la Name propriété est soit COUT1, soit COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Retourne les objets qui résident totalement ou partiellement dans les régions occupées par toutes les Rooms dont la Name propriété est Monitor, ou Auxilary, ou Effects.
Remarques
-
Les guillemets simples (') au début et à la fin de chaque chaîne
RoomNamesont obligatoires. -
Les objets parents de coordonnées, de dimensions et de net ne sont pas retournés.
WithinRoom
Résumé
Retourne les objets qui résident totalement dans la région occupée par tout objet room (règle de contrainte de confinement) dont la Name propriété est conforme à la requête.
Pour que les pads et les vias soient retournés, leurs points centraux doivent se trouver dans la ou les rooms spécifiées.
Syntaxe
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les rooms existantes triées par nom est affichée.
Exemple d’utilisation
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Retourne les objets qui résident totalement dans la région occupée par toute room dont la Name propriété est Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Retourne les objets qui résident totalement dans les régions occupées par toute room dont la Name propriété est soit COUT1, soit COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Retourne les objets qui résident totalement dans les régions occupées par toute room dont la Name propriété est Monitor, ou Auxilary, ou Effects.
Remarques
-
Les guillemets simples (') au début et à la fin de chaque chaîne
RoomNamesont obligatoires. - Les objets parents de coordonnées, de dimensions et de net ne sont pas retournés.