레퍼런스 loadModel()

loadModel()

3D 모델을 불러와 p5.Geometry 객체를 만듭니다.

loadModel() 은 OBJ 및 STL 파일로부터 3D 모델을 불러올 수 있습니다. 모델을 불러오면, model() 함수를 사용하여, 예를 들어 model(shape) 와 같이 모델을 표시할 수 있습니다.

loadModel() 호출하는 방법은 총 세 가지로, 이는 모델을 처리하는 데 도움이 되는 선택적 매개변수 세 가지를 활용합니다.

첫 번째 매개변수 path 는 항상 String이며, 파일의 경로를 나타냅니다. 로컬 파일의 경로는 loadModel('/assets/model.obj')와 같이 상대적으로 지정되어야 합니다.'https://example.com/model.obj'` 와 같은 URL은 브라우저 보안으로 인해 차단될 수 있습니다.

loadModel() 을 호출하는 첫 번째 방법은 파일 경로 뒤에 세 가지 선택적 매개변수를 갖습니다. 첫 번째 선택적 매개변수인 successCallback 는 모델을 최초로 불러온 뒤 호출할 함수입니다. 예를 들어, loadModel('/assets/model.obj', handleModel) 는 모델이 로드되면 handleModel() 함수를 호출합니다. 두 번째 선택적 매개변수 failureCallback 는 모델이 로드되지 않으면 호출할 함수입니다. 예를 들어, loadModel('/assets/model.obj', handleModel, handleFailure) 는 로드 중 오류가 발생하면 handleFailure() 함수를 호출합니다. 세 번째 선택적 매개변수, fileType 는 모델의 파일 확장자를 나타내는 문자열입니다. 예를 들어 loadModel('/assets/model', handleModel, handleFailure, '.obj') 는 파일 모델을 .obj 파일로 불러오려고 시도합니다.

loadModel() 을 호출하는 두 번째 방법은 파일 경로 뒤에 네 가지 선택적 매개변수를 갖습니다. 첫 번째 선택적 매개변수는 Boolean 값입니다. 예를 들어, trueloadModel('/assets/model.obj', true) 에 전달하면, 모델의 크기가 캔버스 크기에 맞도록 재조정됩니다. 그 다음 세 가지 매개변수는 위에서 설명한 successCallback, failureCallback 그리고 fileType 입니다.

loadModel() 을 호출하는 세 번째 방법은 파일 경로 뒤에 하나의 선택적 매개변수를 갖습니다. 선택적 매개변수 optionsloadModel('/assets/model.obj', options)와 같이 옵션을 가진 Object 입니다. options 객체는 다음의 속성을 가질 수 있습니다:

let options = { // Enables standardized size scaling during loading if set to true. normalize: true, <p> // Function to call once the model loads. successCallback: handleModel,</p> <p> // Function to call if an error occurs while loading. failureCallback: handleError,</p> <p> // Model's file extension. fileType: '.stl',</p> <p> // Flips the U texture coordinates of the model. flipU: false,</p> <p> // Flips the V texture coordinates of the model. flipV: false };</p> <p>// Pass the options object to loadModel(). loadModel('/assets/model.obj', options); </p>

Models can take time to load. Calling loadModel() in preload() ensures models load before they're used in setup() or draw().

Note: There’s no support for colored STL files. STL files with color will be rendered without color.

예제

구문

loadModel(path, normalize, [successCallback], [failureCallback], [fileType])
loadModel(path, [successCallback], [failureCallback], [fileType])
loadModel(path, [options])

매개변수

path
String:

불러올 모델의 경로.

normalize
Boolean:

true인 경우 캔버스에 맞게 모델 사이즈를 맞춥니다.

successCallback
function(p5.Geometry):

모델을 불러오면 호출할 함수입니다. 매개변수로 p5.Geometry 객체를 받습니다.

failureCallback
Function(Event):

모델을 불러오는 중 오류가 발생하면 호출할 함수입니다. Error 이벤트 객체를 받습니다.

fileType
String:

모델의 파일 확장자. '.obj' 또는 '.stl'.

options
Object:

모델 불러오기 옵션.

Returns

p5.Geometry: the p5.Geometry object
Notice any errors or typos? Please let us know. Please feel free to edit src/webgl/loading.js and open a pull request!

관련 레퍼런스