* <Public Domain>
*
* 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__
* Lists the various UDI properties
*/
-// General state properties
+/* General state properties*/
/* Constant: UDI_GFX_PROP_ENABLE
*
* Valid values:
*/
#define UDI_GFX_PROP_CUSTOM 1024
-// engine properties
+/* engine properties*/
/* Constant: UDI_GFX_PROP_CLIP
*
*/
#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
/**
* 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
#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 <udi_block_bind_cb_t>
-//
+/* Function: udi_block_bind_req*/
+/* function pointer prototype for connecting to a block device*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_block_bind_cb_t>*/
+/**/
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 <udi_gfx_bind_cb_t>
-// 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 <udi_gfx_bind_cb_t>*/
+/* 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 <udi_block_bind_cb_t>
-//
+/* Function: udi_gfx_unbind_req*/
+/* function pointer prototype for disconnecting a block device*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_block_bind_cb_t>*/
+/**/
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 <udi_gfx_bind_cb_t>
-//
+/* Function: udi_gfx_unbind_ack*/
+/* function pointer prototype for connecting to a block device*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_bind_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_set_engine_req*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_set_connector_req*/
+/* function pointer prototype for setting an connector state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_set_engine_ack*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_set_connector_ack*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_get_engine_req*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_get_connector_req*/
+/* function pointer prototype for setting an connector state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_get_engine_ack*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_get_connector_ack*/
+/* function pointer prototype for setting an engine state*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-// 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 <udi_gfx_state_cb_t>*/
+/* 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 <udi_gfx_state_cb_t>
-// 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 <udi_gfx_state_cb_t>*/
+/* 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;
} 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 <udi_gfx_range_cb_t>
-//
+/* Function: udi_gfx_range_engine_req*/
+/* function pointer prototype for getting an engine property range*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_range_cb_t>*/
+/**/
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 <udi_gfx_range_cb_t>
-//
+/* Function: udi_gfx_range_connector_req*/
+/* function pointer prototype for getting a connector property range*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_range_cb_t>*/
+/**/
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 <udi_gfx_range_cb_t>
-//
+/* Function: udi_gfx_range_engine_ack*/
+/* function pointer prototype for replying an engine property range*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_range_cb_t>*/
+/**/
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 <udi_gfx_range_cb_t>
-//
+/* Function: udi_gfx_range_connector_ack*/
+/* function pointer prototype for replying a connector property range*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_range_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-//
+/* Function: udi_gfx_get_engine_operator_req*/
+/* function pointer prototype for requesting the engine operator layout*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_state_cb_t>*/
+/**/
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 <udi_gfx_state_cb_t>
-// 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 <udi_gfx_state_cb_t>*/
+/* 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 <udi_gfx_command_cb_t>
-//
+/* Function: udi_gfx_connector_command_req*/
+/* function pointer prototype for sending command data to the output connector*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_command_cb_t>*/
+/**/
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 <udi_gfx_command_cb_t>
-//
+/* Function: udi_gfx_engine_command_req*/
+/* function pointer prototype for sending command data to the engine*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_command_cb_t>*/
+/**/
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 <udi_gfx_command_cb_t>
-//
+/* Function: udi_gfx_connector_command_ack*/
+/* function pointer prototype for sending command data replies*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_command_cb_t>*/
+/**/
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 <udi_gfx_command_cb_t>
-//
+/* Function: udi_gfx_engine_command_ack*/
+/* function pointer prototype for sending engine data replies*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_command_cb_t>*/
+/**/
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 <udi_gfx_command_cb_t>
-//
+/* Function: udi_gfx_buffer_info_req*/
+/* function pointer prototype for getting buffer configuration information*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_command_cb_t>*/
+/**/
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 <udi_gfx_command_cb_t>
-// 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 <UDI_GFX_BUFFER_FLAGS> 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 <udi_gfx_command_cb_t>*/
+/* 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 <UDI_GFX_BUFFER_FLAGS> 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;
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 <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 <udi_gfx_buffer_cb_t>*/
+/**/
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 <udi_gfx_buffer_cb_t>
-//
+/* Function: udi_gfx_buffer_write_req_op_t*/
+/* function pointer prototype for reading raw hardware buffers*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_buffer_cb_t>*/
+/**/
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 <udi_gfx_buffer_cb_t>
-//
+/* Function: udi_gfx_buffer_write_ack_op_t*/
+/* function pointer prototype for writing raw hardware buffers*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_buffer_cb_t>*/
+/**/
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 <udi_gfx_buffer_cb_t>
-//
+/* Function: udi_gfx_buffer_write_ack_op_t*/
+/* function pointer prototype for reading raw hardware buffers*/
+/* */
+/* in:*/
+/* cb - A pointer to a <udi_gfx_buffer_cb_t>*/
+/**/
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 <udi_gfx_buffer_cb_t>
-//
-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 <udi_gfx_buffer_cb_t>*/
+/**/
+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 <udi_gfx_buffer_cb_t>
-//
-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 <udi_gfx_buffer_cb_t>*/
+/**/
+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
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
*/
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);