color
ARES System Manual: id Utility
(input)
(input)
(input)
(input)
Where:
- <slot> is one of a, b, c, d, or all
- <spec> is a six-digit hexadecimal code prefixed with # (e.g. #ff00ff for magenta), or an <r g b> triple in eight-bit (0-255) or fractional (0.0-1.0) format, or <swatch>
- <scheme> is a short name identifying the color preset for user convenience (e.g. 'pastel' or 'sad')
- <swatch> is a short name identifying an individual predefined color for user convenience (e.g. 'cherry' or 'company')
This is a default shell alias (see alias) that resolves to
If the
Color Slots
ARES units have four color options that can be managed independently, referred to as 'slots', and identified with the letters 'a' through 'd'. These slots have no intrinsic meaning, but instead are used by attachments for various purposes.
For example, the NS Tetrad Collar uses all four lighting colors simultaneously to indicate different parts of its hardware. Conversely, most controllers will display certain slots depending on circumstance.
The conventional assignment between color slots and function is:
Slot a: primary color; displayed in the absence of special circumstances
Slot b: positive color; indicates charging, repairing, gratification, etc.
Slot c: negative color; indicates damage, low battery, overheating, etc.
Slot d: main HUD color and alert color; used on attachments to indicate a situation that requires attentiveness but is not problematic
A color scheme consists of its name, and assignments for each of the 4 slots.
Color Specifications
ARES accepts the same color formats as Companion (hex, byte, or fraction) and most of the same color names.
Hex colors must be six digits in length, and are identified by a preceding hash ('#') character. Shorter codes (e.g. #f70 for orange) will be padded with zeros (becoming #000f70, a dark blue).
RGB triples consist of three decimal values separated by spaces. If any of the values are greater than 1, the whole number will be interpreted as being in base 255. Otherwise the code will be parsed as fractional (in the range 0.0-1.0).
For example, the RGB triple 1 0 0 is interpreted as bright red, but 1.1 0 0 is interpreted as nearly black. This processing is only done during input; all colors are stored in the native format (fractions).
The list of available color name presets varies from version to version. This version includes:
acid, amber, arctic, beige, blackberry, blue, business, cherry, clay, company, crimson, cyan, daffodil, forest, goldenrod, gray, green, ice, indigo, magenta, mint, ocean, orange, primrose, red, rosy, silver, violet, white, yellow, zooties.
(input)
@color <slot> <spec>
(input)
@color load|save|delete <scheme>
(input)
@color swatch <swatch> <spec>
(input)
@color swatch delete <swatch>
Where:
- <slot> is one of a, b, c, d, or all
- <spec> is a six-digit hexadecimal code prefixed with # (e.g. #ff00ff for magenta), or an <r g b> triple in eight-bit (0-255) or fractional (0.0-1.0) format, or <swatch>
- <scheme> is a short name identifying the color preset for user convenience (e.g. 'pastel' or 'sad')
- <swatch> is a short name identifying an individual predefined color for user convenience (e.g. 'cherry' or 'company')
This is a default shell alias (see alias) that resolves to
id color. It is used to control the unit's lighting color and to manage presets.
If the
color alias has been removed, or if the command must be invoked from outside of a shell context, refer to it as id color instead of color.
Color Slots
ARES units have four color options that can be managed independently, referred to as 'slots', and identified with the letters 'a' through 'd'. These slots have no intrinsic meaning, but instead are used by attachments for various purposes.
For example, the NS Tetrad Collar uses all four lighting colors simultaneously to indicate different parts of its hardware. Conversely, most controllers will display certain slots depending on circumstance.
The conventional assignment between color slots and function is:
Slot a: primary color; displayed in the absence of special circumstances
Slot b: positive color; indicates charging, repairing, gratification, etc.
Slot c: negative color; indicates damage, low battery, overheating, etc.
Slot d: main HUD color and alert color; used on attachments to indicate a situation that requires attentiveness but is not problematic
A color scheme consists of its name, and assignments for each of the 4 slots.
Color Specifications
ARES accepts the same color formats as Companion (hex, byte, or fraction) and most of the same color names.
Hex colors must be six digits in length, and are identified by a preceding hash ('#') character. Shorter codes (e.g. #f70 for orange) will be padded with zeros (becoming #000f70, a dark blue).
RGB triples consist of three decimal values separated by spaces. If any of the values are greater than 1, the whole number will be interpreted as being in base 255. Otherwise the code will be parsed as fractional (in the range 0.0-1.0).
For example, the RGB triple 1 0 0 is interpreted as bright red, but 1.1 0 0 is interpreted as nearly black. This processing is only done during input; all colors are stored in the native format (fractions).
The list of available color name presets varies from version to version. This version includes:
acid, amber, arctic, beige, blackberry, blue, business, cherry, clay, company, crimson, cyan, daffodil, forest, goldenrod, gray, green, ice, indigo, magenta, mint, ocean, orange, primrose, red, rosy, silver, violet, white, yellow, zooties.