= Cubism for GDScript :encoding: utf-8 :lang: ja :author: MizunagiKB [email protected] :copyright: 2023 MizunagiKB :doctype: book :nofooter: :toc: left :toclevels: 3 :source-highlighter: highlight.js :icons: font :experimental: :stylesdir: ./docs/res/theme/css :stylesheet: mizunagi-works.css ifdef::env-github,env-vscode[] :adocsuffix: .adoc endif::env-github,env-vscode[] ifndef::env-github,env-vscode[] :adocsuffix: .html endif::env-github,env-vscode[]

ifdef::env-github,env-vscode[] link:README.adoc[Japanese] / link:README.en.adoc[English] endif::env-github,env-vscode[]

== About GDCubism

このソフトウェア（以下GDCubism）は link:https://www.live2d.com/download/cubism-sdk/[Live2D Cubism SDK]を GDScript や C# から利用可能にするための非公式な GDExtension です。

[NOTE]

この GDExtension は Godot Engine 4.3 以上で使用可能です。（4.1, 4.2 で使用したい場合は link:https://github.com/MizunagiKB/gd_cubism/releases/tag/v0.8.2-godot4.1[v0.8.2-godot4.1] を使用してください）

[IMPORTANT]

0.9から描画方法が直接描画に変わり、 Godot Engine の処理負荷と GPU メモリの消費を大幅に抑える事に成功しました。

一方でいくつか変更が生じています。最も大きな変更点は GDCubismUserModel が SubViewport ではなくなった点です。

以前と同じ様に扱いたい場合は、 SubViewport の下に GDCubismUserModel を配置してご利用ください。（この変更に関するデモとして demo_fade.tscn が追加されています）

GDCubism 内部ではLive2D社が公開している link:https://github.com/Live2D/CubismNativeFramework[Cubism Native Framework] を併用しています。

GDCubism については開発元のLive2D社に問い合わせない様お願い致します。

== 対応プラットフォーム

[cols="2",frame=none,grid=none] |===

|Windows a|

• x86_32
• x86_64

|macOS a|

• x86_64
• arm64
• universal

|Linux a|

• x86_64

|iOS a|

• arm64 (experimental)
• universal (experimental)

|Android a|

• armv7 (experimental)
• arm64v8 (experimental) |===

== ライセンス

[NOTE]

GDCubism は依存する外部ライブラリとリンクすることで、異なる利用条件のライセンスになります。 + GDCubism を組み込んでの配布や販売を考えている場合は以下のページに記載されているライセンスを確認してください。

ifdef::env-github,env-vscode[]

• link:https://mizunagikb.github.io/gd_cubism/gd_cubism/0.6/ja/license.html[License]

== ビルド方法

• link:https://mizunagikb.github.io/gd_cubism/gd_cubism/0.6/ja/build.html[Build]

== 使用方法

• link:https://mizunagikb.github.io/gd_cubism/gd_cubism/0.6/ja/usage.html[Usage] endif::env-github,env-vscode[]

ifndef::env-github,env-vscode[]

• link:./docs-src/modules/ROOT/pages/ja/license.adoc[License]

== ビルド方法

• link:./docs-src/modules/ROOT/pages/ja/build.adoc[Build]

== 使用方法

• link:./docs-src/modules/ROOT/pages/ja/usage.adoc[Usage] endif::env-github,env-vscode[]

== 関連情報

• Live2D link:https://www.live2d.com/[Live2D Cubism] link:https://www.live2d.com/download/cubism-sdk/[Live2D Cubism SDK] link:https://github.com/Live2D[Live2D (GitHub)] link:https://github.com/Live2D/CubismNativeFramework[CubismNativeFramework (GitHub)]
• MizunagiKB ** link:https://github.com/MizunagiKB/gd_cubism[MizunagiKB / gd_cubism (GitHub)]