Regular API function
simAnnounceSceneContentChange / sim.announceSceneContentChange
Description
|
Announces a change in the scene. This is required for the undo/redo function to operate properly when performing changes via the API. Only call this function directly after a change was made through a dialog element (e.g. a checkbox was checked/unchecked) and that change was reported to the scene (e.g. with sim.writeCustomDataBlock). What this call will do is following: the whole scene will be serialized (saved) to memory as a "scene image" and compared to a previously memorized "scene image". If both images are same, then the last image is discarded, otherwise only the changes between the two images are memorized. A call to this function has no effect (and doesn't generate any error) when called during simulation or when in edit mode. |
C/C++ synopsis
|
simInt simAnnounceSceneContentChange()
|
C/C++ parameters |
|
C/C++ return value
|
-1 if operation was not successful, 0 if nothing was memorized, or 1 if changes were memorized.
|
Lua synopsis
|
int result=sim.announceSceneContentChange() |
Lua parameters |
|
Lua return values
|
Same as C function |
Python synopsis |
int result=sim.announceSceneContentChange() |
|