stlwrite

R2026b

삼각분할에서 STL 파일 생성

구문

stlwrite(TR,filename)

stlwrite(TR,filename,fileformat)

stlwrite(___,Name=Value)

설명

stlwrite(TR,filename)은 삼각분할 TR을 이진 STL 파일 filename에 씁니다. 삼각분할은 triangulation 객체이거나 2차원 delaunayTriangulation 객체일 수 있습니다.

stlwrite(TR,filename,fileformat)은 작성된 파일의 파일 형식도 지정합니다. fileformat은 "binary"(디폴트 값)이거나 "text"일 수 있습니다.

stlwrite(___,Name=Value)는 위에 열거된 구문에 대해 이름-값 인수를 하나 이상 사용하여 STL 파일에 쓰기 위한 추가 옵션을 지정합니다. 예를 들어, stlwrite(TR,"stlbinary",Attribute=attributes)는 TR의 각 삼각형에 대한 특성으로 구성된 uint16형 벡터도 씁니다.

예제

교차 링

두 개의 교차 링을 나타내는 삼각분할을 만들고, 그 결과를 STL 파일에 씁니다.

첫 번째 링을 나타내기 위해 내부 반지름이 1이고 외부 반지름이 5인 원환면 곡면을 정의합니다.

R = 5;
r = 1;
angle = linspace(0,2*pi,50);
angle(end) = []; % Omit the repeated point for 0 and 2pi
[theta,omega] = meshgrid(angle,angle);

원환면을 나타내기 위해 x, y, z를 정의합니다.

X = (R+r.*cos(theta)).*cos(omega);
Y = (R+r.*cos(theta)).*sin(omega);
Z = r.*sin(theta);

알파 반지름이 2인 alphaShape 객체를 만듭니다.

shp = alphaShape(X(:),Y(:),Z(:),2);

alphaShape의 경계 곡면에서 삼각분할을 추출합니다. 이 삼각분할은 첫 번째 링을 나타냅니다.

[tri,xyz] = shp.boundaryFacets;
t1 = triangulation(tri,xyz);

삼각분할을 회전하여 두 번째 링을 정의합니다.

t2 = triangulation(tri,xyz*[1 0 0;0 0 1;0 1 0] + [4 0 0]);

두 삼각분할을 결합합니다.

Points = [t1.Points;t2.Points];
Connectivity = ...
[t1.ConnectivityList;
    t2.ConnectivityList + size(t1.Points,1)];
trCombined = triangulation(Connectivity,Points);

그 결과로 생성된 삼각분할을 플로팅합니다.

p = trisurf(trCombined);
p.EdgeAlpha = 0.4;

삼각분할에서 STL 파일을 만듭니다.

stlwrite(trCombined,"Rings.stl");

STL 텍스트 파일에 삼각분할 쓰기

2차원 triangulation 객체를 만들고 플로팅합니다.

P = [2.5 8.0;
     6.5 8.0;
     2.5 5.0;
     6.5 5.0;
     1.0 6.5;
     8.0 6.5];
T = [5 3 1;
     3 2 1;
     3 4 2;
     4 6 2];
TR = triangulation(T,P);
triplot(TR)

삼각분할을 tritext.stl이라는 텍스트 파일에 씁니다.

stlwrite(TR,"tritext.stl","text")

입력 인수

TR — 삼각분할

triangulation 객체 | 2차원 delaunayTriangulation 객체

삼각분할로, triangulation 객체 또는 2차원 delaunayTriangulation 객체로 지정됩니다.

filename — STL 파일 이름

문자형 벡터 | 스칼라 string

STL 파일 이름으로, 문자형 벡터 또는 스칼라 string형으로 지정됩니다. 파일 이름은 .stl 또는 .STL 확장자로 끝나야 합니다.

예: "stltextfile.stl"

fileformat — 파일 형식

"binary" | "text"

파일 형식으로, "binary" 또는 "text"로 지정됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: stlwrite(TR,"stltext",SolidIndex=solidIDs)

Attribute — 이진 특성

uint16형 벡터

이진 특성으로, uint16형 벡터로 지정됩니다. 입력 파일이 이진 파일인 경우, attributes에는 삼각형에 대한 코드화된 정보가 포함될 수 있습니다. 길이는 삼각분할 내의 삼각형 수와 동일해야 합니다. 입력 파일이 텍스트 파일인 경우에는 이 파라미터가 지원되지 않습니다.

SolidIndex — 솔리드 그룹화 인덱스

벡터

솔리드 그룹화 인덱스로, 식별 번호로 구성된 벡터로 지정됩니다. 입력 파일이 텍스트 파일인 경우 식별 번호는 각 삼각형을 삼각분할의 삼각형 그룹에 할당해야 합니다. 벡터의 길이는 삼각분할 내의 삼각형 수와 동일해야 합니다. 입력 파일이 이진 파일인 경우에는 이 파라미터가 지원되지 않습니다.

확장 기능

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2018b에 개발됨

참고 항목

stlread | triangulation | delaunayTriangulation