VMS Help RTL Routines, SMG$, SMG$PUT_LINE_MULTI  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Write Line with Multiple Renditions to Display routine writes
    lines with multiple renditions to the virtual display, optionally
    followed by cursor movement sequences.

    Format

      SMG$PUT_LINE_MULTI  display-id ,text ,rendition-string

                          [,rendition-complement] [,line-advance]

                          [,flags] [,direction] [,character-set]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 display-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Identifier of the virtual display to be affected. The display-id
    argument is the address of an unsigned longword that contains
    this identifier.

 text

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Text to be output. The text argument is the address of a
    descriptor pointing to the output string.

 rendition-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Optional bit mask string that controls the video attributes.
    The rendition-string argument is the address of a descriptor
    pointing to the bit mask string. Each attribute set causes the
    corresponding attribute to be set for the corresponding byte in
    the text string in the display. The following attributes can be
    specified for each byte using the rendition-string argument:

    SMG$M_BLINK     Displays blinking characters.
    SMG$M_BOLD      Displays characters in higher-than-normal
                    intensity.
    SMG$M_REVERSE   Displays characters in reverse video; that is,
                    using the opposite of the default rendition of
                    the virtual display.
    SMG$M_          Displays underlined characters.
    UNDERLINE
    SMG$M_          Specifies invisible characters; that is, the
    INVISIBLE       characters exist in the virtual display but do
                    not appear on the pasteboard.

 rendition-complement

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Optional bit mask string that controls the video attributes. The
    rendition-complement is the address of a descriptor pointing to
    the bit mask string. Each attribute set causes the corresponding
    attribute to be complemented for the corresponding byte in the
    text string in the display.

    If the same bit in the same byte is specified in both the
    rendition-string and rendition-complement arguments, rendition-
    string is evaluated first, followed by rendition-complement.
    By using these two parameters together, you can independently
    control each attribute in a single routine call. On a single-
    attribute basis, you can cause the following transformations:

    Set  Complement Action

    0    0          Attribute set to default
    1    0          Attribute on
    0    1          Attribute set to complement of default setting
    1    1          Attribute off

 line-advance

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Optional number of lines to advance after output. The line-
    advance argument is the address of a signed longword containing
    this number.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Optional bit mask that specifies the action to take if the text
    does not fit on the line. The flags argument is the address of
    an unsigned longword that contains the flag. The flags argument
    accepts the following values:

    0                  Does not wrap (default).
    SMG$M_WRAP_CHAR    Wraps at the last character on the line.
    SMG$M_WRAP_WORD    Wraps at the last space on the line.

 direction

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Optional direction specifier. The direction argument is the
    address of an unsigned longword that contains the direction code
    specifying the scrolling direction, if scrolling is necessary.
    Valid values are SMG$M_UP (default) and SMG$M_DOWN.

 character-set

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Specifies the default character set for all text in this virtual
    display. The character-set argument is the address of an unsigned
    longword that contains the character set code. Valid values are
    SMG$C_ASCII (default) and SMG$C_SPEC_GRAPHICS.