You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

118 lines
4.8 KiB

  1. // Do not edit this file, it is autogenerated by CMake from the .md file
  2. _HKI( "### Expression functions\n"
  3. "\n"
  4. "All function parameters support simple wildcards (`*` and `?`).\n"
  5. "<br><br>\n"
  6. "\n"
  7. " A.enclosedByArea('<zone_name>')\n"
  8. "True if all of `A` lies within the given zone's outline.\n"
  9. "\n"
  10. "NB: this is potentially a more expensive call than `intersectsArea()`. Use "
  11. "`intersectsArea()`\n"
  12. "where possible.\n"
  13. "<br><br>\n"
  14. "\n"
  15. " A.existsOnLayer('<layer_name>')\n"
  16. "True if `A` exists on the given layer. The layer name can be\n"
  17. "either the name assigned in Board Setup > Board Editor Layers or\n"
  18. "the canonical name (ie: `F.Cu`).\n"
  19. "\n"
  20. "NB: this returns true if `A` is on the given layer, independently\n"
  21. "of whether or not the rule is being evaluated for that layer.\n"
  22. "For the latter use a `(layer \"layer_name\")` clause in the rule.\n"
  23. "<br><br>\n"
  24. "\n"
  25. " A.fromTo('x', 'y')\n"
  26. "True if the object exists on the copper path between the given \n"
  27. "pads. `x` and `y` are the full names of pads in the design, such as \n"
  28. "`R1-Pad1`.\n"
  29. "<br><br>\n"
  30. "\n"
  31. " A.getField('<field_name>')\n"
  32. "The value of the given field. Only footprints have fields, so a field is only returned if\n"
  33. "`A` is a footprint.\n"
  34. "<br><br>\n"
  35. "\n"
  36. " A.hasComponentClass('<component_class_name>')\n"
  37. "True if the set of component classes assigned to `A` contains the named \n"
  38. "component class.\n"
  39. "<br><br>\n"
  40. "\n"
  41. " A.hasNetclass('<netclass_name>')\n"
  42. "True if `A` has had the given netclass assigned to it, either by an explicit netclass "
  43. "label\n"
  44. "or through a pattern match assignment.\n"
  45. "<br><br>\n"
  46. "\n"
  47. " A.inDiffPair('<net_name>')\n"
  48. "True if `A` has a net that is part of the specified differential pair.\n"
  49. "`<net_name>` is the base name of the differential pair. For example, `inDiffPair('/CLK')`\n"
  50. "matches items in the `/CLK_P` and `/CLK_N` nets.\n"
  51. "<br><br>\n"
  52. "\n"
  53. " A.intersectsArea('<zone_name>')\n"
  54. "True if any part of `A` lies within the given zone's outline.\n"
  55. "<br><br>\n"
  56. "\n"
  57. " A.intersectsCourtyard('<footprint_identifier>')\n"
  58. "True if any part of `A` lies within the given footprint's principal courtyard.\n"
  59. "<br><br>\n"
  60. "\n"
  61. " A.intersectsFrontCourtyard('<footprint_identifier>')\n"
  62. "True if any part of `A` lies within the given footprint's front courtyard.\n"
  63. "<br><br>\n"
  64. "\n"
  65. " A.intersectsBackCourtyard('<footprint_identifier>')\n"
  66. "True if any part of `A` lies within the given footprint's back courtyard.\n"
  67. "<br><br>\n"
  68. "\n"
  69. "The `footprint_identifier` listed above can be one of the following:\n"
  70. "\n"
  71. "1. A reference designator, possibly containing wildcards `*` and `?`\n"
  72. "2. A footprint library identifier such as `LibName:FootprintName`. In this case,\n"
  73. " the library identifier must contain the `:` character to separate the library\n"
  74. " name from the footprint name, and either name may contain wildcards.\n"
  75. "3. A component class, in the form `${Class:ClassName}`. The keyword `Class` is not\n"
  76. " case-sensitive, but component class names are case-sensitive.\n"
  77. "\n"
  78. "<br>\n"
  79. "\n"
  80. " A.isBlindBuriedVia()\n"
  81. "True if `A` is a blind/buried via.\n"
  82. "<br><br>\n"
  83. "\n"
  84. " AB.isCoupledDiffPair()\n"
  85. "True if `A` and `B` are members of the same diff pair.\n"
  86. "<br><br>\n"
  87. "\n"
  88. " A.isMicroVia()\n"
  89. "True if `A` is a microvia.\n"
  90. "<br><br>\n"
  91. "\n"
  92. " A.isPlated()\n"
  93. "True if `A` has a hole which is plated.\n"
  94. "<br><br>\n"
  95. "\n"
  96. " A.memberOfGroup('<group_name>')\n"
  97. "True if `A` is a member of the given group. The name can contain wildcards.\n"
  98. "Includes nested membership.\n"
  99. "<br><br>\n"
  100. "\n"
  101. " A.memberOfFootprint('<footprint_identifier>')\n"
  102. "True if `A` is a member of a given footprint (for example, a pad or graphic shape defined\n"
  103. "inside that footprint). The various ways of specifying `footprint_identifier` are "
  104. "described above.\n"
  105. "<br><br>\n"
  106. "\n"
  107. " A.memberOfSheet('<sheet_path>')\n"
  108. "True if `A` is a member of the given schematic sheet. The sheet path can contain "
  109. "wildcards.\n"
  110. "<br><br>\n"
  111. "\n"
  112. " A.memberOfSheetOrChildren('<sheet_path>')\n"
  113. "True if `A` is a member of the given schematic sheet, or any of its child hierarchical "
  114. "sheets. The sheet path can \n"
  115. "contain wildcards.\n"
  116. "<br><br>\n"
  117. "\n"
  118. "" );