This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Color Data Type


Any one of the following:

If no default value is specified, a Color type defaults to an empty string (which is treated by Tinderbox as the value 'normal'); in key attribute displays a white colour chip is displayed. In some cases, Tinderbox will show a dark red colour as a 'not initialised' colour value; it is hex colour code #6f0000, though its derivation as a value is not clear.

Note that as 8-bit colour settings are translated within the app into 16-bit colours, rounding errors can occur. So, in some cases - most likely using HSV and HSV based transforms - the values used might not correspond precisely to those set by the user.

When accessed via ^value()^ export code, it will return either a hex colour value or a named Tinderbox colour, depending on what is set for the target attribute. By comparison, using the deprecated ^get()^ or ^getFor()^ export codes, the colour is always returned as a hex figure including a # prefix, e.g. "#FF9900".

Similarly, using format() with a colour attribute will always result in a hexadecimal value string regardless of the stored value. Thus it makes sense to export colour attributes as ^value(format($ColorAttr))^ or ^value($ColorAttr.format())^. However, note that coercing a default (blank) colour to a string value using format() or .format() will result in the colour value "#ffffff", which is not strictly the blank value. So, be wary of using that formatting as a means to check for a blank colour value; better is to use a short form Boolean test.

Listing of Color-type system attributes.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Objects & Concepts : Attributes: Data Types : Color Data Type