GPR_$INQ_TEST16_OFFSET            GPR Calls             GPR_$INQ_TEST16_OFFSET


NAME
     gpr_$inq_text16_offset - returns the x- and y-offsets of an array of 16-
     bit characters.

FORMAT
     gpr_$inq_text16_offset (t_array, t_arrayl, start, xy_end, status)

DESCRIPTION
     This routine returns the following offsets:

        ⊕  The x- and y-offsets from the top left pixel of an array of 16-bit
           characters to the pixel that is the new current position after the
           array is written with gpr_$text16

        ⊕  The x- or y-offset from the top left pixel of an array of 16-bit
           characters to the origin of the array's first character

   Input Parameters
     t_array
          The array of 16-bit characters to inquire about, in
          gpr_$16bit_character_array_t format.  This is an array of unsigned
          2-byte integers.

     t_arrayl
          The number of 16-bit characters in the array.  This is a 2-byte
          integer.

   Output Parameters
     start
          The x- and y-offsets from the top left pixel of the character array
          to the origin of its first character, in gpr_$offset_t format.  This
          data type is 4 bytes long.

     xy_end
          The x- or y-offset from the top left pixel of the character array to
          the pixel that will be the new current position after the array is
          written with gpr_$text16.  This is the x-offset when the text path
          is specified as gpr_$right or gpr_$left.  This is the y-offset when
          the text path is specified as gpr_$up or gpr_$down.  This is a 2-
          byte integer.

     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$set_text_path.

NOTES
     A program can use the information derived from the start output parameter
     to set the current position to the character origin, rather than the top
     left corner of the array, before writing the array with gpr_$text16.