Skip to content

third-person-view.md

Latest commit

 

History

History
69 lines (39 loc) · 2.46 KB

third-person-view.md

File metadata and controls

69 lines (39 loc) · 2.46 KB

geospatial

ThirdPersonView Class (Experimental)

The [ThirdPersonView] class is a subclass of View. This view creates a "camera" in a position that looks at an exact position, position using the direction, distance and orientation specified by the application, in contrast with e.g. FirstPersonView that looks out from the position specified in the view state.

To render, a ThirdPersonView needs to be combined with a viewState object with the following parameters:

  • position (Number[3]) - position

A ThirdPersonView will work with geospatial coordinate systems if a geospatial "anchor point" is provided in the viewState via:

  • longitude
  • latitude
  • zoom

The position vector will then be interpreted as meter offsets from this anchor point.

For more information on using View classes, consult the Views article.

Usage

const view = new ThirdPersonView({
  // Projection parameters (perspective projection)
  fov: 45
});

Constructor

new ThirdPersonView({fov: 45, width: 500, height: 500, ...});

ThirdPersonView takes the same parameters as the View superclass constructor.

Parameters:

  • opts (Object) - Third person view options

    projection matrix arguments:

    • fov (Number, optional) - Field of view covered by camera. Default to 75.
    • near (Number, optional) - Distance of near clipping plane. Default to 1.
    • far (Number, optional) - Distance of far clipping plane. Default to 100.
    • aspect (Number, optional) - Aspect ratio. Default to the view's width/height.

See View constructor for additional parameters, especially for specifying alternate projection matrices, geospatial anchor etc.

Methods

Inherits all View methods.

Remarks

  • Like all Views, the ThirdPersonView will work with all geospatial coordinate systems if a geospatial "anchor point" is supplied through the longitude, latitude and zoom options. The position vector will then be interpreted as meter offsets from this anchor point.

Source

modules/core/src/core/views/third-person-view.js