readSurfaceMesh

標準メッシュ ファイル形式から表面メッシュ データを読み取り

R2022b 以降

ページ内をすべて折りたたむ

    構文

    mesh = readSurfaceMesh(fileName)

    説明

    mesh = readSurfaceMesh(fileName) は、指定されたファイル名をもつサポートされているメッシュ ファイル形式から表面メッシュ データを読み取り、それを surfaceMesh オブジェクトとして返します。

    例

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    表面メッシュ データの読み取り元の PLY ファイルを指定します。

    fileName = fullfile(toolboxdir("lidar"),"lidardata", ...
"surfaceMesh","sphere.ply");

    PLY ファイルからワークスペースに表面メッシュ データを読み取ります。

    mesh = readSurfaceMesh(fileName)
    mesh = 
  surfaceMesh with properties:

         Vertices: [482×3 double]
            Faces: [956×3 int32]
    VertexNormals: [482×3 double]
     VertexColors: []
      FaceNormals: []
       FaceColors: []
      NumVertices: 482
         NumFaces: 956

    表面メッシュを表示します。

    surfaceMeshShow(mesh)

    ライブ スクリプトを開く

    表面メッシュ データの読み取り元の STL ファイルを指定します。

    fileName = fullfile(toolboxdir("lidar"),"lidardata", ...
"surfaceMesh","mobius.stl");

    STL ファイルからワークスペースに表面メッシュ データを読み取ります。

    mesh = readSurfaceMesh(fileName)
    mesh = 
  surfaceMesh with properties:

         Vertices: [1050×3 double]
            Faces: [1960×3 int32]
    VertexNormals: []
     VertexColors: []
      FaceNormals: [1960×3 double]
       FaceColors: []
      NumVertices: 1050
         NumFaces: 1960

    表面メッシュを表示します。

    surfaceMeshShow(mesh)

    入力引数

    すべて折りたたむ

    読み取る表面メッシュ データのファイル名。文字ベクトルまたは string スカラーとして指定します。ファイル名と共にファイル拡張子を指定する必要があります。ファイルが作業フォルダー内にない場合は、ファイルの絶対パスを指定する必要があります。この関数は、次の標準メッシュ ファイル形式をサポートしています。

    • STL — 光造形法ファイル形式

    • PLY — ポリゴン ファイル形式

    • FBX® — Autodesk® Filmbox

    • OBJ — Wavefront® OBJ

    • GLTF — GL 伝送形式 glTF™

    • GLB — GL 伝送形式のバイナリ ファイル

    • OFF — Object File Format

    • DAE — COLLADA™ Digital Asset Exchange

    • STEP または STP — Standard for the Exchange of Product Data

    • IGES または IGS — Initial Graphics Exchange Specification

    データ型: char | string

    出力引数

    すべて折りたたむ

    表面メッシュ データ。surfaceMesh オブジェクトとして返されます。

    制限

    • 次の属性は STL ファイルから読み取ることができません。

      • 頂点法線

      • 頂点の色

      • 面の色

    • 面の色は PLY ファイルから読み取ることができません。

    • FBX ファイル形式から読み取ることができるのは、メッシュ頂点、頂点の色、およびメッシュの三角面のみです。

    • OBJ、GLTF、GLB、OFF、DAE、STEP、STP、IGES、または IGS ファイル形式から読み取ることができるのは、メッシュ頂点とメッシュの三角面のみです。

    バージョン履歴

    R2022b で導入

    すべて展開する

    参考

    | | |