Functions
UInt32 *	mdlColor_matchLongColorMap (UInt32 pUserMap, byte pColorTable, int screen, bool exactColorsEnabled)
	Generate a color map in cmap. More...

int	mdlColor_getColorMap (UInt32 pColormap, int pNumMappings, int screen, int maxSize)
	Obtain an existing colormap for the master design file's colortable. More...

int	mdlColor_assignColorMap (int screen, UInt32 *pColorMap, DgnModelRefP modelRef)
	This function is no longer used. More...

Detailed Description

Function Documentation

int mdlColor_assignColorMap	(	int	screen,
		UInt32 *	pColorMap,
		DgnModelRefP	modelRef
	)

This function is no longer used.

Parameters

[in]	screen	The index of the screen (if needed).
[in]	pColorMap	An array of unsigned long values for colormap information.
[in]	modelRef	The model to get the color descriptor from.

Obtain an existing colormap for the master design file's colortable.

A colormap is an array of draw values corresponding to each RGB triad in the colortable. A colortable has a colormap for each screen in the system.

Parameters

[out]	pColormap	Must point to an array of unsigned long values to receive all or part of the system colormap information.
[in]	pNumMappings	Points to an integer where the number of entries in the system colormap are stored. If numMappings is NULL, it is ignored.
[in]	screen	Indicates for which screen the colormap is to be obtained.
[in]	maxSize	Specifies how many entries from the system colormap are to be copied to colormapP.

UInt32* mdlColor_matchLongColorMap	(	UInt32 *	pUserMap,
		byte *	pColorTable,
		int	screen,
		bool	exactColorsEnabled
	)

Generate a color map in cmap.

cmap contains the Color Manager display color draw values corresponding to each RGB color definition in ctbl.

Remarks: The only difference between mdlColor_matchColorMap and mdlColor_matchLongColorMap is in the size of the color map elements they generate. mdlColor_matchColorMap generates a color map array of bytes. In this case, the byte values are always indices into a hardware color palette. mdlColor_matchLongColorMap generates an array of unsigned long values that can be either indices into a hardware color palette or other "draw values" that are specific to the host windowing system. For example, under Windows NT, each color map entry would be equivalent to a COLORREF specification.; With the advent of color descriptors and color palettes in MicroStation 5.0, the need for generating and manipulating color maps directly is greatly reduced if not eliminated. Furthermore, mdlColor_matchColorMap is not available on all platforms. It is only supported for backwards compatibility to the platforms supported by MicroStation 4.x. If color maps must be used, mdlColor_matchLongColorMap is the preferred function for generating them.

Parameters

[out]	pUserMap	Is an array of 256 elements (bytes or unsigned longs) to receive the matched color indices.
[in]	pColorTable	Is a 768-byte color table (256 RGB specifications) to be matched against the Color Manager's display colors.
[in]	screen	Indicates the right (0) or left (1) screen.
[in]	exactColorsEnabled	Currently ignored.