All Implemented Interfaces:

android.view.View.OnTouchListener
```
public final class ModelViewer
 implements View.OnTouchListener
                    
```
Helps render glTF models into a SurfaceView or TextureView with an orbit controller.
ModelViewer owns a Filament engine, renderer, swapchain, view, and scene. It allows clients to access these objects via read-only properties. The viewer can display only one glTF scene at a time, which can be scaled and translated into the viewing frustum by calling transformToUnitCube. All ECS entities can be accessed and modified via the asset property.
For GLB files, clients can call loadModelGlb and pass in a Buffer with the contents of the GLB file. For glTF files, clients can call loadModelGltf and pass in a Buffer with the JSON contents, as well as a callback for loading external resources.
ModelViewer reduces much of the boilerplate required for simple Filament applications, but clients still have the responsibility of adding an IndirectLight and Skybox to the scene. Additionally, clients should:
- Pass the model viewer into SurfaceView.setOnTouchListener or call its onTouchEvent method from your touch handler.
- Call render and Animator.applyAnimation from a Choreographer frame callback.
NOTE: if its associated SurfaceView or TextureView has become detached from its window, the ModelViewer becomes invalid and must be recreated.
See sample-gltf-viewer for a usage example.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public final class`	`ModelViewer.SurfaceCallback`
`public class`	`ModelViewer.Companion`

Field Summary

Fields
Modifier and Type	Field	Description
`private FilamentAsset`	`asset`
`private Animator`	`animator`
`private final Float`	`progress`
`private Boolean`	`normalizeSkinningWeights`
`private Float`	`cameraFocalLength`
`private Float`	`cameraNear`
`private Float`	`cameraFar`
`private final Scene`	`scene`
`private final View`	`view`
`private final Camera`	`camera`
`private final Renderer`	`renderer`
`private final Integer`	`light`
`private final Engine`	`engine`

Constructor Summary

Constructors
Constructor	Description
`ModelViewer(SurfaceView surfaceView, Engine engine, UiHelper uiHelper, Manipulator manipulator)`
`ModelViewer(TextureView textureView, Engine engine, UiHelper uiHelper, Manipulator manipulator)`
`ModelViewer(Engine engine, UiHelper uiHelper)`

Method Summary

Modifier and Type	Method	Description
`final FilamentAsset`	`getAsset()`
`final Unit`	`setAsset(FilamentAsset asset)`
`final Animator`	`getAnimator()`
`final Unit`	`setAnimator(Animator animator)`
`final Float`	`getProgress()`
`final Boolean`	`getNormalizeSkinningWeights()`
`final Unit`	`setNormalizeSkinningWeights(Boolean normalizeSkinningWeights)`
`final Float`	`getCameraFocalLength()`
`final Unit`	`setCameraFocalLength(Float cameraFocalLength)`
`final Float`	`getCameraNear()`
`final Unit`	`setCameraNear(Float cameraNear)`
`final Float`	`getCameraFar()`
`final Unit`	`setCameraFar(Float cameraFar)`
`final Scene`	`getScene()`
`final View`	`getView()`
`final Camera`	`getCamera()`
`final Renderer`	`getRenderer()`
`final Integer`	`getLight()`
`final Engine`	`getEngine()`
`final Unit`	`loadModelGlb(Buffer buffer)`	Loads a monolithic binary glTF and populates the Filament scene.
`final Unit`	`loadModelGltf(Buffer buffer, Function1<String, Buffer> callback)`	Loads a JSON-style glTF file and populates the Filament scene.
`final Unit`	`loadModelGltfAsync(Buffer buffer, Function1<String, Buffer> callback)`	Loads a JSON-style glTF file and populates the Filament scene.
`final Unit`	`transformToUnitCube(Float3 centerPoint)`	Sets up a root transform on the current model to make it fit into a unit cube.
`final Unit`	`clearRootTransform()`	Removes the transformation that was set up via transformToUnitCube.
`final Unit`	`destroyModel()`	Frees all entities associated with the most recently-loaded model.
`final Unit`	`render(Long frameTimeNanos)`	Renders the model and updates the Filament camera.
`final Unit`	`onTouchEvent(MotionEvent event)`	Handles a MotionEvent to enable one-finger orbit, two-finger pan, and pinch-to-zoom.
`Boolean`	`onTouch(View view, MotionEvent event)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ModelViewer

ModelViewer(SurfaceView surfaceView, Engine engine, UiHelper uiHelper, Manipulator manipulator)

ModelViewer

ModelViewer(TextureView textureView, Engine engine, UiHelper uiHelper, Manipulator manipulator)

ModelViewer

ModelViewer(Engine engine, UiHelper uiHelper)

Method Detail
- getAsset
```
 final FilamentAsset getAsset()
```
- setAsset
```
 final Unit setAsset(FilamentAsset asset)
```
- getAnimator
```
 final Animator getAnimator()
```
- setAnimator
```
 final Unit setAnimator(Animator animator)
```
- getProgress
```
 final Float getProgress()
```
- getNormalizeSkinningWeights
```
 final Boolean getNormalizeSkinningWeights()
```
- setNormalizeSkinningWeights
```
 final Unit setNormalizeSkinningWeights(Boolean normalizeSkinningWeights)
```
- getCameraFocalLength
```
 final Float getCameraFocalLength()
```
- setCameraFocalLength
```
 final Unit setCameraFocalLength(Float cameraFocalLength)
```
- getCameraNear
```
 final Float getCameraNear()
```
- setCameraNear
```
 final Unit setCameraNear(Float cameraNear)
```
- getCameraFar
```
 final Float getCameraFar()
```
- setCameraFar
```
 final Unit setCameraFar(Float cameraFar)
```
- getScene
```
 final Scene getScene()
```
- getView
```
 final View getView()
```
- getCamera
```
 final Camera getCamera()
```
- getRenderer
```
 final Renderer getRenderer()
```
- getLight
```
 final Integer getLight()
```
- getEngine
```
 final Engine getEngine()
```
- loadModelGlb
```
 final Unit loadModelGlb(Buffer buffer)
```
  Loads a monolithic binary glTF and populates the Filament scene.
- loadModelGltf
```
 final Unit loadModelGltf(Buffer buffer, Function1<String, Buffer> callback)
```
  Loads a JSON-style glTF file and populates the Filament scene.
  The given callback is triggered for each requested resource.
- loadModelGltfAsync
```
 final Unit loadModelGltfAsync(Buffer buffer, Function1<String, Buffer> callback)
```
  Loads a JSON-style glTF file and populates the Filament scene.
  The given callback is triggered from a worker thread for each requested resource.
- transformToUnitCube
```
 final Unit transformToUnitCube(Float3 centerPoint)
```
  Sets up a root transform on the current model to make it fit into a unit cube.
  
  Parameters:
  
  centerPoint - Coordinate of center point of unit cube, defaults to < 0, 0, -4 >
- clearRootTransform
```
 final Unit clearRootTransform()
```
  Removes the transformation that was set up via transformToUnitCube.
- destroyModel
```
 final Unit destroyModel()
```
  Frees all entities associated with the most recently-loaded model.
- render
```
 final Unit render(Long frameTimeNanos)
```
  Renders the model and updates the Filament camera.
  
  Parameters:
  
  frameTimeNanos - time in nanoseconds when the frame started being rendered, typically comes from {@link android.view.Choreographer.
- onTouchEvent
```
 final Unit onTouchEvent(MotionEvent event)
```
  Handles a MotionEvent to enable one-finger orbit, two-finger pan, and pinch-to-zoom.
- onTouch
```
 Boolean onTouch(View view, MotionEvent event)
```

Class ModelViewer

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ModelViewer

ModelViewer

ModelViewer

Method Detail

getAsset

setAsset

getAnimator

setAnimator

getProgress

getNormalizeSkinningWeights

setNormalizeSkinningWeights

getCameraFocalLength

setCameraFocalLength

getCameraNear

setCameraNear

getCameraFar

setCameraFar

getScene

getView

getCamera

getRenderer

getLight

getEngine

loadModelGlb

loadModelGltf

loadModelGltfAsync

transformToUnitCube

clearRootTransform

destroyModel

render

onTouchEvent

onTouch