Verifiche di appartenenza

Le funzioni di query PCB mostrate nella finestra di dialogo Membership ChecksQuery Helper
Questa pagina di riferimento descrive le parole chiave del linguaggio di query della categoria Membership Checks disponibili nei documenti PCB e PCB Library in Altium Designer. Per assistenza su una specifica parola chiave di query, utilizzare le seguenti sezioni comprimibili oppure evidenziare (o fare clic all'interno di) una determinata parola chiave nel Query Helper o in un pannello Filter, quindi premere F1 per accedere immediatamente alla relativa sezione.
AsMils
Riepilogo
Per le proprietà numeriche degli oggetti (ad esempio altezza, larghezza, raggio, ecc.), questa parola chiave viene utilizzata per convertire il valore corrente – misurato nelle unità predefinite dell'area di lavoro – in unità imperiali - mil - dove 1 mil = 0,001 pollici, che viene quindi confrontato con il valore immesso nell'espressione.
Sintassi
AsMils(Keyword : Number) : Number
Esempio di utilizzo
AsMils(ArcRadius) = 250
Restituisce tutti gli oggetti arco che hanno una proprietà Radius che è 250mil.
AsMils(Height) Between 300 And 500
Restituisce tutti gli oggetti componente che hanno una proprietà Height maggiore o uguale a 300mil e minore o uguale a 500mil.
AsMils(PolygonGridSize) >= 10
Restituisce tutti gli oggetti riempimento poligonale che hanno una proprietà Grid Size maggiore o uguale a 10mil.
AsMils(Width) < 50
Restituisce tutti gli oggetti arco e traccia che hanno una proprietà Width inferiore a 50mil.
AsMils(TraceLength) = 10
Restituisce tutti gli oggetti arco e traccia che hanno un Length uguale a 10mil.
Note - a causa di un problema nel software, per rilevare correttamente il TraceLength utilizzando la parola chiave AsMils, le unità della scheda devono essere impostate su mil prima di eseguire la query.
AsMM
Riepilogo
Per le proprietà numeriche degli oggetti (ad esempio altezza, larghezza, raggio, ecc.), questa parola chiave viene utilizzata per convertire il valore corrente – misurato nelle unità predefinite dell'area di lavoro – in unità metriche - mm - dove 1 mm = 0,001 metri, che viene quindi confrontato con il valore immesso nell'espressione.
Sintassi
AsMM(Keyword : Number) : Number
Esempio di utilizzo
AsMM(ArcRadius) = 6.35
Restituisce tutti gli oggetti arco che hanno una proprietà Radius che è 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Restituisce tutti gli oggetti componente che hanno una proprietà Height maggiore o uguale a 7.62mm e minore o uguale a 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Restituisce tutti gli oggetti riempimento poligonale che hanno una proprietà Grid Size maggiore o uguale a 0.254mm.
AsMM(Width) < 1.27
Restituisce tutti gli oggetti arco e traccia che hanno una proprietà Width inferiore a 1.27mm.
AsMM(TraceLength) = 1
Restituisce tutti gli oggetti arco e traccia che hanno un Length uguale a 1mm.
Note - a causa di un problema nel software, per rilevare correttamente il TraceLength utilizzando la parola chiave AsMM le unità della scheda devono essere impostate su mil prima di eseguire la query.
ComponentInLayerClass
Riepilogo
Restituisce tutti gli oggetti componente la cui proprietà Layer corrisponde a un layer che è membro della classe di layer specificata.
Sintassi
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione di query, viene presentato un elenco a comparsa di tutte le classi di layer definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Layer corrisponde a un layer che è membro della classe di layer TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Restituisce tutti gli oggetti except oggetti componente la cui proprietà Layer corrisponde a un layer che è membro della classe di layer BottomSide.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ClassName sono obbligatori.
ExistsOnLayer
Riepilogo
Restituisce tutti gli oggetti che esistono sul layer specificato.
Sintassi
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer è il nome del layer così come appare nella scheda Layers & Colors del pannello View Configuration.
Esempio di utilizzo
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Restituisce tutti gli oggetti che esistono sul Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Restituisce tutti gli oggetti except oggetti che esistono sul layer Mechanical 3.
Nota
I caratteri di apice singolo (') all'inizio e alla fine di Layer sono obbligatori.
HasFootprint
Riepilogo
Restituisce tutti gli oggetti componente la cui proprietà Footprint soddisfa la query.
Sintassi
HasFootprint(Footprint : String) : Boolean/Boolean_String
Esempio di utilizzo
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Footprint inizia con SIP e termina con 0, e include un altro carattere intermedio. Esempi di footprint conformi includono SIP10, SIP20 e SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Footprint inizia con DIP. Esempi di footprint conformi includono DIP8, DIP14 e DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Restituisce tutti gli oggetti except oggetti componente la cui proprietà Footprint è IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Footprint include il carattere 2. Esempi di footprint conformi includono 2012, 2N5001, IDC20 e HDR1X2.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine della stringa
Footprintsono obbligatori. - Per ogni oggetto componente restituito, vengono restituiti anche gli oggetti figlio associati.
HasFootprintPad
Riepilogo
Restituisce tutti gli oggetti pad che sono figli di oggetti componente con il Footprint specificato e per i quali la proprietà Name del pad soddisfa la query.
Sintassi
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Esempio di utilizzo
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Restituisce tutti gli oggetti except oggetti pad la cui proprietà Name è 1, e che sono oggetti figlio di oggetti componente la cui proprietà Footprint è 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Restituisce tutti gli oggetti pad la cui proprietà Name è 1, e che sono oggetti figlio di oggetti componente la cui proprietà Footprint inizia con SIP, termina con 0 e include un altro carattere intermedio. Esempi di footprint conformi includono SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Restituisce tutti gli oggetti pad la cui proprietà Name è MNT e che sono oggetti figlio di oggetti componente la cui proprietà Footprint inizia con DB. Esempi di footprint conformi includono DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Restituisce tutti gli oggetti pad la cui proprietà Name inizia con MN, e che sono oggetti figlio di any oggetto componente.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine delle stringhe
FootprinteNamesono obbligatori. - Gli oggetti componente padre non vengono restituiti.
HasMaskExpansionOnLayer
Riepilogo
Restituisce tutti gli oggetti arco, riempimento, pad, regione, traccia e via che hanno valori di espansione della Paste Mask (eccetto le via) oppure di espansione della Solder Mask definiti per il layer specificato. I valori possono essere definiti manualmente oppure ricavati dalla regola di progettazione definita applicabile.
Sintassi
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer è il nome del layer, così come appare nella sezione Layers applicabile, nella scheda Layers & Colors del pannello View Configuration.
Esempio di utilizzo
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Restituisce tutti gli oggetti arco, riempimento, pad, regione, traccia e via che hanno valori di espansione della Paste Mask (eccetto le via) oppure di espansione della Solder Mask definiti per il Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Restituisce tutti gli oggetti except arco, riempimento, pad, regione, traccia e via che hanno valori di espansione della Paste Mask (eccetto le via) oppure di espansione della Solder Mask definiti per Bottom Layer.
Nota
I caratteri di apice singolo (') all'inizio e alla fine di Layer sono obbligatori.
HasPad
Riepilogo
Restituisce tutti gli oggetti pad la cui proprietà del nome completo soddisfa la query.
Sintassi
HasPad(PadName : String) : Boolean/Boolean_String
La stringa PadName specifica il nome completo che un pad deve corrispondere. Questo consiste in una sottostringa iniziale che specifica la proprietà Name del componente padre del pad (cioè il Designator del componente), seguita da una sottostringa che specifica la proprietà Name del pad stesso (cioè il Designator del pad). Il formato è quindi 'ParentComponentDesignator-PadDesignator'.
Esempio di utilizzo
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Restituisce tutti gli oggetti except l'oggetto pad la cui proprietà Name è 1, e che è un oggetto figlio dell'oggetto componente la cui proprietà Name è C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Restituisce l'oggetto pad la cui proprietà Name è 11, e che è un oggetto figlio dell'oggetto componente la cui proprietà Name è U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Restituisce tutti gli oggetti pad la cui proprietà Name è 11, e che sono oggetti figlio di oggetti componente la cui proprietà Name inizia con U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Restituisce tutti gli oggetti pad la cui proprietà Name inizia con 1, e che sono oggetti figlio di any oggetto componente.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa PadName sono obbligatori.
HasViaFeature
Riepilogo
Restituisce tutti gli oggetti via la cui proprietà della caratteristica della via soddisfa la query.
Sintassi
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
La stringa ViaFeature specifica la caratteristica di via che una via deve soddisfare. Può essere una delle seguenti:
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Esempio di utilizzo
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Restituisce tutti gli oggetti except l'oggetto via la cui proprietà della caratteristica di via è Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Restituisce l'oggetto via la cui proprietà della caratteristica di via è Covering.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ViaFeature sono obbligatori.
HasViaType
Riepilogo
Restituisce tutti gli oggetti via la cui proprietà del tipo di via è conforme alla Query.
Sintassi
HasViaType(ViaType : String) : Boolean/Boolean_String
La stringa ViaType specifica la proprietà IPC 4761 Via Type che una via deve soddisfare. Può essere una delle seguenti:
-
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
Esempio di utilizzo
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Restituisce tutti gli oggetti except l'oggetto via la cui proprietà della caratteristica di via è Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Restituisce l'oggetto via la cui proprietà della caratteristica di via è Covering.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ViaFeature sono obbligatori.
InChannelClass
Riepilogo
Restituisce tutti gli oggetti associati a oggetti componente che sono membri della classe di canale di progetto specificata.
Sintassi
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le classi di canale di progetto definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Restituisce tutti gli oggetti associati a oggetti componente che sono membri della classe di canale di progetto Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Restituisce tutti gli oggetti associati a oggetti componente che sono membri della classe di canale di progetto Output channel oppure Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Restituisce tutti gli oggetti associati a oggetti componente che sono membri di qualsiasi classe di canale di progetto la cui proprietà Name inizia con Input.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine di ogni stringa
ClassNamesono obbligatori. - Vengono restituiti anche gli oggetti componente padre.
InComponent
Riepilogo
Restituisce tutti gli oggetti componente la cui proprietà Name è conforme alla Query.
Sintassi
InComponent(Name : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutti i componenti esistenti, ordinati per nome.
Esempio di utilizzo
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Name è U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Name è U1, oppure U2, oppure J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Restituisce tutti gli oggetti except componente la cui proprietà Name è IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Restituisce tutti gli oggetti componente la cui proprietà Name inizia con U.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine della stringa
Namesono obbligatori. - Per ogni oggetto componente restituito, vengono restituiti anche i relativi oggetti figlio associati.
InComponentClass
Riepilogo
Restituisce tutti gli oggetti componente che sono membri della classe di componenti specificata.
Sintassi
InComponentClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le classi di componenti definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Restituisce tutti gli oggetti componente che sono membri della classe di componenti TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Restituisce tutti gli oggetti except componente che sono membri della classe di componenti BottomSideSMD.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ClassName sono obbligatori.
InDifferentialPair
Riepilogo
Restituisce tutti gli oggetti associati a oggetti coppia differenziale la cui proprietà Name è conforme alla Query.
Sintassi
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le coppie differenziali esistenti, ordinate per nome.
Esempio di utilizzo
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Restituisce tutti gli oggetti associati all'oggetto coppia differenziale la cui proprietà Name è Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Restituisce tutti gli oggetti associati a oggetti coppia differenziale la cui proprietà Name è D0 oppure D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Restituisce tutti gli oggetti associati a oggetti coppia differenziale la cui proprietà Name inizia con Input.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine di ogni stringa
DifferentialPairNamesono obbligatori. - Vengono restituiti anche gli oggetti coppia differenziale padre.
InDifferentialPairClass
Riepilogo
Restituisce tutti gli oggetti coppia differenziale che sono membri della classe di coppie differenziali specificata.
Sintassi
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le coppie differenziali esistenti, ordinate per nome.
Esempio di utilizzo
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Restituisce tutti gli oggetti coppia differenziale che sono membri della classe di coppie differenziali TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Restituisce tutti gli oggetti except coppia differenziale che sono membri della classe di coppie differenziali BottomSide.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ClassName sono obbligatori.
InDrillLayerPair
Riepilogo
Restituisce tutti gli oggetti via la cui proprietà Drill Pair corrisponde alla coppia di layer di foratura specificata.
Sintassi
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Esempio di utilizzo
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Restituisce tutti gli oggetti via la cui proprietà Drill Pair corrisponde alla coppia di layer di foratura 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'
Restituisce tutti gli oggetti except via la cui proprietà Drill Pair corrisponde alla coppia di layer di foratura Top Layer - Signal Layer 1.
Note
- La proprietà Drill Layer Pair è definita solo per gli oggetti via.
-
I caratteri di apice singolo (') all'inizio e alla fine della stringa
LayerPairsono obbligatori. -
Per selezionare un tipo specifico di via, includi nella query un controllo adatto del tipo di oggetto:
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaoIsSkipVia.
Ad esempio, la query:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Restituisce tutti gli oggetti via la cui proprietà Drill Pair corrisponde alla coppia di layer di foraturaTop Layer - Signal Layer 1E il cui tipo di via èµVia.
InFromTo
Riepilogo
Restituisce tutti gli oggetti associati a un oggetto from-to le cui proprietà Net, From Pad e To Pad sono conformi alla Query.
Sebbene gli oggetti from-to vengano restituiti nel pannello PCB List, per visualizzarli nell'area di lavoro sarà necessario applicare la query di filtro dopo aver impostato il pannello PCB in modalità From-To Editor.
Sintassi
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
Durante la definizione dell'espressione query, viene presentato un elenco a comparsa di tutti i from-to esistenti, ordinati per nome.
Net_NameFrom_Pad e To_Pad sono tutte stringhe; gli unici caratteri di apice singolo (') utilizzati sono quelli mostrati sopra (immediatamente all'interno della coppia più esterna di parentesi).
Ciascuna delle stringhe From_Pad e To_Pad specifica il nome completo che un pad deve soddisfare. Questo consiste in una sottostringa iniziale che specifica la proprietà Name del componente padre del pad (cioè il Designator del componente), seguita da una sottostringa che specifica la proprietà Name del pad stesso (cioè il Designator del pad). Il formato è quindi 'ParentComponentDesignator-PadDesignator'.
Esempio di utilizzo
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Restituisce tutti gli oggetti associati a un oggetto from-to la cui proprietà Net è VDD_XTAL, la proprietà From Pad è C13-2 e la proprietà To Pad è U1-8. (Di conseguenza, il pad From ha una proprietà Name pari a 2 e il suo oggetto componente padre ha una proprietà Name pari a C13. Analogamente, il pad To ha una proprietà Name pari a 8 e il suo oggetto componente padre ha una proprietà Name pari a U1).
Nota
Vengono restituiti anche gli oggetti from-to padre.
InFromToClass
Riepilogo
Restituisce tutti gli oggetti from-to che sono membri della classe From To specificata.
Sintassi
InFromToClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le classi from-to definite dall'utente esistenti, per nome.
Esempio di utilizzo
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Restituisce tutti gli oggetti from-to che sono membri della classe From To Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Restituisce tutti gli oggetti except from-to che sono membri della classe From To Bus Terminators.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ClassName sono obbligatori.
InLayerClass
Riepilogo
Restituisce tutti gli oggetti la cui proprietà Layer corrisponde a un layer che è membro della classe di layer specificata.
Sintassi
InLayerClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene presentato un elenco a comparsa di tutte le classi di layer definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Restituisce tutti gli oggetti la cui proprietà Layer corrisponde a un layer che è membro della classe di layer TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Restituisce tutti gli oggetti except oggetti la cui proprietà Layer corrisponde a un layer che è membro della classe di layer BottomSide.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa ClassName è obbligatorio.
InLayerStackRegion
Riepilogo
Restituisce tutti gli oggetti il cui punto di riferimento si trova all'interno dell'elemento denominato Board Region.
Sintassi
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Esempio di utilizzo
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Restituisce tutti gli oggetti il cui punto di riferimento si trova all'interno della Board Region la cui proprietà Name è Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Restituisce tutti gli oggetti il cui punto di riferimento si trova all'interno della Board Region la cui proprietà Name è Region1, oppure della Board Region la cui proprietà Name è Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Restituisce tutti gli oggetti except oggetti il cui punto di riferimento si trova all'interno della Board Region la cui proprietà Name è Region2.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa RegionName è obbligatorio.
InNamedPolygon
Riepilogo
Restituisce tutti gli oggetti primitivi che sono figli del riempimento poligonale specificato.
Sintassi
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutti i riempimenti poligonali esistenti, ordinati per nome.
Esempio di utilizzo
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Restituisce tutti gli oggetti primitivi che sono figli del riempimento poligonale la cui proprietà Name è Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Restituisce tutti gli oggetti except oggetti primitivi che sono figli del riempimento poligonale la cui proprietà Name è Power3V3.
Note
-
Il carattere di apice singolo (') all'inizio e alla fine della stringa
PolygonNameè obbligatorio. - Viene restituito anche l'oggetto padre del riempimento poligonale.
InNamedUnion
Riepilogo
Restituisce tutti gli oggetti (padre e figli) che fanno parte dell'unione specificata.
SintassiPCB in modalità Unions . Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le unioni esistenti, ordinate per nome.
Esempio di utilizzo
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Restituisce tutti gli oggetti (padre e figli) che fanno parte dell'unione il cui nome è Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Restituisce tutti gli oggetti except oggetti (padre e figli) che fanno parte dell'unione il cui nome è Unions 1.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa UnionName è obbligatorio.
InNet
Riepilogo
Restituisce tutti gli oggetti associati agli oggetti Net la cui proprietà Name soddisfa la Query.
Sintassi
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le net esistenti, ordinate per nome.
Esempio di utilizzo
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Restituisce tutti gli oggetti associati all'oggetto Net la cui proprietà Name è Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Restituisce tutti gli oggetti associati agli oggetti Net la cui proprietà Name è D0 oppure D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Restituisce tutti gli oggetti associati agli oggetti Net la cui proprietà Name inizia con V.
Note
-
Il carattere di apice singolo (') all'inizio e alla fine di ogni stringa
NetNameè obbligatorio. - Vengono restituiti anche gli oggetti Net padre.
InNetClass
Riepilogo
Restituisce tutte le net (e i relativi oggetti associati) che sono membri della Net Class specificata.
Sintassi
InNetClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le classi di net definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Restituisce tutte le net (e i relativi oggetti associati) che sono membri della Net Class Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Restituisce tutti gli oggetti except net (e i relativi oggetti associati) che sono membri della Net Class Address Bus Nets.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa ClassName è obbligatorio.
InPadClass
Riepilogo
Restituisce tutti gli oggetti pad che sono membri della Pad Class specificata.
Sintassi
InPadClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le classi di pad definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Restituisce tutti gli oggetti pad che sono membri della Pad Class Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Restituisce tutti gli oggetti except oggetti pad che sono membri della Pad Class Bottom Side Probe Pads.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa ClassName è obbligatorio.
InPolygonClass
Riepilogo
Restituisce tutti gli oggetti di riempimento poligonale che sono membri della Polygon Class specificata.
Sintassi
InPolygonClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le classi di poligoni definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Restituisce tutti gli oggetti di riempimento poligonale che sono membri della Polygon Class Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Restituisce tutti gli oggetti except oggetti di riempimento poligonale che sono membri della Polygon Class Custom Polys.
Nota
Il carattere di apice singolo (') all'inizio e alla fine della stringa ClassName è obbligatorio.
InRegion
Riepilogo
Restituisce tutti gli oggetti che si trovano all'interno dell'area specificata dalla Query.
Sintassi
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 specificano le coordinate nel file PCB (Library). I limiti sinistro e destro della regione sono specificati dai parametri X1 e X2, mentre i limiti inferiore e superiore della regione sono specificati dai parametri Y1 e Y2.
Tutte le coordinate fanno riferimento all'origine assoluta (e non all'origine utente o al punto di inserimento del componente) e, attualmente, utilizzano sempre unità in mil (1 mil = 0,001 pollici).
Esempio di utilizzo
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Restituisce gli oggetti che si trovano all'interno della regione rettangolare delimitata da X1 = 12700 e X2 = 13300, e da Y1 = 4700 e Y2 = 5000; tali coordinate fanno riferimento all'origine assoluta.
Note
- Non vengono restituiti gli oggetti componente padre, coordinata, quota e Net.
- Questa parola chiave è un alias della parola chiave InRegionAbsolute.
InRegionAbsolute
Riepilogo
Restituisce tutti gli oggetti che si trovano all'interno dell'area specificata dalla Query.
Sintassi
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 specificano le coordinate nel file PCB (Library). I limiti sinistro e destro della regione sono specificati dai parametri X1 e X2, mentre i limiti inferiore e superiore della regione sono specificati dai parametri Y1 e Y2.
Tutte le coordinate fanno riferimento all'origine assoluta (e non all'origine utente o al punto di inserimento del componente) e, attualmente, utilizzano sempre unità in mil (1 mil = 0,001 pollici).
Esempio di utilizzo
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Restituisce gli oggetti che si trovano all'interno della regione rettangolare delimitata da X1 = 12700 e X2 = 13300, e da Y1 = 4700 e Y2 = 5000; tali coordinate fanno riferimento all'origine assoluta.
Note
- Non vengono restituiti gli oggetti componente padre, coordinata, quota e Net.
- Questa parola chiave è un alias della parola chiave InRegion.
InRegionRelative
Riepilogo
Restituisce tutti gli oggetti che si trovano all'interno dell'area specificata dalla Query.
Sintassi
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 specificano le coordinate nel file PCB (Library). I limiti sinistro e destro della regione sono specificati dai parametri X1 e X2, mentre i limiti inferiore e superiore della regione sono specificati dai parametri Y1 e Y2.
Tutte le coordinate fanno riferimento all'origine utente (file PCB) o al punto di inserimento del componente (file PCB Library), anziché all'origine assoluta, e attualmente utilizzano sempre unità in mil. (1 mil = 0,001 pollici).
Esempio di utilizzo
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Restituisce gli oggetti che si trovano all'interno della regione rettangolare delimitata da X1 = -700 e X2 = 1300, e da Y1 = -400 e Y2 = 1600; tali coordinate fanno riferimento all'origine utente (o al punto di inserimento del componente).
Nota
Non vengono restituiti gli oggetti componente padre, coordinata, quota e Net.
InStructureClass
Riepilogo
Restituisce tutti gli oggetti padre e figlio delle Component Classes e delle Net Classes che sono membri della Structure Class specificata.
Sintassi
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le structure class definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Restituisce tutti gli oggetti padre e figlio delle Component Classes e delle Net Classes che sono membri della Structure Class Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Restituisce tutti gli oggetti padre e figlio delle Component Classes e delle Net Classes che sono membri della Structure Class Output channel oppure della Structure Class Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Restituisce tutti gli oggetti padre e figlio delle Classi di Componenti e delle Classi di Net che sono membri di qualsiasi Classe di Struttura la cui proprietà Name inizia con Input.
Nota
I caratteri di apice singolo (') all'inizio e alla fine di ogni stringa ClassName sono obbligatori.
InUnion
Riepilogo
Restituisce tutti gli oggetti (padre e figli) che fanno parte dell'unione specificata.
Sintassi
InUnion(Union : Number) : Boolean/Boolean_String
I numeri di unione vengono assegnati automaticamente. Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le unioni esistenti ordinate per numero.
Esempio di utilizzo
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Restituisce tutti gli oggetti (padre e figli) che fanno parte dell'unione il cui numero assegnato è 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Restituisce tutti gli oggetti except oggetti (padre e figli) che fanno parte dell'unione il cui numero assegnato è 4.
InxSignal
Riepilogo
Restituisce tutti gli oggetti associati allo xSignal specificato.
Sintassi
InxSignal(Name : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutti gli xSignal esistenti ordinati per nome.
Esempio di utilizzo
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Restituisce tutti gli oggetti associati allo xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Restituisce tutti gli oggetti except oggetti associati allo xSignal DRAM_A0_PP1.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa Name sono obbligatori.
InxSignalClass
Riepilogo
Restituisce tutti gli oggetti xSignal che sono membri della Classe xSignal specificata.
Sintassi
InxSignalClass(ClassName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le classi xSignal definite dall'utente esistenti, ordinate per nome.
Esempio di utilizzo
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Restituisce tutti gli oggetti xSignal che sono membri della Classe xSignal PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Restituisce tutti gli oggetti except oggetti xSignal che sono membri della Classe xSignal PCIE.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa ClassName sono obbligatori.
IsNamedPolygon
Riepilogo
Restituisce il riempimento poligonale specificato.
Sintassi
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutti i riempimenti poligonali esistenti ordinati per nome.
Esempio di utilizzo
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Restituisce l'oggetto riempimento poligonale la cui proprietà Name è Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Restituisce tutti gli oggetti except l'oggetto riempimento poligonale la cui proprietà Name è Power3V3.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine della stringa
PolygonNamesono obbligatori. -
Gli oggetti primitivi figli dell'oggetto riempimento poligonale restituito non vengono restituiti.
IsxSignal
Riepilogo
Restituisce l'oggetto xSignal con il nome specificato.
Sintassi
IsxSignal(Name : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutti gli xSignal esistenti ordinati per nome.
Esempio di utilizzo
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Restituisce lo xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Restituisce tutti gli oggetti except lo xSignal DRAM_A0_PP1.
Nota
I caratteri di apice singolo (') all'inizio e alla fine della stringa Name sono obbligatori.
OnGrid
Riepilogo
Restituisce tutti gli oggetti le cui proprietà X1 e Y1 soddisfano la Query.
Sintassi
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Ogni istanza di Distance_String è una stringa numerica che specifica una distanza nel file PCB (Library). Per essere restituita, la proprietà X1 di un oggetto deve essere un multiplo intero della prima distanza specificata e la sua proprietà Y1 deve essere un multiplo intero della seconda distanza specificata.
X1 e Y1 specificano coordinate nel file PCB (Library). Per essere restituito, la proprietà X1 di un oggetto deve essere un multiplo intero del primo valore specificato e la sua proprietà Y1 deve essere un multiplo intero del secondo valore specificato.
Tutte le coordinate fanno riferimento all'origine assoluta (e non all'origine utente o al punto di inserimento del componente) e, attualmente, utilizzano sempre unità in mil (1 mil = 0,001 pollici).
Esempio di utilizzo
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Restituisce tutti gli oggetti la cui proprietà X1 è un multiplo intero di 25mil e la cui proprietà Y1 è un multiplo intero di 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Restituisce tutti gli oggetti la cui proprietà X1 è un multiplo intero di 5mil e la cui proprietà Y1 è un multiplo intero di 100mil.
OnLayer
Riepilogo
Restituisce tutti gli oggetti la cui proprietà Layer soddisfa la Query.
Sintassi
OnLayer(Layer : String) : Boolean/Boolean_String
Layer è il nome del layer così come appare nella scheda Layers & Colors del pannello View Configuration panel.
Esempio di utilizzo
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Restituisce tutti gli oggetti la cui proprietà Layer è Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Restituisce tutti gli oggetti except oggetti la cui proprietà Layer è il layer Mechanical 3.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine di
Layersono obbligatori. -
Si noti che gli oggetti posizionati sul layer
Multi-Layerverranno restituiti dalla parola chiave di queryOnLayersolo quando si specifica questo particolare layer, cioè quando si usa la queryOnLayer('Multi-Layer'). Gli oggetti posizionati sul layerMulti-Layernon verranno restituiti dalla parola chiave di queryOnLayerquando si specifica un altro layer sul quale esistono le forme di questi oggetti. Usare la queryExistsOnLayer(Layer : String)per individuare gli oggetti (compresi gli oggetti sul layerMulti-Layer) che hanno forme sul layer specificato.
TouchesRoom
Riepilogo
Restituisce gli oggetti che risiedono totalmente o parzialmente all'interno della regione occupata da qualsiasi oggetto room (regola di vincolo di confinamento) la cui proprietà Name soddisfa la Query.
Sintassi
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le room esistenti ordinate per nome.
Esempio di utilizzo
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Restituisce gli oggetti che risiedono totalmente o parzialmente all'interno della regione occupata da qualsiasi Room la cui proprietà Name è Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Restituisce gli oggetti che risiedono totalmente o parzialmente all'interno delle regioni occupate da qualsiasi Room la cui proprietà Name è COUT1 oppure COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Restituisce gli oggetti che risiedono totalmente o parzialmente all'interno delle regioni occupate da qualsiasi Room la cui proprietà Name è Monitor, oppure Auxilary, oppure Effects.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine di ogni stringa
RoomNamesono obbligatori. -
Gli oggetti padre di coordinate, dimensioni e Net non vengono restituiti.
WithinRoom
Riepilogo
Restituisce gli oggetti che risiedono totalmente all'interno della regione occupata da qualsiasi oggetto room (regola di vincolo di confinamento) la cui proprietà Name soddisfa la Query.
Affinché pad e via vengano restituiti, i loro punti centrali devono trovarsi all'interno delle room specificate.
Sintassi
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Durante la definizione dell'espressione Query, viene visualizzato un elenco a comparsa di tutte le room esistenti ordinate per nome.
Esempio di utilizzo
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Restituisce gli oggetti che risiedono totalmente all'interno della regione occupata da qualsiasi room la cui proprietà Name è Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Restituisce gli oggetti che risiedono totalmente all'interno delle regioni occupate da qualsiasi room la cui proprietà Name è COUT1 oppure COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Restituisce gli oggetti che risiedono totalmente all'interno delle regioni occupate da qualsiasi room la cui proprietà Name è Monitor, oppure Auxilary, oppure Effects.
Note
-
I caratteri di apice singolo (') all'inizio e alla fine di ogni stringa
RoomNamesono obbligatori. - Gli oggetti padre di coordinate, dimensioni e Net non vengono restituiti.