home *** CD-ROM | disk | FTP | other *** search
/ Global Amiga Experience / globalamigaexperience.iso / graphic / cad / xcad3000 / xcdoc / defsoft < prev    next >
Text File  |  1995-07-10  |  7KB  |  153 lines
  1.  
  2.    6.1.1 DEFINE SOFTFONT
  3.  
  4.  
  5. The DEFINE SOFTFONT command allows a softfont definition to be saved under
  6. a unique name for later recall. Most drawing commands allow a softfont line-
  7. style to be specified using the SOFTFONT family of modifiers. If a
  8. particular style is to be used several times, it is more efficient to save
  9. the softfont definition using DEFINE SOFTFONT, then recall the softfont by
  10. name as in:
  11.  
  12.    #DRAW LINE SOFTFONT NAME name
  13.  
  14. The softfont definition will be saved in the softfont data file selected
  15. with the command SELECT SOFTFONT, or in the default softfont data file
  16. ( "XCDATA:softfonts" ) if none has been selected.
  17.  
  18.  
  19.    MODIFIERS
  20.  
  21. NAME           A unique name for the softfont to be defined, this modifier
  22.                must be used. The softfont name can consist of up to 15
  23.                alphabetic characters.
  24.  
  25. TYPE           The TYPE modifier is used to specify whether the font will be
  26.                automatically scaled when used in viewports with different
  27.                units types, or whether the font will use absolute units.
  28.                The modifier is followed by one of two keywords:
  29.  
  30.                   FIXED
  31.                               A FIXED softfont will automatically be scaled
  32.                               according to the units of the viewport it will
  33.                               be used in; a softfont defined with a width
  34.                               of 1 inch will be drawn at a width of 25.4 mm
  35.                               in a viewport using millimetre units. The
  36.                               units used to define a FIXED softfont are the
  37.                               units for the active viewport.
  38.  
  39.                   VIEW_DEPENDENT
  40.   
  41.                               A VIEW_DEPENDENT softfont is not fixed to any
  42.                               particular units type, the font takes its
  43.                               units from the viewport is is used in; a
  44.                               softfont defined with a width of one unit will
  45.                               be drawn at a width of 1 inch in a viewport
  46.                               using inch units or at a width of 1 mm in a
  47.                               viewport using millimetre units.
  48.  
  49.                The default type used is VIEW_DEPENDENT.
  50.  
  51. SOFTFONT       The SOFTFONT modifier is used to enter a family of modifiers
  52.                used to define the parameters for a softfont. The modifiers
  53.                are exactly the same as those found in most of the drawing
  54.                commands.
  55.  
  56.                There are three main types of softfont that can be defined:
  57.                a font drawn at a single line-width but with a repeated
  58.                sequence of dashes and spaces; a font drawn at a width which
  59.                may be optionally filled with a solid colour or a
  60.                patternfill; or a font with a width and a repeated sequence
  61.                of dashes and spaces. The WIDTH modifier is used to control
  62.                all of the options available for a width font, the SPACING
  63.                modifier is used to specify a dash/space sequence. One or
  64.                both of these modifiers must be used to define a softfont.
  65.  
  66. .WIDTH         Specifies that the font will have a width. The modifier
  67.                should be followed by a real value defining the softfont
  68.                width - in active viewport units if the is a FIXED type of
  69.                softfont.
  70.  
  71. ..CENTRE       Used to specify that a width softfont should be centre-
  72.                justified about the centre-line of the entity. This is the
  73.                default justification.
  74.  
  75. ...EXTEND      If the EXTEND modifier is used with centre-justification of
  76.                a width softfont, the ends will be extended by half of the
  77.                softfont width.
  78.  
  79. ..LEFT         Used to specify that a width softfont should be left-
  80.                justified about the centre-line of the entity.
  81.  
  82. ..RIGHT        Used to specify that a width softfont should be right-
  83.                justified about the centre-line of the entity.
  84.  
  85. ..OPENENDED    A width softfont is drawn as a series of parallel lines
  86.                closed at each end. The OPENENDED modifier can be used to
  87.                suppress the two lines used to close each end of the parallel
  88.                lines. OPENENDED cannot be used on a filled softfont.
  89.  
  90. ..THICKNESS    If a width softfont is not going to be filled, a hardfont
  91.                type thickness can be applied to the lines used to draw the
  92.                graphics of the softfont. The thickness can be in the range
  93.                1 to 5.
  94.  
  95. ..FILLED       The FILLED modifier is used to specify that a softfont drawn
  96.                at a width should be filled with a solid colour. The default
  97.                option is to use the layer dependent colour for the entity.
  98.  
  99. ...COLOUR      The COLOUR modifier is used to specify an absolute colour
  100.                number for the fill, this will override the layer dependent
  101.                colour. The modifier should be followed by a colour number in
  102.                the range 0-7.
  103.  
  104. ....OUTLINE    If the OUTLINE modifier is used in conjunction with COLOUR,
  105.                the filled softfont will be outlined using the layer
  106.                dependent colour.
  107.  
  108. ..PATTERNFILL  Requires the name of a patternfill previously defined with
  109.                the DEFINE PATTERNFILL command. The softfont will be filled
  110.                with the named patternfill as an alternative to a solid
  111.                colour.
  112.  
  113.                The following modifiers only apply to patternfills that
  114.                were originally defined using colour 1 only. ( See the
  115.                command DEFINE PATTERNFILL ).
  116.  
  117. ...COLOUR      Requires a colour number in the range 0 to 7. The colour
  118.                specified will be used as the 'foreground' colour for the
  119.                patternfill overriding the default layer dependent colour.
  120.  
  121. ....BACKGROUND The background of a patternfill is normally filled with the
  122.                background colour, colour 0. This modifier when used with
  123.                COLOUR will fill the background of the patternfill with the
  124.                layer dependent colour.
  125.  
  126. ...OUTLINE     Will outline the patternfilled softfont with the layer
  127.                dependent colour.
  128.  
  129. .SPACING       The SPACING modifier is used to specify a repeated sequence
  130.                of dashes and spaces to display a particular type of line-
  131.                style such as a dashed line or a centre-line. The modifier
  132.                is followed by a list of comma-separated real values
  133.                defining dash lengths and space lengths as pairs. The first
  134.                value is always a dash length.
  135.  
  136.                For example:
  137.  
  138.                   #DEFINE SOFTFONT NAME name SPACING .5,.5
  139.  
  140.                will create a line style made up of alternate dashes and
  141.                spaces each .5 of a unit in length.
  142.  
  143.                Up to 8 pairs of dash/space values may be entered. If this is
  144.                a FIXED type of softfont, the dash and space lengths should
  145.                be specified in the active viewport units.
  146.  
  147. ..THICKNESS    If a width is not used with s SPACED softfont, a hardfont
  148.                type thickness can be applied to the graphics used to draw
  149.                the softfont. The modifier should be followed by a thickness
  150.                value in the range 1 to 5.
  151.  
  152.  
  153.