The "vc" Package

These routines are meant to provide an abstracted interface to a VX display and colourmaps, used in the kcmap routines.

Library: karmavx
Link With: -lkarmavx

Functions

vc_get_dpy_handleGenerate a display handle for later use.
vc_alloc_coloursAllocate colourcells.
vc_free_coloursFree a number of colourcells in a low level colourmap.
vc_store_coloursStore colours into a low level colourmap.
vc_store_colours_24bitStore colours into a low level colourmap.
vc_get_locationDetermine the location of the graphics display being used.
vc_set_visualtypeSet the current visual of the viewable colourmap.
vc_get_visualtypeGet the current visual of the viewable colourmap.


Functions


Kdisplay vc_get_dpy_handle ()

Generate a display handle for later use.

Parameters:

Returns: A pointer to the display handle on success, else NULL.
Multithreading Level: Unsafe


unsigned int vc_alloc_colours (unsigned int num_cells, unsigned long *pixel_values, unsigned int min_cells, Kdisplay dpy_handle)

This routine will allocate a number of colourcells in a low level colourmap (e.g. using the Xlib routine XAllocColorCells).

Parameters:

Returns: The number of colourcells allocated.
Multithreading Level: Unsafe


void vc_free_colours (unsigned int num_cells, unsigned long *pixel_values, Kdisplay dpy_handle)

Free a number of colourcells in a low level colourmap.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe


void vc_store_colours (unsigned int num_cells, unsigned long *pixel_values, unsigned short *reds, unsigned short *greens, unsigned short *blues, unsigned int stride, Kdisplay dpy_handle)

Store colours into a low level colourmap.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe


void vc_store_colours_24bit (unsigned int num_cells, unsigned long *pixel_values, unsigned short *reds, unsigned short *greens, unsigned short *blues, unsigned int stride, Kdisplay dpy_handle)

This routine will store colours into a low level colourmap. The colours are stored for the DirectColour (24 bit) visual type.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe


void vc_get_location (Kdisplay dpy_handle, unsigned long *serv_hostaddr, unsigned long *serv_display_num)

Determine the location of the graphics display being used.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe


void vc_set_visualtype (Kdisplay dpy_handle, unsigned int visual, flag overlay)

Set the current visual of the viewable colourmap.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe
Note:


void vc_get_visualtype (Kdisplay dpy_handle, unsigned int *visual, flag *overlay)

Get the current visual of the viewable colourmap.

Parameters:

Returns: Nothing.
Multithreading Level: Unsafe


Contact: Richard Gooch
Web Development: Ariel Internet Services