Altium NEXUS Documentation

Query_Lang-SCHFunctions_Fields_FillColorFillColor_AD

Created: November 2, 2018 | Updated: November 2, 2018

Parent page: Schematic Query Functions - Fields

Summary

Returns all blanket, compile mask, ellipse, harness connector, note, polygon, port, rectangle, round rectangle, sheet entry, sheet symbol, and text frame objects whose Fill Color property complies with the Query.

Syntax

FillColor : Numeric_String
FillColor : Number

The FillColor 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 (that do not have a Fill Color property) have been totally excluded by one or more preceding entries within the Query expression. Either use entries in the expression, such as FillColor <> '', FillColor > '', or use entries specifically targeting objects, such as IsRectangle, 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 FillColor keyword can be used in conjunction with a Number, it is possible to individually evaluate the values of each of the Fill Color property's Blue, Green, and Red components by using the following constructs:

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

Example Usage

FillColor = '0'
FillColor <> '' && FillColor = 0

Returns all blanket, compile mask, ellipse, harness connector, note, polygon, port, rectangle, round rectangle, sheet entry, sheet symbol, and text frame objects whose Fill Color property is 0 (which corresponds to values of Blue = 0, Green = 0, and Red = 0).

FillColor = '16711680'
FillColor > '' && FillColor = 16711680

Returns all blanket, compile mask, ellipse, harness connector, note, polygon, port, rectangle, round rectangle, sheet entry, sheet symbol, and text frame objects whose Fill Color property is 16711680 (which corresponds to values of Blue = 255, Green = 0, and Red = 0).

FillColor <> '16777215'
Returns all blanket, compile mask, ellipse, harness connector, note, polygon, port, rectangle, round rectangle, sheet entry, sheet symbol, and text frame objects except those whose Fill Color property is 16777215 (which corresponds to values of Blue = 255, Green = 255, and Red = 255).

IsBlanket Or IsCompileMask && FillColor Mod 256 Between 64 And 192
Returns all blanket and compile mask objects whose Fill 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 Fill Color property is only defined for blanket, compile mask, ellipse, harness connector, note, polygon, port, rectangle, round rectangle, sheet entry, sheet symbol, and text frame objects.

 

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: