cdi3.json 정보

[마지막 갱신일: 2020/01/30]

 

개요

Cubism Editor 3.3.02(2019/04/23 공개)부터 Cubism 편집기에서 모델을 내보낼 때 .cdi3.json을 내보낼 수 있습니다.
.cdi3.json은 파라미터, 파라미터 그룹, 파트의 ID와 이름을 묶는 정보가 기술된 파일입니다.

Editor상에서 설정한 파라미터명이나 파라미터 그룹명, 파트명은 SDK상에서 모델을 취급할 때에 불필요한 항목이므로 moc3에 써내지지 않습니다.
하지만 유저가 모델의 파라미터를 직접 조작할 수 있는 어플리케이션과 같이 파라미터의 이름을 표시시키고 싶은 경우, .cdi3.json를 이용하는 것으로 이름을 취득하는 것이 가능합니다.

 

.cdi3.json에 기술된 내용

・Parameters
 ・파라미터 ID, 파라미터 이름(에디터에 표시되는 이름), 소속된 파라미터 그룹의 ID
・ParameterGroups
 ・그룹 ID, 그룹 이름(에디터에 표시되는 이름), 소속되어 있는 파라미터 그룹의 ID
・Parts
 ・파트 ID, 파트명(에디터에 표시되는 이름)

※소속하고 있는 파라미터 그룹의 ID:
 매개 변수 그룹은 편집기에서 트리 구조로 표현되지만 cdi의 구조는 List 구조로 데이터를 저장합니다.
 SDK에서 매개 변수 그룹의 트리 구조를 처리하는 경우이 정보를 사용하여 배치를 복원해야합니다.
 소속되어 있는 파라미터 그룹이 없다 (에디터상에서는 나무 구조의 루트) 경우, 이 항목은 공란이 됩니다.

cdi3.json 사양에 대한 자세한 내용은 GitHub의 CubismSpecs를 참조하십시오.

cdi3.json을 구문 분석하려면 Cubism SDK for Native에서 CubismCdiJson을 사용합니다.
Cubism SDK for Web는 Json 파서를 직접 가지고 있기 때문에 .cdi3.json을 다루는 구현을 수행하는 경우 그 곳을 사용하여 사용자 측에서 대응할 수 있습니다.

 

CubismCdiJson

인스턴스 생성

 

 

파라미터(Parameters)

매개변수 관련 정보를 얻는 API는 다음과 같습니다.

・파라미터 수: CubismCdiJson::GetParametersCount()
・파라미터 ID: CubismCdiJson::GetParametersId()
・소속된 파라미터 그룹의 ID: CubismCdiJson::GetParametersGroupId()
・파라미터명: csmChar* CubismCdiJson::GetParametersName()

 

 

파라미터 그룹 (ParameterGroups)

파라미터 그룹 관련 정보를 얻는 API는 다음과 같습니다.

・파라미터 그룹 수: CubismCdiJson::GetParameterGroupsCount()
・파라미터 그룹 ID: CubismCdiJson::GetParameterGroupsId()
・해당 파라미터 그룹의 부모 파라미터 그룹 ID: CubismCdiJson::GetParameterGroupsGroupId()
・파라미터 그룹명: CubismCdiJson::GetParameterGroupsName()

 

 

파츠(Parts)

파츠 관련 정보를 얻는 API는 다음과 같습니다.

・파트 수: CubismCdiJson::GetPartsCount()
・파트 ID: CubismCdiJson::GetPartsId()
・파트명: CubismCdiJson::GetPartsName()

© 2010 - 2022 Live2D Inc.