AW_EVENT_CELL_BEGIN

DESCRIPTION

Indicates the beginning of a cell update.

NOTES

This event is triggered only in response to a call to aw_query. This event will be followed by zero or more AW_EVENT_CELL_OBJECT events and one AW_EVENT_CELL_END event.

The following attributes are valid during the context of this event:

AW_CELL_X
AW_CELL_Z
AW_CELL_SEQUENCE
AW_CELL_SIZE

AW_CELL_X and AW_CELL_Z specify the coordinates of the cell that is being updated.   AW_CELL_SEQUENCE is the sequence number for this cell.  The sequence number for the last cell in a sector is the new sequence number for that sector.   AW_CELL_SIZE is the size in bytes of the entire cell update message (note: this is not necessarily the same as the size of the cell data as it relates to the world's current cell data limit.)

See Property for a description of the property query mechanism.

EXAMPLE

See Sample Program #2 for a complete example.

SEE ALSO

aw_query
aw_sector_from_cell
AW_EVENT_CELL_OBJECT
AW_EVENT_CELL_END