SetNameOfInstanceWEx
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 SetNameOfInstanceWEx( __int64 model, __int64 owlInstance, const wchar_t * name ); // Linux, OS-X and non-Visual Studio Windows solutions public: int64_t SetNameOfInstanceWEx( int64_t model, int64_t owlInstance, const wchar_t * name );
Property model
Size: 64 bit / 8 byte (value)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 SetNameOfInstanceWEx can be used.
#includeint64_t model = CreateModel(); if (model) { // // Classes // int64_t classCube = GetClassByNameW(model, L"Cube"); CreateInstanceW(classCube, nullptr); CreateInstanceW(classCube, nullptr); CreateInstanceW(classCube, nullptr); // // The following setting makes sure all instance handles are in an ordered list // In certain cases where several models are open or in case of conversion // between formats this can be handy and / or time efficient. // int64_t instanceCnt = 0; OrderedHandles(model, nullptr, nullptr, &instanceCnt, 4, 4); assert(instanceCnt == 3); // // Datatype Properties (attributes) // int64_t propertyLength = GetPropertyByNameW(model, L"length"); // // Instances (creating) // int64_t myInstanceI = CreateInstanceW(classCube, L""), myInstanceII = CreateInstanceW(classCube, L"secondInstance"); assert(myInstanceI == instanceCnt + 1); assert(myInstanceII == instanceCnt + 2); double length = 2.; SetDatatypePropertyEx(model, myInstanceI, propertyLength, &length, 1); wchar_t * instanceNameI = nullptr; GetNameOfInstanceWEx(model, myInstanceI, &instanceNameI); length += 1.; SetDatatypePropertyEx(model, myInstanceII, propertyLength, &length, 1); wchar_t * instanceNameII = nullptr; GetNameOfInstanceWEx(model, myInstanceII, &instanceNameII); // // The retrieved instance names have the following values // instanceNameI : '' // instanceNameII : 'secondInstance' // SetNameOfInstanceWEx(model, myInstanceI, L"firstInstance"); SetNameOfInstanceWEx(model, myInstanceII, nullptr); // // The retrieved instance names have the following values // instanceNameI : UNDEFINED (name is not anymore existing) // instanceNameII : UNDEFINED (name is not anymore existing) // wchar_t * instanceNameIII = nullptr; GetNameOfInstanceWEx(model, myInstanceI, &instanceNameIII); wchar_t * instanceNameIV = nullptr; GetNameOfInstanceWEx(model, 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); }