deki-tween
30가지 이상의 이징 함수를 갖춘 트윈. 인스펙터에서는 TweenComponent를, 코드에서는 TweenManager를 사용합니다.
저장소: github.com/dekiengine/deki-tween · 최신 릴리스: 0.19.0 · 엔진 0.19.0 이상 필요
DekiEditor --packages-add deki-tween <project> 또는 패키지 관리자로 설치합니다. 엔진 자체의 컴포넌트와 C++ API는 Deki 문서에 있습니다.
에디터에는 Tween(으)로 표시됩니다.
컴포넌트
| 컴포넌트 | 카테고리 | 설명 |
|---|---|---|
| TweenComponent | 애니메이션 | 이징 커브를 따라 오브젝트의 위치, 스케일 또는 회전을 애니메이션합니다. |
기능 플래그
빌드에서 뺄 수 있는 부분입니다. define이 있는 기능은 그 define으로 켜고 끄며, 나머지는 컴포넌트와 함께 제거됩니다.
| 기능 | define | 기본값 |
|---|---|---|
| Tween | DEKI_FEATURE_TWEEN | 켜짐 |
컴포넌트 레퍼런스
TweenComponent
이징 커브를 따라 오브젝트의 위치, 스케일 또는 회전을 애니메이션합니다.
인스펙터 이름: 트윈 컴포넌트 · 카테고리: 애니메이션 · 유형: DekiTween::TweenComponent
| 속성 | 유형 | 기본값 | 제약 | 설명 |
|---|---|---|---|---|
| targetType | enum | "Position" | Position, Scale, Rotation | 오브젝트의 어떤 속성을 애니메이션할지 지정합니다. 위치, 스케일, 회전, 색상 중에서 고릅니다. |
| endValue | Vector3 | [0.0, 0.0, 0.0] | 도달할 값입니다. 어떤 성분을 쓰는지는 위의 대상에 따라 다릅니다. | |
| duration | float | 1 | 0.1~10(슬라이더) | 한 번 재생하는 데 걸리는 시간(초)입니다. |
| delay | float | 0 | 0~5(슬라이더) | 시작하기 전에 기다리는 시간(초)입니다. |
| easeType | enum | "Linear" | Linear, SineIn, SineOut, SineInOut, QuadIn, QuadOut, QuadInOut, CubicIn, CubicOut, CubicInOut, QuartIn, QuartOut, QuartInOut, QuintIn, QuintOut, QuintInOut, ExpoIn, ExpoOut, ExpoInOut, CircIn, CircOut, CircInOut, BackIn, BackOut, BackInOut, ElasticIn, ElasticOut, ElasticInOut, BounceIn, BounceOut, BounceInOut | 움직임의 모양입니다. 선형은 기계적입니다. 이즈 인 아웃은 부드럽게 시작하고 끝나서 거의 모든 것에 자연스럽게 보입니다. |
| loops | int32 | 0 | -1~100 | 실행할 횟수입니다. 0은 한 번 실행하고, -1은 무한히 반복합니다. |
| pingPong | bool | false | 처음으로 돌아가는 대신 한 번씩 번갈아 트윈을 거꾸로 재생합니다. | |
| autoPlay | bool | true | 오브젝트가 활성화되는 즉시 시작합니다. 끄면 다른 무언가가 시작해야 합니다. | |
| relative | bool | false | 종료 값을 절대 목적지가 아니라 오브젝트의 현재 위치로부터의 오프셋으로 취급합니다. |
변경 내역
변경 내역은 영어로 되어 있습니다.
0.19.0
Changed
- minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.
Added
- Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.
- The package's editor text goes through the editor's translation (Tr), so it shows in the editor's language. Needs the editor release that adds Localization.h; raise minEngine to it when releasing.
0.18.0
Changed
- minEngine 0.18.0. Reflection ABI 21: the package must be rebuilt.
- Names follow the code style (deki-engine/docs/codestyle): types, functions and enum values are PascalCase, constants kPascalCase, members m_PascalCase, locals and parameters camelCase. The code is formatted with clang-format 22.
- The functions the editor finds by name are PascalCase: DekiTweenRegisterComponents, DekiTweenGetAutoComponentCount, DekiTweenEnsureRegistered and the rest. Built against engine ABI 21; a build of this package from before does not load and is rebuilt.
- Renamed: on_complete and on_update are onComplete and onUpdate; EaseType::COUNT is Count.
Removed
- The former names from before 0.16.0 (bare class names, and deki-gpio's DekiEsp32::ESP32PinSetup). A scene that old is upgraded with 0.17 first.
이전 릴리스: CHANGELOG.md
패키지의 리플렉션 데이터에서 생성했습니다(엔진 0.19.0). 속성 이름은 씬 파일에서 쓰는 키입니다. 이름을 바꿔도 별칭이 유지됩니다(호환성).
