Aw terrain load node

From ActiveWiki
Revision as of 10:25, 27 October 2008 by Macavity (talk | contribs) (New reason code)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Minimum requirements
Added in version 3.3
SDKbuild 24


int aw_terrain_load_node (void)

Description

Uploads a single node of terrain data to a world.

Callback

AW_CALLBACK_TERRAIN_LOAD_NODE_RESULT

Notes

The primary purpose of this method is to upload bulk terrain data dumps from the world server administration tool. SDK applications that wish to upload or modify terrain should use the aw_terrain_set method instead.

For version 4.1 and later: It is not needed to set AW_TERRAIN_VERSION_NEEDED for this method, as world server build 73 or later will automatically do the data conversion to version 2.

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

Arguments

None

Argument attributes

AW_TERRAIN_PAGE_X
AW_TERRAIN_PAGE_Z
AW_TERRAIN_NODE_X
AW_TERRAIN_NODE_Z
AW_TERRAIN_NODE_SIZE
AW_TERRAIN_NODE_HEIGHT_COUNT
AW_TERRAIN_NODE_HEIGHTS
AW_TERRAIN_NODE_TEXTURE_COUNT
AW_TERRAIN_NODE_TEXTURES

Return values

RC_SUCCESS
RC_NOT_INITIALIZED
RC_NO_INSTANCE
RC_NO_CONNECTION
The connection to the world is down.
RC_UNAUTHORIZED
Only world server administration instances or those owned by a caretaker (i.e. aw_bool (AW_WORLD_CARETAKER_CAPABILITY) returns 1) may use this method.
RC_UNABLE_TO_UPDATE_TERRAIN
The terrain's stride value is invalid.
RC_DATABASE_ERROR

Returned attributes

None

See also