Skip to content

Commit

Permalink
Merge pull request #33 from Live2D/develop
Browse files Browse the repository at this point in the history
Cubism 4 SDK for Native R5
  • Loading branch information
itoh-at-live2d-com authored Sep 8, 2022
2 parents 34723b8 + 7a3d51d commit 8e94d81
Show file tree
Hide file tree
Showing 37 changed files with 1,432 additions and 308 deletions.
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).


## [4-r.5] - 2022-09-08

### Added

* Add support for Visual Studio 2022.
* Add the multilingual supported documents.

### Changed

* Update third-party libraries.

### Fixed

* Fix an issue where the window title for the minimum sample of D3D9 was that of D3D11.


## [4-r.5-beta.5] - 2022-08-04

### Changed
Expand Down Expand Up @@ -230,6 +246,7 @@ See [Core Changelog] for details.
* What was `Package.json` is currently being changed to`cubism-info.yml`.


[4-r.5]: https://github.com/Live2D/CubismNativeSamples/compare/4-r.5-beta.5...4-r.5
[4-r.5-beta.5]: https://github.com/Live2D/CubismNativeSamples/compare/4-r.5-beta.4.1...4-r.5-beta.5
[4-r.5-beta.4.1]: https://github.com/Live2D/CubismNativeSamples/compare/4-r.5-beta.4...4-r.5-beta.4.1
[4-r.5-beta.4]: https://github.com/Live2D/CubismNativeSamples/compare/4-r.5-beta.3...4-r.5-beta.4
Expand Down
15 changes: 15 additions & 0 deletions Core/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).


## 2022-09-08

### Added

* Add the multilingual supported documents.
* Support Visual Studio 2022.


## 2022-08-04

### Fixed

* [Web] Fix `csmGetMocVersion` function argument.


## 2022-07-07

### Added
Expand Down
72 changes: 72 additions & 0 deletions Core/README.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
[English](README.md) / [日本語](README.ja.md)

---

# Live2D Cubism Core

このフォルダーには、ネイティブアプリケーションを開発するためのヘッダーおよびプラットフォーム固有のライブラリファイルが含まれています。

Cubism Coreは、Cubismモデルをアプリケーションにロードするための小さなライブラリです。


## はじめに

モデルを画面に表示して、アニメーションを再生するための情報については、[CubismNativeSamples](https://github.com/Live2D/CubismNativeSamples)をご覧ください。


## ファイル構造

```
Core
├─ dll # Shared (Dynamic) Library files
├─ include # Header file
└─ lib # Static Library files
```


## ライブラリリスト

| プラットフォーム | アーキテクチャ | dll | lib | パス | 注記 |
| --- | --- | --- | --- | --- | --- |
| Android | ARM64 ||| android/arm64-v8a | |
| Android | ARMv7 ||| android/armeabi-v7a | |
| Android | x86 ||| android/x86 | |
| Android | x86_64 ||| android/x86_64 | |
| iOS | ARM64 | || ios/xxx-iphoneos | iOSデバイス |
| iOS | x86_64 | || ios/xxx-iphonesimulator | iOS Simulator |
| Linux | x86_64 ||| linux/x86_64 | |
| macOS | ARM64 ||| macos/arm64 | |
| macOS | x86_64 ||| macos/x86_64 | |
| Mac Catalyst | ARM64 | || experimental/catalyst | Universal Binary |
| Mac Catalyst | x86_64 | || experimental/catalyst | Universal Binary |
| Raspberry Pi | ARM ||| experimental/rpi | |
| UWP | ARM || | experimental/uwp/arm | |
| UWP | ARM64 || | experimental/uwp/arm64 | |
| UWP | x64 || | experimental/uwp/x64 | |
| UWP | x86 || | experimental/uwp/x86 | |
| Windows | x86 ||| windows/x86 | |
| Windows | x86_64 ||| windows/x86_64 | |

### 実験的ライブラリ

`Raspberry Pi``UWP``catalyst`は実験的なライブラリです。

### Windows用スタティックライブラリ

ライブラリは、VC++バージョン名ディレクトリの下にあります。

以下は、VC++バージョンのVisual Studioバージョンです。

| VC++バージョン | Visual Studioバージョン |
| ---: | --- |
| 120 | Visual Studio 2013 |
| 140 | Visual Studio 2015 |
| 141 | Visual Studio 2017 |
| 142 | Visual Studio 2019 |
| 143 | Visual Studio 2022 |

また、サフィックスライブラリ(`_MD``_MDd``_MT``_MTd`)は、ライブラリのコンパイルに使用される[ランタイムライブラリの使用](https://docs.microsoft.com/en-us/cpp/build/reference/md-mt-ld-use-run-time-library) オプションを参照します。

### 呼び出し規約

*Windows/x86*のダイナミックリンクライブラリを使用する場合は、呼び出し規約として明示的に`__stdcall`を使用してください。
19 changes: 11 additions & 8 deletions Core/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,12 @@
[English](README.md) / [日本語](README.ja.md)

---

# Live2D Cubism Core

This folder contains header and platform-specific library files for developing native applications.

What's the Core anyway? It's a small library that allows you to load Cubism models in your application.
What's the Core anyway? It's a small library that allows you to load Cubism models into your application.


## Getting Started
Expand Down Expand Up @@ -38,7 +42,7 @@ Core
| Mac Catalyst | ARM64 | || experimental/catalyst | Universal Binary |
| Mac Catalyst | x86_64 | || experimental/catalyst | Universal Binary |
| Raspberry Pi | ARM ||| experimental/rpi | |
| UWP | ARM || | experimental/uwp/arm | |
| UWP | ARM ||   | experimental/uwp/arm |   |
| UWP | ARM64 || | experimental/uwp/arm64 | |
| UWP | x64 || | experimental/uwp/x64 | |
| UWP | x86 || | experimental/uwp/x86 | |
Expand All @@ -51,21 +55,20 @@ Core

### Windows Static Library

Libraries are located under VC++ version name directory.
Libraries are located under the VC++ version name directory.

Below is the Visual Studio version for VC++ version.
Below is the Visual Studio version for the VC++ version.

| VC++ version | Visual Studio version |
| ---: | --- |
| 120 | Visual Studio 2013 |
| 140 | Visual Studio 2015 |
| 141 | Visual Studio 2017 |
| 142 | Visual Studio 2019 |
| 143 | Visual Studio 2022 |

Also, the suffix library (`_MD`, `_MDd`, `_MT`, `_MTd`) refers to the
[Use Run-Time Library](https://docs.microsoft.com/en-us/cpp/build/reference/md-mt-ld-use-run-time-library)
option used to compile the library.
Also, the suffix library (`_MD`, `_MDd`, `_MT`, `_MTd`) refers to the [Use Run-Time Library] option used to compile the library.

### Calling convention

When using dynamic library of *Windows/x86*, explicitly using `__stdcall` as calling convention.
When using the dynamic library of *Windows/x86*, explicitly use `__stdcall` as the calling convention.
8 changes: 8 additions & 0 deletions Core/RedistributableFiles.txt
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,10 @@ under the terms of the Live2D Proprietary Software License Agreement:
- lib/windows/x86/142/Live2DCubismCore_MDd.lib
- lib/windows/x86/142/Live2DCubismCore_MT.lib
- lib/windows/x86/142/Live2DCubismCore_MTd.lib
- lib/windows/x86/143/Live2DCubismCore_MD.lib
- lib/windows/x86/143/Live2DCubismCore_MDd.lib
- lib/windows/x86/143/Live2DCubismCore_MT.lib
- lib/windows/x86/143/Live2DCubismCore_MTd.lib
- lib/windows/x86_64/120/Live2DCubismCore_MD.lib
- lib/windows/x86_64/120/Live2DCubismCore_MDd.lib
- lib/windows/x86_64/120/Live2DCubismCore_MT.lib
Expand All @@ -62,3 +66,7 @@ under the terms of the Live2D Proprietary Software License Agreement:
- lib/windows/x86_64/142/Live2DCubismCore_MDd.lib
- lib/windows/x86_64/142/Live2DCubismCore_MT.lib
- lib/windows/x86_64/142/Live2DCubismCore_MTd.lib
- lib/windows/x86_64/143/Live2DCubismCore_MD.lib
- lib/windows/x86_64/143/Live2DCubismCore_MDd.lib
- lib/windows/x86_64/143/Live2DCubismCore_MT.lib
- lib/windows/x86_64/143/Live2DCubismCore_MTd.lib
2 changes: 1 addition & 1 deletion Framework
83 changes: 83 additions & 0 deletions NOTICE.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
[English](NOTICE.md) / [日本語](NOTOICE.ja.md)

---

# お知らせ

## [注意事項] Cocos2d-xセットアップのエラーについて (2022-03-15)

Cocos2d-xサンプルプロジェクトのセットアップ時に実行するsetup-cocos2dバッチにおいてエラーが発生いたします。
これはGitHubがGitプロトコルセキュリティを改善したことに起因し、GitにてCocos2d-xのsubmodule取得が失敗するためです。
具体的には`git://`経由での接続ができなくなったためエラーが発生しています。

詳しくはGitHub公式ブログをご確認ください。

* [GitHub 公式ブログ](https://github.blog/2021-09-01-improving-git-protocol-security-github/)

### 回避方法

* ターミナルもしくはコマンドプロンプトにて以下のコマンドを実行することで、`git://`を用いた接続を`https://`に置き換える
* `git config --global url."https://github.com/".insteadOf git://github.com/`
* このコマンドは実行端末の全ユーザのgitconfigに影響します。ご了承ください。


## [注意事項] Metal及びCocos2d-x v4.0 の macOSサンプルビルドにおけるメモリリークについて (2021-12-09)

Metal及びCocos2d-x v4.0 の macOSサンプルビルドにおいてメモリリークが発生いたします。
これはMetalフレームワーク内で発生するため、公式の対応をお待ち下さい。
本件のお問い合わせについて弊社ではお答えいたしかねますので、ご了承ください。

詳細については Apple Developer Forums をご確認ください。

* [Apple Developer Forums - Memory leak in MTLCommandBuffer?](https://developer.apple.com/forums/thread/120931)


## [制限事項] Apple製品の対応状況について (2021-12-09 更新)

macOS Monterey v12.0につきまして、Cubism 4 SDK for Native R4 (4-r.4) にて対応いたしました。
また、Cubism 4 SDK for Native R4 Beta1 (4-r.4-beta.1) 以降のバージョンでApple Silicon版のmacに対応しております。
※Cubism Editorは現在Apple Silicon製のMacに対応しておりません、ご了承ください。


## [制限事項] Cocos2d-x v4.0 の Linux(Ubuntu)サンプルビルドについて (2021-04-15)

Cocos2d-x v4.0 は `Ubuntu 20.04` ビルドに対応しておりません。
使用する際は以下の回避方法を確認し、いずれかを適用してご利用いただきますようお願いいたします。

### 回避方法

* `Ubuntu 16.04` または `Ubuntu 18.04` を使用する

* 以下issueを確認し、`Cocos2d-x v4.0` で使用されている `libchipmunk` ライブラリを差し替える
* [cocos2d/cocos2d-x linking error when integrating with libchipmunk on linux#20471](https://github.com/cocos2d/cocos2d-x/issues/20471)
* WARNING: この回避方法を使用してビルドしたプロジェクトはいかなる場合でも保守いたしかねます


## [注意事項] Visual Studio 2013 ご利用時の OpenGL サンプルビルドについて (2021-02-17)

`Visual Studio 2013` を使用した `OpenGL` サンプルビルドでは、`setup_glew_glfw.bat` をそのまま使用してビルドすると `GLEW` にてリンクエラーが発生します。
以下回避方法を確認し、ご利用いただきますようお願いいたします。

### 回避方法

* `GLEW 2.2.0` を使用する場合
* `glew` プロジェクトから `libvcruntime.lib` の参照を削除する
* `Visual Studio 2013` 以降の Visual Studio を使用する

* `GLEW 2.1.0` を使用する場合
* `setup_glew_glfw_vs2013.bat` を使用して `thirdParty` のセットアップを行う


## Cubism Core

### [注意事項] macOS Catalina 以降のバージョンでの `.bundle``.dylib` の利用について

macOS Catalina 上で `.bundle``.dylib` を利用する際、公証の確認のためオンライン環境に接続している必要があります。

詳しくは、Apple社 公式ドキュメントをご確認ください。

* [Apple社 公式ドキュメント](https://developer.apple.com/documentation/security/notarizing_your_app_before_distribution)

---

©Live2D
Loading

0 comments on commit 8e94d81

Please sign in to comment.