SetNameOfInstanceW
In case instance does not exist it returns 1, when name cannot be updated 2.
Syntax
// Visual Studio for Windows public: __int64 __declspec(dllexport) __stdcall SetNameOfInstanceW( __int64 owlInstance, const wchar_t * name ); // Linux, OS-X and non-Visual Studio Windows solutions public: int64_t SetNameOfInstanceW( int64_t owlInstance, const wchar_t * name );
Property owlInstance
Size: 64 bit / 8 byte (value)Property name
Size: 64 bit / 8 byte (reference)
Example
Here you can find code snippits that show how the API call SetNameOfInstanceW can be used.
#includeint64_t model = CreateModel(); if (model) { // // Classes // int64_t classCube = GetClassByNameW(model, L"Cube"); // // Datatype Properties (attributes) // int64_t propertyLength = GetPropertyByNameW(model, L"length"); // // Instances (creating) // int64_t myInstanceI = CreateInstanceW(classCube, L""), myInstanceII = CreateInstanceW(classCube, L"secondInstance"); assert(GetVolume(myInstanceI, 0, 0) == 0.); double length = 2.; SetDatatypeProperty(myInstanceI, propertyLength, &length, 1); wchar_t * instanceNameI = nullptr; GetNameOfInstanceW(myInstanceI, &instanceNameI); length += 1.; SetDatatypePropertyW(myInstanceII, propertyLength, &length, 1); wchar_t * instanceNameII = nullptr; GetNameOfInstanceW(myInstanceII, &instanceNameII); // // The retrieved instance names have the following values // instanceNameI : '' // instanceNameII : 'secondInstance' // SetNameOfInstanceW(myInstanceI, L"firstInstance"); SetNameOfInstanceW(myInstanceII, nullptr); // // The retrieved instance names have the following values // instanceNameI : UNDEFINED (name is not anymore existing) // instanceNameII : UNDEFINED (name is not anymore existing) // assert(GetArea(myInstanceI, 0, 0) == 24.); assert(GetVolume(myInstanceII, 0, 0) == 27.); wchar_t * instanceNameIII = nullptr; GetNameOfInstanceW(myInstanceI, &instanceNameIII); wchar_t * instanceNameIV = nullptr; GetNameOfInstanceW(myInstanceII, &instanceNameIV); // // The retrieved instance names have the following values // instanceNameI : UNDEFINED (name is not anymore existing) // instanceNameII : UNDEFINED (name is not anymore existing) // instanceNameIII : 'firstInstance' // instanceNameIV : nullptr // // // The resulting model can be viewed in 3D-Editor.exe // SaveModelW(model, L"c:\\created\\myFile.bin"); CloseModel(model); }