•  Back 
  •  Object library 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help page 
  •  Show info about hypertext 
  •  View a new file 
Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.16.9  objc_sysvar                                                TOS

 Name:         »Object sysvar« - Manipulation of 3D objects.

 Opcode:       48

 Syntax:       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 );

 Description:  The call objc_sysvar permits the setting or inquiring 
               the appearance of the AES 3D objects. The following 
               apply:

                Parameter  Meaning

                ob_smode
                            0  -  Inquire status 
                            1  -  Set new status 

                ob_swhich  Desired 3D elements:

                           LK3DIND (1) - Indicators
                            Modus 0: ob_soval1 = 0
                                    On selection of an object the 
                                    associated text does not move 
                                    ob_soval1 = 1
                                    On selection of an abject the 
                                    associated text moves
                                    ob_soval2 = 0
                                    Object colour does not change on 
                                    selection
                                    ob_soval2 = 1
                                    Object colour changes on selection
                            Modus 1: As mode 1, but now the relevant 
                                    values may be set with the 
                                    parameters ob_sival1 or ob_sival2
                           LK3DACT (2) - Activators
                           Determines behaviour of the activators; all 
                           further statements are to be used in the 
                           same way as for indicators

                           INDBUTCOL (3) - Colour of non-selected 
                           indicators
                            Modus 0: ob_soval1 is the current colour
                            Modus 1: ob_sival1 contains the colour to 
                                    be set
                           ACTBUTCOL (4) - Colour of non-selected 
                           activators
                            Modus 0: ob_soval1 is the current colour
                            Modus 1: ob_sival1 contains the colour to 
                                    be set
                           BACKGRCOL (5) - Colour of the 3D background
                            Modus 0: ob_soval1 is the current colour
                            Modus 1: ob_sival1 contains the colour to 
                                    be set
                           AD3DVALUE (6) - Inquire pixel enlargement
                            Modus 0: ob_soval1
                                    Number of pixels in the horizontal 
                                    direction by which the 3D buttons 
                                    should be enlarged on each side
                                    ob_soval2
                                    Number of pixels in the vertical 
                                    direction by which the 3D buttons 
                                    should be enlarged on each side
                                    Note: This mode always returns the 
                                    value 0 in MagiC as the object 
                                    sizes of the system are not 
                                    affected in this case
                            Modus 1: Not supported at present
                           MX_ENABLE3D (10) - Switch on/off 3D-look 
                           This mode is only present under MagiC 
                           (since Version 3.0), and allows the 3D-look 
                           to be switched on or off. The following 
                           apply:
                            Modus 0: ob_soval1 = 0
                                    (3D is off)
                                    ob_soval1 = 1
                                    (3D is active)
                            Modus 1: ob_sival1 = 0
                                    ob_sival2 = 0
                                    (3D-look off)
                                    ob_sival1 = 1
                                    ob_sival2 = 1
                                    (3D-look on)

               Note: The settings made with objc_sysvar apply not just 
               for your own program, but are global for the whole 
               system. For this reason the function should not be used 
               in normal user applications, but only in configuration 
               programs (such as CPX modules).

               Although the function is present in MagiC 2.0, due to 
               not yet implemented 3D-objects no modifications are 
               possible. For this reason close attention should be 
               paid to the function's return value. As of MagiC 3 the 
               3D-look is available, but some differences have to be 
               borne in mind.

 Return value: An error has arisen only if the value 0 is returned.

 Availability: Available as of AES version 3.40.

               The presence of this function can be ascertained with a 
               call of appl_getinfo (opcode 13).

 Group:        Object library

 Querverweise: Binding