RedGPU API - v3.9.0-Alpha
    Preparing search index...

    Class FollowController

    특정 타겟 메시를 따라다니는 3D 카메라 컨트롤러

    카메라는 타겟 메시 주변을 구면 좌표계로 회전하며, 거리(distance), 높이(height), 팬(pan), 틸트(tilt) 값을 통해 위치를 제어합니다. 타겟 메시의 이동과 회전을 자동으로 추적하며, 부드러운 카메라 움직임을 위한 보간(interpolation) 기능을 지원합니다.

    const followController = new new RedGPU.Camera.FollowController(redGPUContext, targetMesh);
    followController.distance = 15;
    followController.height = 8;
    followController.pan = 45;
    followController.tilt = 30;

    Hierarchy (View Summary)

    Index

    Constructors

    Accessors

    • get distanceInterpolation(): number

      거리 값의 보간 계수를 가져옵니다.

      Returns number

      거리 보간 계수 (0.01 ~ 1)

    • set distanceInterpolation(value: number): void

      거리 값의 보간 계수를 설정합니다. 낮을수록 부드러운 움직임, 높을수록 빠른 응답

      Parameters

      • value: number

        보간 계수 (0.01 ~ 1)

      Returns void

    • get followTargetRotation(): boolean

      타겟 메시의 회전을 따를지 여부를 가져옵니다.

      Returns boolean

      true일 경우 타겟의 회전을 따름

    • set followTargetRotation(value: boolean): void

      타겟 메시의 회전을 따를지 여부를 설정합니다.

      Parameters

      • value: boolean

        true일 경우 타겟의 회전을 따름

      Returns void

    • get interpolation(): number

      전체 카메라 위치의 보간 계수를 가져옵니다.

      Returns number

      보간 계수 (0.01 ~ 1)

    • set interpolation(value: number): void

      전체 카메라 위치의 보간 계수를 설정합니다. 낮을수록 부드러운 움직임, 높을수록 빠른 응답

      Parameters

      • value: number

        보간 계수 (0.01 ~ 1)

      Returns void

    • get keyboardProcessedThisFrame(): boolean

      Returns boolean

    • set keyboardProcessedThisFrame(value: boolean): void

      Parameters

      • value: boolean

      Returns void

    • get tilt(): number

      타겟을 중심으로 한 카메라의 세로 회전(틸트) 각도를 가져옵니다.

      Returns number

      틸트 각도 (도 단위, -89 ~ 89)

    • set tilt(value: number): void

      타겟을 중심으로 한 카메라의 세로 회전(틸트) 각도를 설정합니다. -89도에서 89도 범위로 제한됩니다.

      Parameters

      • value: number

        틸트 각도 (도 단위)

      Returns void

    Methods

    • 키보드 입력이 있는지 체크하고 활성 View를 설정합니다.

      Type Parameters

      • T extends Record<string, string>

      Parameters

      • view: View3D

        현재 View

      • keyNameMapper: T

        키 매핑 객체

      Returns boolean

      키보드 입력 처리가 가능하면 true, 아니면 false

    • 카메라의 타겟 오프셋을 한 번에 설정합니다.

      Parameters

      • x: number

        X축 오프셋

      • Optionaly: number = 0

        Y축 오프셋 (기본값: 0)

      • Optionalz: number = 0

        Z축 오프셋 (기본값: 0)

      Returns void

    • 매 프레임마다 카메라의 위치와 방향을 업데이트합니다.

      현재 값들을 목표 값으로 보간하고, 카메라의 위치와 lookAt 대상을 설정합니다.

      Parameters

      • view: View3D

        카메라가 속한 3D 뷰

      • time: number

        현재 시간 (ms)

      Returns void