Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.8.1.33  v_orient                                                 TOS

 Name:         »Set orientation for output«

 Opcode:       5 (Escape 27)

 Syntax:       int16_t v_orient ( int16_t handle, int16_t orientation 
               );

 Description:  The call v_orient sets the output orientation for a 
               device. The following apply:

                Parameter    Meaning

                handle       Workstation identifier
                orientation  Format:
                              -1 =  Just return orientation
                              0 =   Set to portrait
                              1 =   Set to landscape

               Note: The desired setting must be performed before any 
               output is actioned.

               If there is insufficient memory free to alter the 
               orientation, the function returns the value -1; in that 
               case the printer workstation must be closed with 
               v_clswk.

 Return value: The function returns the set output orientation, or -1 
               in case of error.

 Availability: GEM/3 Release 3.1 and otherwise only if contrl[4] has a 
               non-zero value.

 Group:        Special graphic functions

 See Also:     Binding   v_copies   v_tray