addView

Add views to view set

Since R2020a

collapse all in page

Syntax

vSet = addView(vSet,viewId)

vSet = addView(vSet,viewId,absPose)

vSet = addView(___,Name,Value)

vSet = addView(vSet,viewTable)

Description

vSet = addView(vSet,viewId) adds the view specified by viewId to the view set, vSet.

example

vSet = addView(vSet,viewId,absPose) specifies the absolute pose of the view.

vSet = addView(___,Name,Value) specifies options using one or more name-value arguments in addition to any of the input argument combinations in previous syntaxes.

vSet = addView(vSet,viewTable) adds one or more views in the table specified by viewTable.

Examples

collapse all

Add View to Image View Set

Open Live Script

Create an empty image view set.

vSet = imageviewset;

Detect interest points in the image.

imageDir = fullfile(toolboxdir('vision'),'visiondata','structureFromMotion');
I = imread(fullfile(imageDir,'image1.jpg'));
points = detectSURFFeatures(im2gray(I));

Add the interest points as a view to the image view set.

vSet = addView(vSet,1,'Points',points);

Input Arguments

collapse all

`vSet` — Image view set
`imageviewset` object

Image view set, specified as an imageviewset object.

`viewId` — View identifier
positive integer

View identifier, specified as an integer. View identifiers are unique to a specific view.

`absPose` — Absolute pose of the view
`rigidtform3d` object

Absolute pose of the view, specified as a rigidtform3d object.

`viewTable` — One or more views
two-column table | three-column table

One or more views, specified as a two-column or three-column table. The table must contain the columns ViewId and AbsolutePose. The Points column is optional.

Column	Description
`ViewID`	View identifier, specified as an integer. View identifiers are unique to a specific view.
`AbsolutePose`	Absolute pose of the view, specified as a `rigidtform3d` object.
`Points`	Point cloud for the view, specified as a `pointCloud` object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "Points",detectSURFFeatures(im2gray(I))

`Features` — Feature vectors
M-by-N matrix | `binaryFeatures` object

Feature vectors, specified as an M-by-N matrix of M feature vectors or as a binaryFeatures object.

`Points` — Image points
M-by-2 matrix | M-element feature point array

Image points, specified as an M-by-2 matrix of coordinates in the format [x,y] or an M-element feature point array. For more details, see Point Feature Types.

Output Arguments

collapse all

`vSet` — View set with added views
`imageviewset` object

View set with added views, returned as an imageviewset object.

Extended Capabilities

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

When you specify table as an input argument, then code generation has limitations. For information about the limitations, see Code Generation for Tables (MATLAB Coder) and Table Limitations for Code Generation (MATLAB Coder).

Version History

Introduced in R2020a

expand all

R2022b: Supports premultiply geometric transformation convention

Starting in R2022b, most Computer Vision Toolbox™ functions create and perform geometric transformations using the premultiply convention. Accordingly, you can now specify poses (the absPose argument and the AbsolutePose column of the viewTable argument) as rigidtform3d objects, which use the premultiply convention.

Although you can still specify poses as rigid3d objects, these objects are not recommended because they use the postmultiply convention. The addView function automatically converts the poses to the premultiply convention and returns an imageviewset object that represents the poses as rigidtform3d objects.

For more information, see Migrate Geometric Transformations to Premultiply Convention.

addView

Syntax

Description

Examples

Add View to Image View Set

Input Arguments

`vSet` — Image view set
`imageviewset` object

`viewId` — View identifier
positive integer

`absPose` — Absolute pose of the view
`rigidtform3d` object

`viewTable` — One or more views
two-column table | three-column table

Name-Value Arguments

`Features` — Feature vectors
M-by-N matrix | `binaryFeatures` object

`Points` — Image points
M-by-2 matrix | M-element feature point array

Output Arguments

`vSet` — View set with added views
`imageviewset` object

Extended Capabilities

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

Version History

R2022b: Supports premultiply geometric transformation convention

See Also

Functions

Objects

addView

Syntax

Description

Examples

Add View to Image View Set

Input Arguments

vSet — Image view set imageviewset object

viewId — View identifier positive integer

absPose — Absolute pose of the view rigidtform3d object

viewTable — One or more views two-column table | three-column table

Name-Value Arguments

Features — Feature vectors M-by-N matrix | binaryFeatures object

Points — Image points M-by-2 matrix | M-element feature point array

Output Arguments

vSet — View set with added views imageviewset object

Extended Capabilities

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

Version History

R2022b: Supports premultiply geometric transformation convention

See Also

Functions

Objects

`vSet` — Image view set
`imageviewset` object

`viewId` — View identifier
positive integer

`absPose` — Absolute pose of the view
`rigidtform3d` object

`viewTable` — One or more views
two-column table | three-column table

`Features` — Feature vectors
M-by-N matrix | `binaryFeatures` object

`Points` — Image points
M-by-2 matrix | M-element feature point array

`vSet` — View set with added views
`imageviewset` object

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