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.10.43  vs_clip                                                   TOS

 Name:         »Set clipping Rectangle« - setzt Begrenzungsrechteck.

 VDI-Nummer:   129

 Deklaration:  void vs_clip ( int16_t handle, int16_t clip_flag, 
               int16_t *pxyarray );

 Beschreibung: Die Funktion begrenzt alle grafischen Ausgaben auf 
               einen bestimmten Bereich. Es gilt:

                Parameter    Bedeutung

                handle       Kennung der Workstation
                clip_flag
                              0 = Clipping einschalten
                              1 = Clipping ausschalten
                pxyarray[0]  x-Koordinate
                pxyarray[1]  y-Koordinate des Eckpunktes
                pxyarray[2]  x-Koordinate
                pxyarray[3]  y-Koordinate der diagonal 
                             gegenüberliegenden Ecke

               Hinweis: Das Clipping sollte aus Sicherheitsgründen 
               immer eingeschaltet werden, da die Ausgaberoutinen beim 
               Überschreiten der Bildschirmgrenzen sehr schnell große 
               Speicherbereiche überschreiben, was zu unerfreulichen 
               Abtürzen und Datenmüll führen kann.

               Wenn der Arbeitsbereich den ganzen Bildschirm 
               einbeziehen soll, ist es ratsam, bei vs_clip() die bei 
               v_opnvwk() erhaltenen Bildschirmausmaße einzustellen.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all drivers.

 Gruppe:       Kontrollfunktionen

 Querverweis:  Binding   Clipping