KiCad PCB EDA Suite
Loading...
Searching...
No Matches
panel_setup_rules_help_8expression_functions.h File Reference

Go to the source code of this file.

Functions

 _HKI ("### Expression functions\n" "\n" "All function parameters support simple wildcards (`*` and `?`).\n" "<br><br>\n" "\n" " A.enclosedByArea('<zone_name>')\n" "True if all of `A` lies within the given zone's outline.\n" "\n" "NB: this is potentially a more expensive call than `intersectsArea()`. Use `intersectsArea()`\n" "where possible.\n" "<br><br>\n" "\n" " A.existsOnLayer('<layer_name>')\n" "True if `A` exists on the given layer. The layer name can be\n" "either the name assigned in Board Setup > Board Editor Layers or\n" "the canonical name (ie: `F.Cu`).\n" "\n" "NB: this returns true if `A` is on the given layer, independently\n" "of whether or not the rule is being evaluated for that layer.\n" "For the latter use a `(layer \"layer_name\")` clause in the rule.\n" "<br><br>\n" "\n" " A.fromTo('x', 'y')\n" "True if the object exists on the copper path between the given \n" "pads. `x` and `y` are the full names of pads in the design, such as \n" "`R1-Pad1`.\n" "<br><br>\n" "\n" " A.getField('<field_name>')\n" "The value of the given field. Only footprints have fields, so a field is only returned if\n" "`A` is a footprint.\n" "<br><br>\n" "\n" " A.hasComponentClass('<component_class_name>')\n" "True if the set of component classes assigned to `A` contains the named \n" "component class.\n" "<br><br>\n" "\n" " A.hasNetclass('<netclass_name>')\n" "True if `A` has had the given netclass assigned to it, either by an explicit netclass label\n" "or through a pattern match assignment.\n" "<br><br>\n" "\n" " A.inDiffPair('<net_name>')\n" "True if `A` has a net that is part of the specified differential pair.\n" "`<net_name>` is the base name of the differential pair. For example, `inDiffPair('/CLK')`\n" "matches items in the `/CLK_P` and `/CLK_N` nets.\n" "<br><br>\n" "\n" " A.intersectsArea('<zone_name>')\n" "True if any part of `A` lies within the given zone's outline.\n" "<br><br>\n" "\n" " A.intersectsCourtyard('<footprint_identifier>')\n" "True if any part of `A` lies within the given footprint's principal courtyard.\n" "<br><br>\n" "\n" " A.intersectsFrontCourtyard('<footprint_identifier>')\n" "True if any part of `A` lies within the given footprint's front courtyard.\n" "<br><br>\n" "\n" " A.intersectsBackCourtyard('<footprint_identifier>')\n" "True if any part of `A` lies within the given footprint's back courtyard.\n" "<br><br>\n" "\n" "The `footprint_identifier` listed above can be one of the following:\n" "\n" "1. A reference designator, possibly containing wildcards `*` and `?`\n" "2. A footprint library identifier such as `LibName:FootprintName`. In this case,\n" " the library identifier must contain the `:` character to separate the library\n" " name from the footprint name, and either name may contain wildcards.\n" "3. A component class, in the form `${Class:ClassName}`. The keyword `Class` is not\n" " case-sensitive, but component class names are case-sensitive.\n" "\n" "<br>\n" "\n" " A.isBlindBuriedVia()\n" "True if `A` is a blind/buried via.\n" "<br><br>\n" "\n" " AB.isCoupledDiffPair()\n" "True if `A` and `B` are members of the same diff pair.\n" "<br><br>\n" "\n" " A.isMicroVia()\n" "True if `A` is a microvia.\n" "<br><br>\n" "\n" " A.isPlated()\n" "True if `A` has a hole which is plated.\n" "<br><br>\n" "\n" " A.memberOfGroup('<group_name>')\n" "True if `A` is a member of the given group. The name can contain wildcards.\n" "Includes nested membership.\n" "<br><br>\n" "\n" " A.memberOfFootprint('<footprint_identifier>')\n" "True if `A` is a member of a given footprint (for example, a pad or graphic shape defined\n" "inside that footprint). The various ways of specifying `footprint_identifier` are described above.\n" "<br><br>\n" "\n" " A.memberOfSheet('<sheet_path>')\n" "True if `A` is a member of the given schematic sheet. The sheet path can contain wildcards.\n" "<br><br>\n" "\n" "")
 

Function Documentation

◆ _HKI()

_HKI ( "### Expression functions\n" "\n" "All function parameters support simple wildcards (`*` and `?`).\n" "<br><br>\n" "\n" " A.enclosedByArea('<zone_name>')\n" "True if all of `A` lies within the given zone's outline.\n" "\n" "NB: this is potentially a more expensive call than `intersectsArea()`. Use `intersectsArea()`\n" "where possible.\n" "<br><br>\n" "\n" " A.existsOnLayer('<layer_name>')\n" "True if `A` exists on the given layer. The layer name can be\n" "either the name assigned in Board  Setup,
Board Editor Layers or\n" "the canonical name(ie:`F.Cu`).\n" "\n" "NB:this returns true if `A` is on the given  layer,
independently\n" "of whether or not the rule is being evaluated for that layer.\n" "For the latter use a `(layer \"layer_name\")` clause in the rule.\n" "<br><br>\n" "\n" " A.fromTo('x', 'y')\n" "True if the object exists on the copper path between the given \n" "pads. `x` and `y` are the full names of pads in the  design,
such as \n" "`R1-Pad1`.\n" "< br >< br >\n" "\n" " A.getField('< field_name >')\n" "The value of the given field. Only footprints have  fields,
so a field is only returned if\n" "`A` is a footprint.\n" "< br >< br >\n" "\n" " A.hasComponentClass('< component_class_name >')\n" "True if the set of component classes assigned to `A` contains the named \n" "component class.\n" "< br >< br >\n" "\n" " A.hasNetclass('< netclass_name >')\n" "True if `A` has had the given netclass assigned to  it,
either by an explicit netclass label\n" "or through a pattern match assignment.\n" "< br >< br >\n" "\n" " A.inDiffPair('< net_name >')\n" "True if `A` has a net that is part of the specified differential pair.\n" "`< net_name >` is the base name of the differential pair. For  example,
`inDiffPair('/CLK')`\n" "matches items in the `/CLK_P` and `/CLK_N` nets.\n" "< br >< br >\n" "\n" " A.intersectsArea('< zone_name >')\n" "True if any part of `A` lies within the given zone 's outline.\n" "< br >< br >\n" "\n" " A.intersectsCourtyard('< footprint_identifier >')\n" "True if any part of `A` lies within the given footprint 's principal courtyard.\n" "< br >< br >\n" "\n" " A.intersectsFrontCourtyard('< footprint_identifier >')\n" "True if any part of `A` lies within the given footprint 's front courtyard.\n" "< br >< br >\n" "\n" " A.intersectsBackCourtyard('< footprint_identifier >')\n" "True if any part of `A` lies within the given footprint 's back courtyard.\n" "< br >< br >\n" "\n" "The `footprint_identifier` listed above can be one of the following:\n" "\n" "1. A reference  designator,
possibly containing wildcards ` *` and `?`\n" "2. A footprint library identifier such as `LibName:FootprintName`. In this  case,
\n" " the library identifier must contain the `:` character to separate the library\n" " name from the footprint  name,
and either name may contain wildcards.\n" "3. A component  class,
in the form `${Class:ClassName}`. The keyword `Class` is not\n" " case-  sensitive,
but component class names are case-sensitive.\n" "\n" "< br >\n" "\n" " A.isBlindBuriedVia()\n" "True if `A` is a blind/buried via.\n" "< br >< br >\n" "\n" " AB.isCoupledDiffPair()\n" "True if `A` and `B` are members of the same diff pair.\n" "< br >< br >\n" "\n" " A.isMicroVia()\n" "True if `A` is a microvia.\n" "< br >< br >\n" "\n" " A.isPlated()\n" "True if `A` has a hole which is plated.\n" "< br >< br >\n" "\n" " A.memberOfGroup('< group_name >')\n" "True if `A` is a member of the given group. The name can contain wildcards.\n" "Includes nested membership.\n" "< br >< br >\n" "\n" " A.memberOfFootprint('< footprint_identifier >')\n" "True if `A` is a member of a given footprint(for example, a pad or graphic shape defined\n" "inside that footprint). The various ways of specifying `footprint_identifier` are described above.\n" "< br >< br >\n" "\n" " A.memberOfSheet('< sheet_path >')\n" "True if `A` is a member of the given schematic sheet. The sheet path can contain wildcards.\n" "< br >< br >\n" "\n" ""   
)