connectedViews

Connected views in view set

Since R2020a

Syntax

viewTable = connectedViews(vSet,viewId)

Description

viewTable = connectedViews(vSet,viewId) returns a table of views from vSet that are connected to the view specified by viewId.

Examples

Get Connected Views in View Set

Create an empty point cloud view set object.

vSet = pcviewset;

Add views to the point cloud view set.

vSet = addView(vSet,1);
vSet = addView(vSet,2);
vSet = addView(vSet,3);
vSet = addView(vSet,4);

Connect views in the point cloud view set.

vSet = addConnection(vSet,1,2);
vSet = addConnection(vSet,2,3);
vSet = addConnection(vSet,2,4);

Get the connected views for the view with ID 2.

viewTable = connectedViews(vSet,2)

viewTable=3×3 table
    ViewId      AbsolutePose        PointCloud  
    ______    ________________    ______________

      1       1x1 rigidtform3d    1x1 pointCloud
      3       1x1 rigidtform3d    1x1 pointCloud
      4       1x1 rigidtform3d    1x1 pointCloud

Input Arguments

vSet — Point cloud view set

pcviewset object

Point cloud view set, specified as a pcviewset object.

viewId — View identifier

positive integer

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

Output Arguments

viewTable — One or more views

two-column table | three-column table

One or more views, returned as a three-column table. The table must contain the columns as described in this table.

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.

Extended Capabilities

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

Version History

Introduced in R2020a

R2022b: Supports premultiply geometric transformation convention

Starting in R2022b, most Computer Vision Toolbox™ functions create and perform geometric transformations using the premultiply convention. Accordingly, the connectedViews function now returns the AbsolutePose value in the viewTable argument as a rigidtform3d object, which uses the premultiply convention. Before, the function returned AbsolutePose as a rigid3d object, which uses the postmultiply convention. For more information, see Migrate Geometric Transformations to Premultiply Convention.