Lens

Changes fov, orthographic size, near and far, with damping.

Sets the camera's fov, orthographicSize, near and far. Leave one out to keep the current value. Each one can be damped separately, for effects like a speed zoom.

Set lens values through Lens, not on the real camera directly. Klipp writes the lens every time the shot changes, so direct changes get overwritten, for example by the next blend.

Settings

Setting	Description	Default
`fov`	Field of view, in degrees.
`orthographicSize`	Half the view's height in world units, for an orthographic camera.
`near`	Near clipping plane.
`far`	Far clipping plane.
`fovDamping`	Seconds to reach a new `fov`. See Damping.	`0`
`orthographicSizeDamping`	Seconds to reach a new `orthographicSize`.	`0`
`nearDamping`	Seconds to reach a new `near`.	`0`
`farDamping`	Seconds to reach a new `far`.	`0`
`fovMaxSpeed`	Maximum `fov` change, in degrees per second.	`Infinity`
`orthographicSizeMaxSpeed`	Maximum `orthographicSize` change, in units per second.	`Infinity`
`nearMaxSpeed`	Maximum `near` change, in units per second.	`Infinity`
`farMaxSpeed`	Maximum `far` change, in units per second.	`Infinity`

Usage

import { LensExtension } from '@pmndrs/klipp';

const lens = new LensExtension({ fov: 50, fovDamping: 0.4 });
camera.addExtension(lens);

// any time later
lens.fov = boosting ? 75 : 50;

import { LensExtension } from '@pmndrs/klipp';

const lens = new LensExtension({ fov: 50, fovDamping: 0.4 });
camera.addExtension(lens);

// any time later
lens.fov = boosting ? 75 : 50;

<VirtualCamera name="chase" priority={10}>
  <Body.Follow target={carRef} offset={[0, 2, 6]} />
  <Aim.HardLookAt target={carRef} />
  <Extension.Lens fov={boosting ? 75 : 50} fovDamping={0.4} />
</VirtualCamera>

ref gives you the LensExtension. To change the lens every frame without re-rendering, set its fields directly:

const lens = useRef<LensExtension>(null);

useFrame(() => {
  lens.current.fov = 50 + speed * 0.5;
});

Edit this page