SetNameOfInstanceEx
Error return codes:
0 successful
1 argument model or owlInstance is incorrect (not a proper handle to an active instance)
2 argument name is incorrect (nullptr or zero length name)
3 the name of instance is locked
4 name is already used by another class
5 name is already used by a property
6 name is already used by an instance
7 undefined error
This call has the same behavior as SetNameOfInstance, however needs to be
used in case instance are exchanged as a successive series of integers.
Syntax
public const string enginedll = @"engine.dll"; [DllImport(enginedll, EntryPoint = "SetNameOfInstanceEx")] public static extern Int64 SetNameOfInstanceEx(Int64 model, Int64 owlInstance, string name); [DllImport(enginedll, EntryPoint = "SetNameOfInstanceEx")] public static extern Int64 SetNameOfInstanceEx(Int64 model, Int64 owlInstance, byte[] name);
Property model
Size: 64 bit / 8 byte (value)Property owlInstance
Size: 64 bit / 8 byte (value)Property name
Size: 32 bit / 4 byte (reference)
Example (based on pure API calls)
Here you can find code snippits that show how the API call SetNameOfInstanceEx can be used.
using RDF; // include at least engine.cs within your solution static void Main(string[] args) { Int64 model = RDF.engine.CreateModel(); if (model != 0) { // // Classes // Int64 classCube = RDF.engine.GetClassByName(model, "Cube"); RDF.engine.CreateInstance(classCube, (string) null); RDF.engine.CreateInstance(classCube, (string) null); RDF.engine.CreateInstance(classCube, (string) null); // // 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 instanceCnt = 0; RDF.engine.OrderedHandles(model, (IntPtr) 0, (IntPtr) 0, out instanceCnt, 4, 4); System.Diagnostics.Debug.Assert(instanceCnt == 3); // // Datatype Properties (attributes) // Int64 propertyLength = RDF.engine.GetPropertyByName(model, "length"); // // Instances (creating) // Int64 myInstanceI = RDF.engine.CreateInstance(classCube, ""), myInstanceII = RDF.engine.CreateInstance(classCube, "secondInstance"); System.Diagnostics.Debug.Assert(myInstanceI == instanceCnt + 1); System.Diagnostics.Debug.Assert(myInstanceII == instanceCnt + 2); double length = 2.0; RDF.engine.SetDatatypePropertyEx(model, myInstanceI, propertyLength, ref length, 1); IntPtr instanceNamePtrI = IntPtr.Zero; RDF.engine.GetNameOfInstanceEx(model, myInstanceI, out instanceNamePtrI); string instanceNameI = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrI); length += 1.0; RDF.engine.SetDatatypePropertyEx(model, myInstanceII, propertyLength, ref length, 1); IntPtr instanceNamePtrII = IntPtr.Zero; RDF.engine.GetNameOfInstanceEx(model, myInstanceII, out instanceNamePtrII); string instanceNameII = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrII); RDF.engine.SetNameOfInstanceEx(model, myInstanceI, "firstInstance"); RDF.engine.SetNameOfInstanceEx(model, myInstanceII, (string) null); IntPtr instanceNamePtrIII = IntPtr.Zero; RDF.engine.GetNameOfInstanceEx(model, myInstanceI, out instanceNamePtrIII); string instanceNameIII = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrIII); IntPtr instanceNamePtrIV = IntPtr.Zero; RDF.engine.GetNameOfInstanceEx(model, myInstanceII, out instanceNamePtrIV); string instanceNameIV = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrIV); // // The retrieved instance names have the following values // instanceNameI : '' // instanceNameII : 'secondInstance' // instanceNameIII : 'firstInstance' // instanceNameIV : null // // // The resulting model can be viewed in 3D-Editor.exe // RDF.engine.SaveModel(model, "c:\\created\\myFile.bin"); RDF.engine.CloseModel(model); } }