addView

Add views to view set

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.

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

vSet = addView(___,Name,Value) specifies options using one or more name-value pair 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

Add View to Image View Set

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

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

rigid3d object

Absolute pose of the view, specified as a rigid3d 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. 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 rigid3d 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(rgb2gray(i))

Features — Feature vectors

M-by-N matrix | binaryFeatures object

Feature vectors, specified as the comma-separated pair consisting of 'Features' and 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 the comma-separated pair consisting of 'Points' and 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

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