CreateTrace (Layout Editor)

Use: Create a trace with a manually specified path between pins, ports, or selected edges.

Command: Draw > Route > Manual

Syntax: CreateTrace

Array("NAME:options", "Layer1:=", <"layer">, "Layer2:=", <"layer">),

Array("NAME:Lines", "Num:=", <n_lines>, "l0:=",

Array("Name:=", <"line">, "LayerName:=", <"layer">, "lw:=", <"width">,

"endstyle:=", <endstyle>, "joinstyle:=", <joinstyle>, "n:=", <n_vertex>,

"U:=", <"units">, "x:=", <value>, "y:=", <value>, ), …),

Array("NAME:Vias", "Num:=", <n_vias>,

Array("NAME:v1", "name:=", <"via">, "ReferencedPadstack:=", <"padstack">,

"vposition:=", Array("x:=", <"vertex">, "y:=", <"vertex">), "vrotation:=",

Array(<"angle">), "overrides hole:=", <override>, "hole diameter:=",

Array(<"diameter">), "highest_layer:=", <"layer">, "lowest_layer:=", <"layer">), …),

Array("NAME:elements", <"port">, …),

Array("NAME:EdgeRefs", "edge:=", Array(<edge description>), …)

Return Value: None

Parameters: <"layer">

Type: text

Description: layer name

 

<n_lines>

Type: integer

Description: number of line definitions following

 

<"line">

Type: text

Description: line name

 

<"width">

Type: text

Description: line width; value with units, e.g. "1mm"

 

<endstyle>

Type: integer

Description: end (cap) style value for the line.

 

<joinstyle>

Type: integer

Description: join style value.

 

<n_vertex>

Type: integer

Description: number of vertices in the line

 

<value>

Type: double

Description: simple value, e.g. 10

 

<n_vias>

Type: integer

Description: number of via defintions following

 

<"via">

Type: text

Description: via name

 

<"padstack">

Type: text

Description: padstack defintion name.

 

<"angle">

Type: text

Description: via orientation; value with units, e.g. "180deg"

 

<override>

Type: boolean (true or false)

Description: if true, the diameter is used to override the via hole definition.

 

<"diameter">

Type: text

Description: via hole diameter override; a value with units, e.g. "1mm"

 

<"port">

Type: text

Description: a port or pin name.

 

<edge description>

for primitive edges

"et:=", "pe", "prim:=", <"prim">, "edge:=", <edge#>

 

<"prim">

Type: text

Description: primitive name

 

<edge#>

Type: integer

Description: edge number on the primitive

 

<edge description>

for via edges

"et:=", "pse", "sel:=", <"via">, "layer:=", <layer id>,

"sx:=", <start X location>, "sy:=", <start Y location>, "ex:=", <end X location>,

"ey:=", <end Y location>, "h:=", <arc height>, "rad:=", <radians>

 

<"via">:

text that is the name of the via to use

<layer id>:

an integer that is the id of the layer of the pad of the via to use

 

<start X location>, <start Y Location>:

   doubles that are the X, Y location of the start point of the edge arc

<end X location>, <end Y Location>:

   doubles that are the X, Y location of the end point of the edge arc

 

<arc height>:

double giving the height of the edge arc (0 for a straight edge)

<radians>:

double giving the arc size in radians (0 for a straight edge)