7.9 KiB
7.9 KiB
ビルド手順（Windows）
Visual Studio 2015 と Qt 5.9 でビルドできることを確認しています。
必要なソフトウェアの導入
Visual Studio Express 2015 for Windows Desktop
- https://www.visualstudio.com/ja-jp/products/visual-studio-express-vs.aspx
- Express 版はターゲットプラットフォームごとにバージョンが分かれています。
for Windowsではなくfor Windows Desktopを使用します - Community 版や Professional 版などでも構いません
CMake
- https://cmake.org/download/
- Visual Studio 用のプロジェクトファイルの生成に使用します
ソースコードの取得
- 本リポジトリを
git cloneします - 以下の説明中の
$opentoonzは、本リポジトリの root を表します - Visual Studio は BOM の無い UTF-8 のソースコードを正しく認識できず、改行コードが LF で、1行コメントの末尾が日本語の場合に、改行が無視されて次の行もコメントとして扱われる問題があるため、Git に下記の設定をして改行コードを CRLF に変換すると良いでしょう
git config core.safecrlf true
必要なライブラリのインストール
サイズの大きいライブラリはこのリポジトリには含めていないので、別途インストールする必要があります。
lib と dll
libとdllファイルは Git Large File Storage で管理しています。lfsのクライアントを導入して、上記git cloneのあとにgit lfs pullを実行してください。
Qt
- https://www.qt.io/download-open-source/
- クロスプラットフォームの GUI フレームワークです
- 上記の URL から以下のファイルをダウンロードして Qt 5.9 (64 ビット版) を適当なフォルダにインストールします
boost
- http://www.boost.org/users/history/version_1_61_0.html
- 上記の URL から boost_1_61_0.zip をダウンロードして解凍し、 boost_1_61_0 を
$opentoonz/thirdparty/boostにコピーします
ビルド
CMake で Visual Studio のプロジェクトを生成する
- CMake を立ち上げる
- Where is the source code に
$opentoonz/toonz/sourcesを指定する - Where to build the binaries に
$opentoonz/toonz/buildを指定する
- 他の場所でも構いません
- チェックアウトしたフォルダ内に作成する場合は、buildから開始するフォルダ名にするとgitから無視されます
- ビルド先を変更した場合は、以下の説明を適宜読み替えてください
- Configure をクリックして、 Visual Studio 14 2015 Win64 を選択します
- Qt のインストール先がデフォルトではない場合、
Specify QT_PATH properlyというエラーが表示されるので、QT_PATHに Qt5 をインストールしたパスを指定します - Generate をクリック
- CMakeLists.txt に変更があった場合は、ビルド時に自動的に処理が走るので、以降は CMake を直接使用する必要はありません
ライブラリの設定
下記のファイルをコピーします
$opentoonz/thirdparty/LibJPEG/jpeg-9/jconfig.vc→$opentoonz/thirdparty/LibJPEG/jpeg-9/jconfig.h$opentoonz/thirdparty/tiff-4.0.3/libtiff/tif_config.vc.h→$opentoonz/thirdparty/tiff-4.0.3/libtiff/tif_config.h$opentoonz/thirdparty/tiff-4.0.3/libtiff/tiffconf.vc.h→$opentoonz/thirdparty/tiff-4.0.3/libtiff/tiffconf.h$opentoonz/thirdparty/libpng-1.6.21/scripts/pnglibconf.h.prebuilt→$opentoonz/thirdparty/libpng-1.6.21/pnglibconf.h
ビルド
$opentoonz/toonz/build/OpenToonz.slnを開いて Release 構成を選択してビルドします$opentoonz/toonz/build/Releaseにファイルが生成されます
ストップモーション機能とキヤノン製デジタルカメラのサポートを有効にするには
以下の３つのライブラリが追加で必要です。
- OpenCV (v4.1.0以上)
- libjpeg-turbo
- Canon EOS Digital SDK (EDSDK)：入手方法の詳細はキヤノンマーケティングジャパン株式会社Webサイトをご参照下さい。
CMake上で、WITH_STOPMOTION オプションをONにします。CMake上、または環境変数でOpenCV_DIR の値をOpenCVのインストールフォルダ内のbuildフォルダの場所に設定します。（例： C:/opencv/build）
実行時にはOpenCV、libjpeg-turboならびにCanon EDSDKの.dllファイルをOpenToonz.exe と同じフォルダにコピーします。
実行
実行可能ファイルなどの配置
$oepntoonz/toonz/build/Releaseの中身を適当なフォルダにコピーしますOpenToonz.exeのパスを引数にして Qt に付属のwindeployqt.exeを実行します
- 必要な Qt のライブラリなどが
OpenToonz.exeと同じフォルダに集められます
- 下記のファイルを
OpenToonz.exeと同じフォルダにコピーします
$opentoonz/thirdparty/glut/3.7.6/lib/glut64.dll$opentoonz/thirdparty/glew/glew-1.9.0/bin/64bit/glew32.dll
- バイナリ版の OpenToonz のインストール先にある
srvフォルダをOpenToonz.exeと同じフォルダにコピーします
srvが無くても OpenToonz は動作しますが、 mov 形式などに対応できませんsrv内のファイルの生成方法は後述します
Stuffフォルダの作成
既にバイナリ版の OpenToonz をインストールしている場合、この手順とレジストリキーの作成と同様の処理が行われているため、これらの手順は不要です。
$opentoonz/stuffを適当なフォルダにコピーします
レジストリキーの作成
- レジストリエディタで下記のキーを作成し、 Stuff フォルダの作成でコピーした stuff フォルダのパスを記載します
- HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\TOONZROOT
実行
OpenToonz.exe を実行して動作すれば成功です。おめでとうございます。
Qt
- https://www.qt.io/download-open-source/
- 64 ビット版と同じインストーラーで Qt 5.9 (32 ビット版) を適当なフォルダにインストールします
CMake で Visual Studio の 32 ビット版のプロジェクトを生成する
- 64 ビット版と同様の手順で、次のようにフォルダ名とターゲットを読み替えます
$opentoonz/toonz/build→$opentoonz/toonz/build32- Visual Studio 14 2015 Win64 → Visual Studio 14 2015
QT_PATHには 32 ビット版の Qt のパスを指定します
32 ビット版のビルド
$opentoonz/toonz/build32/OpenToonz.slnを開いてビルドします
srv フォルダの配置
- 64 ビット版の
srvフォルダの中に下記のファイルをコピーします$opentoonz/toonz/build32/Releaseから- image.dll
- tnzcore.dll
- Qt の 32ビット版のインストール先から
- Qt5Core.dll
- Qt5Network.dll
$opentoonz/thirdparty/glut/3.7.6/lib/glut32.dll
翻訳ファイルの生成
Qt の翻訳ファイルは、ソースコードから .ts ファイルを生成して、 .ts ファイルに対して翻訳作業を行い、 .ts ファイルから .qm ファイルを生成します。Visual Studioソリューション中のtranslation_から始まるプロジェクトに対して「 translation_??? のみをビルド」を実行すると、 .ts ファイルと .qm ファイルの生成が行われます。これらのプロジェクトはソリューションのビルドではビルドされないようになっています。