SetNameOfInstance
In case instance does not exist it returns 1, when name cannot be updated 2.
Syntax
public const string EngineDLL = @"engine.dll";[DllImport(EngineDLL, EntryPoint = "SetNameOfInstance")] public static extern Int64 SetNameOfInstance(Int64 owlInstance, string name); [DllImport(EngineDLL, EntryPoint = "SetNameOfInstance")] public static extern Int64 SetNameOfInstance(Int64 owlInstance, byte[] 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 SetNameOfInstance can be used.
using Engine; static void Main(string[] args) { Int64 model = Engine.x86_64.CreateModel(); if (model != 0) { // // Classes // Int64 classCube = Engine.x86_64.GetClassByName(model, "Cube"); // // Datatype Properties (attributes) // Int64 propertyLength = Engine.x86_64.GetPropertyByName(model, "length"); // // Instances (creating) // Int64 myInstanceI = Engine.x86_64.CreateInstance(classCube, ""), myInstanceII = Engine.x86_64.CreateInstance(classCube, "secondInstance"); System.Diagnostics.Debug.Assert(Engine.x86_64.GetVolume(myInstanceI, (IntPtr) 0, (IntPtr) 0) == 0.0); double length = 2.0; Engine.x86_64.SetDatatypeProperty(myInstanceI, propertyLength, ref length, 1); IntPtr instanceNamePtrI = IntPtr.Zero; Engine.x86_64.GetNameOfInstance(myInstanceI, out instanceNamePtrI); string instanceNameI = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrI); length += 1.0; Engine.x86_64.SetDatatypeProperty(myInstanceII, propertyLength, ref length, 1); IntPtr instanceNamePtrII = IntPtr.Zero; Engine.x86_64.GetNameOfInstance(myInstanceII, out instanceNamePtrII); string instanceNameII = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrII); Engine.x86_64.SetNameOfInstance(myInstanceI, "firstInstance"); Engine.x86_64.SetNameOfInstance(myInstanceII, (string) null); System.Diagnostics.Debug.Assert(Engine.x86_64.GetArea(myInstanceI, (IntPtr) 0, (IntPtr) 0) == 24.0); System.Diagnostics.Debug.Assert(Engine.x86_64.GetVolume(myInstanceII, (IntPtr) 0, (IntPtr) 0) == 27.0); IntPtr instanceNamePtrIII = IntPtr.Zero; Engine.x86_64.GetNameOfInstance(myInstanceI, out instanceNamePtrIII); string instanceNameIII = System.Runtime.InteropServices.Marshal.PtrToStringAnsi(instanceNamePtrIII); IntPtr instanceNamePtrIV = IntPtr.Zero; Engine.x86_64.GetNameOfInstance(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 // Engine.x86_64.SaveModel(model, "c:\\created\\myFile.bin"); Engine.x86_64.CloseModel(model); } }