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.5.25  v_fillarea                                                 TOS

 Name:         »Filled area« - Fill an area.

 Opcode:       9

 Syntax:       void v_fillarea ( int16_t handle, int16_t count, 
               int16_t *pxyarray );

 Description:  The call v_fillarea fills an area that is surrounded by 
               a polygon. The following apply:

                Parameter            Meaning

                handle               Workstation identifier
                count                Number of vertices
                pxyarray[0]          X-coordinate, and
                pxyarray[1]          Y-coordinate of first point
                ...
                ...
                pxyarray[2*count-2]  X-coordinate, and
                pxyarray[2*count-1]  Y-coordinate of last point

               Note: If a device does not have area fill capability, 
               GEM VDI outlines the polygon using the current fill 
               area colour.

               At least three coordinate pairs have to be passed. The 
               device driver ensures that the fill area is closed by 
               connecting the first point to the last point. A single 
               coordinate pair will be drawn as a point only if the 
               automatic outlining of the fill area has been switched 
               on with vsf_perimeter.

               The current fill attributes will be respected.

 Return value: The function does not return a result.

 Availability: Supported by all drivers.

 Group:        Output functions

 See Also:     Binding   vswr_mode   vs_color   vsf_interior 
               vsf_style   vsf_color   vsf_udpat   vsf_perimeter