Cubism Native Samples

Live2D Cubism 4 Editor で出力したモデルを表示するアプリケーションのサンプル実装です。

Cubism Native Framework および Live2D Cubism Core と組み合わせて使用します。

ライセンス

本 SDK を使用する前にライセンスをご確認ください。

注意事項

本 SDK を使用する前に注意事項をご確認ください。

ディレクトリ構成

.
├─ Core             # Live2D Cubism Core が含まれるディレクトリ
├─ Framework        # レンダリングやアニメーション機能などのソースコードが含まれるディレクトリ
└─ Samples
   ├─ Cocos2d-x     # Cocos2d-x のサンプルプロジェクトが含まれるディレクトリ
   ├─ D3D9          # DirectX 9.0c のサンプルプロジェクトが含まれるディレクトリ
   ├─ D3D11         # DirectX 11 のサンプルプロジェクトが含まれるディレクトリ
   ├─ Metal         # Metal のサンプルプロジェクトが含まれるディレクトリ
   ├─ OpenGL        # OpenGL のサンプルプロジェクトが含まれるディレクトリ
   └─ Resources     # モデルのファイルや画像などのリソースが含まれるディレクトリ

Cubism Native Framework

モデルを表示、操作するための各種機能を提供します。

Cubism Native Framework は、当リポジトリのサブモジュールとして含まれています。当リポジトリをクローンした後、サブモジュールのクローンを実行することでファイルが追加されます。

Live2D Cubism Core for Native

モデルをロードするためのライブラリです。当リポジトリには Live2D Cubism Core for Native は同梱されていません。

ダウンロードするにはこちらのページを参照ください。ダウンロードした Zip ファイルの中身を当リポジトリの Core ディレクトリにコピーし、プログラムにリンクさせてください。

ビルド方法

ビルド方法についてはサンプルプロジェクトによって異なります。各サンプルプロジェクトに同梱された README.md を参照ください。

サンプルプロジェクトの成果物の生成場所

本サンプルでは、Android を除く CMake プロジェクトの成果物は bin ディレクトリに生成されます。

例）OpenGL サンプルの macOS プロジェクトのビルドを make_gcc スクリプトを使用して行なった場合

Demo
└─ proj.mac.cmake
   └─ build
      └─ make_gcc
         └─ bin
            └─ Demo
               ├─ Resources    # Samples/Resources と同じ
               └─ Demo         # 実行可能なアプリケーション

コンパイルオプション

プロジェクトにおいて、マクロ USE_RENDER_TARGET または USE_MODEL_RENDER_TARGET が有効な場合、モデルがテクスチャへレンダリングされるようになります。詳細はサンプルディレクトリ内の LAppLive2DManager.cpp を参照ください。

SDKマニュアル

Cubism SDK Manual

変更履歴

当リポジトリの変更履歴については CHANGELOG.md を参照ください。

開発環境

開発ツール	バージョン
Android Studio	Chipmunk 2021.2.1 Patch 1
CMake	3.23.0
Visual Studio 2013	Update 5
Visual Studio 2015	Update 3
Visual Studio 2017	15.9.49
Visual Studio 2019	16.11.17
XCode	13.4.1

Android

Android SDK tools	バージョン
Android NDK	24.0.08215888
Android SDK	33.0.0
CMake	3.18.1

Linux

系統	ディストリビューション・バージョン	Docker イメージ	GCC
Red Hat	Amazon Linux 2	`amazonlinux:2`	7.3.1
Red Hat	CentOS 7	`centos:7`	4.8.5
Red Hat	CentOS Stream 8 *1	`centos:latest`	8.5.0
Debian	Ubuntu 18.04	`ubuntu:18.04`	7.5.0
Debian	Ubuntu 20.04	`ubuntu:20.04`	9.4.0

*1 CentOS 8はサポートしておりません

Mesa ライブラリ

Red Hat
- mesa-libGL-devel
- mesa-libGLU-devel
Debian
- libgl1-mesa-dev
- libglu1-mesa-dev

動作確認環境

プラットフォーム	バージョン
iOS / iPadOS	15.5
macOS	12.5
Windows 10	21H2
Windows 11	21H2

Android

バージョン	デバイス	Tegra
11	Pixel 3a
7.1.1	Nexus 9	✔︎

Linux

系統	ディストリビューション	バージョン
Red Hat	Amazon Linux	2
Red Hat	CentOS Stream	8
Debian	Ubuntu	20.04

コミュニティ

ユーザー同士でCubism SDKの活用方法の提案や質問をしたい場合は、是非コミュニティをご活用ください。

novicechen / cubismnativesamples Goto Github PK