draw-rectangle in dc<%>

Draws a rectangle. The current pen is used for the outline and the current brush for filling the shape.

If both the pen and brush are non-transparent, the rectangle is filled with the brush before the outline is drawn with the pen. In unsmoothed mode, when the pen is size 0 or 1, the filling precisely overlaps the entire outline. As a result, if a rectangle is drawn with a size-0 or size-1 'xor pen% and an 'xor brush%, the outline is xored twice (first by the brush, then by the pen), leaving it unchanged. More generally, the pen is centered over the outline of the rectangle, rounding toward the center in unsmoothed mode.

See also set-smoothing for information on the 'aligned smoothing mode.

• (send a-dc draw-rectangle x y width height) -> void
     x : real number
     y : real number
     width : non-negative real number
     height : non-negative real number

  Draws a rectangle with the given top-left corner and size.

  Restrictions on the magnitude of drawing coordinates are described with dc<%>.