49.3.1 Color Specifiers

Function: color-specifier-p object

This function returns non-nil if object is a color specifier.

Function: make-color-specifier spec-list

Return a new color specifier object with the given specification list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators. See Specifiers, for a detailed description of how specifiers work.

Valid instantiators for color specifiers are:

• A string naming a color (e.g. under X this might be "lightseagreen2" or "#F534B2").
• A color instance (use that instance directly if the device matches, or use the string that generated it).
• A vector of no elements (only on TTY’s; this means to set no color at all, thus using the "natural" color of the terminal’s text).
• A vector of one or two elements: a face to inherit from, and optionally a symbol naming which property of that face to inherit, either foreground or background (if omitted, defaults to the same property that this color specifier is used for; if this specifier is not part of a face, the instantiator would not be valid).

Function: make-face-boolean-specifier spec-list

Return a new face-boolean specifier object with the given spec list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators. See Specifiers, for a detailed description of how specifiers work.

Valid instantiators for face-boolean specifiers are

• t or nil.
• A vector of two or three elements: a face to inherit from, optionally a symbol naming the property of that face to inherit from (if omitted, defaults to the same property that this face-boolean specifier is used for; if this specifier is not part of a face, the instantiator would not be valid), and optionally a value which, if non-nil, means to invert the sense of the inherited property.