유저 데이터 정보

[마지막 갱신일: 2019/09/03]

 

Cubism3.1부터는 아트 메쉬에 문자열 정보를 추가하는 「유저 데이터」 기능을 이용할 수 있습니다.

.userdata3.json 파일에 표시된 문자열 데이터는 프로그램에서 아트 메쉬에 연결된 정보로 얻을 수 있으며,
아트 메쉬에 대해 다양한 처리를 할 때의 판별 재료로서 사용할 수 있습니다.

 

예를 들면 다음과 같이 사용할 수 있습니다.

  • ”Skin”이나 “Hair” 등의 태그를 붙여, 태그에 의해 렌더링시의 색조를 변화시킴으로써 캐릭터의 커스터마이즈를 가능하게 한다.
  • 투명도를 조작하는 등의 파라미터를 기술하고, 광원 등에 대한 메쉬의 평균 좌표로부터의 거리로 파라미터를 조작하여, 반사를 표현한다.
  • 태그가 있는 메쉬에만 파티클을 붙인다.

 

인스턴스 만들기

사용자 데이터는 .userdata3.json 파일에 설명되며 취급은 CubismModelUserData 클래스에서 수행됩니다.
로드는 Native(C++)의 CubismModelUserData::Create 함수,
또는 Web(TypeScript)의 CubismModelUserData.create 함수를 사용합니다.

 

 

액세스

유저 데이터에의 액세스는 Native(C++)의 CubismModelUserData::GetArtMeshUserDatas 함수, 또는 Web(TypeScript)의 CubismModelUserData.getArtMeshUserDatas 함수에 의해 실시합니다.
CubismModelUserDataNode 구조체가 들어있는 동적 배열이 반환되므로 일반 배열처럼 액세스합니다.

 

 

폐기

모델이 해제될 때 CubismModelUserData 클래스도 파기해야 합니다.

 

 

Userdata 범위 표시

Live2D Cubism SDK for Native의 Cocos2d-x 샘플에서는 LAppDefine.cpp의 DebugDrawRectEnable을 true로 설정하여
HitArea와 Userdata의 아트 메쉬가 있는 위치를 직사각형으로 표시하게 됩니다.

빨간색이 HitArea이고 목 스카프에 대한 파란색 사각형이 Userdata의 존재 범위입니다.

© 2010 - 2022 Live2D Inc.