@ue-too/board / index / clampZoomByHandler

関数: clampZoomByHandler()

clampZoomByHandler(delta, camera, config): number

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

Handler pipeline step that clamps "zoom by" deltas to prevent boundary violations.

パラメータ

delta

number

Zoom level change

camera

BoardCamera

Current camera instance (provides current zoom and boundaries)

config

ZoomHandlerClampConfig

Clamping configuration

戻り値

number

Adjusted delta that respects zoom boundaries

Remarks

This handler ensures that applying the delta won't exceed zoom boundaries.

Algorithm:

1. Calculate potential new zoom level (current + delta)
2. Clamp that level to boundaries
3. Return the difference (clamped - current) as the new delta

Behavior:

• If clampZoom is false: Returns delta unchanged
• If clampZoom is true: Adjusts delta to stay within boundaries

The resulting delta may be zero if already at a boundary and trying to zoom further.

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

例

camera.zoomLevel = 2.8;
camera.zoomBoundaries = { max: 3.0 };

const config: ZoomHandlerClampConfig = {
  clampZoom: true
};

const delta = 0.5;  // Would exceed max
const clamped = clampZoomByHandler(delta, camera, config);
// clamped = 0.2 (only zoom to boundary, not beyond)

参照

• clampZoomLevel for clamping implementation
• createDefaultZoomByOnlyHandler for default pipeline usage