GDIMENSION


gdimension               m=<i>} {,f=<frag>} {,typ=<i>, r1=<i>,<i1> {,r2=<i>,<i1>}
{,r3=<i>,<i1>,r4=<i>,<i1>}
{,pos=<vector>}
{,w1=<n>} {,w2=<n>}
{,aty=<i>} {,arr=<i>}
{,txt='<text>'} {,rat=<n>}
{,cs=<n>{,<n1>} {,tol=<n>{,<n1>}
{,ds=<i>}
{,box} {,und} {,da=<n>} {,j=<cc>}
{,dis=<n>} {,occ=<svar>}
{,sha=<i>}

Function

To create an "associative" dimension to one or two items. The g-dimension item type is 19. There is not a symbol/code to refer to g-dimension, so that SELECT, IDENTIFY etc. handle only the numeric item code 19.

Parameters

m=

The colour of the g-dimension

 

 

f=

The fragment of the g-dimension

 

 

typ=

         distance

2          angular
3
          radius
         parallel
         perpendicular
6
          concentric
7
          tangent
8
          coincident
9
          fixed
10
         equal radius
11
         equal distance
12
         symmetric constraint

13         not used

14         orthogonal

 

The “reference items” for this type of G-Dimension is the G-Node object only. An example would be as follows:

partition

gnode ...

v1=inf(28)

partition

gnode ...

v2=inf(28)

gdimension typ=14,r1=v1,1,r2=v2,1,pos=p3,txt='#',w1=25,w2=25,arr=3,m=1

gdimension typ=14,r1=v1,1,r2=v2,1,pos=p4,txt='#',w1=25,w2=25,arr=3,m=1

 

r1=

The first parameter i is the id of one of the items the g-dimension
 

r2=

points to;

The second parameter i1 is :

0     if meaningless;

1     if it refers to the start point of a line or an arc;

2     if it refers to the endpoint of a line or an arc;
 

pos=

The position of the text

 

 

w1=

The displacement from the witness line, relative to the first item, from the item itself

 

 

w2=

The displacement from the witness line, relative to the second item, from the item itself

 

 

aty=

1     internal

2     external

3     external plus a support line

 

arr=

none

 

1     simple chevron

2     triangle

3     filled triangle

 

txt=

The string value of the g-dimension

 

 

rat=

The aspect ratio of the text

 

 

cs=

The text height and the tolerance height

 

 

tol=

The two tolerance texts (not used)

 

 

ds=

The decimal places

 

 

box

Whether the text should be "boxed" (not used)

 

 

und

Whether the text should be "underlined" (not used)

 

 

da=

The text angle (not used)

 

 

j=

The text justification (not used)

 

 

dis=

The displacement distance (not used)

 

 

occ=

The text occurrence (not used)

 

 

sha=

The constraint shape (not used)

Note

The id of an item is returned by inf(28) function. This command does NOT work in 3D.

The items considered by this command are :

Point                  (17)

Single Line           (3)

Construction Line  (18)

Arc/Circle            (11)

 

Update 11.7.0 (b05): The equal radius constraint requires two geometric entities and is identified by type 10.  The geometric entities can only be circles or arcs.   Meaning that, the radius of the first geometric entity is the same as the radius of the second geometry.

 

gdim   typ=10,r1=id1,0,r2=id2

 

The equal distance geometric constraint requires four geometric entities and is identified by type 11. These geometric entities can be points, lines or infinite lines only. Meaning that the distance between the first and second geometry is the same as the distance between the third and fourth geometry.

 

gdim   typ=11,r1=id1,0,r2=id2,0,r3=id3,0,r4=id4,0

 

A symmetric constraint requires three geometric entities, two items of the same type and the axis of symmetry which can only be a line or an infinite line.

 

gdim   typ=12,r1=id1,0,r2=id2,0,r3=id3,0

 

Update 11.7.0 (b05): G-Dimension can have complex text. The case is when an inequality must be set to GDimension’s text. An inequality  can be the definition of a range or a minimum or a maximum, that the actual value must match. The three supported formats are :

     range     [<minimum value>,<maximum value>]

     minimum     min:<minimum value>

     maximum     max:<maximum value>

 

where <minimum value> and <maximum value> can be expressions or values, for instance :

     range     [40,120]

               [d1,120]

               [d1/2,d1*2]

 

     minimum   min:40

               min:d1

               min:d1/2

 

     maximum   max:120

               max:d2

               max:d1*2

 

When the format min:<minimum value> is specified then the maximum value is BIG, a system variable internal to Eagle equals the maximum represented double. When the format max:<maximum value> is specified then the minimum value is 0.

 

The inequalities are pre-processed by Eagle and not passed to DCM. After an evaluation and after each step of a drag the inequalities are post-processed and if the solution found by DCM makes the actual value of an inequality unacceptable then an error is returned in the same fashion as for colliding constraints.

Examples

gdimension f=50,typ=4,r1=104,0,r2=106,0
gdimension typ=1,r1=101,1,r2=103,2,pos=j
gdim   typ=11,r1=id1,0,r2=id2,0,r3=id3,0,r4=id4,0
gdim   typ=10,r1=id1,0,r2=id2

See also

evaluate, gsearch, gchange, drag