                                                                atrbt_dig
Chapter 9 Input Modes

The atrbt_dig command sets the graphic input mode to assign attributes from
the current, active graphics input device (GIN).

atrbt_dig

    Sets graphic input mode for attribute assignment from the current GIN.

         attrbt_dig  otype  action  attr

    Sets the graphics input mode to allow assignment of attributes to objects
    using the current active graphics input device (GIN).  The attribute string
    specified by attr is applied to the otype object(s) as defined by the
    action code.  This mode is actively used by a continue command.  The action
    applying the attr string to the otype object will occur at every X,Y
    position. The start, increment and decrement commands will behave like the
    continue command. 

    If $++ is imbedded within the attribute string, it will be replaced with a
    5 character string (xxxxx) which is a whole number >= 0.  Each time an
    attribute containing the $++ string is assigned, the value is incremented.
    The initial value can be reset any time by using the plus_plus command.
    ___________________________________________________________________________
    Options/arguments:

         otype     Object type code, where:
                   0 =  node
                   1 =  segment
                   2 =  polygon (def=same as map_type value in header)
         action    Action code, where:
                   0 =  Replace all attributes w/single new one. 
                   1 =  Replace/set 1st attribute, leave others. 
                   2 =  Replace/set 2nd attribute, leave others. 
                   3 =  Insert new 1st attribute, push others up by one.
                   4 =  Prefix 1st existing attribute.
                   5 =  Suffix 1st existing attribute.
                   6 =  Add a new (additional) last attribute. 
                   7 =  Remove ALL attributes for one object. 
*                  8 =  Prefix 2nd existing attribute.
*                  9 =  Suffix 2nd existing attribute.
         attr      Attribute string (maximum 30 characters long)
    ___________________________________________________________________________
    Note that the following special variable sequences are allowed:
    ___________________________________________________________________________
    $record

    This special attribute variable is converted to the object record number
    when the attribute is assigned.  For example: if the attribute string
    entered by the user is 'abc$record' and is assigned using atrbt_dig,
    atrbt_rec, atrbt_serial, or atrbt_set to object 123, then the attribute
    assigned is 'abc123'.
    ___________________________________________________________________________
    $serial

    This special attribute variable is converted to the object serial number
    when the attribute is assigned.  For example: if the attribute string
    entered by the user is 'ab$serialzz' and is assigned using atrbt_dig,
    atrbt_rec, atrbt_serial, or atrbt_set to an object with a serial number of
    999, then the attribute assigned is 'ab999zz'.

    ___________________________________________________________________________
    $++

    This special attribute variable is replace by a 5 digit integer which can
    be initialized using the plus_plus command.  Each time an attribute is
    stored using the $++ variable substring, the internal value is incremented
    by 1. 
    ___________________________________________________________________________
    Example(s):

    To assign the attribute HW678 to the polygon containing the location
    defined by any subsequent continue command, enter:

         atrbt_dig  2 3 HW678

    To replace the attribute assigned to any segment identified by a subsequent
    continue command with an attribute of JK782, enter:
     
         atrbt_dig  1 0 JK782
    ___________________________________________________________________________
    See also:

              atrbt_rec, atrbt_serial, atrbt_set, plus_plus
    ___________________________________________________________________________
