Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileVsetMode()
EgetShift()
Setscreen()
Getrez()                                                              XBIOS

Syntax

WORD Getrez( VOID )

Function      Getrez() returns a machine-dependent code representing the
              current screen mode/ratio.

Opcode        4 (0x04)

Availability  All TOS versions.

Binding       move.w   #$04,-(sp)
              trap     #14
              addq.l   #2,sp

Return Value  Getrez() returns a value representing the current video
              display mode. To find the value you will receive back based
              on current Atari manufactured video hardware, refer to the
              following chart:

              Colors:    2   4  16  256  TC (True Color)

              Screen
              Dimension:

               320x200   X   X   0   0   X

               320x240   X   0   0   0   0

               320x480   X   7   7   7   7

               640x200   1   X   X   X   X

               640x400   2   X   X   X   X

               640x480   2   2   2∙  2   2

              1280x960   6   X   X   X   X

              ∙ This value varies. TT030 Medium resolution returns a value
              of 4, however, the Falcon returns a value of 2.

Caveats       This call is extremely machine-dependent. Dependence on this
              call will make your program incompatible with third-party
              video boards and future hardware. Use the values returned by
              v_opnvwk() to determine screen attributes.

Comments      Use of this call in preparing to call v_opnwk() is
              acceptable and must be done to specify the correct fonts to
              load from GDOS.

See Also      VsetMode(), EgetShift(), Setscreen()