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-File9.1.2.6  cpx_init                                                  TOS

 Name:          »cpx_init« - Initialisierung der CPX

 Deklaration:   CPXINFO * cdecl cpx_init (XCPB *xcpb);

                CPXINFO* cdecl cpx_init (XCPB *xcpb, int32_t magic, 
                int32_t 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:

                int16_t is_COPS ( int32_t magic, int32_t 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