AddObject ("3D Line") (Layout Editor)

Adds a 3D line to the active design.

UI Access From the Layout ribbon, select Draw 3D line.
Parameters
Name Type Description
<ObjectType> String Type of object to add (i.e., must have the value "3D Line").
<Parameters> Array Structured array containing these parameters in order:
  • <NAME:Contents>
  • <3D LineGeometry>
<NAME:Contents> String Identifies the contents of the array (i.e., "Contents").
<3D LineGeometry> Array Structured array containing these parameters in order:
  • <Name>
  • <LayerName>
  • <lw>
  • <gm>
<Name> String Name of the new object.

<LayerName>

String

Name of the target layer.

<lw>

Integer

Line width of the new object.

<gm>

Array

 Structured array containing these parameters in order:
  • <m>
  • <pnt>
<m> Integer

"Placement Mode" - species one of the following:

0 3D - points are placed according to user-specified XYZ coordinates.
1 Top - points are placed on top of the target layer.
2 Middle - points are placed in the middle of the target layer.
3 Bottom - points are placed on bottom of the target layer.
<pnt> Array Structured array containing these parameters in order:
  • <lid>
  • <pos>

<lid>

Integer

 Identifies the layer identification number on which the 3D line's position will be affixed (e.g., "2").

<pos>

Array

 Structured array containing these parameters in order:
  • <X>
  • <Y>
  • <Z>

<X>

 Integer X coordinate of the new object (e.g., -0.08mm).

<Y>

 Integer X coordinate of the new object (e.g., 0.03mm).

<Z>

 Integer Y coordinate of the new object (e.g., 0mm).
Return Value Returns the name of the new 3D line.

 

Python Syntax AddObject(<ObjectType>, [<Parameters>])
Python Example

oEditor.AddObject("3D Line",

[

"NAME:Contents",

"3D LineGeometry:=",

[

"Name:=", "3D Line_12904",

"LayerName:=", "Postprocessing",

"lw:=" , "0",

"gm:=",

[

"m:=", 1,

"pnt:=", [ "lid:=", 2, "pos:=", [ "X:=", "-0.08mm", "Y:=", "0.03mm", "Z:=", "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" ,[ "X:=" , "-0.07mm", "Y:=" , "0.03mm", "Z:=" , "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" , [ "X:=" , "-0.07mm", "Y:=" , "0.021mm", "Z:=" , "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" , [ "X:=" , "-0.08mm", "Y:=" , "0.02mm", "Z:=" , "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" , [ "X:=" , "-0.08mm", "Y:=" , "0.03mm", "Z:=" , "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" , [ "X:=" , "-0.08mm", "Y:=" , "0.03mm", "Z:=" , "0"]],

"pnt:=" , [ "lid:=" , 2, "pos:=" , [ "X:=" , "-0.08mm", "Y:=" , "0.03mm", "Z:=" , "0"]]

]

]

])