Cubism Core API 참조

[마지막 갱신일: 2022/07/07]

이 페이지에 게시된 Cubism Core API 참조의 PDF에서,

Live2D Cubism SDK for Native에서 Live2D Cubism Core의 역할, 사용법 및 API 사양을 다룹니다.

 

대상자

・Live2D Cubism SDK for Native 사용자

・다른 언어(Java, Python 등)에서 Core를 호출할 수 있도록 래퍼 구현을 고려하는 사람

・게임 엔진 등 다른 프로그램이나 플랫폼에 통합하는 것을 검토하고 있는 사람

 

Core 및 Framework 기능 분류

아래 그림은 Application, Core, Framework의 관계와 기능의 역할을 보여줍니다.

Core는 Application과 Framework에서 모두 사용됩니다.

Core란?

Core는 Cubism 3 이후의 에디터를 사용해 작성된 모델(.moc3 파일)을 취급하기 위해서 필요한 API를 갖춘 라이브러리입니다. 특징에 대해 아래에 설명합니다.

・API는 C언어로 구성.

・Core 자신으로 메모리를 확보・파기하지 않습니다. 필요한 메모리 양을 Core로부터 요구되기 때문에, 이용하는 측에서 지정량을 확보해 Core에 건네줄 필요가 있습니다.

・그리기 기능은 포함하지 않습니다. 모델의 파라미터에 따라 정점 정보를 계산하는 것이 Core의 역할이며, 이용하는 측은 계산이 끝난 정점 정보 및 묘화에 필요한 정보(UV나 불투명도 등)를 Core로부터 취득해, 묘화를 실시합니다. 덧붙여 그리기 기능은 Framework가 레퍼런스 구현을 제공하고 있기 때문에 독자적으로 구현할 필요는 없습니다.

상기의 특징으로부터, 이식성이 높고 플랫폼에 의존하지 않는 설계가 되어 있습니다.

 

일본어 버전 PDF 파일

다운로드: 일본어 버전 Cubism Core API 참조 (2.85MB)

[마지막 갱신일 2022/07/07 r10]

 

업데이트 내역

갱신일 버전 수 종별 내용
2022/07/07 r10 추가 매개변수 유형을 검색하는 기능에 대한 설명을 추가했습니다.
추가 아트 메쉬의 부모 부품을 얻는 기능에 대한 설명을 추가했습니다.
추가 「moc3의 파일 버전」 「csmGetMocVersion」에서 얻을 수있는 버전에 대한 설명을 업데이트했습니다.
2022/05/19 r9 추가 곱하기 색·스크린색에 관련된 설명을 추가했습니다.
파라미터에 설정된 키의 정보의 취득에 관련한 설명을 추가했습니다.
2021/02/26 r8 수정 csmGetDrawableIndexCounts에서 개수 0의 Drawable이 존재하는 설명을 추가했습니다.
수정 csmGetDrawableIndices에서 유효한 주소가 저장되지 않는 경우가 있는 설명을 추가했습니다.
2019/09/04 r7 수정 Cubism Core 및 Cubism SDK 표기법 조정
2019/08/01 r6 추가 moc3 파일 버전 상수 추가
ConstantFlag의 요소 추가에 따른 스니펫 추가
마스크 반전 플래그에 대한 설명 추가
마스크 반전 기능 설명 추가
개별 API에 사용 가능한 버전의 항목 추가
수정 오자 수정
2019/02/12 r5 추가 파일 버전을 확인하는 방법에 대해 추가 
추가 csmGetLatestMocVersion API 설명 추가 
추가 csmGetMocVersion API 설명 추가 
추가 csmGetPartParentPartIndices API가 추가된 CoreVersion 표기 추가 
2018/12/20 r4 추가 「moc3 파일 버전 정보」 추가
추가 「파츠의 부모 파츠 얻기」 추가
추가 「csmGetPartParentPartIndices」의 API 설명 추가
수정 오자, 탈자 수정. 모호함 회피를 위한 문장 수정.
2018/07/11 r3 수정 오자, 탈자 수정
수정 모호함 회피를 위한 문장 수정
수정 마스크의 그리기 방법과 그 액세스에 관한 그리기 방법의 지정을 세밀하게 수정
수정 API 목록에서 일부 인수에 const가 붙어 있던 오류를 수정
2018/05/18 r2 수정 오자 수정
추가 csmGetDrawableVertexPositions에서 얻은 정보의 특성에 추가
2018/03/27 r1 신규 작성 신규 작성

 

English PDF File

Download : English Cubism Core API Reference (2.71MB)

[Last Update 2022/07/07 r10]

 

Change log

Update day Version Update Type Content
2022/07/07 r10 Added Added description of the function to get parameter types.
Added Added description of the function to get parent parts of ArtMeshes.
Added Updated obtained versions in "File version of moc3" and "csmGetMocVersion".
2022/05/19 r9 Added Added explanations related to multiply colors and screen colors.
Added explanations related to obtaining information on keys set in parameters.
2021/03/01 r8 Fixed Added an explanation for the existence of Drawables with a count of 0 in csmGetDrawableIndexCounts.
Fixed Added explanation of the case where csmGetDrawableIndices does not store valid addresses.
2019/09/04 r7 Fixed Adjusted notation of "Cubism Core" and "Cubism SDK"
2019/08/01 r6 Added Added a constant stands for moc3 file version
Added a snippet since the ConstantFlag element has added
Added a description of the Inverted Mask flag
Added a description of the Inverted Mask function
Added an item stands for the available version of each API
Fixed Typo fixes
2019/02/26 r5 Added Added "File version of moc3" 
Added Added "Getting the parent parts of the parts" 
Added Added the API description of csmGetLatestMocVersion
Added Added the API description of csmGetMocVersion
Added Added the API description of csmGetPartParentPartIndices 
2018/07/20 r3 Corrected Corrected errors of snipet
Corrected Corrected vague expression
Corrected Corrected omissions of letter in snipet
Corrected Corrected vague expression
Corrected Corrected mistake that const is included in notation of arguments.
Corrected Added more detailed explanation about rendering method of mask and how to access it
2018/06/14 r2 translation translation to English from Japanese

© 2010 - 2022 Live2D Inc.