PGetColorInfo

Gets the color information for the specified color, using the designated color model and library.

Query constructor

PGetColorInfo(short cModel, const char * sColorName);

short cModel;
kColorRGB for RGB color model, expressed in percentages
kColorCYMK for process color (CMYK) model
kColorHLS for HLS color model
kColorMultiInk for multi-ink model
kColorRGB255 for RGB color model, expressed in units from 0 to 255
const char * sColorName;
Name of the color exactly as it appears on the Colors palette

Query results

PGetColorInfo is a subclass of PListQuery. This query returns a large amount of color information from PageMaker.

short nPercent1;

cModel Meaning

kColorRGB Percentage of red, in tenths of a percent (100.0% = 1000)

kColorRGB255 Units of red from 0 to 255

kColorCMYK
kColorMultiInk Percentage of cyan, in tenths of a percent (100.0% = 1000)

kColorHLS Degrees of hue in tenths of a degree

cModel	Meaning
kColorRGB	Percentage of red, in tenths of a percent (100.0% = 1000)
kColorRGB255	Units of red from 0 to 255
kColorCMYK kColorMultiInk	Percentage of cyan, in tenths of a percent (100.0% = 1000)
kColorHLS	Degrees of hue in tenths of a degree

short nPercent2;

cModel Meaning

kColorRGB Percentage of green, in tenths of a percent (100.0% = 1000)

kColorRGB255 Units of green from 0 to 255

kColorCMYK
kColorMultiInk Percentage of magenta, in tenths of a percent (100.0% = 1000)

kColorHLS Percentage of lightness in tenths of a percent (100.0% = 1000). 0 for a tint.

cModel	Meaning
kColorRGB	Percentage of green, in tenths of a percent (100.0% = 1000)
kColorRGB255	Units of green from 0 to 255
kColorCMYK kColorMultiInk	Percentage of magenta, in tenths of a percent (100.0% = 1000)
kColorHLS	Percentage of lightness in tenths of a percent (100.0% = 1000). 0 for a tint.

short nPercent3;

cModel Meaning

kColorRGB Percentage of blue, in tenths of a percent (100.0% = 1000)

kColorRGB255 Units of blue from 0 to 255

kColorCMYK
kColorMultiInk Percentage of yellow, in tenths of a percent (100.0% = 1000)

kColorHLS Percentage of saturation in tenths of a percent (100.0% = 1000).
0 for a tint.

cModel	Meaning
kColorRGB	Percentage of blue, in tenths of a percent (100.0% = 1000)
kColorRGB255	Units of blue from 0 to 255
kColorCMYK kColorMultiInk	Percentage of yellow, in tenths of a percent (100.0% = 1000)
kColorHLS	Percentage of saturation in tenths of a percent (100.0% = 1000). 0 for a tint.

short nPercent4;

cModel Meaning

kColorCMYK
kColorMultiInk Percentage of black, in tenths of a percent (100.0% = 1000)

kColorRGB
kColorRGB255
kColorHLS
0 (Unused)

cModel	Meaning
kColorCMYK kColorMultiInk	Percentage of black, in tenths of a percent (100.0% = 1000)
kColorRGB kColorRGB255 kColorHLS	0 (Unused)

short cType;

kColorTypeSpot for spot
kColorTypeProcess for process
kColorTypeTint for tint
kColorTypeHifi for HiFi color

short nEPS;

Number of imported EPS files assigned that color

short bOverprint;

0 for knockout
1 for overprint

const char * sBaseColor;

Name of base color used for tint; null if not a tint

short cDefinedModel;

Model used in internal definition of color:
0 (zero)for RGB color model expressed in units from 0 to 255
1 for process color (CMYK) model
2 for HLS color model
3 for L*a*b color model
4 for multi-ink model

For each ink in the returned list (make sure PListQuery::Count() > 0 before referencing any of these):

const char * sInkName;

Name of ink.

short dInkLevel;

Percentage of specified ink-coverage value, be tween 0 and 100 in tenths of a percent (100.0 = 1000)

Reference to color library is lost for color-picker defined colors. No association with the original color library is maintained if the color was originally defined with a color picker. Only the CMYK values remain.

cModel ignored for tints. PageMaker ignores the cModel parameter if sColorName is a tint.

Example. This examples defines a CYMK color "Peach" using the PDefineColor command. It then requests the definition of Peach using the RGB model. Notice that while a color can be defined using one model, you can request the color definition using a different model.

PDefineColor("Peach", process, kColorCMYK, 0, 15, 30, 10, 0); PGetColorInfo info(kColorRGB, "Peach"); info.nPercent1; // 850 (R) info.nPercent2; // 700 (G) info.nPercent3; // 900 (B) info.nPercent4; // 0 (-) info.cType; // 1 (kColorTypeSpot) info.nEPS; // 0 info.bOverprint; // false info.sBaseColor; // "" info.cDefinedModel; // 4 (multi-ink) info.Count(); // 0 (no inks)

PGetColorInfo

Query constructor

Query results

See also