This library contains a multitude of functions to manage true color on the MATRIX graphic boards. In all, the following routines are available in TC-VDI 0.7:
• vq_calibrate | Tests colour calibration |
• vq_colors | Gets a palette sequence |
• vq_pixcol | Gets pixel |
• vq_pixrgb | Gets pixel rgb color |
• vrf_rgb | Gets fill color values |
• vrl_rgb | Gets line color values |
• vrt_rgb | Gets text color values |
• vrun_parallel | Parallelogram color runs |
• vrun_rect | Rectangle color runs |
• vrun_triangle | Triangle color runs |
• vs_calibrate | Sets colour calibration |
• vs_colors | Sets a palette sequence |
• vs_pixcol | Sets pixel through soft palette |
• vs_pixrgb | Sets pixel rgb color |
• vsf_rgb | Sets fill color values |
• vsl_rgb | Sets line color values |
• vst_rgb | Sets text color values |
See also: MATRIX XBIOS extension
Name: | »Inquire colors« - Obtain the RGB values of a colour palette.
|
Opcode: | 65
|
Syntax: | void vq_colors ( int16_t handle, int16_t from, int16_t to,
int16_t set_flag, int16_t *rgb_table );
|
Description: | The call vq_colors obtains the RGB values starting from the
colour index from to the colour index to. The
resulting values are stored in rgb_table.
|
Return value: | The function does not return a result.
|
Availability: | Available only with MATRIX drivers in TC mode.
|
Group: | TC-VDI functions
|
See also: | Binding vs_colors
|
C: | void vq_colors ( int16_t handle, int16_t from, int16t_to,
int16_t set_flag, int16_t *rgb_table );
| |||||||||||||||||||||||||||||||||
Binding: |
void vq_colors (int16_t handle, int16_t from, int16_t to, int16_t set_flag, int16_t *rgb_table) { intin[0] = from; intin[1] = to; intin[2] = set_flag; intin[3..4] = rgb_table; contrl[0] = 65; contrl[1] = 0; contrl[3] = 5; contrl[6] = handle; vdi (); } | |||||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Inquire pixel colour index« - Obtain the index of a pixel.
| ||||||||||||||
Opcode: | 58
| ||||||||||||||
Syntax: | void vq_pixcol ( int16_t handle, int16_t x, int16_t y, int16_t
*phys_ix, int16_t *vdi_ix );
| ||||||||||||||
Description: | The call vq_pixcol obtains the physical and VDI indexes of the
pixel at the given coordinates. The following apply:
| ||||||||||||||
Return value: | The function does not return a result.
| ||||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||||
Group: | TC-VDI functions
| ||||||||||||||
See also: | Binding vs_pixcol
|
C: | void vq_pixcol ( int16_t handle, int16_t x, int16t_y, int16_t
*phys_ix, int16_t *vdi_ix );
| |||||||||||||||||||||||||||||||||
Binding: |
void vq_pixcol (int16_t handle, int16_t x, int16_t y, int16_t *phys_ix, int16_t *vdi_ix) { ptsin[0] = x; ptsin[1] = y; contrl[0] = 58; contrl[1] = 1; contrl[3] = 0; contrl[6] = handle; vdi (); *phys_ix = intout[0]; *vdi_ix = intout[1]; } | |||||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Inquire pixel colour representation« - Obtain the RGB
intensities of a pixel.
| ||||||||||||||||
Opcode: | 60
| ||||||||||||||||
Syntax: | void vq_pixrgb ( int16_t handle, int16_t x, int16_t y, int16_t
*rgb );
| ||||||||||||||||
Description: | The call vq_pixrgb obtains the RGB colour intensities of the
pixel at the given coordinates. The following apply:
| ||||||||||||||||
Return value: | The function does not return a result.
| ||||||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||||||
Group: | TC-VDI functions
| ||||||||||||||||
See also: | Binding vs_pixrgb
|
C: | void vq_pixrgb ( int16_t handle, int16_t x, int16t_y, int16_t
*rgb );
| ||||||||||||||||||||||||||||||
Binding: |
void vq_pixrgb (int16_t handle, int16_t x, int16_t y, int16_t *rgb) { ptsin[0] = x; ptsin[1] = y; contrl[0] = 60; contrl[1] = 1; contrl[3] = 0; contrl[6] = handle; vdi (); rgb[0] = intout[0]; rgb[1] = intout[1]; rgb[2] = intout[2]; } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Inquire fill colour representation« - Obtain the RGB
intensities for the colour with which a 2-dimensional graphic object
is filled.
| ||||||||||||
Opcode: | 54
| ||||||||||||
Syntax: | void vrf_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||
Description: | The call vrf_rgb obtains the RGB colour intensities of the fill
colour of 2-dimensional graphic object. The following apply:
| ||||||||||||
Return value: | The function does not return a result.
| ||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||
Group: | TC-VDI functions
| ||||||||||||
See also: | Binding vrl_rgb vrt_rgb vsf_rgb vsl_rgb vst_rgb
|
C: | void vrf_rgb ( int16_t handle, int16_t *rgb );
|
Binding: |
void vrf_rgb (int16_t handle, int16_t *rgb) { contrl[0] = 54; contrl[1] = 0; contrl[3] = 0; contrl[6] = handle; vdi (); rgb[0] = intout[0]; rgb[1] = intout[1]; rgb[2] = intout[2]; } |
GEM-Arrays: |
|
Name: | »Inquire polyline colour representation« - Obtain the RGB
intensities for the line colour.
| ||||||||||||
Opcode: | 56
| ||||||||||||
Syntax: | void vrl_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||
Description: | The call vrl_rgb obtains the RGB colour intensities of the line
colour. The following apply:
| ||||||||||||
Return value: | The function does not return a result.
| ||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||
Group: | TC-VDI functions
| ||||||||||||
See also: | Binding vrf_rgb vrt_rgb vsf_rgb vsl_rgb vst_rgb
|
C: | void vrl_rgb ( int16_t handle, int16_t *rgb );
|
Binding: |
void vrl_rgb (int16_t handle, int16_t *rgb) { contrl[0] = 56; contrl[1] = 0; contrl[3] = 0; contrl[6] = handle; vdi (); rgb[0] = intout[0]; rgb[1] = intout[1]; rgb[2] = intout[2]; } |
GEM-Arrays: |
|
Name: | »Inquire graphic text colour representation« - Obtain the RGB
intensities of the text output.
| ||||||||||||
Opcode: | 55
| ||||||||||||
Syntax: | void vrt_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||
Description: | The call vrt_rgb obtains the RGB colour intensities of the
graphic text output. The following apply:
| ||||||||||||
Return value: | The function does not return a result.
| ||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||
Group: | TC-VDI functions
| ||||||||||||
See also: | Binding vrf_rgb vrl_rgb vsf_rgb vsl_rgb vst_rgb
|
C: | void vrt_rgb ( int16_t handle, int16_t *rgb );
|
Binding: |
void vrt_rgb (int16_t handle, int16_t *rgb) { contrl[0] = 55; contrl[1] = 0; contrl[3] = 0; contrl[6] = handle; vdi (); rgb[0] = intout[0]; rgb[1] = intout[1]; rgb[2] = intout[2]; } |
GEM-Arrays: |
|
Name: | »Parallelogram color run« - Parallelogram colour run.
| ||||||||||||||||||||
Opcode: | 62
| ||||||||||||||||||||
Syntax: | void vrun_parallel ( int16_t handle, int16_t *pts, int16_t
*rgbs );
| ||||||||||||||||||||
Description: | To define the parallelogram only three points are required. The
following apply:
| ||||||||||||||||||||
Return value: | The function does not return a result.
| ||||||||||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||||||||||
Group: | TC-VDI functions
| ||||||||||||||||||||
See also: | Binding vrun_rect vrun_triangle
|
C: | void vrun_parallel ( int16_t handle, int16_t *pts, int16_t
*rgbs );
| |||||||||||||||||||||||||||
Binding: |
void vrun_parallel (int16_t handle, int16_t *pts, int16_t *rgbs) { ptsin[0..5] = pts[0..5]; intin[0..11] = rgbs[0..11]; contrl[0] = 62; contrl[1] = 3; contrl[3] = 12; contrl[6] = handle; vdi (); } | |||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Rectangle color run« - Rectangle colour run.
| ||||||||||||||||
Opcode: | 61
| ||||||||||||||||
Syntax: | void vrun_rect ( int16_t handle, int16_t *pts, int16_t *rgbs );
| ||||||||||||||||
Description: | The following apply:
| ||||||||||||||||
Return value: | The function does not return a result.
| ||||||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||||||
Group: | TC-VDI functions
| ||||||||||||||||
See also: | Binding vrun_parallel vrun_triangle
|
C: | void vrun_rect ( int16_t handle, int16_t *pts, int16_t *rgbs );
| |||||||||||||||||||||||||||
Binding: |
void vrun_rect (int16_t handle, int16_t *pts, int16_t *rgbs) { ptsin[0..3] = pts[0..3]; intin[0..11] = rgbs[0..11]; contrl[0] = 61; contrl[1] = 2; contrl[3] = 12; contrl[6] = handle; vdi (); } | |||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Triangle color run« - Triangle colour run.
| ||||||||||||||||||||
Opcode: | 63
| ||||||||||||||||||||
Syntax: | void vrun_triangle ( int16_t handle, int16_t *pts, int16_t
*rgbs );
| ||||||||||||||||||||
Description: | The following apply:
| ||||||||||||||||||||
Return value: | The function does not return a result.
| ||||||||||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||||||||||
Group: | TC-VDI functions
| ||||||||||||||||||||
See also: | Binding vrun_parallel vrun_rect
|
C: | void vrun_triangle ( int16_t handle, int16_t *pts, int16_t
*rgbs );
| |||||||||||||||||||||||||||
Binding: |
void vrun_triangle (int16_t handle, int16_t *pts, int16_t *rgbs) { ptsin[0..5] = pts[0..5]; intin[0..8] = rgbs[0..8]; contrl[0] = 63; contrl[1] = 3; contrl[3] = 9; contrl[6] = handle; vdi (); } | |||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set colors« - Set the RGB value of a colour.
|
Opcode: | 64
|
Syntax: | void vs_colors ( int16_t handle, int16_t from, int16_t to,
int16_t *rgb_table );
|
Description: | The call vs_colors sets the RGB values of the palette starting
from the palette index from to the palette index to.
The colour values are stored in rgb_table.
|
Return value: | The function does not return a result.
|
Availability: | Available only with MATRIX drivers in TC mode.
|
Group: | TC-VDI functions
|
See also: | Binding vq_colors
|
C: | void vs_colors ( int16_t handle, int16_t from, int16_t to,
int16_t *rgb_table );
| ||||||||||||||||||||||||||||||
Binding: |
void vs_colors (int16_t handle, int16_t from, int16_t to, int16_t *rgb_table) { intin[0] = from; intin[1] = to; intin[2..3] = rgb_table; contrl[0] = 64; contrl[1] = 0; contrl[3] = 4; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set pixel colour index« - Set the colour index of a pixel.
| ||||||||||||
Opcode: | 57
| ||||||||||||
Syntax: | void vs_pixcol ( int16_t handle, int16_t x, int16_t y, int16_t
vdi_ix );
| ||||||||||||
Description: | The call vs_pixcol sets the VDI colour index for the pixel at
the given coordinates.
| ||||||||||||
Return value: | The function does not return a result.
| ||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||
Group: | TC-VDI functions
| ||||||||||||
See also: | Binding vq_pixcol
|
C: | void vs_pixcol ( int16_t handle, int16_t x, int16_t y, int16_t
vdi_ix );
| ||||||||||||||||||||||||||||||
Binding: |
void vs_pixcol (int16_t handle, int16_t x, int16_t y, int16_t vdi_ix) { ptsin[0] = x; ptsin[1] = y; intin[0] = vdi_ix; contrl[0] = 57; contrl[1] = 1; contrl[3] = 1; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set pixel RGB colour values« - Set the colour of a pixel.
| ||||||||||||
Opcode: | 59
| ||||||||||||
Syntax: | void vs_pixrgb ( int16_t handle, int16_t x, int16_t y, int16_t
*rgb );
| ||||||||||||
Description: | The call vs_pixrgb sets the RGB colour for the pixel at the
given coordinates.
| ||||||||||||
Return value: | The function does not return a result.
| ||||||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||||||
Group: | TC-VDI functions
| ||||||||||||
See also: | Binding vq_pixrgb
|
C: | void vs_pixrgb ( int16_t handle, int16_t x, int16_t y, int16_t
*rgb );
| ||||||||||||||||||||||||||||||||||||
Binding: |
void vs_pixrgb (int16_t handle, int16_t x, int16_t y, int16_t *rgb) { ptsin[0] = x; ptsin[1] = y; intin[0] = *rgb++; intin[1] = *rgb++; intin[2] = *rgb; contrl[0] = 59; contrl[1] = 1; contrl[3] = 3; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set fill RGB colour values« - Set the colour with which a
2-dimensional graphic object is to be filled.
| ||||||||
Opcode: | 51
| ||||||||
Syntax: | void vsf_rgb ( int16_t handle, int16_t *rgb );
| ||||||||
Description: | The call vsf_rgb sets the fill RGB colour for 2-dimensional
graphic objects.
| ||||||||
Return value: | The function does not return a result.
| ||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||
Group: | TC-VDI functions
| ||||||||
See also: | Binding vrf_rgb vrl_rgb vrt_rgb vsl_rgb vst_rgb
|
C: | void vsf_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||||||||||||||||||||
Binding: |
void vsf_rgb (int16_t handle, int16_t *rgb) { intin[0] = *rgb++; intin[1] = *rgb++; intin[2] = *rgb; contrl[0] = 51; contrl[1] = 0; contrl[3] = 3; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set polyline RGB colour values« - Set the line colour.
| ||||||||
Opcode: | 53
| ||||||||
Syntax: | void vsl_rgb ( int16_t handle, int16_t *rgb );
| ||||||||
Description: | The call vsl_rgb sets the RGB colour for lines.
| ||||||||
Return value: | The function does not return a result.
| ||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||
Group: | TC-VDI functions
| ||||||||
See also: | Binding vrf_rgb vrl_rgb vrt_rgb vsf_rgb vst_rgb
|
C: | void vsl_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||||||||||||||||||||
Binding: |
void vsl_rgb (int16_t handle, int16_t *rgb) { intin[0] = *rgb++; intin[1] = *rgb++; intin[2] = *rgb; contrl[0] = 53; contrl[1] = 0; contrl[3] = 3; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|
Name: | »Set graphic text RGB colour values« - Set the colour of the
text output.
| ||||||||
Opcode: | 52
| ||||||||
Syntax: | void vst_rgb ( int16_t handle, int16_t *rgb );
| ||||||||
Description: | The call vst_rgb sets the RGB colour values for subsequent
graphic text operations.
| ||||||||
Return value: | The function does not return a result.
| ||||||||
Availability: | Available only with MATRIX drivers in TC mode.
| ||||||||
Group: | TC-VDI functions
| ||||||||
See also: | Binding vrf_rgb vrl_rgb vrt_rgb vsf_rgb vsl_rgb
|
C: | void vst_rgb ( int16_t handle, int16_t *rgb );
| ||||||||||||||||||||||||||||||
Binding: |
void vst_rgb (int16_t handle, int16_t *rgb) { intin[0] = *rgb++; intin[1] = *rgb++; intin[2] = *rgb; contrl[0] = 52; contrl[1] = 0; contrl[3] = 3; contrl[6] = handle; vdi (); } | ||||||||||||||||||||||||||||||
GEM-Arrays: |
|