NAME
libcucul attribute conversions -
Functions
unsigned char cucul_attr_to_ansi (unsigned long int)
Get DOS ANSI information from attribute. unsigned char cucul_attr_to_ansi_fg (unsigned long int)
Get ANSI foreground information from attribute. unsigned char cucul_attr_to_ansi_bg (unsigned long int)
Get ANSI background information from attribute.
Detailed Description
These functions perform conversions between attribute values.
Function Documentation
unsigned char cucul_attr_to_ansi (unsigned long int attr)
Get the ANSI colour pair for a given attribute. The returned value is an 8-bit value whose higher 4 bits are the background colour and lower 4 bits are the foreground colour.
If the attribute has ARGB colours, the nearest colour is used. Special attributes such as CUCUL_DEFAULT and CUCUL_TRANSPARENT are not handled and are both replaced with CUCUL_LIGHTGRAY for the foreground colour and CUCUL_BLACK for the background colour.
This function never fails. If the attribute value is outside the expected 32-bit range, higher order bits are simply ignored.
Parameters:
attr The requested attribute value.
Returns:
The corresponding DOS ANSI value.
unsigned char cucul_attr_to_ansi_fg (unsigned long int attr)
Get the ANSI foreground colour value for a given attribute. The returned value is either one of the CUCUL_RED, CUCUL_BLACK etc. predefined colours, or the special value CUCUL_DEFAULT meaning the media's default foreground value, or the special value CUCUL_TRANSPARENT.
If the attribute has ARGB colours, the nearest colour is returned.
This function never fails. If the attribute value is outside the expected 32-bit range, higher order bits are simply ignored.
Parameters:
attr The requested attribute value.
Returns:
The corresponding ANSI foreground value.
unsigned char cucul_attr_to_ansi_bg (unsigned long int attr)
Get the ANSI background colour value for a given attribute. The returned value is either one of the CUCUL_RED, CUCUL_BLACK etc. predefined colours, or the special value CUCUL_DEFAULT meaning the media's default background value, or the special value CUCUL_TRANSPARENT.
If the attribute has ARGB colours, the nearest colour is returned.
This function never fails. If the attribute value is outside the expected 32-bit range, higher order bits are simply ignored.
Parameters:
attr The requested attribute value.
Returns:
The corresponding ANSI background value.