connectedViews

R2026b

Connected views in view set

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       1×1 rigidtform3d    1×1 pointCloud
      3       1×1 rigidtform3d    1×1 pointCloud
      4       1×1 rigidtform3d    1×1 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 (Image Processing Toolbox) 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™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

Introduced in R2020a

R2026b: Moved to Point Cloud Toolbox from Computer Vision Toolbox

Starting in R2026b, connectedViews is available in Point Cloud Toolbox™. In releases R2026a and before, connectedViews is available in Computer Vision Toolbox™.

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 (Image Processing Toolbox) object, which uses the premultiply convention. Before, the function returned AbsolutePose as a rigid3d (Image Processing Toolbox) object, which uses the postmultiply convention. For more information, see Migrate Geometric Transformations to Premultiply Convention (Image Processing Toolbox).