GsOT

Ordering table header

struct GsOT {
        u_short length;
        GsOT_TAG *org;
        u_short offset;
        u_short point;
        GsOT_TAG *tag;
};

Members

length Bit length of the ordering table (OT)
org Pointer to start address of GsOT_TAG table
offset OT screen coordinate system Z-axis offset
point OT screen coordinate system Z-axis typical value
tag Pointer to current GsOT_TAG

Explanation

The GsOT structure describes the header of the ordering table.
This header has pointers to the actual ordering table array, specified by the org and tag members.
These members are initialized using the GsClearOT() function.
org always points to the start of the ordering table.
tag points to the element within the ordering table at which drawing will take place.
length indicates the size of the ordering table. It is a value from 1-14 where the actual ordering table size is 2length (i.e. a value of 14 indicates an array of 16384 GsOT_TAG items, while a value of 8 indicates an array of 256 GsOT_TAG items).
org points to a GsOT_TAG array running from 0-1. If the value "14" is specified, org points to a GsOT_TAG array running from 0-16384. The GsClearOt() function initializes memory from org up through the size indicated by length. Note that memory will be destroyed if the size of the GsOT_TAG array pointed to by org is greater than that specified by length.
point is used by the GsSortOt() function in the sorting of ordering tables.
The ordering table Z-axis offset is specified by offset. For example, if offset = 256, the start of the ordering table is Z = 256. (Not yet supported.)

Notes

The length and org values should be set first. The other members are set by the GsClearOt() function.

See Also

GsClearOt(), GsDrawOt(), GsSortOt()