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.11.25  vrt_cpyfm                                                 TOS

 Name:         »Copy Raster, Transparent« - kopiert ein 
               Monochromraster auf ein Farbraster.

 VDI-Nummer:   121

 Deklaration:  void vrt_cpyfm ( int16_t handle, int16_t vr_mode, 
               int16_t *pxyarray, MFDB *psrcMFDB, MFDB *pdesMFDB, 
               int16_t *color_index );

 Beschreibung: Die Funktion kopiert ein monochromes, rechteckiges 
               Raster unter Beachtung der Schreibmodi auf ein anderes 
               (auch farbiges) rechteckiges Raster. Es gilt:

                Parameter       Bedeutung

                handle          Kennung der Workstation
                vr_mode         Schreibmodus
                                 1 = Replace
                                 2 = Transparent
                                 3 = XOR
                                 4 = Reverse Transparent
                pxyarray[0]     x-Koordinate
                pxyarray[1]     y-Koordinate des Eckpunktes des 
                                Quellrasters
                pxyarray[2]     x-Koordinate
                pxyarray[3]     y-Koordinate der diagonal gegenüber 
                                liegenden Ecke des Quellrasters
                pxyarray[4]     x-Koordinate
                pxyarray[5]     y-Koordinate des Eckpunktes des 
                                Zielrasters
                pxyarray[6]     x-Koordinate
                pxyarray[7]     y-Koordinate der diagonal gegenüber 
                                liegenden Ecke des Zielrasters
                psrcMFDB        Zeiger auf den MFDB der Quelle
                pdesMFDB        Zeiger auf den MFDB des Ziels
                color_index[0]  Farbnummer der Farbe, die als gesetzt 
                                interpretiert werden soll
                color_index[1]  Farbnummer der Farbe, die als nicht 
                                gesetzt interpretiert werden soll

               Hinweis: Sollten die Größen beider Raster nicht 
               übereinstimmen, so werden die Größe des Quellrasters 
               und die obere linke Ecke des Zielrasters als Startpunkt 
               benutzt. Der Bildschirm darf niemals als Quellraster 
               angegeben werden.

               Normalerweise ignoriert die Funktion die Breite und 
               Höhe des Zielrasters und geht von den Maßen des 
               Quellrasters aus. Wenn ein Raster skaliert werden soll, 
               muss daher das oberste Bit im Schreibmodus gesetzt 
               werden (vr_mode|0x8000). Die Funktion beachtet dann 
               unterschiedliche Ausmaße und skaliert das Raster. Ob 
               der jeweilige Treiber Raster skalieren kann, sollte per 
               vq_extnd (work_out[30]) ermittelt werden; das oberste 
               Bit im Schreibmodus darf nur gesetzt werden, wenn der 
               Treiber über diese Fähigkeit verfügt.

               Achtung: In älteren NVDI-Druckertreibern hat diese 
               Funktion leider einen Fehler, der dazu führt, daß 
               Bitmaps, die nur eine Zeile hoch sind, evtl. nicht 
               ausgegeben werden. Aus diesem Grund sollte die 
               übergebene Bitmap mindestens zwei Zeilen hoch sein.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all screen drivers.

 Gruppe:       Rasterfunktionen

 Querverweis:  Binding   vro_cpyfm   vswr_mode   Rasterformate