Skip to content

Live2D/CubismNativeSamples

Repository files navigation

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.16
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.4
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の活用方法の提案や質問をしたい場合は、是非コミュニティをご活用ください。