|
The loaded world will be add to the existing world
the given position indicates where the origin (note that the origin is 0,0,0 and not the center of the world)
of the added world will be located
returns a handle to the group that encapsulates the added world
if an error occurred it will return NULL
It is important to check the return value
Note that usually you will call STATE_group_set_location(added_world_grp, center_position);
after calling STATE_engine_add_world() to move the center of the added world
to its place. Not calling STATE_group_set_location() will put the origin
of the added world in the location as given by the position argument. Note that this is different from moving the center of the world to
the given position
The function is relevant only for EDITOR_MODE. For VIEWER_MODE (the default mode)
use STATE_object_create_from_file() instead.
|