surfaceMeshShow

R2026b

곡면 메시 표시

R2022b 이후

페이지 내 모두 축소

    구문

    surfaceMeshShow(surfaceMeshObj)
    surfaceMeshShow(triangulationObj)
    surfaceMeshShow(vertices,faces)
    surfaceMeshShow(___,Name=Value)

    설명

    surfaceMeshShow(surfaceMeshObj)는 surfaceMeshObj 객체에 의해 지정된 곡면 메시를 표시합니다.

    예제

    surfaceMeshShow(triangulationObj)는 triangulation 객체에 의해 지정된 곡면 메시를 표시합니다.

    surfaceMeshShow(vertices,faces)는 입력 꼭짓점과 입력 면에 의해 정의된 곡면 메시를 표시합니다.

    surfaceMeshShow(___,Name=Value)는 위에 열거된 구문의 인수 조합 외에 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어, Title="Cuboid"는 곡면 메시를 표시할 때 제목 "Cuboid"를 사용합니다.

    예제

    예제

    모두 축소

    라이브 스크립트 열기

    곡면 메시에 대한 메시 꼭짓점과 메시 면을 정의합니다.

    vertices = [0 0 0; 0 0 1; 0 1 1; 0 0 2; 1 0.5 1];
faces = [1 2 3; 2 3 4; 2 3 5];

    꼭짓점과 면을 사용하여 surfaceMesh 객체를 만듭니다.

    mesh = surfaceMesh(vertices,faces);

    곡면 메시를 표시합니다.

    surfaceMeshShow(mesh,Title="Surface Mesh",ColorMap="hot",BackgroundColor="blue")

    Viewer3D 객체를 만들어 곡면 메시를 표시합니다.

    viewer = viewer3d;
viewer.CameraPosition = [-2 2 0];

    viewer.CameraZoom = 0.5;
surfaceMeshShow(mesh,Parent=viewer,Title="Surface Mesh With Viewer")
    라이브 스크립트 열기

    3차원 삼각분할을 나타내는 triangulation 객체를 만듭니다.

    [x,y] = meshgrid(1:15,1:15);
tri = delaunay(x,y);
z = peaks(15);
triangulationObject = triangulation(tri,x(:),y(:),z(:));

    삼각분할에 의해 정의된 곡면 메시를 표시합니다.

    surfaceMeshShow(triangulationObject,ColorMap="summer",Title="Triangulation Object Mesh");

    입력 인수

    모두 축소

    곡면 메시 데이터로, surfaceMesh 객체로 지정됩니다.

    곡면 메시의 삼각분할로, triangulation 객체로 지정됩니다.

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

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

    이름-값 인수

    모두 축소

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

    예: surfaceMeshShow(mesh,Title="Cuboid")는 곡면 메시를 표시할 때 제목 "Cuboid"를 사용합니다.

    곡면 메시의 컬러맵으로, 다음 옵션 중 하나로 지정됩니다.

    컬러맵 이름색조

    parula

    Colorbar showing the colors of the parula colormap. The colormap starts at dark blue and transitions to lighter blue, green, orange and yellow. The transitions between colors are more perceptually uniform than in most other colormaps.

    turbo

    Colorbar showing the colors of the turbo colormap. The colormap starts at dark blue and transitions to lighter blue, bright green, orange, yellow, and dark red. This colormap is similar to jet, but the transitions between colors are more perceptually uniform than in jet.

    hsv

    Colorbar showing the colors of the hsv colormap. The colormap starts at red and transitions to yellow, bright green, cyan, dark blue, magenta, and bright orange.

    hot

    Colorbar showing the colors of the hot colormap. The colormap starts at dark red and transitions to bright red, orange, yellow, and white.

    cool

    Colorbar showing the colors of the cool colormap. The colormap starts at cyan and transitions to light blue, light purple, and magenta.

    spring

    Colorbar showing the colors of the spring colormap. The colormap starts at magenta and transitions to pink, light orange, and yellow.

    summer

    Colorbar showing the colors of the summer colormap. The colormap starts at medium green and transitions to yellow.

    autumn

    Colorbar showing the colors of the autumn colormap. The colormap starts at bright orange and transitions to yellow.

    winter

    Colorbar showing the colors of the winter colormap. The colormap starts at dark blue and transitions to bright green.

    gray

    Colorbar showing the gray colormap. The colormap starts at black and transitions to white.

    bone

    Colorbar showing the bone colormap. This colormap has colors that are approximately gray with a slight blue color tint. The colormap starts at dark gray and transitions to white.

    copper

    Colorbar showing the copper colormap. This colormap starts at black and transitions to a medium orange, similar to the color of copper.

    pink

    Colorbar showing the pink colormap. This colormap starts at dark red and transitions to dark pink, tan, and white.

    sky (R2023a 이후)

    Colorbar showing the sky colormap. This colormap starts at a very light shade of blue and transitions to a darker shade of blue.

    abyss (R2023b 이후)

    Colorbar showing the abyss colormap. This colormap starts at a very dark shade of blue and transitions to a lighter shade of blue.

    nebula (R2025a 이후)

    Colorbar showing the nebula colormap. This colormap starts at a medium shade of blue and transitions to a bright shade of red.

    jet

    Colorbar showing the colors of the jet colormap. The colormap starts at dark blue and transitions to light blue, bright green, orange, yellow, and dark red.

    lines

    Colorbar showing the colors of the lines colormap. The colormap contains a repeating pattern of colors: dark blue, dark orange, dark yellow, dark purple, medium green, light blue, and dark red.

    colorcube

    Colorbar showing the colors of the colorcube colormap. The colormap is a course sampling of the RGB colorspace.

    prism

    Colorbar showing the colors of the prism colormap. The colormap contains a repeating pattern of colors: red, orange, yellow, green, blue, and purple.

    flag

    Colorbar showing the colors of the flag colormap. The colormap contains a repeating pattern of colors: red, white, blue, and black.

    white

    Colorbar showing the white colormap, which is entirely white.

    자세한 내용은 colormap 항목을 참조하십시오.

    곡면 메시의 배경 색으로, 다음 옵션 중 하나로 지정됩니다.

    • RGB 3색 - 색의 빨간색, 녹색, 파란색 성분의 농도를 지정하는 요소를 3개 가진 행 벡터입니다. 농도는 [0,1] 범위 안에 있어야 합니다(예: [0.4 0.6 0.7]).

    • 16진수 색 코드 - 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리 16진수 숫자(범위: 0~F)가 오는 문자형 벡터 또는 string형 스칼라입니다. 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 "#FF8800", "#ff8800", "#F80", "#f80"은 동일합니다.

    • 색 이름 또는 짧은 이름 - 색의 이름을 지정합니다(예: "red" 또는 "green"). 짧은 이름은 색 이름의 문자를 사용하여 지정합니다(예: "r" 또는 "g").

    RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.

    아래 표에는 이름이 지정된 색 옵션, 그에 해당하는 RGB 3색, 16진수 색 코드가 나열되어 있습니다.

    색 이름짧은 이름RGB 3색16진수 색 코드
    "red""r"[1 0 0]"#FF0000"
    "green""g"[0 1 0]"#00FF00"
    "blue""b"[0 0 1]"#0000FF"
    "cyan" "c"[0 1 1]"#00FFFF"
    "magenta""m"[1 0 1]"#FF00FF"
    "yellow""y"[1 1 0]"#FFFF00"
    "black""k"[0 0 0]"#000000"
    "white""w"[1 1 1]"#FFFFFF"

    곡면 메시의 투명도로, 범위 [0, 1]에 있는 양의 스칼라로 지정됩니다. 값 1을 설정하면 메시가 완전히 불투명해지고, 값 0을 설정하면 완전히 투명해지며, 이 둘 사이의 값을 설정하면 반투명해집니다.

    데이터형: single | double

    메시 곡면을 와이어프레임으로 표시할지 여부로, 논리값 true 또는 false로 지정됩니다. true로 설정한 경우 함수는 메시 곡면을 와이어프레임으로 표시합니다. 그 외의 경우에는 곡면이 완전히 채워진 상태로 표시됩니다.

    데이터형: logical

    메시 꼭짓점만 표시할지 여부로, 논리값 true 또는 false로 지정됩니다. true로 설정한 경우 함수는 메시 꼭짓점만 표시합니다.

    데이터형: logical

    곡면 메시 표시에 사용할 제목으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 이 값은 기본적으로 비어 있습니다.

    데이터형: char | string

    surfaceMesh 객체의 부모로, Viewer3D (Image Processing Toolbox) 객체로 지정됩니다. Viewer3D 객체는 viewer3d (Image Processing Toolbox) 함수를 사용하여 만들 수 있습니다. 부모를 지정하지 않고 surfaceMeshShow를 호출하는 경우 함수는 새 Viewer3D 객체를 생성하고 이 객체를 부모로 설정합니다. surfaceMesh 객체의 부모를 다시 지정할 수는 없습니다.

    버전 내역

    R2022b에 개발됨

    모두 확장

    참고 항목

    함수

    객체