Cubism Core API リファレンス

[最終更新日 : 2019/09/04]

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

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

 

対象者

・Live2D Cubism SDK for Native の利用者

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

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

 

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)

[最終更新日 2019/09/04 r7]

更新履歴

更新日 版数 種別 内容
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

English Cubism Core API Reference(2.71MB)

[Last Update 2019/09/04 r7]

 

Change log

Update day Version Update Type Content
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

Copyright © 2019 Live2D Inc.