Cubism Native Core API リファレンス

[最終更新 2019/02/26]

このページで公開されるCubism Native Core API リファレンスのPDFでは、

Live2D Cubism 3 SDK for Native における Live2D Cubism Coreの役割、使用方法、APIの仕様について扱います。

 

対象者

・Live2D Cubism 3 SDK for Native の利用者

・Core を他言語(JavaやPythonなど)から呼び出せるようにラッパーの実装を検討している者

・ゲームエンジンなど他のプログラムやプラットフォームへ組み込むことを検討している者

 

CoreとFrameworkの機能分類

以下の図はApplication、Core、Frameworkの関係と機能の役割を示したものです。

CoreはApplicationからもFrameworkからも使用されます。

Coreとは

CoreはCubism 3 Editor を用いて作成されたモデル(.moc3ファイル)を扱うために必要なAPIを備えたライブラリです。特徴について下記に述べます。

・APIはC言語から構成。

・Core自身でメモリを確保・破棄しません。必要なメモリ量をCoreから要求されるため、利用する側で指定量を確保してCoreに渡す必要があります。

・描画機能は含みません。モデルのパラメータに応じて頂点情報を計算することがCoreの役目であり、利用する側は計算済みの頂点情報および描画に必要な情報(UVや不透明度など)をCoreから取得し、描画を行います。なお描画機能はFrameworkがリファレンス実装を提供しているため独自に実装する必要はありません。

上記特徴から、移植性の高くプラットフォームに依存しない設計になっています。

 

日本語版 PDFファイル

日本語版 Cubism Native Core API リファレンス (2.58MB)

[最終更新日 2019/02/12 r5]

更新履歴

更新日 版数 種別 内容
2018/03/27 r1 新規作成 新規作成
2018/05/18 r2 修正 誤字修正
追記 csmGetDrawableVertexPositionsで得られる情報の特性について追加
2018/07/11 r3 修正 誤字、脱字修正
修正 曖昧さの回避のための文言修正
修正 マスクの描画方法とそのアクセスに関して描画方法の指定を細かく修正
修正 APIリストで一部引数にconstが付いていた間違いを修正
2018/12/20 r4 追加 「moc3ファイルのバージョンについて」を追加
追加 「パーツの親パーツを取得」を追加
追加 「csmGetPartParentPartIndices」のAPI説明を追加
修正 誤字、脱字修正。曖昧さ回避のための文言修正。
2019/02/12 r5 追加 ファイルバージョンを調べる方法について追加 
追加 csmGetLatestMocVersionのAPI説明を追加 
追加 csmGetMocVersionのAPI説明を追加 
追加 csmGetPartParentPartIndicesのAPIが追加された CoreVersionの表記を追加 

 

English PDF File

English Cubism Native Core API Reference(1.77MB)

[Last Update 2019/02/26 r5]

 

Change log

Update day Version Update Type Content
2018/06/14 r2 translation translation to English from Japanese
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
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 

Copyright © 2019 Live2D Inc.