@ue-too/board / index / clampZoomToHandler

函式: clampZoomToHandler()

clampZoomToHandler(destination, camera, config): number

定義於: packages/board/src/camera/camera-rig/zoom-handler.ts:207

Handler pipeline step that clamps "zoom to" targets to camera zoom boundaries.

參數

destination

number

Target zoom level

camera

BoardCamera

Current camera instance (provides zoomBoundaries)

config

ZoomHandlerClampConfig

Clamping configuration

回傳

number

Clamped zoom level

備註

This handler enforces zoom level limits on absolute zoom requests.

Behavior:

• If clampZoom is false: Returns destination unchanged
• If clampZoom is true: Clamps destination to BoardCamera.zoomBoundaries (min/max)

The clamping is performed by clampZoomLevel, which handles:

• Missing boundaries (undefined min/max)
• One-sided constraints (only min or only max)
• Full range constraints

Can be used standalone, but typically composed into a handler pipeline via createDefaultZoomToOnlyHandler or createHandlerChain.

範例

camera.zoomBoundaries = { min: 0.5, max: 3.0 };

const config: ZoomHandlerClampConfig = {
  clampZoom: true
};

const target = 5.0;  // Exceeds max
const clamped = clampZoomToHandler(target, camera, config);
// clamped = 3.0 (clamped to max boundary)

參閱

• clampZoomLevel for clamping implementation
• createDefaultZoomToOnlyHandler for default pipeline usage