Atari Logo
Atari Computer

Hauptseite -
Welches System? -
Hardware -
Software -
Emulatoren -
Internet
MausNet
Programmieren
Verweise
Über

CPX-Dokumentation

Home CPX-Funktionen cpx_hook cpx_m1

1.2.6 cpx_init

Name »cpx_init« - Initialisierung der CPX
 
Deklaration CPXINFO * cdecl cpx_init (XCPB *xcpb);
 
CPXINFO * cdecl cpx_init (XCPB *xcpb, LONG magic, LONG version );
 
Beschreibung Die Funktion sorgt für die Initialisierung der CPX. Es gilt:
 
Parameter Bedeutung
 
xcpb Zeiger auf die XCPB-Struktur von XControl
 

Hinweis: Die Funktion muss am Beginn des Textsegments der CPX-Datei stehen, und wird während der XControl-Initialisierung sowie beim Aktivieren der CPX aufgerufen.
 
Mit Hilfe der zweiten Aufrufform kann anhand der Parameter magic und version festgestellt werden, ob die CPX unter XCONTROL oder COPS läuft. Es bietet sich die folgende Routine an:
 
WORD is_COPS ( LONG magic, LONG version )
{
   if ((magic == 'COPS') && (version >= 0x10000L))
      return (TRUE);     /* COPS */
   else return (FALSE);   /* XCONTROL */
}

Falls COPS erkannt wurde, kann die CPX einen bis zu 512*384 Pixel großen Objektbaum zeichnen und bei der Funktion Xform_do übergeben.
 
Ergebnis Die Funktion liefert einen der folgenden Werte zurück:
 
NULL : 'Set Only'-CPX
sonst : Zeiger auf die CPXINFO-Struktur der CPX
Gruppe CPX-Funktionen
 
Querverweis cpx_close XCONTROL
 

Home CPX-Funktionen cpx_hook cpx_m1


Best viewed with any browser English version not yet available.

Änderungen und Irrtümer vorbehalten. Letzte Änderung:
14 September 2001.
Home - Mail an den Webmaster - Impressum