Unigine::Properties Class

Unigine properties. This interface provides access to Unigine property manager functions.

To use this class, include the UnigineProperties.h file.

Unigine::Properties Class

Members

---

virtual ~Properties ()

Virtual destructor.

static Properties * get ()

Return a pointer to the existing property manager.

Return value

Pointer to the existing property manager.

virtual int create (const char * name) const =0

Creates an empty property library.

Arguments

• const char * name - Property library name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int load (const char * name) const =0

Loads the property library from the file.

Arguments

• const char * name - Property library name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int save (const char * name) const =0

Saves the property library into the file.

Arguments

• const char * name - Property library name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int clear (const char * name) const =0

Clears the property library by its name.

Arguments

• const char * name - Property library name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int getNumLibraries () const =0

Returns the number of loaded property libraries.

Return value

The number of loaded property libraries.

virtual const char * getLibraryName (int num) const =0

Returns the property library name.

Arguments

• int num - Property library number.

Return value

The name of property library.

virtual int isLibraryEditable (int num) const =0

Returns the property library editable flag.

Arguments

• int num - Property library number.

Return value

The editable flag.

virtual int isLibrary (const char * name) const =0

Checks the property library by its name.

Arguments

• const char * name - Property library name.

Return value

Returns 1 if the property library is loaded; otherwise, 0 is returned.

virtual int findLibrary (const char * name) const =0

Finds the property library by its name.

Arguments

• const char * name - Property library name.

Return value

Property library number.

virtual int getNumProperties (int library) const =0

Returns the number of library properties.

Arguments

• int library - Library number.

Return value

The number of library properties.

virtual PropertyPtr getProperty (int library, int num) const =0

Returns the property.

Arguments

• int library - Library number.
• int num - Property number.

Return value

Property smart pointer.

virtual const char * getPropertyName (int library, int num) const =0

Returns the property name.

Arguments

• int library - Library number.
• int num - Property number.

Return value

The name of property.

virtual int isProperty (const char * name) const =0

Checks the property by its name.

Arguments

• const char * name - Property name.

Return value

Returns 1 if the property is loaded; otherwise, 0 is returned.

virtual PropertyPtr findProperty (const char * name) const =0

Finds the property by its name.

Arguments

• const char * name - Property name.

Return value

Property smart pointer.

virtual int findPropertyLibrary (const char * name) const =0

Finds the property library by property name.

Arguments

• const char * name - Property name.

Return value

Property library number.

virtual int findPropertyLibrary (const PropertyPtr & property) const =0

Finds the property library by property name.

Arguments

• const PropertyPtr & property - Property smart pointer.

Return value

Property library number.

virtual int findLibraryProperty (int library, const char * name) const =0

Finds the property in the specified property library.

Arguments

• int library - Library number.
• const char * name - Property name.

Return value

Property number.

virtual int findLibraryProperty (int library, const PropertyPtr & property) const =0

Finds the property in the specified property library.

Arguments

• int library - Library number.
• const PropertyPtr & property - Property smart pointer.

Return value

Property number.

virtual int cloneProperty (const char * name, const char * new_library, const char * new_name) const =0

Clones property into the specified property library.

Arguments

• const char * name - Property name.
• const char * new_library - New property library name.
• const char * new_name - New property name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int inheritProperty (const char * name, const char * new_library, const char * new_name) const =0

Inherits property into the specified property library.

Arguments

• const char * name - Property name.
• const char * new_library - New property library name.
• const char * new_name - New property name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int moveProperty (const char * name, const char * new_library, const char * new_name) const =0

Moves property into the specified property library.

Arguments

• const char * name - Property name.
• const char * new_library - New property library name.
• const char * new_name - New property name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.

virtual int removeProperty (const char * name) const =0

Remove property by its name.

Arguments

• const char * name - Property name.

Return value

Returns 1 if the operation was a success; otherwise, 0 is returned.