home *** CD-ROM | disk | FTP | other *** search
/ Global Amiga Experience / globalamigaexperience.iso / graphic / cad / xcad3000 / xcdoc / drawsym < prev    next >
Encoding:
Text File  |  1995-07-10  |  6.8 KB  |  148 lines
  1.  
  2.    5.12.2 DRAW SYMBOL
  3.  
  4.  
  5. The DRAW SYMBOL command is used to draw one or more instances of a symbol
  6. previously created using the DEFINE SYMBOL command.
  7.  
  8. Unless the EXPLODE modifier is used, a symbol will consist of a single
  9. entity whose graphical appearence is identical to the entities used to
  10. define the symbol. If any cpoints, tnodes or other symbols were included in
  11. the original symbol definition, these will be created as separate entities.
  12. Any separate entities that belong to the symbol will be related or linked
  13. to the main symbol instance in a child member list.
  14.  
  15.  
  16.    COMMAND FORMAT
  17.  
  18.       #DRAW SYMBOL modifiers :Loc x1 x2 ... xn
  19.  
  20. The named symbol is drawn at each location entered via IDENTS. The origin
  21. of each symbol is displayed as a small circle with a vertical and horizontal
  22. line passing through the circle centre. ( See fig. 5.99 ).
  23.  
  24.  
  25.    MODIFIERS
  26.  
  27. NAME           The name of the symbol to be drawn. This may have a maximum
  28.                of 80 characters and should not include the ".sym" suffix
  29.                that is added by DEFINE SYMBOL.
  30.  
  31.                If a symbol directory has been selected using the command
  32.                SELECT SYMBOL, then only the last level of the symbol name
  33.                need be entered.
  34.  
  35. NODIR          This modifier is used the override the current symbol
  36.                directory selected using the command DEFINE SYMBOL. If this
  37.                modifier is used, the symbol name should include the full
  38.                directory path.
  39.  
  40. LABEL          This modifier is used to enter a text-string to substitute
  41.                any occurances of the sub-string "#LABEL" within any text
  42.                entities related to tnodes that are part of the symbol.
  43.                ( See documentation for the command DEFINE SYMBOL ).
  44.  
  45. PARAMETERS     The PARAMETERS modifier is used to enter a family of
  46.                modifiers which may be used to specify any symbol parameters.
  47.  
  48. .SCALE         Requires a real value defining the symbol scale. The default
  49.                scale is 1.0 if this modifier is omitted. ( See fig. 5.100 ).
  50.  
  51. .ANGLE         Requires a real value defining the symbol alignment angle in
  52.                degrees. The symbol is drawn in its default alignment if
  53.                this modifier is omitted.
  54.  
  55. .ALIGN         The ALIGN modifier can be used to derive the angle for a
  56.                symbol from a segment of an existing line, string, polygon or
  57.                xhatch polygon entity. The command format differs slightly if
  58.                the ALIGN modifier is used:
  59.  
  60.                   #DRAW SYMBOL NAME name PARAMETERS ALIGN :
  61.                                        Ent x1 :Loc x2 x3 ... xn [:Ent ... ]
  62.  
  63.                The required line or string or polygon segment is selected
  64.                with 'x1'. Each location entered after this defines a
  65.                point on the identified entity to be used as the origin
  66.                for a symbol. The angle for the symbol is obtained from the
  67.                slope of the line, string or poltgon segment nearest to the
  68.                entered location. ( See fig. 5.101 and 5.102 ).
  69.  
  70.                ALIGN excludes use of the ANGLE modifier.
  71.  
  72. .MIRRORX       If the MIRRORX modifier is entered, the symbol will be
  73.                mirrored about its origin in the x-axis.
  74.  
  75. .MIRRORY       If the MIRRORY modifier is entered, the symbol will be
  76.                mirrored about its origin in the y-axis. Only one of MIRRORX
  77.                or MIRRORY can be used.
  78.  
  79. .UNITSCONVERT  This modifier is used to toggle between units or no units
  80.                conversion. If units conversion is on ( the default ), then
  81.                a symbol defined in a units type that is different to the
  82.                units type of the viewport it is about to be drawn in will
  83.                be scaled accordingly: ie., a symbol defined as one inch
  84.                square will appear as 25.4 millimetres square in a viewport
  85.                using millimetre units.
  86.  
  87.                If units conversion is off, the no scaling is carried out.
  88.  
  89.  
  90.                The following three modifiers can be used to inhibit certain
  91.                transformations being applied to text entities and tnode
  92.                parameters. Their default state is ON, in which case text
  93.                will be scaled, mirrored or rotated if the appropriate
  94.                modifiers are used.
  95.  
  96. .TEXTROTATE    Can be used to inhibit rotation of text. The origin of the
  97.                text will be rotated but the text angle will remain
  98.                unchanged.
  99.  
  100. .TEXTSCALE     Can be used to inhibit scaling of text. The origin of the
  101.                text will be scaled but the text height and width will remain
  102.                unchanged.
  103.  
  104. .TEXTMIRROR    Can be used to inhibit mirroring of text. The origin of the
  105.                text will be mirrored but the text itself will not. ( See
  106.                fig. 5.103 ).
  107.  
  108. .ABSLAYER      The ABSLAYER modifier is used to specify that the symbol
  109.                should be drawn on the same layers as the entities originally
  110.                used to define the symbol. The symbol instance - the small
  111.                circle and cross used to show the symbol origin - is always
  112.                drawn on the active layer.
  113.  
  114.                If the modifier is omitted, then the symbol is drawn at a
  115.                relative layer: i.e., if the current active layer is 30 and
  116.                the original entities used to define the symbol where on layer 
  117.                10, then the resulting symbol will appear on layer 40.
  118.  
  119. .RELDEPTH      The RELDEPTH modifier is used to specify that the symbol
  120.                should be drawn using a relative depth. The default is to use
  121.                the same depths as the original entities used to define the
  122.                symbol.
  123.  
  124. EXPLODE        Specifies that the symbol should be exploded into all of its
  125.                component parts. If this modifier is used, individual
  126.                entities are created as opposed to a single graphics entity.
  127.                This means that each entity that makes up the symbol can be
  128.                edited or referenced in the normal way.
  129.  
  130.                A symbol instance is still created to act as a parent entity
  131.                to all of the other entities that make up the symbol.
  132.                The symbol can then be treated as one group of entities by
  133.                referencing the symbol instance.
  134.  
  135.                An exploded symbol cannot be modified using the CHANGE SYMBOL
  136.                command.
  137.  
  138. .UNLINK        If the UNLINK modifier is used in conjunction with EXPLODE,
  139.                a symbol instance will not be created. The entities that
  140.                make up the symbol will not be related in any way and cannot
  141.                be referenced as a group.
  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.