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.19.3  xgrf_stepcalc                                              TOS

 Name:         »Stepcalc for XGraf« - Parameter calculation for the 
               animation of rectangles.

 Opcode:       130

 Syntax:       int16_t xgrf_stepcalc ( int16_t orgw, int16_t orgh, 
               int16_t xc, int16_t yc, int16_t w, int16_t h, int16_t 
               *pcx, int16_t *pcy, int16_t *pcnt, int16_t *pxstep, 
               int16_t *pystep );

 Description:  The call xgrf_stepcalc calculates all parameters for a 
               call of xgrf_2box. The following apply:

                Parameter  Meaning

                orgw       Starting width
                orgh       Starting height
                xc         End position in X-direction
                yc         End position in Y-direction
                w          Width of final size
                h          Height of final size
                pcx        Centred position at completion of process 
                           in X-direction
                pcy        Ditto for Y-directiong
                pcnt       Number of single steps
                pxstep     Step size in X-direction
                pystep     Step size in Y-direction

               Note: The centred position, number of steps as well as 
               step size are calculated from the starting size, final 
               size and the end positions of the rectangle.

 Return value: This is unknown at present.

 Availability: The function is available only as of PC-GEM 2.0, as of 
               KAOS 1.4.2 and MagiC.

 Group:        Extended graphics library

 See Also:     Binding   xgrf_2box   MagiC