본문 바로가기
카테고리 없음

DOTween

giihan 2025. 5. 23. 16:32
반응형
SMALL

DOTween은 Unity에서 애니메이션을 간편하게 구현할 수 있도록 도와주는 강력한 트윈(Tween) 엔진입니다. 다양한 API를 통해 오브젝트의 위치, 회전, 스케일, 색상 등 여러 속성을 부드럽게 변화시킬 수 있습니다. 아래는 DOTween의 주요 API를 정리한 내용입니다.

📌 DOTween 주요 API 정리

1. DOTween 클래스 (정적 메서드)

DOTween의 핵심 클래스이며, 트윈을 생성하고 제어하는 다양한 정적 메서드를 제공합니다.

  • 초기화 및 설정
    • Init(...): DOTween을 초기화합니다.
    • SetTweensCapacity(tweenersCapacity, sequencesCapacity): 트윈과 시퀀스의 최대 용량을 설정합니다.
  • 트윈 생성
    • To(getter, setter, endValue, duration): 일반적인 트윈을 생성합니다.
    • Sequence(): 시퀀스를 생성하여 여러 트윈을 순차적으로 실행할 수 있습니다.
  • 트윈 제어
    • Play(target), Pause(target), Kill(target): 트윈을 재생, 일시정지, 종료합니다.
    • Restart(target), Rewind(target), Complete(target): 트윈을 재시작, 되감기, 즉시 완료합니다.

자세한 내용은 DOTween Class Reference를 참고하세요.

2. ShortcutExtensions 클래스

Unity의 다양한 컴포넌트(Transform, Rigidbody, Material 등)에 확장 메서드를 제공하여 간편하게 트윈을 생성할 수 있습니다.

  • Transform 관련
    • DOMove(endValue, duration): 위치를 이동합니다.
    • DORotate(endValue, duration): 회전을 변경합니다.
    • DOScale(endValue, duration): 스케일을 변경합니다.YouTube
  • Material 관련
  • Camera, Light 등 기타 컴포넌트
    • 카메라의 배경색 변경, 라이트의 강도 조절 등 다양한 메서드를 제공합니다.

자세한 내용은 ShortcutExtensions Class Reference를 참고하세요.

3. Tweener 클래스

단일 속성을 애니메이션화하는 트윈 객체입니다.

  • 속성 변경
    • ChangeStartValue(newStartValue, newDuration): 시작 값을 변경합니다.
    • ChangeEndValue(newEndValue, newDuration, snapStartValue): 종료 값을 변경합니다.
    • ChangeValues(newStartValue, newEndValue, newDuration): 시작 및 종료 값을 동시에 변경합니다.
  • 콜백 설정
    • OnStart(callback), OnUpdate(callback), OnComplete(callback): 트윈의 특정 시점에 콜백을 설정합니다.

자세한 내용은 Tweener Class Reference를 참고하세요.

4. Sequence 클래스

여러 트윈을 순차적 또는 병렬로 실행할 수 있는 시퀀스를 생성합니다.

  • 트윈 추가
    • Append(tween): 트윈을 시퀀스의 끝에 추가합니다.
    • Join(tween): 트윈을 현재 시점에 병렬로 추가합니다.
    • Insert(atPosition, tween): 지정한 위치에 트윈을 삽입합니다.
  • 시퀀스 제어
    • Prepend(tween): 트윈을 시퀀스의 시작에 추가합니다.
    • AppendInterval(interval): 지정한 시간만큼 대기합니다.
    • AppendCallback(callback): 콜백을 시퀀스에 추가합니다.

자세한 내용은 Sequence Class Reference를 참고하세요.

5. 트윈 설정 메서드

트윈의 동작 방식을 세부적으로 설정할 수 있는 메서드들입니다.

  • SetEase(easeType): 트윈의 이징 함수를 설정합니다.
  • SetLoops(loops, loopType): 트윈의 반복 횟수와 유형을 설정합니다.
  • SetDelay(delay): 트윈 시작 전 지연 시간을 설정합니다.
  • SetSpeedBased(): 속도 기반 트윈으로 설정합니다.
  • SetUpdate(updateType, isIndependentUpdate): 업데이트 유형과 독립 업데이트 여부를 설정합니다.

🔗 추가 자료

반응형
LIST

티스토리툴바