loadModel()

3Dモデルを読み込んで p5.Geometryオブジェクトを作成します。

loadModel()はOBJおよびSTLファイルから3Dモデルを読み込むことができます。モデルが 読み込まれると、model(shape)のように model()関数で表示できます。

loadModel()を呼び出す方法は3つあり、モデルの処理を助けるためのオプションパラメータがあります。

最初のパラメータpathは常にファイルへのパスを示すStringです。ローカルファイルへのパスは loadModel('/assets/model.obj')のように相対パスで指定する必要があります。URL（例： 'https://example.com/model.obj'）はブラウザのセキュリティによってブロックされることがあります。

loadModel()を呼び出す最初の方法は、ファイルパスの後に3つのオプションパラメータがあります。最初のオプションパラメータsuccessCallbackは、モデルが読み込まれた後に呼び出される関数です。例えば、 loadModel('/assets/model.obj', handleModel)は、モデルが読み込まれた後にhandleModel()関数を呼び出します。2番目のオプションパラメータfailureCallbackは、モデルの読み込みに失敗した場合に呼び出される関数です。例えば、 loadModel('/assets/model.obj', handleModel, handleFailure)は、エラーが発生した場合にhandleFailure()関数を呼び出します。3番目のオプションパラメータfileTypeは、モデルのファイル拡張子を示す文字列です。例えば、 loadModel('/assets/model', handleModel, handleFailure, '.obj')は、ファイルモデルを.objファイルとして読み込もうとします。

loadModel()を呼び出す2番目の方法は、ファイルパスの後に4つのオプションパラメータがあります。最初のオプションパラメータはBoolean値です。trueが渡されると、例えばloadModel('/assets/model.obj', true)のように、モデルはキャンバスに収まるようにリサイズされます。次の3つのパラメータは、上記のsuccessCallback、failureCallback、およびfileTypeです。

loadModel()を呼び出す3番目の方法は、ファイルパスの後に1つのオプションパラメータがあります。オプションパラメータoptionsはオプションを持つObjectです。例えばloadModel('/assets/model.obj', options)のように。optionsオブジェクトには次のプロパティがあります：

let options = {
  // 読み込み中に標準化されたサイズスケーリングを有効にする場合はtrueに設定します。
  normalize: true,

  // モデルが読み込まれた後に呼び出される関数。
  successCallback: handleModel,

  // 読み込み中にエラーが発生した場合に呼び出される関数。
  failureCallback: handleError,

  // モデルのファイル拡張子。
  fileType: '.stl',

  // モデルのUテクスチャ座標を反転します。
  flipU: false,

  // モデルのVテクスチャ座標を反転します。
  flipV: false
};

// optionsオブジェクトをloadModel()に渡します。
loadModel('/assets/model.obj', options);

モデルの読み込みには時間がかかることがあります。preload()でloadModel()を呼び出すことで、モデルがsetup()やdraw()で使用される前に読み込まれることを保証します。

注意：カラー付きSTLファイルのサポートはありません。カラー付きSTLファイルは色なしでレンダリングされます。