simGetExtensionString

Retrieves a string that describes additional environment or object properties, mainly used by extension plugins.

C++ synopsis

char* simGetExtensionString(int objectHandle, int index, const char* key)

Arguments

• objectHandle: the handle of an object, or -1 if you wish to retrieve the extension string of the environment.
• index: keep to -1, unless the object is a shape, and you wish to retrieve the extension string of a shape component (since a shape can be a compound of several other shapes).
• key: an optional key indicating what value to retrieve. If none is specified, then the whole extension string will be returned. Keys should have the form of key@parentKey@...@parentKey. To retrieve the shadow enabled value of extension string "povray{ shadow {true} fadeXDist {0.00}}", specify following key: shadow@povray. The key is case sensitive.

Return

• a string if the operation was successful. The user is in charge of releasing the buffer with simReleaseBuffer.