CustomTransform

개요

4x4 변형 행렬 값을 직접 입력해 자유로운 변형(회전·기울이기·이동 조합)을 적용합니다. 예를 들어 여러 변형을 한 번에 조합할 때 사용합니다.

속성 (Property)

속성	설명	값	기본값
Transform(Matrix4)	4×4 변형 행렬을 직접 입력해 자유 변형(확대·이동·회전·기울임 조합)을 적용합니다. 스튜디오 편집 패널에서는 Transform(Matrix4) 그룹의 4×4 입력 격자로 16개 성분을 편집하며, 각 성분의 내부 속성명은 arg0~arg15(열 우선, column-major)입니다.	숫자 16개 (arg0~arg15)	단위 행렬 (arg0·arg5·arg10·arg15 = 1.0, 나머지 = 0.0)
alignment	행렬 변형의 기준점을 지정합니다.	정렬 값	중앙
transformHitTest	변형을 적용한 위치를 기준으로 터치 판정을 수행할지 지정합니다.	켜기/끄기	켜기
filterQuality	행렬 변형을 적용해 렌더링할 때 사용할 이미지 품질(보간 방식)을 지정합니다.	none, low, medium, high	미설정

사용 예시

Transform(Matrix4)는 4×4 행렬을 열 우선(column-major) 순서로 채웁니다. 16개 성분의 위치는 다음과 같습니다.

| arg0  arg4  arg8   arg12 |
| arg1  arg5  arg9   arg13 |
| arg2  arg6  arg10  arg14 |
| arg3  arg7  arg11  arg15 |

자주 쓰는 성분:

• arg0 = 가로 배율(scaleX), arg5 = 세로 배율(scaleY)
• arg12 = 가로 이동(translateX, px), arg13 = 세로 이동(translateY, px)

기본값(단위 행렬)에서 아래 성분만 바꾸면 됩니다.

목표	설정할 성분
2배 확대	arg0 = 2.0, arg5 = 2.0
오른쪽 40·아래 20 이동	arg12 = 40.0, arg13 = 20.0
가로 2배 + 오른쪽 40 이동	arg0 = 2.0, arg12 = 40.0
좌우 반전(flip)	arg0 = -1.0

스크립트에서는 성분 이름(arg0~arg15)으로 개별 설정할 수 있습니다.

// 2배 확대 + 오른쪽 40px 이동 (customTransformID = Custom Transform 위젯 ID)
customTransformID.setProperty("arg0", 2.0);   // 가로 배율
customTransformID.setProperty("arg5", 2.0);   // 세로 배율
customTransformID.setProperty("arg12", 40.0); // 가로 이동

경고

arg0·arg5(배율)를 0으로 두면 위젯이 화면에서 사라집니다. 특정 변형만 줄 때는 단위 행렬 상태에서 필요한 성분만 바꾸세요.