Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileAPOLY adr_pnt,num_pnt,y0 to y1,f,m,addr,num_pattern

adr_pnt, num_pnt, y0, y1, f, m, addr, num_pattern: iexp

APOLY is similar to the POLYFILL command. It draws an (invisible) sequence of
joined lines, with 'num_pnt' corners and fills the resulting area with a user
defined pattern. 'adr_pnt' is the address of the array which contains
alternating x- and y-coordinates of the corner points. The parameter 'num_pnt'
contains the number of corner points. y0 and y1 specify the lowest and highest
parts of the screen where filling can take place - it is like a vertical-only
clipping facility. The parameters f, m, addr, and num_pattern correspond to
those of HLINE.

Example:

    DIM x&(9),pattern&(1)
    FOR i%=0 to 7
      x&(i%)=RAND(100)
    NEXT i%
    x&(8)=x&(0)
    x&(9)=x&(1)
    '
    adr_corners%=V:x&(0)
    pattern&(0)=-1
    adr_pattern%=V:pattern&(0)
    '
    ACLIP 1,0,0,200,200
    APOLY adr_corners%,4,0 TO 100,1,1,adr_pattern%,0

--> Draws a random filled quadrilateral.

Memo: Internally APOLY does not set Line-A offset MFILL even though
      the documentation states the pattern parameters are identical to HLINE.
      Internally HLINE always sets Line-A offset MFILL.
        INT{L~A+52}=0 ;mfill (mono)

Line-A Filled Polygon+