Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileVQT_EXTENT(text$[,x1,y1,x2,y2,x3,y3,x4,y4])

text$: sexp
x1, y1, x2, y2, x3, y3, x4, y4: ivar

The function VQT_EXTENT() returns the corner coordinates of a rectangle which
will surround the text in text$. The coordinates can either be found in the
variables x1,y1 to x4,y4, or in PTSOUT(0) to PTSOUT(7). The corner points are
numbered in a counter-clockwise direction:

    Variable  PTSOUT(x/y)  Position
    x1,y1     0/1          P1
    x2,y2     2/3          P2
    x3,y3     4/5          P3
    x4,y4     6/7          P4

Which would be interpreted as:













Example

    INPUT text$
    CLS
    ATEXT 100,25,2,text$
    ~VQT_EXTENT(text$,x1,y1,x2,y2,x3,y3,x4,y4)
    BOX x4+100,y4+25,x2+100,y2+25

--> The input text is put at the arbitrary screen position (100,25), and a box
    is neatly put around it.

Memo: VQT_EXTENT() seems to return INTOUT(0), but it's useless.
      This VDI call is documented as not having a return value.

vqt_extent()+