surfaceMesh

곡면 메시 생성

R2022b 이후

설명

surfaceMesh 객체는 곡면 메시를 생성하고 저장합니다. 곡면 메시는 기하학적 곡면을 표현하며 꼭짓점, 면, 가장자리로 구성됩니다. surfaceMesh 객체와 객체 함수를 사용하여 다음을 수행할 수 있습니다.

• 메시 꼭짓점과 메시 면 추가 및 제거

• 회전, 평행 이동, 변환, 스케일링과 같은 기하학적 연산 수행

• 메시 법선 계산

• 메시 자르기, 단순화 및 세분하기

• 자체 교차 여부, 밀폐 여부 또는 방향 지정 가능 여부와 같은 메시 속성 확인

• 퇴화하고 참조되지 않은 꼭짓점 및 면 제거

생성

구문

mesh = surfaceMesh(vertices,faces)

mesh = surfaceMesh(___,Name=Value)

설명

mesh = surfaceMesh(vertices,faces)는 지정된 꼭짓점과 면으로 surfaceMesh 객체를 생성합니다.

mesh = surfaceMesh(___,Name=Value)는 위에 열거된 구문의 인수 외에 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어 VertexNormals=[8 -4 4; 4 4 8; -6 6 3; -3 -6 6; 3 -6 -6; 6 6 -3]은 메시 꼭짓점에 대한 법선 벡터를 지정합니다.

속성

Vertices — 메시 꼭짓점

M×3 행렬

메시 꼭짓점으로, M×3 행렬로 지정됩니다. 이 행렬의 각 행은 [x y z] 형식이며 꼭짓점의 좌표를 지정합니다. 각 꼭짓점은 행렬에서의 행 번호와 동일한 꼭짓점 ID를 갖습니다. M은 메시의 총 꼭짓점 개수입니다.

vertices 인수는 객체를 생성할 때 이 속성을 설정합니다.

데이터형: single | double

Faces — 메시 삼각형 면

N×3 행렬

메시 삼각형 면으로, N×3 행렬로 지정됩니다. 행렬의 각 행은 [V1 V2 V3] 형식이며 삼각형 면을 정의하는 Vertices에서 그에 대응하는 꼭짓점의 행 인덱스를 지정합니다. N은 메시의 면 개수입니다.

faces 인수는 객체를 생성할 때 이 속성을 설정합니다.

데이터형: single | double

VertexNormals — 메시 꼭짓점에 대한 법선 벡터

M×3 행렬

메시 꼭짓점에 대한 법선 벡터로, M×3 행렬로 지정됩니다. 행렬의 각 행은 [x y z] 형식이며 꼭짓점에 대한 법선 벡터를 지정합니다. M은 메시의 총 꼭짓점 개수입니다.

꼭짓점 법선은 꼭짓점에 연결된 모든 면 법선의 가중 평균입니다.

이 속성을 설정하려면, 객체를 생성할 때 지정하십시오.

예: mesh(vertices,faces,VertexNormals=[8 -4 4; 4 4 8; -6 6 3; -3 -6 6; 3 -6 -6; 6 6 -3])

데이터형: single | double

VertexColors — 메시 꼭짓점에 대한 색 값

M×3 행렬

메시 꼭짓점에 대한 색 값으로, M×3 행렬로 지정됩니다. 행렬의 각 행은 [R G B] 형식이며 꼭짓점에 대한 색 값을 지정합니다. 각 값은 범위 [0, 1] 내에 있어야 합니다. M은 메시의 총 꼭짓점 개수입니다.

이 속성을 설정하려면, 객체를 생성할 때 지정하십시오.

예: mesh(vertices,faces,VertexColors=[1 0 0; 0 0 1; 0 0 0; 1 1 1 1; 1 1 0; 0 1 1])

데이터형: single | double

FaceNormals — 메시 면에 대한 법선

N×3 행렬

메시 면에 대한 법선 벡터로, N×3 행렬로 지정됩니다. 행렬의 각 행은 [x y z] 형식이며 면에 대한 법선을 지정합니다. N은 메시의 총 면 개수입니다.

이 속성을 설정하려면, 객체를 생성할 때 지정하십시오.

예: mesh(vertices,faces,FaceNormals=[8 -4 4; 4 4 8; -6 6 3; -3 -6 6; 3 -6 -6; 6 6 -3])

데이터형: single | double

FaceColors — 메시 면에 대한 색

N×3 행렬

메시 면에 대한 색 값으로, N×3 행렬로 지정됩니다. 행렬의 각 행은 [R G B] 형식이며 면에 대한 색 값을 지정합니다. 각 값은 범위 [0, 1] 내에 있어야 합니다. N은 메시의 총 면 개수입니다.

이 속성을 설정하려면, 객체를 생성할 때 지정하십시오.

예: mesh(vertices,faces,FaceColors=[1 0 0; 0 0 1; 0 0 0; 1 1 1; 1 1 0; 0 1 1])

데이터형: single | double

NumVertices — 메시 꼭짓점 개수

양의 정수

메시 꼭짓점 개수로, 양의 정수로 저장됩니다.

이 속성은 읽기 전용입니다.

데이터형: unit32

NumFaces — 메시 면 개수

양의 정수

메시 면 개수로, 양의 정수로 저장됩니다.

이 속성은 읽기 전용입니다.

데이터형: unit32

객체 함수

addVertices	Add vertices to surface mesh
addFaces	Add faces to surface mesh
removeVertices	Remove vertices from surface mesh
removeFaces	Remove faces from surface mesh
translate	Translate surface mesh
rotate	Rotate surface mesh
transform	Apply rigid transformation to surface mesh
vertexCenter	Find vertex center of surface mesh
scale	Scale vertices of surface mesh
computeNormals	Compute unit normals for mesh vertices and faces
crop	곡면 메시 자르기
simplify	Simplify surface mesh
subdivide	Subdivide surface mesh
isEdgeManifold	Check if surface mesh is edge-manifold
isOrientable	Check if surface mesh is orientable
isSelfIntersecting	Check if surface mesh is self-intersecting
isVertexManifold	Check if surface mesh is vertex-manifold
isWatertight	Check if surface mesh is watertight
removeDefects	Remove surface mesh defects

예제

직육면체 곡면 메시 만들기

직육면체에 대한 메시 꼭짓점을 정의합니다.

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];

꼭짓점을 사용하여 메시 면을 정의합니다.

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];

곡면 메시를 만듭니다.

mesh = surfaceMesh(vertices,faces);

곡면 메시를 표시합니다.

surfaceMeshShow(mesh,Title="Cuboid Mesh")

버전 내역

R2022b에 개발됨

참고 항목

pc2surfacemesh | readSurfaceMesh | writeSurfaceMesh | surfaceMeshShow | smoothSurfaceMesh | clusterConnectedFaces