Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

XcmsColorSpace − Xcms color space structure. 

Availability

Release 5 and later. 

Description

The XcmsColorSpace structure contain the information necessary to convert the encoding of color specifications to other color spaces, and to parse a color string encoded specifically for this color space.  The prefix member points to a string that identifies that a color strings encoding is for this particular color space. 

<color_space>:<color_space_specific_encoding> For example, the prefix "cieuvy:" for the color string "CIEuvY:0.119/0.545/0.254".  Although the prefix in the color string may be entered in upper or lower case, all characters of the prefix specified in the WXcmsColorSpace must be in lower case.  The id member is predefined if the color space is registered with the X Consortium; otherwise assigned at run-time (see XcmsAddColorSpace()).  The parseString member points to the color space specific string parsing function.  The to_CIEXYZ member is pointer to an array of functions that, when executed in sequence, will convert a WXcmsColor structure encoded for this color space to the CIEXYZ encoding.  The from_CIEXYZ member is pointer to an array of functions that, when executed in sequence, will convert a WXcmsColor structure encoded for CIEXYZ to this color space’s encoding.  The inverse_flag member if set (i.e. 1) indicates that for each function in the to_CIEXYZ list, there is an inverse function in the  from_CIEXYZ list.  Note however that the corresponding order is reversed - the inverse of the first function in to_CIEXYZ will be the last function in  from_CIEXYZ. 

Structures

The XcmsColorSpace structure contains: typedef XcmsConversionProc *XcmsFuncListPtr;
 
typedef struct _XcmsColorSpace {
    char *prefix;
    XcmsColorFormat id;
    XcmsParseStringProc parseString;
    XcmsFuncListPtr to_CIEXYZ;
    XcmsFuncListPtr from_CIEXYZ;
    int inverse_flag; } XcmsColorSpace;

See Also

XcmsAddColorSpace(), XcmsAddFunctionSet(), XcmsFunctionSet, XcmsConversionProc, XcmsParseStringProc. 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026