Instance Header API Calls
File IO API Calls
Schema Reading API Calls
Instance Reading API Calls
Instance Writing API Calls
Controling API Calls
Uncategorized API Calls
Geometry Kernel related API Calls
Deprecated API Calls (GENERIC)
Validation
Deprecated API Calls (GEOMETRY)

sdaiCreateInstanceBN

This call creates an instance of the given entity. Technically it will transform into the following call

    sdaiCreateInstance(
            model,
            sdaiGetEntity(
                    model,
                    entityName
                )
        );

Syntax

C++ 32 bit
C++ 64 bit
C# 32 bit
C# 64 bit
public const string ifcenginedll = @"ifcengine.dll";

[DllImport(IFCEngineDLL, EntryPoint = "sdaiCreateInstanceBN")]
public static extern Int32 sdaiCreateInstanceBN(int_t model, string entityName);

[DllImport(IFCEngineDLL, EntryPoint = "sdaiCreateInstanceBN")]
public static extern Int32 sdaiCreateInstanceBN(int_t model, byte[] entityName);

Property model

Size: 32 bit / 4 byte (value)
The handle to the model. The model handle is static during its existance. Several models can be opened simultaniously within one session. Different models are always independent, threads are allowed to be running on different models simultaniously.

Property entityName

Size: 32 bit / 4 byte (reference)
...

Example (based on pure API calls)

Here you can find code snippits that show how the API call sdaiCreateInstanceBN can be used.

C++ 32 bit
C++ 64 bit
C# 32 bit
C# 64 bit
using RDF;      //  include at least engine.cs within your solution

//
//  Created result when stored as IFC:
//  #31313 = IFCPOSTALADDRESS($, $, $, $, ('RDF Ltd.', 'Main Office'), '32', 'Bankya', 'Sofia', '1320', 'Bulgaria');
//
Int64 ifcPostalAddressInstance = ifcengine.sdaiCreateInstanceBN(model, "IFCPOSTALADDRESS");

Int64 addressLines = ifcengine.sdaiCreateAggrBN(ifcPostalAddressInstance, "AddressLines");
ifcengine.sdaiAppend(addressLines, ifcengine.sdaiSTRING, "RDF Ltd.");
ifcengine.sdaiAppend(addressLines, ifcengine.sdaiSTRING, "Main Office");

ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "PostalBox", ifcengine.sdaiSTRING, "32");
ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Town", ifcengine.sdaiSTRING, "Bankya");
ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Region", ifcengine.sdaiSTRING, "Sofia");      //  It is allowed to mix sdaiUNICODE and sdaiSTRING
ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "PostalCode", ifcengine.sdaiUNICODE, "1320");  //  as long as each call is consitent in itself.
ifcengine.sdaiPutAttrBN(ifcPostalAddressInstance, "Country", ifcengine.sdaiSTRING, "Bulgaria");