•  Back 
  •  Objektfunktionen 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help page 
  •  Show info about hypertext 
  •  View a new file 
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-File8.16.9  objc_sysvar                                                TOS

 Name:         »Object sysvar« - Manipulation der 3D Objekte

 AES-Nummer:   48

 Deklaration:  int16_t objc_sysvar ( int16_t ob_smode, int16_t 
               ob_swhich, int16_t ob_sival1, int16_t ob_sival2, 
               int16_t *ob_soval1, int16_t *ob_soval2 );

 Beschreibung: Die Funktion erlaubt es, das Erscheinungsbild der 3D- 
               Objekte des AES zu setzen bzw. zu erfragen. Es gilt:

                Parameter  Bedeutung

                ob_smode
                            0  -  Status abfragen 
                            1  -  neuen Status setzen 

                ob_swhich  Gewünschte 3D-Komponente:

                           LK3DIND (1) - Indikatoren
                            Modus 0: ob_soval1 = 0
                              beim Selektieren eines Objektes bewegt 
                              sich der zugehörige Text nicht.
                              ob_soval1 = 1
                              beim Selektieren eines Objektes bewegt 
                              sich der zugehörige Text.
                              ob_soval2 = 0
                              Objektfarbe ändert sich beim Selektieren 
                              nicht.
                              ob_soval2 = 1
                              Objektfarbe wird beim Selektieren 
                              verändert.
                            Modus 1: wie Modus 0, nur lassen sich 
                              jetzt die jeweiligen Werte, über die 
                              Parameter ob_sival1 bzw. ob_sival2 
                              setzen.
                           LK3DACT (2) - Aktivatoren
                           Bestimmt das Verhalten der Aktivatoren. 
                           Alle weiteren Angaben sind analog den 
                           Indikatoren zu verwenden.

                           INDBUTCOL (3) - Farbe nicht-selektierter 
                           Indikatoren!
                            Modus 0: ob_soval1 ist die aktuelle Farbe.
                            Modus 1: ob_sival1 enthält die zu setzende 
                              Farbe.
                           ACTBUTCOL (4) - Farbe nicht-selektierter 
                           Aktivatoren
                            Modus 0: ob_soval1 ist die aktuelle Farbe.
                            Modus 1: ob_sival1 enthält die zu setzende 
                              Farbe.
                           BACKGRCOL (5) - Farbe des 3D Hintergrundes
                            Modus 0: ob_soval1 ist die aktuelle Farbe.
                            Modus 1: ob_sival1 enthält die zu setzende 
                              Farbe.
                           AD3DVALUE (6) - Pixelvergrößerung erfragen
                            Modus 0: ob_soval1
                              Anzahl der Pixel in horizontaler 
                              Richtung, um die 3D-Buttons nach jeder 
                              Seite vergrößert werden.
                              ob_soval2
                              Anzahl der Pixel in vertikaler Richtung, 
                              um die 3D-Buttons nach jeder Seite 
                              vergrößert werden.
                              Hinweis: Dieser Modus liefert in MagiC 
                              stets den Wert 0, da die Objektgrößen 
                              vom System nicht angetastet werden.
                            Modus 1: z.Zt. nicht unterstützt.
                           MX_ENABLE3D (10) - 3D Look ein-/ausschalten 
                           Dieser Modus ist nur unter MagiC (ab 
                           Version 3.0) vorhanden, und erlaubt es, den 
                           3D-Look ein- bzw. auszuschalten. Es gilt:
                            Modus 0: ob_soval1 = 0
                              (3D ist aus)
                              ob_soval1 = 1
                              (3D ist aktiv)
                            Modus 1: ob_sival1 = 0
                              ob_sival2 = 0
                              (3D-Look aus)
                              ob_sival1 = 1
                              ob_sival2 = 1
                              (3D-Look ein)

               Hinweis: Die per objc_sysvar vorgenommenen 
               Einstellungen gelten nicht nur für das eigene Programm, 
               sondern für das ganze System. Aus diesem Grund sollte 
               die Funktion in normalen Anwenderprogrammen nicht 
               benutzt werden, sondern nur in Konfigurations- 
               Programmen (z.B. CPX-Modulen) zum Einsatz kommen.

               In MagiC 2.0 ist die Funktion zwar vorhanden, läßt 
               jedoch aufgrund der noch fehlenden 3D-Objekte keine 
               Modifikationen zu. Deshalb sollte der Rückgabewert der 
               Funktion beachtet werden. Ab MagiC 3 steht der 3D-Look 
               zwar zur Verfügung, jedoch gilt es einige Unterschiede 
               zu beachten.

 Ergebnis:     Ein Fehler ist nur dann aufgetreten, wenn als Ergebnis 
               der Wert 0 zurückgegeben wird.

 Verfügbar:    Available as of AES version 3.40.

               Das Vorhandensein dieser Funktion kann per appl_getinfo 
               (Opcode 13) erfragt werden.

 Gruppe:       Objekte

 Querverweise: Binding