X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;ds=inline;f=UDI%2Finclude%2Fudi_gfx.h;h=cd7db759f2002fb130d51860f775571057430bde;hb=3d67e21210fbcad7cdcbfa9c348019a191ce1798;hp=23da6fa9377c4886dd3e973eb93f14216c5152db;hpb=522f6081c5133562acbf438fd9c9fc0324b72ace;p=tpg%2Facess2.git diff --git a/UDI/include/udi_gfx.h b/UDI/include/udi_gfx.h index 23da6fa9..cd7db759 100644 --- a/UDI/include/udi_gfx.h +++ b/UDI/include/udi_gfx.h @@ -9,10 +9,10 @@ * * * Origin: - * http://www.d-rift.nl/combuster/mos3/?p=viewsource&file=/include/common/udi_gfx.h + * http:/*www.d-rift.nl/combuster/mos3/?p=viewsource&file=/include/common/udi_gfx.h*/ */ -// note that the specification, and thus, the contents of this file is not fixed. +/* note that the specification, and thus, the contents of this file is not fixed.*/ #ifndef __UDI_GFX_H__ #define __UDI_GFX_H__ @@ -30,7 +30,7 @@ * Lists the various UDI properties */ -// General state properties +/* General state properties*/ /* Constant: UDI_GFX_PROP_ENABLE * * Valid values: @@ -130,7 +130,7 @@ */ #define UDI_GFX_PROP_CUSTOM 1024 -// engine properties +/* engine properties*/ /* Constant: UDI_GFX_PROP_CLIP * @@ -272,25 +272,27 @@ */ #define UDI_GFX_PROP_OPERATOR_COUNT 28 -// properties for removal: -#define UDI_GFX_PROP_STORE_COUNT 24 // not generic -#define UDI_GFX_PROP_STORE_WIDTH 9 // not generic -#define UDI_GFX_PROP_STORE_HEIGHT 10 // not generic -#define UDI_GFX_PROP_STORE_BITS 11 // not generic -#define UDI_GFX_PROP_PALETTE 1024 // optional, can be derived from the operator tree -#define UDI_GFX_PROP_BUFFER 1025 // optional, can be derived from the operator tree -#define UDI_GFX_PROP_TILESHEET 1026 // optional, can be derived from the operator tree -#define UDI_GFX_PROP_OPERATOR_INDEX 17 // deprecated for dedicated methods -#define UDI_GFX_PROP_OPERATOR_OPCODE 18 // deprecated for dedicated methods -#define UDI_GFX_PROP_OPERATOR_ARG_1 19 // deprecated for dedicated methods -#define UDI_GFX_PROP_OPERATOR_ARG_2 20 // deprecated for dedicated methods -#define UDI_GFX_PROP_OPERATOR_ARG_3 21 // deprecated for dedicated methods -#define UDI_GFX_PROP_SOURCE_WIDTH 12 // should have been documented when I still knew what it did. -#define UDI_GFX_PROP_SOURCE_HEIGHT 13 // should have been documented when I still knew what it did. -#define UDI_GFX_PROP_INPUTX 25 // should have been documented when I still knew what it did. -#define UDI_GFX_PROP_INPUTY 26 // should have been documented when I still knew what it did. - -// connector properties +#if 0 +/* properties for removal:*/ +#define UDI_GFX_PROP_STORE_COUNT 24 /* not generic*/ +#define UDI_GFX_PROP_STORE_WIDTH 9 /* not generic*/ +#define UDI_GFX_PROP_STORE_HEIGHT 10 /* not generic*/ +#define UDI_GFX_PROP_STORE_BITS 11 /* not generic*/ +#define UDI_GFX_PROP_PALETTE 1024 /* optional, can be derived from the operator tree*/ +#define UDI_GFX_PROP_BUFFER 1025 /* optional, can be derived from the operator tree*/ +#define UDI_GFX_PROP_TILESHEET 1026 /* optional, can be derived from the operator tree*/ +#define UDI_GFX_PROP_OPERATOR_INDEX 17 /* deprecated for dedicated methods*/ +#define UDI_GFX_PROP_OPERATOR_OPCODE 18 /* deprecated for dedicated methods*/ +#define UDI_GFX_PROP_OPERATOR_ARG_1 19 /* deprecated for dedicated methods*/ +#define UDI_GFX_PROP_OPERATOR_ARG_2 20 /* deprecated for dedicated methods*/ +#define UDI_GFX_PROP_OPERATOR_ARG_3 21 /* deprecated for dedicated methods*/ +#define UDI_GFX_PROP_SOURCE_WIDTH 12 /* should have been documented when I still knew what it did.*/ +#define UDI_GFX_PROP_SOURCE_HEIGHT 13 /* should have been documented when I still knew what it did.*/ +#define UDI_GFX_PROP_INPUTX 25 /* should have been documented when I still knew what it did.*/ +#define UDI_GFX_PROP_INPUTY 26 /* should have been documented when I still knew what it did.*/ +#endif + +/* connector properties*/ #define UDI_GFX_PROP_SIGNAL 23 #define UDI_GFX_PROP_CONNECTOR_TYPE 24 #define UDI_GFX_PROP_VGA_H_FRONT_PORCH 25 @@ -340,46 +342,43 @@ /** * Enumeration: UDI_GFX_OPERATOR * Lists the display output operator - * - * a1/a2/a3 represents taking the output of a previous operation - * v1/v2/v3 represents the literal value of that argument */ -#define UDI_GFX_OPERATOR_RGB 0 // output = (color) red(a1) + green(a2) + blue(a3) (each component is UDI_GFX_PROP_COLOR_BITS -#define UDI_GFX_OPERATOR_YUV 1 // output = (color) Y(a1) + U(a2) + V(a3) -#define UDI_GFX_OPERATOR_YIQ 2 // output = (color) Y(a1) + I(a2) + Q(a3) -#define UDI_GFX_OPERATOR_I 3 // output = (color) intensity(a1) -#define UDI_GFX_OPERATOR_ALPHA 4 // output = (color) a1 + alpha(a2) -#define UDI_GFX_OPERATOR_ADD 5 // output = a1 + a2 + v3 -#define UDI_GFX_OPERATOR_SUB 6 // output = a1 - a2 - v3 -#define UDI_GFX_OPERATOR_MUL 7 // output = a1 * a2 -#define UDI_GFX_OPERATOR_DIV 8 // output = a1 / a2 -#define UDI_GFX_OPERATOR_MAD 9 // output = a1 * a2 + a3 -#define UDI_GFX_OPERATOR_FRC 10 // output = (a1 * a2) / a3 -#define UDI_GFX_OPERATOR_SHR 11 // output = a1 >> (a2 + v3) -#define UDI_GFX_OPERATOR_SHL 12 // output = a1 << (a2 + v3) -#define UDI_GFX_OPERATOR_ROR 13 // output = a1 >> a2 (over a3 bits) -#define UDI_GFX_OPERATOR_ROL 14 // output = a1 << a2 (over a3 bits) -#define UDI_GFX_OPERATOR_SAR 15 // output = a1 >> a2 (width is a3 bits, i.e. empties are filled with bit a3-1) -#define UDI_GFX_OPERATOR_SAL 16 // output = a1 <<< (a2 + v3) (empties filled with bit 0) -#define UDI_GFX_OPERATOR_AND 17 // output = a1 & a2 -#define UDI_GFX_OPERATOR_OR 18 // output = a1 | a2 | v3 -#define UDI_GFX_OPERATOR_NOT 19 // output = ~a1 -#define UDI_GFX_OPERATOR_XOR 20 // output = a1 ^ a2 ^ v3 -#define UDI_GFX_OPERATOR_NEG 21 // output = -a1 -#define UDI_GFX_OPERATOR_SEG 22 // output = (a1 >> v2) & (2**v3-1) (select v3 bits starting from bit v2) -#define UDI_GFX_OPERATOR_RANGE 23 // output = (a1 > a2) ? a2 : ((a1 < a3) ? a3 : a1) -#define UDI_GFX_OPERATOR_CONST 24 // output = v1 -#define UDI_GFX_OPERATOR_ATTR 25 // output = property[a1 + v2] -#define UDI_GFX_OPERATOR_SWITCH 26 // output = output[(a1 % v3) + v2] -#define UDI_GFX_OPERATOR_BUFFER 27 // output = buffer[a1][a2] (buffer is v3 bits per entry) -#define UDI_GFX_OPERATOR_X 28 // output = output x pixel -#define UDI_GFX_OPERATOR_Y 29 // output = output y pixel -#define UDI_GFX_OPERATOR_TX 30 // output = horizontal tile index belonging to output pixel -#define UDI_GFX_OPERATOR_TY 31 // output = vertical tile index belonging to output pixel -#define UDI_GFX_OPERATOR_TXOFF 32 // output = horizontal offset from start of tile -#define UDI_GFX_OPERATOR_TYOFF 33 // output = vertical offset from start of tile -#define UDI_GFX_OPERATOR_INPUT 34 // output = input engine[x][y] component v1 -#define UDI_GFX_OPERATOR_DINPUT 35 // output = input engine[a1][a2] component v3 +#define UDI_GFX_OPERATOR_RGB 0 /* output = (color) red(a1) + green(a2) + blue(a3) (each component is UDI_GFX_PROP_COLOR_BITS*/ +#define UDI_GFX_OPERATOR_YUV 1 /* output = (color) Y(a1) + U(a2) + V(a3)*/ +#define UDI_GFX_OPERATOR_YIQ 2 /* output = (color) Y(a1) + I(a2) + Q(a3)*/ +#define UDI_GFX_OPERATOR_I 3 /* output = (color) intensity(a1)*/ +#define UDI_GFX_OPERATOR_ALPHA 4 /* output = (color) a1 + alpha(a2)*/ +#define UDI_GFX_OPERATOR_ADD 5 /* output = a1 + a2 + v3*/ +#define UDI_GFX_OPERATOR_SUB 6 /* output = a1 - a2 - v3*/ +#define UDI_GFX_OPERATOR_MUL 7 /* output = a1 * a2*/ +#define UDI_GFX_OPERATOR_DIV 8 /* output = a1 / a2*/ +#define UDI_GFX_OPERATOR_MAD 9 /* output = a1 * a2 + a3*/ +#define UDI_GFX_OPERATOR_FRC 10 /* output = (a1 * a2) / a3*/ +#define UDI_GFX_OPERATOR_SHR 11 /* output = a1 >> (a2 + v3)*/ +#define UDI_GFX_OPERATOR_SHL 12 /* output = a1 << (a2 + v3)*/ +#define UDI_GFX_OPERATOR_ROR 13 /* output = a1 >> a2 (over a3 bits)*/ +#define UDI_GFX_OPERATOR_ROL 14 /* output = a1 << a2 (over a3 bits)*/ +#define UDI_GFX_OPERATOR_SAR 15 /* output = a1 >> a2 (width is a3 bits, i.e. empties are filled with bit a3-1)*/ +#define UDI_GFX_OPERATOR_SAL 16 /* output = a1 <<< (a2 + v3) (empties filled with bit 0)*/ +#define UDI_GFX_OPERATOR_AND 17 /* output = a1 & a2*/ +#define UDI_GFX_OPERATOR_OR 18 /* output = a1 | a2 | v3*/ +#define UDI_GFX_OPERATOR_NOT 19 /* output = ~a1*/ +#define UDI_GFX_OPERATOR_XOR 20 /* output = a1 ^ a2 ^ v3*/ +#define UDI_GFX_OPERATOR_NEG 21 /* output = -a1*/ +#define UDI_GFX_OPERATOR_SEG 22 /* output = (a1 >> v2) & (2**v3-1) (select v3 bits starting from bit v2)*/ +#define UDI_GFX_OPERATOR_RANGE 23 /* output = (a1 > a2) ? a2 : ((a1 < a3) ? a3 : a1)*/ +#define UDI_GFX_OPERATOR_CONST 24 /* output = v1*/ +#define UDI_GFX_OPERATOR_ATTR 25 /* output = property[a1 + v2]*/ +#define UDI_GFX_OPERATOR_SWITCH 26 /* output = output[(a1 % v3) + v2]*/ +#define UDI_GFX_OPERATOR_BUFFER 27 /* output = buffer[a1][a2] (buffer is v3 bits per entry)*/ +#define UDI_GFX_OPERATOR_X 28 /* output = output x pixel*/ +#define UDI_GFX_OPERATOR_Y 29 /* output = output y pixel*/ +#define UDI_GFX_OPERATOR_TX 30 /* output = horizontal tile index belonging to output pixel*/ +#define UDI_GFX_OPERATOR_TY 31 /* output = vertical tile index belonging to output pixel*/ +#define UDI_GFX_OPERATOR_TXOFF 32 /* output = horizontal offset from start of tile*/ +#define UDI_GFX_OPERATOR_TYOFF 33 /* output = vertical offset from start of tile*/ +#define UDI_GFX_OPERATOR_INPUT 34 /* output = input engine[x][y] component v1*/ +#define UDI_GFX_OPERATOR_DINPUT 35 /* output = input engine[a1][a2] component v3*/ /* Enumeration: UDI_GFX_STOCK_FORMAT * Lists stock configurations @@ -401,179 +400,179 @@ #define UDI_GFX_STOCK_FORMAT_B5G5R5X1 8 #define UDI_GFX_STOCK_FORMAT_N8 9 -// Enumeration: UDI_GFX_BUFFER_INFO_FLAG -// Lists behavioural patterns for direct buffer accesses. -// -#define UDI_GFX_BUFFER_INFO_FLAG_R 0x0001 // buffer can be read -#define UDI_GFX_BUFFER_INFO_FLAG_W 0x0002 // buffer can be written -#define UDI_GFX_BUFFER_INFO_FLAG_BITALIGN_ENTRY 0x0004 // for non-multiple-of-eight buffer slot sizes, align on byte boundary every unit -#define UDI_GFX_BUFFER_INFO_FLAG_BITALIGN_ROW 0x0008 // for non-multiple-of-eight buffer slot sizes, align only the start of the row +/* Enumeration: UDI_GFX_BUFFER_INFO_FLAG*/ +/* Lists behavioural patterns for direct buffer accesses.*/ +/**/ +#define UDI_GFX_BUFFER_INFO_FLAG_R 0x0001 /* buffer can be read*/ +#define UDI_GFX_BUFFER_INFO_FLAG_W 0x0002 /* buffer can be written*/ +#define UDI_GFX_BUFFER_INFO_FLAG_BITALIGN_ENTRY 0x0004 /* for non-multiple-of-eight buffer slot sizes, align on byte boundary every unit*/ +#define UDI_GFX_BUFFER_INFO_FLAG_BITALIGN_ROW 0x0008 /* for non-multiple-of-eight buffer slot sizes, align only the start of the row*/ -// Constant: UDI_GFX_PROVIDER_OPS_NUM -// the ops number used for the graphics driver +/* Constant: UDI_GFX_PROVIDER_OPS_NUM*/ +/* the ops number used for the graphics driver*/ #define UDI_GFX_PROVIDER_OPS_NUM 1 -// Constant: UDI_GFX_CLIENT_OPS_NUM -// the ops number used for the graphics application +/* Constant: UDI_GFX_CLIENT_OPS_NUM*/ +/* the ops number used for the graphics application*/ #define UDI_GFX_CLIENT_OPS_NUM 2 -// Structure: udi_gfx_bind_cb_t -// Contains the operations of a driver binding request +/* Structure: udi_gfx_bind_cb_t*/ +/* Contains the operations of a driver binding request*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; } udi_gfx_bind_cb_t; #define UDI_GFX_BIND_CB_NUM 1 -// Function: udi_block_bind_req -// function pointer prototype for connecting to a block device -// -// in: -// cb - A pointer to a -// +/* Function: udi_block_bind_req*/ +/* function pointer prototype for connecting to a block device*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_bind_req_op_t (udi_gfx_bind_cb_t *cb ); udi_gfx_bind_req_op_t udi_gfx_bind_req; -// Function: udi_gfx_bind_ack -// function pointer prototype for acknowledging a connection request -// -// in: -// cb - A pointer to a -// sockets - The number of addressable socket components -// engines - The number of addressable engine components -// status - The result of the bind operation -// +/* Function: udi_gfx_bind_ack*/ +/* function pointer prototype for acknowledging a connection request*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/* sockets - The number of addressable socket components*/ +/* engines - The number of addressable engine components*/ +/* status - The result of the bind operation*/ +/**/ typedef void udi_gfx_bind_ack_op_t (udi_gfx_bind_cb_t *cb, udi_index_t sockets, udi_index_t engines, udi_status_t status ); udi_gfx_bind_ack_op_t udi_gfx_bind_ack; -// Function: udi_gfx_unbind_req -// function pointer prototype for disconnecting a block device -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_unbind_req*/ +/* function pointer prototype for disconnecting a block device*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_unbind_req_op_t (udi_gfx_bind_cb_t *cb ); udi_gfx_unbind_req_op_t udi_gfx_unbind_req; -// Function: udi_gfx_unbind_ack -// function pointer prototype for connecting to a block device -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_unbind_ack*/ +/* function pointer prototype for connecting to a block device*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_unbind_ack_op_t (udi_gfx_bind_cb_t *cb ); udi_gfx_unbind_ack_op_t udi_gfx_unbind_ack; -// Structure: udi_gfx_state_cb_t -// Contains the operations of a read/write transaction +/* Structure: udi_gfx_state_cb_t*/ +/* Contains the operations of a read/write transaction*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; udi_ubit32_t subsystem; udi_ubit32_t attribute; } udi_gfx_state_cb_t; #define UDI_GFX_STATE_CB_NUM 2 -// Function: udi_gfx_set_engine_req -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_set_engine_req*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_set_engine_req_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t value); udi_gfx_set_engine_req_op_t udi_gfx_set_engine_req; -// Function: udi_gfx_set_connector_req -// function pointer prototype for setting an connector state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_set_connector_req*/ +/* function pointer prototype for setting an connector state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_set_connector_req_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t value); udi_gfx_set_connector_req_op_t udi_gfx_set_connector_req; -// Function: udi_gfx_set_engine_ack -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_set_engine_ack*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_set_engine_ack_op_t (udi_gfx_state_cb_t *cb ); udi_gfx_set_engine_ack_op_t udi_gfx_set_engine_ack; -// Function: udi_gfx_set_connector_ack -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_set_connector_ack*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_set_connector_ack_op_t (udi_gfx_state_cb_t *cb ); udi_gfx_set_connector_ack_op_t udi_gfx_set_connector_ack; -// Function: udi_gfx_get_engine_req -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_get_engine_req*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_get_engine_req_op_t (udi_gfx_state_cb_t *cb ); udi_gfx_get_engine_req_op_t udi_gfx_get_engine_req; -// Function: udi_gfx_get_connector_req -// function pointer prototype for setting an connector state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_get_connector_req*/ +/* function pointer prototype for setting an connector state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_get_connector_req_op_t (udi_gfx_state_cb_t *cb ); udi_gfx_get_connector_req_op_t udi_gfx_get_connector_req; -// Function: udi_gfx_get_engine_ack -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_get_engine_ack*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_get_engine_ack_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t value); udi_gfx_get_engine_ack_op_t udi_gfx_get_engine_ack; -// Function: udi_gfx_get_connector_ack -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_get_connector_ack*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_get_connector_ack_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t value); udi_gfx_get_connector_ack_op_t udi_gfx_get_connector_ack; -// Function: udi_gfx_set_engine_nak -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// status - An UDI status value indicative of the error -// -typedef void udi_gfx_set_engine_nak_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t status); +/* Function: udi_gfx_set_engine_nak*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/* status - An UDI status value indicative of the error*/ +/**/ +typedef void udi_gfx_set_engine_nak_op_t (udi_gfx_state_cb_t *cb, udi_status_t status); udi_gfx_set_engine_nak_op_t udi_gfx_set_engine_nak; -// Function: udi_gfx_set_connector_nak -// function pointer prototype for setting an engine state -// -// in: -// cb - A pointer to a -// status - An UDI status value indicative of the error -// -typedef void udi_gfx_set_connector_nak_op_t (udi_gfx_state_cb_t *cb, udi_ubit32_t status); +/* Function: udi_gfx_set_connector_nak*/ +/* function pointer prototype for setting an engine state*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/* status - An UDI status value indicative of the error*/ +/**/ +typedef void udi_gfx_set_connector_nak_op_t (udi_gfx_state_cb_t *cb, udi_status_t status); udi_gfx_set_connector_nak_op_t udi_gfx_get_connector_nak; -// Structure: udi_gfx_range_cb_t -// Contains the operations of a range request transaction +/* Structure: udi_gfx_range_cb_t*/ +/* Contains the operations of a range request transaction*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; udi_ubit32_t subsystem; udi_ubit32_t attribute; @@ -581,151 +580,151 @@ typedef struct { } udi_gfx_range_cb_t; #define UDI_GFX_RANGE_CB_NUM 3 -// Function: udi_gfx_range_engine_req -// function pointer prototype for getting an engine property range -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_range_engine_req*/ +/* function pointer prototype for getting an engine property range*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_range_engine_req_op_t (udi_gfx_range_cb_t *cb ); udi_gfx_range_engine_req_op_t udi_gfx_range_engine_req; -// Function: udi_gfx_range_connector_req -// function pointer prototype for getting a connector property range -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_range_connector_req*/ +/* function pointer prototype for getting a connector property range*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_range_connector_req_op_t (udi_gfx_range_cb_t *cb ); udi_gfx_range_connector_req_op_t udi_gfx_range_connector_req; -// Function: udi_gfx_range_engine_ack -// function pointer prototype for replying an engine property range -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_range_engine_ack*/ +/* function pointer prototype for replying an engine property range*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_range_engine_ack_op_t (udi_gfx_range_cb_t *cb ); udi_gfx_range_engine_ack_op_t udi_gfx_range_engine_ack; -// Function: udi_gfx_range_connector_ack -// function pointer prototype for replying a connector property range -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_range_connector_ack*/ +/* function pointer prototype for replying a connector property range*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_range_connector_ack_op_t (udi_gfx_range_cb_t *cb ); udi_gfx_range_connector_ack_op_t udi_gfx_range_connector_ack; -// Function: udi_gfx_get_engine_operator_req -// function pointer prototype for requesting the engine operator layout -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_get_engine_operator_req*/ +/* function pointer prototype for requesting the engine operator layout*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_get_engine_operator_req_op_t (udi_gfx_range_cb_t *cb ); udi_gfx_get_engine_operator_req_op_t udi_gfx_get_engine_operator_req; -// Function: udi_gfx_get_engine_operator_ack -// function pointer prototype for replying the engine operator layout -// -// in: -// cb - A pointer to a -// op - The operator performed at this index -// arg1 - the first argument to this operator -// arg2 - the second argument to this operator -// arg3 - the third argument to this operator -// +/* Function: udi_gfx_get_engine_operator_ack*/ +/* function pointer prototype for replying the engine operator layout*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/* op - The operator performed at this index*/ +/* arg1 - the first argument to this operator*/ +/* arg2 - the second argument to this operator*/ +/* arg3 - the third argument to this operator*/ +/**/ typedef void udi_gfx_get_engine_operator_ack_op_t (udi_gfx_range_cb_t *cb, udi_ubit32_t op, udi_ubit32_t arg1, udi_ubit32_t arg2, udi_ubit32_t arg3 ); udi_gfx_get_engine_operator_ack_op_t udi_gfx_get_engine_operator_ack; -// Structure: udi_gfx_command_cb_t -// Contains the operations of a command sequence +/* Structure: udi_gfx_command_cb_t*/ +/* Contains the operations of a command sequence*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; udi_buf_t * commanddata; } udi_gfx_command_cb_t; #define UDI_GFX_COMMAND_CB_NUM 4 -// Function: udi_gfx_connector_command_req -// function pointer prototype for sending command data to the output connector -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_connector_command_req*/ +/* function pointer prototype for sending command data to the output connector*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_connector_command_req_op_t (udi_gfx_command_cb_t *cb ); udi_gfx_connector_command_req_op_t udi_gfx_connector_command_req; -// Function: udi_gfx_engine_command_req -// function pointer prototype for sending command data to the engine -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_engine_command_req*/ +/* function pointer prototype for sending command data to the engine*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_engine_command_req_op_t (udi_gfx_command_cb_t *cb ); udi_gfx_engine_command_req_op_t udi_gfx_engine_command_req; -// Function: udi_gfx_connector_command_ack -// function pointer prototype for sending command data replies -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_connector_command_ack*/ +/* function pointer prototype for sending command data replies*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_connector_command_ack_op_t (udi_gfx_command_cb_t *cb); udi_gfx_connector_command_ack_op_t udi_gfx_connector_command_ack; -// Function: udi_gfx_engine_command_ack -// function pointer prototype for sending engine data replies -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_engine_command_ack*/ +/* function pointer prototype for sending engine data replies*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_engine_command_ack_op_t (udi_gfx_command_cb_t *cb); udi_gfx_engine_command_ack_op_t udi_gfx_engine_command_ack; -// Structure: udi_gfx_buffer_cb_t -// Contains a description of a buffer, or area thereof +/* Structure: udi_gfx_buffer_cb_t*/ +/* Contains a description of a buffer, or area thereof*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; udi_ubit32_t buffer_index; } udi_gfx_buffer_info_cb_t; -// Function: udi_gfx_buffer_info_req -// function pointer prototype for getting buffer configuration information -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_buffer_info_req*/ +/* function pointer prototype for getting buffer configuration information*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_buffer_info_req_op_t (udi_gfx_buffer_info_cb_t *cb); udi_gfx_buffer_info_req_op_t udi_gfx_buffer_info_req; -// Function: udi_gfx_buffer_info_ack -// function pointer prototype for getting buffer configuration information -// -// in: -// cb - A pointer to a -// width - The width of the buffer -// height - The height of the buffer -// bitsper - The number of bits read from the buffer per pixel unit -// flags - A bitfield of indicating the exposed -// capabilities of this buffer -// -// Note that bitsper might not be a multiple of eight. -// +/* Function: udi_gfx_buffer_info_ack*/ +/* function pointer prototype for getting buffer configuration information*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/* width - The width of the buffer*/ +/* height - The height of the buffer*/ +/* bitsper - The number of bits read from the buffer per pixel unit*/ +/* flags - A bitfield of indicating the exposed */ +/* capabilities of this buffer*/ +/**/ +/* Note that bitsper might not be a multiple of eight.*/ +/**/ typedef void udi_gfx_buffer_info_ack_op_t (udi_gfx_buffer_info_cb_t *cb, udi_ubit32_t width, udi_ubit32_t height, udi_ubit32_t bitsper, udi_ubit32_t flags); udi_gfx_buffer_info_ack_op_t udi_gfx_buffer_info_ack; -// Structure: udi_gfx_buffer_cb_t -// Contains a description of a buffer, or area thereof +/* Structure: udi_gfx_buffer_cb_t*/ +/* Contains a description of a buffer, or area thereof*/ typedef struct { - // Variable: gcb - // The main control block + /* Variable: gcb*/ + /* The main control block*/ udi_cb_t gcb; udi_ubit32_t buffer_index; udi_ubit32_t x; @@ -735,58 +734,58 @@ typedef struct { udi_buf_t * buffer; } udi_gfx_buffer_cb_t; -// Function: udi_gfx_buffer_write_req_op_t -// function pointer prototype for writing raw hardware buffers -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_buffer_write_req_op_t*/ +/* function pointer prototype for writing raw hardware buffers*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_buffer_write_req_op_t (udi_gfx_buffer_cb_t *cb); udi_gfx_buffer_write_req_op_t udi_gfx_buffer_write_req; -// Function: udi_gfx_buffer_write_req_op_t -// function pointer prototype for reading raw hardware buffers -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_buffer_write_req_op_t*/ +/* function pointer prototype for reading raw hardware buffers*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_buffer_read_req_op_t (udi_gfx_buffer_cb_t *cb); udi_gfx_buffer_read_req_op_t udi_gfx_buffer_read_req; -// Function: udi_gfx_buffer_write_ack_op_t -// function pointer prototype for writing raw hardware buffers -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_buffer_write_ack_op_t*/ +/* function pointer prototype for writing raw hardware buffers*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_buffer_write_ack_op_t (udi_gfx_buffer_cb_t *cb); udi_gfx_buffer_write_ack_op_t udi_gfx_buffer_write_ack; -// Function: udi_gfx_buffer_write_ack_op_t -// function pointer prototype for reading raw hardware buffers -// -// in: -// cb - A pointer to a -// +/* Function: udi_gfx_buffer_write_ack_op_t*/ +/* function pointer prototype for reading raw hardware buffers*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ typedef void udi_gfx_buffer_read_ack_op_t (udi_gfx_buffer_cb_t *cb); udi_gfx_buffer_read_ack_op_t udi_gfx_buffer_read_ack; -// Function: udi_gfx_buffer_write_nak_op_t -// error handling for buffer writes -// -// in: -// cb - A pointer to a -// -typedef void udi_gfx_buffer_write_nak_op_t (udi_gfx_buffer_cb_t *cb, udi_ubit32_t status); +/* Function: udi_gfx_buffer_write_nak_op_t*/ +/* error handling for buffer writes*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ +typedef void udi_gfx_buffer_write_nak_op_t (udi_gfx_buffer_cb_t *cb, udi_status_t status); udi_gfx_buffer_write_nak_op_t udi_gfx_buffer_write_nak; -// Function: udi_gfx_buffer_write_nak_op_t -// error handling for buffer reads -// -// in: -// cb - A pointer to a -// -typedef void udi_gfx_buffer_read_nak_op_t (udi_gfx_buffer_cb_t *cb, udi_ubit32_t status); +/* Function: udi_gfx_buffer_write_nak_op_t*/ +/* error handling for buffer reads*/ +/* */ +/* in:*/ +/* cb - A pointer to a */ +/**/ +typedef void udi_gfx_buffer_read_nak_op_t (udi_gfx_buffer_cb_t *cb, udi_status_t status); udi_gfx_buffer_read_nak_op_t udi_gfx_buffer_read_nak; /* Structure: udi_gfx_provider_ops_t @@ -803,12 +802,12 @@ typedef const struct { udi_gfx_get_engine_req_op_t *gfx_get_engine_req_op; udi_gfx_range_connector_req_op_t *gfx_range_connector_req_op; udi_gfx_range_engine_req_op_t *gfx_range_engine_req_op; - udi_gfx_get_engine_operator_req_op_t*gfx_get_engine_operator_req_op_t; - udi_gfx_connector_command_req_op_t *gfx_connector_command_op; - udi_gfx_engine_command_req_op_t *gfx_engine_command_op; - udi_gfx_buffer_info_req_op_t *gfx_buffer_info_ack; - udi_gfx_buffer_read_req_op_t *gfx_buffer_read_ack; - udi_gfx_buffer_write_req_op_t *gfx_buffer_write_ack; + udi_gfx_get_engine_operator_req_op_t*gfx_get_engine_operator_req_op; + udi_gfx_connector_command_req_op_t *gfx_connector_command_req_op; + udi_gfx_engine_command_req_op_t *gfx_engine_command_req_op; + udi_gfx_buffer_info_req_op_t *gfx_buffer_info_req_op; + udi_gfx_buffer_read_req_op_t *gfx_buffer_read_req_op; + udi_gfx_buffer_write_req_op_t *gfx_buffer_write_req_op; } udi_gfx_provider_ops_t; /* Structure: udi_gfx_client_ops_t @@ -817,28 +816,28 @@ typedef const struct { */ typedef const struct { udi_channel_event_ind_op_t *channel_event_ind_op; - udi_gfx_bind_ack_op_t *udi_gfx_bind_ack; - udi_gfx_unbind_ack_op_t *udi_gfx_unbind_ack; - udi_gfx_set_connector_ack_op_t *udi_gfx_set_connector_ack; - udi_gfx_set_engine_ack_op_t *udi_gfx_set_engine_ack; - udi_gfx_set_connector_nak_op_t *udi_gfx_set_connector_nak; - udi_gfx_set_engine_nak_op_t *udi_gfx_set_engine_nak; - udi_gfx_get_connector_ack_op_t *udi_gfx_get_connector_ack; - udi_gfx_get_engine_ack_op_t *udi_gfx_get_engine_ack; - udi_gfx_range_connector_ack_op_t *udi_gfx_range_connector_ack; - udi_gfx_range_engine_ack_op_t *udi_gfx_range_engine_ack; - udi_gfx_get_engine_operator_req_op_t*udi_gfx_get_engine_operator_ack; - udi_gfx_connector_command_ack_op_t *udi_gfx_connector_command_ack; - udi_gfx_engine_command_ack_op_t *udi_gfx_engine_command_ack; - udi_gfx_buffer_info_ack_op_t *gfx_buffer_info_ack; - udi_gfx_buffer_read_ack_op_t *gfx_buffer_read_ack; - udi_gfx_buffer_write_ack_op_t *gfx_buffer_write_ack; - udi_gfx_buffer_read_nak_op_t *gfx_buffer_read_nak; - udi_gfx_buffer_write_nak_op_t *gfx_buffer_write_nak; + udi_gfx_bind_ack_op_t *gfx_bind_ack_op; + udi_gfx_unbind_ack_op_t *gfx_unbind_ack_op; + udi_gfx_set_connector_ack_op_t *gfx_set_connector_ack_op; + udi_gfx_set_engine_ack_op_t *gfx_set_engine_ack_op; + udi_gfx_set_connector_nak_op_t *gfx_set_connector_nak_op; + udi_gfx_set_engine_nak_op_t *gfx_set_engine_nak_op; + udi_gfx_get_connector_ack_op_t *gfx_get_connector_ack_op; + udi_gfx_get_engine_ack_op_t *gfx_get_engine_ack_op; + udi_gfx_range_connector_ack_op_t *gfx_range_connector_ack_op; + udi_gfx_range_engine_ack_op_t *gfx_range_engine_ack_op; + udi_gfx_get_engine_operator_req_op_t*gfx_get_engine_operator_ack_op; + udi_gfx_connector_command_ack_op_t *gfx_connector_command_ack_op; + udi_gfx_engine_command_ack_op_t *gfx_engine_command_ack_op; + udi_gfx_buffer_info_ack_op_t *gfx_buffer_info_ack_op; + udi_gfx_buffer_read_ack_op_t *gfx_buffer_read_ack_op; + udi_gfx_buffer_write_ack_op_t *gfx_buffer_write_ack_op; + udi_gfx_buffer_read_nak_op_t *gfx_buffer_read_nak_op; + udi_gfx_buffer_write_nak_op_t *gfx_buffer_write_nak_op; } udi_gfx_client_ops_t; -// temporary +/* temporary*/ #ifndef UDI_ANNOY_ME void EngineReturnSimpleRange (int source, int index, int prop, int first, int last, int modulus); void ConnectorReturnSimpleRange (int source, int index, int prop, int first, int last, int modulus);