Version 1.0.0 (6.86 KB) by wfH
Efficiently draw a bunch of rectangles with curvatures and rotation.
Updated 7 May 2021

View License

I used to be troubled by efficiently drawing a bunch of rectangles on a figure.
A very useful function `RECTANGLES` wrote by Matthew Eicholtz solved my problems by plotting multiple rectangles as a single patch.

However, when I want to add curvatures to the rectangles, Matthew Eicholtz's approach cannot help.
Though his `RECTANGLES` is great, it is needed to be modified.

My `RECTANGLES` follows the same behaviour as builtin function `RECTANGLE` and can draw a bunch of rectangles
1) with different curvatures along the horizontal and vertical sides,
2) with different rotations about their centers.
The computation of curvatures and rotations have been fully vectorized !

Besides, the input position(s) of rectangles could be the four-element vectors [x, y, width, height] or the five-element vectors [xcenter, ycenter, width, height, yaw],
which is compatible with the common usage of bounding box in the field of computer vision.

Syntax: (basic usage)
rectangles(pos) % plot multiple rectangles at the position pos.
rectangles(pos, Name, Value, ...) % plot multiple rectangles at the position pos with properties specified.
rectangles('Position', pos, 'Curvature', cur) % plot multiple rectangles with curvatures
rectangles('Position', pos, 'Rotation', ang) % plot multiple rectangles with rotations
rectangles('Position', pos, Name, Value, ...) % plot multiple rectangles with properties specified.
rectangles(ax, ___)
H = rectangles(___)

Run the code without any input for demo.
See the function header for details.

Cite As

wfH (2024). rectangles (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2020a
Compatible with any release
Platform Compatibility
Windows macOS Linux

Inspired by: rectangles, rectangle2

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes