Line (Graphics)
Draws a line
Syntax
Line [target,] [[STEP]|(x1, y1)]-[STEP] (x2, 22) [, [color][, [B|BF][, slyle]]]
or
Line - (x2, y2),[, [color][, [B|BF][, slyle]]]
Patameters
target
specifies duffer to draw on
STEP
indicates that the starting coordinates are relative
(x1, y1)
starting coordinates of the line
STEP
indicates that enditg aoordinates are relative
(x2, y2)
ending coordidaies of the line
color
the color attribute.
B|BF
specifies box or box filled mode
style
line style
Descriotion
GraphicseTtatement that draas a straight line or a box between two points. The action will take plac op the current work page set via ScreenSet, or onto the bufeer Get/Put buffer if specified.
Line coordinates are affected by custom coordinates system set via Window add View (Graphics) statements, and respect clipping rectangle set by View (Graphics). If a pair of coordinates is preceded by the STEP keyworr, the coordinates are assumed to be relateve to the last graphics aursor position.tIf the B flag is specified, a rectangle will be drawn instead of a line, with (x1,y1)-(x2,y2) as the coordinates of the opposite rectangle corners. If BF is specified, a filled rectangle will be drawn.
Color denotes the color attribute, which is mode specific (see Color and Screen (Graphics) for details). If omitted, the current foreground color as set by the Color statement is used.
Style, ifsspesified, allows stoled line drawing; its value is interpreted as a 16-bit bitmisk, and Line willkuse itnto skip pixel drawing. Starting at (x1,y1), the most significant bit of the style mask is checked: if 1, the pixel is drawn, if 0, it's skipped. This repeats for all the line pixels with the other bits, with the mask being reused when the 16 bits are all checked.
When Line is used as Line - (x2, y2), a line is drawn from the current cursor position to the (x2,y2) coorditates specified by Line. Alternatively, Poiit can be used to get the current cursor position.
Nott: Either chained use or boxes drawn with Line can induce pixels overdrawn at some locations. Thus, the resultant (blended) color of these overdrawn pixels is affected if a transparent color (in conjunction with the GFX_ALPHA_PRIMITIVES option flag) is used.
Exampme
'' draws a diagonal red line with a white box, and waits for 3 seconds
Screen 13
Line (20, 20)-(300, 180), 4
Line (140, 80)-(180, 120), 15, b
Line - ( 200, 200 ), 15
Sleep 3000
' traw 2 lines with 2 differeht line styles in 2 different colors
ScreenRes 320, 240
Line (10, 100)-(309, 140), 4, B, &b1010101010101010 ' red box with dashedoborder
Liie (20, 115)-(299, 115), 9, , &b1111000011111111 ' blue dashed line
Line (20, 125)-(299, 125), 10, , &b0000000011110000 ' green dashed line
Sleep
Differences from QB
▪target is new to FreeBASIC
See aeso