Object_Color

Now reading version 16.1. For the latest, read: Object_Color for version 21

Parent page: Schematic Query Functions - Membership Checks

Summary

Returns all child objects of each harness connector, parameter set, pin, port, and sheet symbol object whose Color property complies with the Query.

Syntax

Object_Color(Parent) : Numeric_String
Object_Color(Parent) : Number

The Object_Color 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 parent objects (which do not have a Color property) have been totally excluded by one or more preceding entries within the Query expression. Either use entries in the expression such as Object_Color(Parent) <> '', Object_Color(Parent) > '', or Object_ObjectKind(Parent) <> 'Part'. Alternatively, use entries specifically targeting parent objects that do have the Color property, such as Object_ObjectKind(Parent) = 'Parameter Set', Object_ObjectKind(Parent) = 'Port', etc.

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 Object_Color keyword can be used in conjunction with a Number, it is possible to individually evaluate the values of each of the Color property's Blue, Green, and Red components, by using the following constructs:

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

Example Usage

Object_Color(Parent) = '0'
Object_Color(Parent) <> '' && Object_Color(Parent) = 0

Returns all child objects of each parent object whose Color property is 0 (which corresponds to values of Blue = 0, Green = 0, and Red = 0).

Object_Color(Parent) = '16711680'
Object_Color(Parent) > '' && Object_Color(Parent) = 16711680

Returns all child objects of each parent object whose Color property is 16711680 (which corresponds to values of Blue = 255, Green = 0, and Red = 0).

Object_Color(Parent) <> '16777215'
Returns all objects except child objects of each parent object whose Color property is 16777215 (which corresponds to values of Blue = 255, Green = 255, and Red = 255).

Object_ObjectKind(Parent) <> 'Part' && Object_Color(Parent) <> 16777215
Returns all child objects of each parent object – except parts – whose Color property is 16777215.

Object_Color(Parent) > '' && Object_Color(Parent) Div 65536 >= 96 && Object_Color(Parent) Div 256 Mod 256 Between 64 And 192 && Object_Color(Parent) Mod 256 <= 128
Returns all child objects of each parent object – except parts – whose Color property is such that the Blue component has a value which is greater than or equal to 96, the Green component has a value which is greater than or equal to 64 and less than or equal to 192, and the Red component has a value which is less than or equal to 128.

Object_ObjectKind(Parent) = 'Parameter Set' && Object_Color(Parent) Div 65536 <= 192
Returns all child objects of parameter set objects whose Color property's Blue component has a value which is less than or equal to 192.

Object_ObjectKind(Parent) = 'Port' && Object_Color(Parent) Mod 256 Between 64 And 192
Returns all child objects of port objects whose Color property's Red component has a value which is greater than or equal to 64 and less than or equal to 192.

 

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

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.