•  Back 
  •  Line-A Function Reference 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  %About 
  •  Show info about hypertext 
  •  View a new file 
Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileLine-A Horizontal Line
v_pline()
$A003 - Arbitrary Line                                               Line-A

Function      Draw a line between any two coordinates.

Parameters    COLBIT0-3 are set appropriately to determine the line color.
              LSTLIN is a flag in which a value of 0 specifies to draw the
              last point in each line or a value of 1 which specifies not
              to. LNMASK specifies the pattern mask to apply to the line.
              WRMODE specifies the write mode of the function (0-3). ( X1,
              Y1 ), and ( X2, Y2 ) give the starting and ending
              coordinates of the line.

Example       ;Draw a solid line from ( 0, 0 ) to ( 100, 100 )
Binding       
              move.w   #1,24(a5)      ; COLBIT0
              move.w   #1,26(a5)      ; COLBIT1
              move.w   #1,28(a5)      ; COLBIT2
              move.w   #1,30(a5)      ; COLBIT3
              move.w   #0,32(a5)      ; LSTLIN
              move.w   #$FFFF,34(a5)  ; LNMASK
              move.w   #0,36(a5)      ; WRMODE
              move.w   #0,38(a5)      ; X1
              move.w   #0,40(a5)      ; Y1
              move.w   #100,42(a5)    ; X2
              move.w   #100,42(a5)    ; Y2
              .dc.w    $A003

Caveats       LNMASK is modified as a result of this call.

See Also      Line-A Horizontal Line ($A004), v_pline()