Create3DComponent

Creates a 3D component.

UI Access

Draw > 3D Component Library > Create 3D Component.

Parameters

Name	Type	Description
<CreateData>	Array	Structured array containing geometry data: (Array["NAME:CreateData", "ComponentName:=", "<string>", "Company:=", "<string>", "Company URL:=", "<string>", "Model Number:=","<string>", "Help URL:=" , "<string>", "Version:=", "<string>", "Notes:=", "<string>", "IconType:=","<string>", "Owner:=", "<string>", "Email:=", "<string>", "Date:=", "<string>", #Component creation date "HasLabel:=", <boolean>, "IsEncrypted:=", <boolean>, "AllowEdit:=", <boolean>, "SecurityMessage:=" , "<string>", "Password:=" , "<string>", "EditPassword:=" , "<string>", "PasswordType:=" , "<string>", "HideContents:=" , <boolean>, "ReplaceNames:=" , <boolean>, #for objects and materials "ComponentOutline:=" , "<string>",#"None" or "Bounding Box" "IncludedParts:=" , [Array of partnames], "HiddenParts:=" , [Array of hidden parts], "IncludedCS:=" , [Array of included CS], "DefaultHandle:=" , "<reference CS>" "IncludedParameters:=" , [Array of included parameters], "IncludedDependentParameters:=", [Array of dependent parameters], "ParameterDescription:=", <array> "IsLicensed:=" , <boolean> "LicensingDllName:=" , "<string>" "VendorComponentIdentifier:=", "<string>" "PublicKeyFile:=" , "<string>" ]
<DesignData>	Array	Structured array containing design data: Array["NAME:DesignData", "Boundaries:=", <array>, "Excitations:=", <array>, "MeshOperations:=", <array>]
<FileName>	String	Full file path to 3D component.
<ImageFile>	Array	Optional. Structured array containing file path of 3D component image: Array["NAME:ImageFile", "ImageFile:=", <string>])

Return Value

None.

Python Syntax

Create3DComponent(<CreateData>, <DesignData>, <FileName>, <ImageFile>)

Python Example

oEditor.Create3DComponent(
[
"NAME:CreateData",
"ComponentName:=", "Connector", 
"Company:=", "", 
"Company URL:=" , ""
"Version:=", "1.0",
"Notes:=", "",  
"Owner:=", "", 
"IconType:=" , "",
"Email:=", "", 
"Date:=", "11:41:01 AM Aug 28, 2024", 
"HasLabel:=", false, 
"IsEncrypted:="     , False,
"AllowEdit:="       , False,
"SecurityMessage:=" , "",
"Password:="        , "",
"EditPassword:="    , "",
"PasswordType:="    , "UnknownPassword",
"HideContents:="    , True,
"ReplaceNames:="    , True,
"ComponentOutline:="    , "None",
"IncludedParts:=", ["Box1", "Cylinder1", "Cone1"], 
"IncludedCS:=", ["RelativeCS1"], 
"DefaultHandle:=", "Global", 
"IncludedParameters:=", ["htcone", "lr", "htcyl", "zs", "radcyl", "xs", "$rp", "$con"], 
"IncludedDependentParameters:=", [],
"ParameterDescription:=", [], 
"IsLicensed:="		, False,
"LicensingDllName:="	, "",
"VendorComponentIdentifier:=", "",
"PublicKeyFile:="	, ""
],
[
"NAME:DesignData", 
"Boundaries:=", ["PerfE1", "FiniteCond1"], 
"Excitations:=", ["1"], 
"MeshOperations:=", []
],  
"C:/tmp/Connector.a3dcomp", 
[
"NAME:ImageFile", "ImageFile:=", ""
])

Example with an External Circuit:

oDesign = oProject.SetActiveDesign("Maxwell3DDesign1")

oEditor = oDesign.SetActiveEditor("3D Modeler")

oEditor.Create3DComponent(

[

"NAME:CreateData",

"ComponentName:=" , "Maxwell3DDesign1",

"Company:=" , "",

"Company URL:=" , "",

"Model Number:=" , "",

"Help URL:=" , "",

"Version:=" , "1.0",

"Notes:=" , "",

"IconType:=" , "",

"Owner:=" , "",

"Email:=" , "",

"Date:=" , "3:36:11 PM Feb 14, 2025",

"HasLabel:=" , False,

"IsEncrypted:=" , False,

"AllowEdit:=" , False,

"SecurityMessage:=" , "",

"Password:=" , "",

"EditPassword:=" , "",

"PasswordType:=" , "UnknownPassword",

"HideContents:=" , True,

"ReplaceNames:=" , True,

"ComponentOutline:=" , "None",

"IncludedParts:=" , ["Box1"],

"HiddenParts:=" , [],

"IncludedCS:=" , [],

"DefaultHandle:=" , "Global",

"IncludedParameters:=" , [],

"IncludedDependentParameters:=", [],

"ParameterDescription:=", [],

"IsLicensed:=" , False,

"LicensingDllName:=" , "",

"VendorComponentIdentifier:=", "",

"PublicKeyFile:=" , ""

[

"NAME:DesignData",

"Excitations:=" , ["CoilTerminal1","CoilTerminal2","Winding1","External Circuit”]

"F:/Designs/ComponentExternalCircuit/test.a3dcomp",

[

"NAME:ImageFile",

"ImageFile:=" , ""

])