This is machine translation

Translated by

Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

insertShape

Insert shapes in image or video

collapse all in page

Syntax

RGB = insertShape(I,shape,position)

RGB = insertShape(___,Name,Value)

Description

example

RGB = insertShape(I,shape,position) returns a truecolor image with shape inserted. The input image, I, can be either a truecolor or grayscale image. You draw the shapes by overwriting pixel values.

example

RGB = insertShape(___,Name,Value) uses additional options specified by one or more Name,Value pair arguments.

Examples

collapse all

Insert Circle and Filled Shapes on an Image

Open Live Script

Read the image.

I = imread('peppers.png');

Draw a circle with a border line width of 5.

RGB = insertShape(I,'circle',[150 280 35],'LineWidth',5);

Draw a filled triangle and a filled hexagon.

pos_triangle = [183 297 302 250 316 297];
pos_hexagon = [340 163 305 186 303 257 334 294 362 255 361 191];
RGB = insertShape(RGB,'FilledPolygon',{pos_triangle,pos_hexagon},...
    'Color', {'white','green'},'Opacity',0.7);

Display the image.

imshow(RGB);

Input Arguments

collapse all

`I` — Input image
M-by-N-by-3 truecolor | M-by-N 2-D grayscale image

Input image, specified in truecolor or 2-D grayscale.

Data Types: single | double | int16 | uint8 | uint16

`shape` — Type of shape
character vector

Type of shape, specified as a character vector. The vector can be, 'Rectangle', 'FilledRectangle', 'Line', 'Polygon', 'FilledPolygon', 'Circle', or 'FilledCircle'.

Data Types: char

`position` — Position of shape
matrix | vector | cell array

Position of shape, specified according to the type of shape, described in the table.

Shape Position Shape Drawn

Shape	Position	Shape Drawn
`'Rectangle'` `'FilledRectangle'`	M-by-4 matrix where each row specifies a rectangle as $[\begin{matrix} x & y & w i d t h & h e i g h t \end{matrix}]$ . $[\begin{matrix} x_{1} & y_{1} & w i d t h_{1} & h e i g h t_{1} \\ x_{2} & y_{2} & w i d t h_{2} & h e i g h t_{2} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & w i d t h_{M} & h e i g h t_{M} \end{matrix}]$
`'Line'`	For one or more disconnected lines, an M-by-4 matrix, where each four-element vector [x₁, y₁, x₂,y₂], describe a line with endpoints, [x₁ y₁] and [x₂ y₂].
For one or more line segments, an M-by-2L matrix, where each row is a vector representing a polyline with L number of vertices. $[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$ . The polyline always contains (L-1) number of segments because the first and last vertex points do not connect. For lines with fewer segments, repeat the ending coordinates to fill the matrix. You can also specify the shapes as a cell array of M vectors. {[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]} p, q, and r specify the number of vertices.
`'Polygon'` `'FilledPolygon'`	An M-by-2L matrix, where each row represents a polygon with L number of vertices. Each row of the matrix corresponds to a polygon. For polygons with fewer segments, repeat the ending coordinates to fill the matrix. $[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$ You can also specify the shapes as a cell array of M vectors: {[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]} p, q, and r specify the number of vertices.
`'Circle'` `'FilledCircle'`	An M-by-3 matrix, where each row is a vector specifying a circle as $[\begin{matrix} x & y & r a d i u s \end{matrix}]$ . The $[\begin{matrix} x & y \end{matrix}]$ coordinates represent the center of the circle. $[\begin{matrix} x_{1} & y_{1} & r a d i u s_{1} \\ x_{2} & y_{2} & r a d i u s_{2} \\ ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & r a d i u s_{M} \end{matrix}]$

'Rectangle'
'FilledRectangle'

M-by-4 matrix where each row specifies a rectangle as

[\begin{matrix} x & y & w i d t h & h e i g h t \end{matrix}]

$[\begin{matrix} x_{1} & y_{1} & w i d t h_{1} & h e i g h t_{1} \\ x_{2} & y_{2} & w i d t h_{2} & h e i g h t_{2} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & w i d t h_{M} & h e i g h t_{M} \end{matrix}]$

'Line'

For one or more disconnected lines, an M-by-4 matrix, where each four-element vector [x₁, y₁, x₂,y₂], describe a line with endpoints, [x₁ y₁] and [x₂ y₂].

For one or more line segments, an M-by-2L matrix, where each row is a vector representing a polyline with L number of vertices.

$[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$

The polyline always contains (L-1) number of segments because the first and last vertex points do not connect. For lines with fewer segments, repeat the ending coordinates to fill the matrix.

You can also specify the shapes as a cell array of M vectors.

{[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]}

p, q, and r specify the number of vertices.

'Polygon'
'FilledPolygon'

An M-by-2L matrix, where each row represents a polygon with L number of vertices. Each row of the matrix corresponds to a polygon. For polygons with fewer segments, repeat the ending coordinates to fill the matrix.

You can also specify the shapes as a cell array of M vectors:

{[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]}

p, q, and r specify the number of vertices.

'Circle'
'FilledCircle'

An M-by-3 matrix, where each row is a vector specifying a circle as

[\begin{matrix} x & y & r a d i u s \end{matrix}]

. The

[\begin{matrix} x & y \end{matrix}]

coordinates represent the center of the circle.

$[\begin{matrix} x_{1} & y_{1} & r a d i u s_{1} \\ x_{2} & y_{2} & r a d i u s_{2} \\ ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & r a d i u s_{M} \end{matrix}]$

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Color','yellow' specifies yellow for the shape color.

`'LineWidth'` — Shape border line width
`1` (default) | positive scalar integer

Shape border line width, specified in pixels, as a positive scalar integer. This property only applies to the 'Rectangle', 'Line', 'Polygon', or 'Circle' shapes.

Data Types: uint8 | uint16 | int16 | double | single

`'Color'` — Shape color
`'yellow'` (default) | character vector | cell array of character vectors | [R G B] vector | M-by-3 matrix

Shape color, specified as the comma-separated pair consisting of 'Color' and either a character vector, cell array of character vector, or matrix. You can specify a different color for each shape, or one color for all shapes.

To specify a color for each shape, set Color to a cell array of color character vectors or an M-by-3 matrix of M number of RGB (red, green, and blue) color values.

To specify one color for all shapes, set Color to either a color character vector or an [R G B] vector. The [R G B] vector contains the red, green, and blue values.

Supported colors: 'blue', 'green', 'red', 'cyan', 'magenta', 'black','black', and 'white'.

`'Opacity'` — Opacity of filled shape
0.6 (default) | range of [`0` `1`]

Opacity of filled shape, specified as the comma-separated pair consisting of 'Opacity' and a scalar value in the range [0 1]. The Opacity property applies for the FilledRectangle, FilledPolygon, and FilledCircle shapes.

`'SmoothEdges'` — Smooth shape edges
`true` (default) | `false`

Smooth shape edges, specified as the comma-separated pair consisting of 'SmoothEdges' and a logical value of true or false. A true value enables an anti-aliasing filter to smooth shape edges. This value applies only to nonrectangular shapes. Enabling anti-aliasing requires additional time to draw the shapes.

Data Types: logical

Output Arguments

collapse all

`RGB` — Output image
M-by-N-by-3 truecolor

Output image, returned as a truecolor image.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

'Color' and 'SmoothEdges' must be compile-time constants.

This is machine translation

insertShape

Syntax

Description

Examples

Insert Circle and Filled Shapes on an Image

Input Arguments

`I` — Input image
M-by-N-by-3 truecolor | M-by-N 2-D grayscale image

`shape` — Type of shape
character vector

`position` — Position of shape
matrix | vector | cell array

Name-Value Pair Arguments

`'LineWidth'` — Shape border line width
`1` (default) | positive scalar integer

`'Color'` — Shape color
`'yellow'` (default) | character vector | cell array of character vectors | [R G B] vector | M-by-3 matrix

`'Opacity'` — Opacity of filled shape
0.6 (default) | range of [`0` `1`]

`'SmoothEdges'` — Smooth shape edges
`true` (default) | `false`

Output Arguments

`RGB` — Output image
M-by-N-by-3 truecolor

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

See Also

Topics

Introduced in R2014a

Computer Vision Toolbox Documentation

Support

Introducing Deep Learning with MATLAB

This is machine translation

insertShape

Syntax

Description

Examples

Insert Circle and Filled Shapes on an Image

Input Arguments

I — Input image M-by-N-by-3 truecolor | M-by-N 2-D grayscale image

shape — Type of shape character vector

position — Position of shape matrix | vector | cell array

Name-Value Pair Arguments

'LineWidth' — Shape border line width 1 (default) | positive scalar integer

'Color' — Shape color 'yellow' (default) | character vector | cell array of character vectors | [R G B] vector | M-by-3 matrix

'Opacity' — Opacity of filled shape 0.6 (default) | range of [0 1]

'SmoothEdges' — Smooth shape edges true (default) | false

Output Arguments

RGB — Output image M-by-N-by-3 truecolor

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

See Also

Topics

Introduced in R2014a

Select a Web Site

How to Get Best Site Performance

Americas

Europe

Asia Pacific

Computer Vision Toolbox Documentation

Support

Introducing Deep Learning with MATLAB

`I` — Input image
M-by-N-by-3 truecolor | M-by-N 2-D grayscale image

`shape` — Type of shape
character vector

`position` — Position of shape
matrix | vector | cell array

`'LineWidth'` — Shape border line width
`1` (default) | positive scalar integer

`'Color'` — Shape color
`'yellow'` (default) | character vector | cell array of character vectors | [R G B] vector | M-by-3 matrix

`'Opacity'` — Opacity of filled shape
0.6 (default) | range of [`0` `1`]

`'SmoothEdges'` — Smooth shape edges
`true` (default) | `false`

`RGB` — Output image
M-by-N-by-3 truecolor

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.