int aw_terrain_next (void)


aw_terrain_next returns the next node in an enumeration of all terrain nodes in a world

Callback

AW_CALLBACK_TERRAIN_NEXT_RESULT

Notes

This method is new in SDK build 24 and requires a version 3.3 or later world server.

The primary purpose of aw_terrain_next is for enumerating all terrain nodes for generating a terrain dump from the world server administration tool. SDK applications that wish to query terrain for should use aw_terrain_query instead for most purposes.

The current state of the terrain node enumeration is determined by the values of the following attributes:

AW_TERRAIN_PAGE_X
AW_TERRAIN_PAGE_Z
AW_TERRAIN_NODE_X
AW_TERRAIN_NODE_Z
AW_TERRAIN_NODE_SIZE

The node data is returned via the event AW_EVENT_TERRAIN_DATA.

See terrain for more information on manipulating terrain from the SDK.

SEE ALSO

aw_terrain_query
aw_terrain_set
aw_terrain_delete_all
aw_terrain_load_node



Active Worlds™ is a trademark of Activeworlds Inc. Questions or problems regarding this product should be posted to the newsgroup news://news.activeworlds.com/sdk. Problems with this web page should be reported to the author.

Copyright © 1998-2008 Activeworlds Inc. All rights reserved.