Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.8.1.33  v_orient                                                 TOS

 Name:         »Set Orientation for Output« - Ausgabeformat festlegen.

 VDI-Nummer:   5 (Escape 27)

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

 Beschreibung: Die Funktion legt das Ausgabeformat für ein Gerät fest. 
               Es gilt:

                Parameter    Bedeutung

                handle       Kennung der Workstation
                orientation  Format
                              -1 =  aktuelles Format ermitteln
                              0 =   Hochformat (Portrait)
                              1 =   Querformat (Landscape)

               Hinweis: Die gewünschte Einstellung muss vorgenommen 
               werden, bevor irgendwelche Ausgaben getätigt werden.

               Falls nicht genügend Speicherplatz zur Verfügung steht 
               um die Orientierung zu verändern, liefert die Funktion 
               den Wert -1 zurück; in diesem Fall muß die Drucker- 
               Workstation per v_clswk geschlossen werden.

 Ergebnis:     Die Funktion liefert das eingestellte Ausgabeformat 
               zurück, bzw. im Fehlerfall den Wert -1.

 Verfügbar:    GEM/3 Release 3.1 und ansonsten nur, falls contrl[4] 
               einen Wert ungleich 0 enthält.

 Gruppe:       Grafikspezial-Funktionen

 Querverweis:  Binding   v_copies   v_tray