VMS Help  —  RTL Routines, SMG$  SMG$PUT_CHARS_MULTI
    The Put Text with Multiple Renditions to Display routine writes
    text with multiple renditions to the virtual display.

    Format

      SMG$PUT_CHARS_MULTI  display-id ,text [,start-row]

                           [,start-column] [,flags]

                           [,rendition-string]

                           [,rendition-complement] [,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.

 start-row

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

    Optional row number at which to start output. The start-row
    argument is the address of a signed longword containing this
    number. If omitted, the current row number is used.

 start-column

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

    Optional column number at which to start output. The start-column
    argument is the address of a signed longword containing this
    number. If omitted, the current column number is used.

 flags

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

    Optional bit mask that specifies the action to take before the
    specified text is output. The flags argument is the address of
    an unsigned longword that contains the flag. The flags argument
    accepts the following values:

    0                  Does not erase line (the default).
    SMG$M_ERASE_TO_    Erases the remaining part of the line.
    EOL
    SMG$M_ERASE_LINE   Erases the entire line.

 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

 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 (the default) and SMG$C_SPEC_GRAPHICS.
Close Help