Query_Lang-SCHFunctions_Fields_PinDesignator_CustomColorPinDesignator_CustomColor_AD

您正在阅读的是 20.1. 版本。关于最新版本,请前往 Query_Lang-SCHFunctions_Fields_PinDesignator_CustomColor((PinDesignator_CustomColor))_AD 阅读 21 版本

Parent page: Schematic Query Functions - Fields

Summary

Returns all pin objects whose Pin Designator Color property complies with the Query.

Syntax

PinDesignator_CustomColor : Numeric_String
PinDesignator_CustomColor : Number

The PinDesignator_CustomColor keyword can always be used in conjunction with a Numeric_String. It can alternatively be used in conjunction with a Number, but only when all objects (which do not have a Pin Designator Color property) have been totally excluded by one or more preceding entries within the Query expression. Either use entries in the expression such as PinDesignator_CustomColor <> '', PinDesignator_CustomColor > '', or use entries specifically targeting pin objects, i.e. IsPin.

The color corresponding to a particular number can be deduced from the following relationship:

65536 * Blue + 256 * Green + Red

where the Blue, Green, and Red components each have a value between 0 and 255 (inclusive).

When the PinDesignator_CustomColor keyword can be used in conjunction with a Number, it is possible to individually evaluate the values of each of the Pin Designator Color property's Blue, Green, and Red components, by using the following constructs:

  • Blue = Pin Designator Color Div 65536
  • Green = Pin Designator Color Div 256 Mod 256
  • Red = Pin Designator Color Mod 256

Example Usage

PinDesignator_CustomColor = '0'
PinDesignator_CustomColor <> '' && PinDesignator_CustomColor = 0

Returns all pin objects whose Pin Designator Color property is 0 (which corresponds to values of Blue = 0, Green = 0, and Red = 0).

PinDesignator_CustomColor = '16711680'
PinDesignator_CustomColor > '' && PinDesignator_CustomColor = 16711680

Returns all pin objects whose Pin Designator Color property is 16711680 (which corresponds to values of Blue = 255, Green = 0, and Red = 0).

PinDesignator_CustomColor <> '16777215'
Returns all pin objects except those whose Pin Designator Color property is 16777215 (which corresponds to values of Blue = 255, Green = 255, and Red = 255).

IsPin && PinDesignator_CustomColor Div 65536 <= 192
Returns all pin objects whose Pin Designator Color property's Blue component has a value which is less than or equal to 192.

IsPin && PinDesignator_CustomColor Mod 256 Between 64 And 192
Returns all pin objects whose Pin Designator Color property's Red component has a value which is greater than or equal to 64 and less than or equal to 192.

Tips

  1. The Pin Designator Color property is only defined for pin objects.

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

软件的功能取决于您购买的Altium产品级别。您可以比较Altium Designer软件订阅的各个级别中包含的功能,以及通过Altium 365平台提供的应用程序所能实现的功能。

如果您在软件中找不到某个讨论过的功能,请联系Altium销售团队以获取更多信息。