                                                                atrbt_line
Chapter 9 Input Modes

The atrbt_line command sets the graphics input mode to digitize line attributes
between any two nodes.

atrbt_line

    Sets mode for digitizing all line attributes between any two nodes.

         atrbt_line action [mp=xxx] attr

    Sets the graphics input mode to digitize line attributes between any two
    nodes.  When in atrbt_line mode, the cursor is located near a node at one
    end of a series of segments and start is is executed.  The starting node
    will be shown in a cursor box.  The cursor cross-hair is then moved to the
    other end (or an intermediate point) of the series of segments and continue
    is executed.  The program then finds the shortest path between the two
    nodes and attributes all segments along the path with the input attribute
    and attribute action.  Subsequent presses of continue will continue the
    process from the previous endpoint.

    If $mp is imbedded within the attribute string (attr), it will be replaced
    with a 7 character string (xxxxx.xx) which is the number of miles from the
    beginning node.  The beginning node can be given a non-zero valud by using
    the mp=xxx optional parameter.  The $mp string will always be in map
    miles.  Each $mp string will be at least 0.01 greater than the preceding
    one.

    If a $++ 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 resent any time by using the plus_plus command.
    ___________________________________________________________________________
    Options/arguments

    action    Attribute action code
              0 = Replace all attributes w/single new one.
              1 = Replace/set 1st attribute, leave others.
              2 = Replace/set 2nd attribute, leave others.
              3 = Insert 1st new 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.
    mp=xxx    initial node distance in miles (to the nearest 0.01 miles).
    attr      any string of up to 30 characters.  If $mp is imbedded in the
              string, the mile post of the beginning of each segment attributed
              will replace the string.
    ___________________________________________________________________________


    NOTE:     Special variable sequences 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 the 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 replaced 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 attribute all segments between the node at 45 120 and the node at 366
    711 with the attribute 'cold creek' as the second attribute, enter:

         atrbt_line 2 cold_creek
         start 45 120             (enter with the mouse or digitizer)
         continue 366 711         (enter with the mouse or digitizer)

    To attribute all segments (on a transportation layer) between the node at
    532 1029 and the node at 875 262 with the road number 2642011- followed by
    the mile point of the segment beginning, where the first segment begins at
    mile point 12.62, (as the first attribute), enter:

         atrbt_line 1 mp=12.62 2642011-$mp
         start 532 1029
         continue 875 262
    ___________________________________________________________________________
    See also:

              atrbt_dig, plus_plus
    ___________________________________________________________________________
