Main Content

transform

Apply rigid transformation to surface mesh

Since R2022b

    Description

    transform(mesh,tform) applies the rigid 3-D transformation specified by tform to the surface mesh mesh.

    example

    Examples

    collapse all

    Define mesh vertices for a surface mesh.

    vertices = [1 -1  1; 1 1 1; -1 1 1; -1 -1 1; ...
                1 -1 -1; 1 1 -1; -1 1 -1; -1 -1 -1];

    Define the mesh faces using the vertices.

    faces = [6 2 1; 1 5 6; 8 4 3; 3 7 8; 6 7 3; 3 2 6; ...
             5 1 4; 4 8 5; 4 1 2; 2 3 4; 7 6 5; 5 8 7];

    Create and display the surface mesh.

    mesh = surfaceMesh(vertices,faces);
    surfaceMeshShow(mesh,Title="Original Mesh")

    Define rotation and translation values, then use them to generate a transformation matrix.

    theta = 30; 
    rotationMat = [cosd(theta)  sind(theta) 0;
                  -sind(theta) cosd(theta) 0;
                      0            0       1];
    translationVector = [2 0 0]; 
    tform = rigidtform3d(rotationMat,translationVector);

    Apply the rigid transformation and visualize the output.

    transform(mesh,tform);
    surfaceMeshShow(mesh,Title="Transformed Mesh")

    Input Arguments

    collapse all

    Surface mesh, specified as a surfaceMesh object.

    Rigid 3-D transformation matrix, specified as a rigidtform3d object.

    Version History

    Introduced in R2022b