PAINT - QB64 Wiki

PAINT

From QB64 Wiki

Revision as of 17:34, 15 December 2012 by Clippy (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The PAINT statement is used to color enclosed graphic objects with a designated fill color and border COLOR.


Syntax:

PAINT [STEP] (column%, row%), fillcolor%[, bordercolor%][,background$]


Parameters:

  • Can use the STEP keyword for relative coordinate placements. STEP(0, 0) can be used after CIRCLE to fill it with color.
  • Graphic column and row INTEGER pixel coordinates should be inside of a fully enclosed border.
  • INTEGER or LONG 32 bit Fillcolor is the color to paint the inside of an object. Colors limited to SCREEN mode used.
  • Optional INTEGER or LONG 32 bit border color is the color of the enclosed shape's border when different from the fill color.
  • Optional background ASCII character sets the tiling style. Default = CHR$(0). Seldom used.


Usage:

  • The enclosed border color must be one color value only. The object border must be fully enclosed!
  • PAINT coordinates MUST be inside of a closed shape to be colored. Paint will not do anything when placed on the border color.
  • If the border color does not enclose the area, PAINT may flood the screen or go beyond the border area.
  • If the shape is not totally enclosed, every color except the border color may be painted over.
  • DRAW shapes can be filled using the string "P fillcolor, bordercolor". Use a "B" blind move to offset from shape's border.


Example 1: Painting a CIRCLE immediately after it is drawn using STEP(0, 0) to paint from the circle's center point.

SCREEN 12 x = 200: y = 200 CIRCLE (x, y), 100, 10 PAINT STEP(0, 0), 2, 10

Results: A circle located at x and y with a bright green border filled in dark green. The last coordinate used was the circle's center point and PAINT used it also with the STEP relative coordinates being zero.


Example 2: Routine to check a DRAW string to make sure that the drawn shape is fully enclosed so that a PAINT does not bleed.

SCREEN 12 drw$ = "C15S20R9D4R6U3R3D3R7U5H3U2R9D3G2D6F1D3F5L10D1G1L4H2L7G2L3H2L3U8L2U5R1BF4" FOR i = 1 TO LEN(drw$) tmp$ = UCASE$(MID$(drw$, i, 1)) check = 1 SELECT CASE tmp$ CASE "U": ver = -1: hor = 0 CASE "D": ver = 1: hor = 0 CASE "E": ver = -1: hor = 1 CASE "F": ver = 1: hor = 1 CASE "G": ver = 1: hor = -1 CASE "H": ver = -1: hor = -1 CASE "L": ver = 0: hor = -1 CASE "R": ver = 0: hor = 1 CASE ELSE: check = 0 END SELECT IF check THEN snum$ = "" FOR j = i + 1 TO i + 4 'set for up to 4 digits and spaces IF j > LEN(drw$) THEN EXIT FOR n$ = MID$(drw$, j, 1) num = ASC(n$) IF (num > 47 AND num < 58) OR num = 32 THEN snum$ = snum$ + n$ ELSE: EXIT FOR END IF NEXT vertical = vertical + (ver * VAL(snum$)) horizont = horizont + (hor * VAL(snum$)) END IF PRINT tmp$, horizont, vertical 'SLEEP NEXT PSET (300, 300): DRAW drw$

Explanation: If the DRAW string is enclosed, the end values should each be 0! In the example, the proper result should be 4, 4 as there is a BF4 offset for PAINT which cannot be on a border. The result is 4, 5 because the shape is not completely enclosed.



See also:



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page