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-File7.8.1.43  v_xbit_image                                             TOS

 Opcode:       5 (Escape 101)

 Syntax:       void v_xbit_image(int16_t handle, BYTE *filename, 
               int16_t aspect, int16_t x_scale, int16_t y_scale, 
               int16_t h_align, int16_t v_align, int16_t rotation, 
               int16_t foreground, int16_t background, int16_t xy[])

 Description:  The call v_xbit_image draws an image from a disk file 
               onto the current device - with rotation and colouring.

               Passed #ptsin=2, #intin=8 + length of filename.

               INTIN holds:

                  . 0 to ignore aspect ratio, 1 to preserve it
                  . X axis scaling: 0 = fractional, 1 = integer
                  . Y axis scaling: 0 = fractional, 1 = integer
                  . Horizontal alignment: 0=left 1=centre 2=right
                  . Vertical alignment: 0=top 1=centre 2=bottom
                  . Rotation angle, 0 - 3600 in 1/10th degrees
                  . Foreground colour if drawing a monochrome image on 
                    a colour device
                  . Background colour
                  . Filename, one character per word

 Availability: GEM/3 and later

 Group:        Special graphic functions