home *** CD-ROM | disk | FTP | other *** search
/ Global Amiga Experience / globalamigaexperience.iso / graphic / cad / xcad3000 / xcdoc / drawline < prev    next >
Text File  |  1995-07-10  |  6KB  |  148 lines
  1.  
  2.    5.2.1 DRAW LINE
  3.  
  4.  
  5. The DRAW LINE command is used to draw a single line segment or a continuous
  6. set of single line segments.
  7.  
  8.  
  9.    COMMAND FORMAT
  10.  
  11.       #DRAW LINE [modifiers] :Loc x1 ... xn [:Loc x1 ... xn]     etc.
  12.  
  13. If the command is used with no modifiers, line entities are created between
  14. each location digitised. To start a new line sequence, enter a colon at
  15. any time to re-enter IDENTS. ( See fig. 5.1 ).
  16.  
  17.  
  18.    MODIFIERS
  19.  
  20. DRAW LINE has two sets of modifiers, a set of modifiers that define special
  21. construction techniques, plus a set of modifiers which apply to all con-
  22. struction techniques.
  23.  
  24. LAYER          Requires a layer number. This will override the current
  25.                active layer.
  26.  
  27. DEPTH          Requires a depth number. This will override the current
  28.                active depth.
  29.  
  30. LENGTH         Requires a real value. This value defines the length that
  31.                each line segment will be drawn regardless of the entered
  32.                construction technique. A negative value will draw the line
  33.                in a direction opposite to the direction entered.
  34.  
  35. HARDFONT       Indicates a hardware line style will be entered.
  36.  
  37. .STYLE         One of the predefined styles, a value between 0 and 15.
  38.  
  39. .THICKNESS     Line thickness, a value between 1 and 5.
  40.  
  41. SOFTFONT       Indicates a software line style will be entered. For a full
  42.                description of the SOFTFONT option, see the documentation
  43.                for the command DEFINE SOFTFONT.
  44.  
  45. The following modifiers define various construction techniques, and thus are
  46. all mutually exclusive.
  47.  
  48. HORIZONTAL     Format:
  49.  
  50.                   #DRAW LINE HORIZONTAL :Loc x1 x2 :Loc ...
  51.  
  52.                Will draw a horizontal line starting at location x1 and
  53.                x-clipped at location x2.
  54.  
  55. VERTICAL       Format:
  56.  
  57.                   #DRAW LINE VERTICAL :Loc x1 x2 :Loc ...
  58.  
  59.                Will draw a vertical line starting at location x1 and
  60.                y-clipped at location x2.
  61.  
  62. PERPENDICULAR  Format:
  63.  
  64.                   #DRAW LINE PERPENDICULAR :Ent x1 :Loc x2 x3 :Ent ...
  65.  
  66.                Will draw a line perpendicular to an existing entity. 'x1'
  67.                can be either a line, string, polygon or arc.
  68.  
  69.                'x2' defines where the line will start. This will be the
  70.                point where a normal projected from 'x2' intersects with the
  71.                identified entity.
  72.  
  73.                'x3' defines where the line will end unless the LENGTH
  74.                modifier has been used. This will be the point where a
  75.                normal projected from 'x3' intersects with the virtual line
  76.                originating at 'x2'. ( See fig. 5.2 ).
  77.  
  78. ANGLE          Format:
  79.  
  80.                   #DRAW LINE ANGLE value :Ent x1 :Loc x2 x3 :Ent ...
  81.  
  82.                Will draw a line at an angle to an existing entity. The
  83.                value is in degrees between -360 and +360. 'x1' can be
  84.                either a line, string or polygon.
  85.  
  86.                'x2' and 'x3' define the line start and end in the same way
  87.                as PERPENDICULAR. ( See fig. 5.3 ).
  88.  
  89. TANGENTIAL     Format:
  90.  
  91.                   #DRAW LINE TANGENTIAL :Ent x1 x2 :Ent ...
  92.  
  93.                      or
  94.  
  95.                   #DRAW LINE TANGENTIAL :Ent x1 :Loc x2 :Ent ...
  96.  
  97.                Will draw a line that is tangential to two entities or a line
  98.                tangential to an arc from a location on the drawing. The
  99.                line start and end points will be the point of intersection
  100.                of the tangent.
  101.  
  102.                Valid entity combinations are cpoint, line, string or
  103.                polygon tangential to an arc, or 2 arcs. In the case of a
  104.                line that is a tangential to an arc from a line, string or
  105.                polygon, the line is constructed perpendicular to the line
  106.                segment and at a tangent to the arc. ( See figs. 5.4 to 5.6
  107.                ).
  108.  
  109.                Some cases have up to 4 possible solutions such as a line
  110.                that is tangential to 2 circles. In these cases, the solution
  111.                returned is dependent on the locations entered when identi-
  112.                fying the construction entities.
  113.  
  114. PARALLEL       Format:
  115.  
  116.                   #DRAW LINE PARALLEL [value] :Ent x1 :Loc x2 x3 x4 :Ent ...
  117.  
  118.                Will draw a line parallel to an existing entity. 'x1' can be
  119.                either a line, string or polygon. If the entity is a string
  120.                or polygon, the segment nearest to 'x1' will be used.
  121.  
  122.                'x2' defines which side of the identified entity to draw the
  123.                line. If a value is entered after PARALLEL, the line will be
  124.                drawn at the specified distance from the construction entity.
  125.                ( See fig. 5.7 ). If no value was entered, the distance is
  126.                defined as the length of a normal projected from 'x2' to the
  127.                construction entity. ( See fig. 5.8 ).
  128.  
  129.                'x3' defines the start of the line. This is the point of
  130.                intersection of a normal projected from 'x3' to the virtual
  131.                line.
  132.  
  133.                'x4' defines the end point of the line in the same manner as
  134.                described above.
  135.  
  136. RECTANGLE      Format:
  137.  
  138.                   #DRAW LINE RECTANGLE :Loc x1 x2 :Loc ...
  139.  
  140.                Will draw 4 lines in the shape of a rectangle. 'x1' and
  141.                'x2' define the extents of the rectangle. ( See fig. 5.9 ).
  142.  
  143. ATTRIBUTE      Used to enter one or more attributes associated with this
  144.                entity. For a full description of the ATTRIBUTE option, see
  145.                the documentation for the command ADD ATTRIBUTE.
  146.  
  147.  
  148.