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.7.23  vsc_form                                                   TOS

 Name:         »Set Mouse Form« - setzt die Mauszeigerform.

 VDI-Nummer:   111

 Deklaration:  void vsc_form ( int16_t handle, int16_t *pcur_form );

 Beschreibung: Die Funktion erlaubt die Definition der Form des 
               Mauszeigers. Es gilt:

                Parameter          Bedeutung

                handle             Kennung der Workstation
                pcur_form[0]       x-Koordinate
                pcur_form[1]       y-Koordinate des Hot-Spot
                pcur_form[2]       reserviert, sollte 1 sein
                pcur_form[3]       Farbindex der Hintergrundmaske
                pcur_form[4]       Farbindex der Vordergrundmaske
                pcur_form[05..20]  Definition der Hintergrundmaske
                pcur_form[21..36]  Definition der Vordergrundmaske

               Jede Maske wird als Feld mit 16 Wörtern zu je 16 Bit 
               festgelegt. Bit-15 des ersten Wortes ist hierbei die 
               obere linke Ecke der Maske, und Bit 0 von Wort 16 ist 
               ist die rechte untere Ecke.

               Unter dem Hot-Spot versteht man die exakte Position des 
               Grafikcursors. Bei einem Pfeil würde dies der 
               Pfeilspitze, bei einem Kreuz der Mitte entsprechen. Die 
               Koordinaten werden relativ zur oberen linken Ecke der 
               Maske angegeben.

               Zum Setzen der Mausform sollte in GEM-Programmen 
               unbedingt die AES-Funktion graf_mouse verwendet werden. 
               Andernfalls wird die Mausform-Verwaltung des AES 
               nachhaltig verwirrt.

               Hinweis: Die Eingabefunktionen des VDI arbeiten nur auf 
               der physikalischen Workstation, die im Normalfall von 
               den AES benutzt wird. Deshalb sollte man besser auf 
               graf_mouse zurückgreifen.

               Unter NVDI ist es auch möglich, die aktuelle Form der 
               Maus zu ermitteln (vgl. Binding).

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all screen drivers.

 Gruppe:       Eingabefunktionen

 Querverweis:  Binding   graf_mouse   MFORM