피벗 페인터 툴 1.0 머티리얼 함수 | 언리얼 엔진 5.1 문서

Pivot Painter (피벗 페인터)는 메시의 버텍스 안에 로테이션 정보를 보관하는 Pivot Painter MAXScript 를 이용할 수 있는 머티리얼 함수입니다. 스태틱 메시의 동적인 모션을 처리하는 데 좋습니다.

피벗 페인터에서 제공되는 데이터는 이 함수 없이도 이용할 수야 있지만, 훨씬 힘듭니다.

Pivot Painter 함수

Pivot Painter 카테고리 아래의 모든 함수는 다음과 같습니다.

이 함수는 Pivot Painter MAXScript 가 모델의 UV 에 저장한 월드 위치와 각도 정보를 처리하고 관리합니다.

PivotPainter_HierarchyData

오브젝트 계층구조 작업을 할 수 있도록 특수 디자인된 함수입니다.

항목	설명
입력
Max Dist for Parent Piv (Scalar)	부모 피벗에 대한 최대 거리 - 애셋에 칠하는 도중 이 값은 MAXScript "Max Dist for Parent Piv" 스피너에 사용된 값에 일치됩니다.
출력
Parent Piv Position	부모 피벗 위치 - 월드 스페이스의 각 부모에 대한 피벗 포인트 정보를 반환합니다. 자손은 부착된 부모의 피벗 포인트 정보를 반환합니다.
Parent X Axis Vector	부모 X 축 벡터 - 부모의 X 축을 아래로 향하는 정규화 벡터를 반환합니다.
Child Piv Position	자손 피벗 위치 - 각 자손에 대한 월드 스페이스 피벗 위치 정보를 반환합니다. 부모는 (0,0,0) 값을 반환합니다.
Child X-Axis Vector	자손 X 축 벡터 - 부모의 X 축을 아래로 향하는 정규화 벡터를 반환합니다.
Object Pivot Point	오브젝트 피벗 포인트 - 오브젝트의 피벗 포인트 위치입니다.
Object Orientation	오브젝트 오리엔테이션 - 오브젝트의 방향입니다.
Object Scale	오브젝트 스케일 - 오브젝트의 크기입니다.
Object Black Mask	오브젝트 블랙 마스크 - (현재 미작동) Pivot Painter 툴에서 검게 칠해진 표면의 검정 값을 반환합니다.

라벨이 "-----------------" 인 출력은 구분선이며, 사용할 수 있는 것이 아닙니다.

PivotPainter_PerObjectData

오브젝트 단위로 작업할 수 있도록 특수 디자인된 함수입니다.

항목	설명
출력
Pivot Position	피벗 위치 - 월드 스페이스의 각 요소에 대한 피벗 포인트 정보를 반환합니다.
Child X-Axis	자손 X 축 - 요소의 X 축을 아래로 향하는 정규화 벡터를 반환합니다. 피벗 포인트에서 메시의 평균 중심을 가리키는 것입니다.
Random Value Per Element	요소별 임의값 - 요소별 0-1 범위의 임의값을 반환합니다.
Custom Alpha Values	커스텀 알파값 - 모델의 버텍스 알파 채널에 저장된 커스텀 감쇠값을 반환합니다.
Object Scale	오브젝트 스케일 - 오브젝트의 균등 스케일과 동일한 스케일 값을 반환합니다.

PivotPainter_PerObjectFoliageData

각각의 폴리지 오브젝트에 작동하도록 디자인된 함수입니다.

항목	설명
입력
Wind Vector (Vector4)	바람 벡터 - 들어오는 바람의 방향과 세기 벡터를 받습니다.
Optimized for Foliage Placement (StaticBool)	폴리지 배치에 최적화 - Pivot Painter 의 "Optimize for Foliage Placement" 옵션을 체크한 상태로 메시를 처리한 경우 True 로 설정합니다. 기본값은 False 입니다.
Optimized Vector (Vector3)	최적화 벡터 - 요소의 회전축으로 사용할 로컬 벡터를 입력합니다. Optimize for Foliage Placement 입력이 True 로 설정된 경우에만 사용할 수 있습니다.
출력
Piv Position	피벗 위치 - 월드 스페이스 내 각 요소에 대한 피벗 포인트 정보를 반환합니다.
Element Rot Axis	요소 회전축 - "RotateAboutAxis" 노드에 사용할 가지의 회전축을 반환합니다. 잎도 같은 정보를 반환합니다. 주: 각도는 가지의 X 축 상의 벡터를 로컬에서 월드 스페이스로 변환하여 알아냅니다. 그런 다음 바람 방향과 변환한 벡터의 교차 곱(cross product)을 알아냅니다.
Element X-Axis	요소 X 축 - 요소 X 축을 아래로 향하는 정규화 벡터를 반환합니다. 피벗 포인트에서 메시의 평균 중심쪽을 향하는 것입니다.
Random Value Per Element	요소별 임의값 - 요소별 0-1 범위의 임의값을 반환합니다.
Custom Alpha Values	커스텀 알파값 - 모델의 버텍스 알파 채널에 저장된 커스텀 감쇠값을 반환합니다.
Normalized Wind Vector	정규화된 바람 벡터 - 바람의 방향과 세기가 0-1 범위로 정규화된 벡터입니다.
Wind Speed	바람 속력 - 바람 속력 x 시간 x -1 을 출력합니다.
Wind Strength	바람 세기 - 바람의 세기를 반환합니다. 바람 벡터의 세기는 바람 벡터에서 0 까지의 거리를 계산하여 알아냅니다.
Object Scale XYZ	오브젝트 스케일 XYZ - 오브젝트의 균등 스케일과 같은 스칼라 값을 반환합니다.
Uniform Object Scale	균등 오브젝트 스케일 - 오브젝트의 균등 스케일과 같은 스칼라 값을 반환합니다.

PivotPainter_TreeData

tree 로 시작하는 출력은 Pivot Painter MAXScript 가 저장하는 것이기에 모델의 UV 정보를 처리합니다. Leaf 로 시작하는 출력은 스크립트의 오브젝트별 피벗 페인팅 부분이 저장하는 것이기에 UV 정보를 처리합니다.

항목	설명
입력
WindVector (Vector3)	바람 벡터 - 바람이 부는 방향입니다.
Max Dist for Parent Piv (Scalar)	부모 피벗에 대한 최대 거리 - 애셋에 칠하는 도중 이 값은 MAXScript "Max Dist for Parent Piv" 스피너에 사용된 값에 일치됩니다.
출력
Branch Piv Position	가지 피벗 위치 - 월드 스페이스의 각 가지에 대한 피벗 포인트 정보를 반환합니다. 잎은 붙어있는 가지의 피벗 포인트 정보를 반환합니다.
Branch Wind Rot Axis	가지 바람 회전축 - "RotateAboutAxis" 노드에 사용할 가지의 회전축을 반환합니다. 잎도 같은 정보를 반환합니다. 주: 각도는 가지의 X 축 상의 벡터를 로컬에서 월드 스페이스로 변환하여 알아냅니다. 그런 다음 바람 방향과 변환한 벡터의 교차 곱(cross product)을 알아냅니다.
Branch X-Axis Vector	가지 X 축 벡터 - 가지의 X 축을 아래로 향하는 정규화 벡터를 반환합니다. 커스텀 벡터 계산을 할 필요가 있지 않고서야 보통 폴리지 애니메이션에는 필요치 않습니다.
Branch Flow Grad	가지 흐름 그레이디언트 - 바람이 부는 방향으로의 기울기 값을 반환합니다.
Branch Flow Grad 90 Deg	가지 흐름 90 도 그레이디언트 - 바람에 90 도 교차된 월드 스페이스 기울기 값을 반환합니다.
Leaf Piv Position	잎 피벗 위치 - 각 잎의 월드 스페이스 피벗 위치 정보를 반환합니다. 가지는 (0,0,0) 값을 반환합니다.
Leaf Rot Axis	잎 회전축 - "RotateAboutAxis" 노드에 사용할 잎의 회전축을 반환합니다. 가지는 (0,0,0) 을 반환합니다. 주: 각도는 잎 X 축 상의 벡터를 로컬에서 월드 스페이스로 변환하여 구합니다. 그런 다음 바람 방향과 변환한 벡터 사이의 교차 곱(cross product)을 구합니다.
Leaf X-Axis Vector	잎 X 축 벡터 - 가지의 X 축을 아래로 향하는 정규화 벡터를 반환합니다. 커스텀 벡터 계산에 필요치 않고서야 보통 폴리지 애니메이션에는 필요치 않습니다.
Leaf Mask	잎 마스크 - 잎에 대한 하양 마스크를 반환합니다. 모든 가지는 검정입니다.
Leaf Flow Grad	잎 흐름 그레이디언트 - 바람이 부는 방향으로의 기울기 값을 반환합니다.
Leaf Flow Grad 90 deg	잎 흐름 90 도 그레이디언트 - 바람에 90 도 교차된 월드 스페이스 기울기 값을 반환합니다.
Object Pivot Point	오브젝트 피벗 포인트 - 오브젝트의 피벗 포인트 위치를 반환합니다.
Object Orientation	오브젝트 오리엔테이션 - 오브젝트의 방향을 반환합니다.
Object Rotation Axis	오브젝트 회전축 - 오브젝트 회전축을 반환합니다.
Object Scale	오브젝트 스케일 - 오브젝트의 스케일을 반환합니다.
Object Flow Grad	오브젝트 흐름 그레이디언트 - 월드 스페이스의 오브젝트 수준에서 바람 벡터에 정렬된 기울기입니다.
Object Flow Grad 90 deg	오브젝트 흐름 90 도 그레이디언트 - 월드 스페이스의 오브젝트 수준에서 바람 벡터에 90 도 틀어 정렬된 기울기입니다.
WindStrength	바람 세기 - 바람의 세기를 반환합니다. 바람 벡터의 세기는 바람 벡터에서 0 까지의 거리를 계산하여 알아냅니다.
Normalized Wind Vector	정규화 바람 벡터 - 세기가 0-1 범위로 정규화된 바람 벡터를 반환합니다.
WindSpeed	바람 속력 - 시간을 곱한 바람 속력입니다.
Black Mask	검정 마스크 - 피벗 페인터 툴로 검정 칠을 한 표면의 검정 값을 반환합니다. 이 마스크는 버텍스 셰이더에서만 작동합니다.

라벨이 "-----------------" 인 출력은 구분을 위한 것으로, 실제 사용할 수는 없습니다.