readSurfaceMesh

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

R2022b 以降

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

構文

mesh = readSurfaceMesh(fileName)

説明

例

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

例

すべて折りたたむ

PLY ファイルからの表面メッシュの読み取り

ライブスクリプトを開く

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

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

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

mesh = readSurfaceMesh(fileName)

mesh = 
  surfaceMesh with properties:

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

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

surfaceMeshShow(mesh)

STL ファイルからの表面メッシュの読み取り

ライブスクリプトを開く

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

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

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

mesh = readSurfaceMesh(fileName)

mesh = 
  surfaceMesh with properties:

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

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

surfaceMeshShow(mesh)

入力引数

すべて折りたたむ

`fileName` — 読み取る表面メッシュデータのファイル名
文字ベクトル | string スカラー

読み取る表面メッシュデータのファイル名。文字ベクトルまたは 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

出力引数

すべて折りたたむ

`mesh` — 表面メッシュデータ
`surfaceMesh` オブジェクト

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

制限

次の属性は STL ファイルから読み取ることができません。
- 頂点法線
- 頂点の色
- 面の色
面の色は PLY ファイルから読み取ることができません。
FBX ファイル形式から読み取ることができるのは、メッシュ頂点、頂点の色、およびメッシュの三角面のみです。
OBJ、GLTF、GLB、OFF、DAE、STEP、STP、IGES、または IGS ファイル形式から読み取ることができるのは、メッシュ頂点とメッシュの三角面のみです。