diff --git a/README.md b/README.md index 318f801..07d4ece 100644 --- a/README.md +++ b/README.md @@ -1,30 +1,34 @@ -# OpenToonz +# OpenToonz ([日本語](./doc/README_ja.md)) -## これは何? +## What is OpenToonz? -2Dアニメーション制作ソフトウェアです。 -イタリアのDigital Video社が開発し、株式会社スタジオジブリのカスタマイズを経て、ジブリ作品の制作に長年使われてきたソフトウェア「Toonz」が基になっています。 +OpenToonz is a 2D animation suite published by +[DWANGO](http://dwango.co.jp/english/). It is based on **Toonz Studio +Ghibli Version**, originally developed in Italy by +[Digital Video, Inc.](http://www.toonz.com/), and customized by +[Studio Ghibli](http://www.ghibli.jp/) over many years of production. -## 動作条件 +## Program Requirements -https://opentoonz.github.io/ を参照してください。 +Please refer to the OpenToonz site at . -## インストール +## Installation -https://opentoonz.github.io/ から最新版のインストーラーをダウンロードしてインストールしてください。 +Please download and install OpenToonz from the installers at . -## ビルド方法 +## How to Build Locally -- [Windows](how_to_build_win.md) -- [OS X](how_to_build_macosx.md) +- [Windows](./doc/how_to_build_win.md) +- [OS X](./doc/how_to_build_macosx.md) -### ライセンス +## Licensing -- thirdpartyディレクトリ以外のファイル - - [修正BSDライセンス](LICENSE.txt) - - ライセンスに基づき、商用・非商用問わず、自由にソフトウェアの利用やソースコードの改変ができます -- thirdpartyディレクトリ内のファイル - - 各ディレクトリ内のREADMEやソースコードに記載されたライセンスに従ってください +- Files outside of the `thirdparty` directory are based on the Modified BSD License. + - [modified BSD license](./LICENSE.txt). + - Based on this license, this software may be used or changed freely for business or personal use. +- For files in the `thirdparty` directory: + - Please consult with the licenses in the appropriate READMEs or source codes. ### Special Thanks + This Open Source Program is developed from Toonz, a software originally created by Digital Video, S.p.A., Rome Italy diff --git a/doc/README_ja.md b/doc/README_ja.md new file mode 100644 index 0000000..e6438a0 --- /dev/null +++ b/doc/README_ja.md @@ -0,0 +1,30 @@ +# OpenToonz ([English](../README.md)) + +## これは何? + +2D アニメーション制作ソフトウェアです。 +イタリアの Digital Video 社が開発し、株式会社スタジオジブリのカスタマイズを経て、ジブリ作品の制作に長年使われてきたソフトウェア `Toonz` が基になっています。 + +## 動作条件 + +https://opentoonz.github.io/ を参照してください。 + +## インストール + +https://opentoonz.github.io/ から最新版のインストーラーをダウンロードしてインストールしてください。 + +## ビルド方法 + +- [Windows](./how_to_build_win_ja.md) +- [OS X](./how_to_build_macosx_ja.md) + +### ライセンス + +- thirdparty ディレクトリ以外のファイル + - [修正 BSD ライセンス](LICENSE.txt) + - ライセンスに基づき、商用・非商用問わず、自由にソフトウェアの利用やソースコードの改変ができます +- thirdparty ディレクトリ内のファイル + - 各ディレクトリ内の README やソースコードに記載されたライセンスに従ってください + +### Special Thanks +This Open Source Program is developed from Toonz, a software originally created by Digital Video, S.p.A., Rome Italy diff --git a/doc/how_to_build_macosx.md b/doc/how_to_build_macosx.md new file mode 100644 index 0000000..6e94321 --- /dev/null +++ b/doc/how_to_build_macosx.md @@ -0,0 +1,70 @@ +# Setting Up the Development Environment on MacOSX + +## Necessary Software + +- git +- brew +- Xcode +- cmake + - Version 3.2.2 confirmed to work. +- Qt + - http://download.qt.io/official_releases/qt/5.5/5.5.1/ + - qt-opensource-mac-x64-clang-5.5.1.dmg +- boost + - http://www.boost.org/users/history/version_1_55_0.html + +## Building on MacOSX + +### Using brew to Install Necessary Packages + +``` +$ brew install glew lz4 libjpeg libpng lzo pkg-config +``` + +### Cloning the Repository + +``` +$ git clone https://github.com/opentoonz/opentoonz +``` + +### (Optional) Creating the stuff Directory + +If the directory `/Applications/OpenToonz/OpenToonz_1.0_stuff` does not exist, enter the following command: + +``` +$ sudo cp -r opentoonz/stuff /Applications/OpenToonz/OpenToonz_1.0_stuff +``` + +### Building tiff in thirdparty + +``` +$ cd opentoonz/thirdparty/tiff-4.0.3 +$ ./configure && make +``` + +### Installing boost to thirdpaty +The following assumes `boost_1_55_0.tar.bz2` was downloaded to `~/Downloads`. + +``` +$ cd ../boost +$ mv ~/Downloads/boost_1_55_0.tar.bz2 . +$ tar xjvf boost_1_55_0.tar.bz2 +``` + +### Building Everything Together + +``` +$ cd ../../toonz +$ mkdir build +$ cd build +$ cmake ../sources +$ make +``` + +Please be patient as the install will take a while. + +### After Building + +``` +$ open ./toonz/OpenToonz_1.0.app +``` diff --git a/doc/how_to_build_macosx_ja.md b/doc/how_to_build_macosx_ja.md new file mode 100644 index 0000000..558294e --- /dev/null +++ b/doc/how_to_build_macosx_ja.md @@ -0,0 +1,71 @@ +# MacOSX での開発環境構築 + +## 必要なソフトウェア + +- git +- brew +- Xcode +- cmake + - バージョン 3.2.2 で動作確認済みです。 +- Qt + - http://download.qt.io/official_releases/qt/5.5/5.5.1/ + - qt-opensource-mac-x64-clang-5.5.1.dmg +- boost + - http://www.boost.org/users/history/version_1_55_0.html + +## ビルド手順 + +### brew で必要なパッケージをインストール + +``` +$ brew install glew lz4 libjpeg libpng lzo pkg-config +``` + +### リポジトリを clone + +``` +$ git clone https://github.com/opentoonz/opentoonz +``` + +### stuff ディレクトリの設置 (任意) + +`/Applications/OpenToonz/OpenToonz_1.0_stuff` というディレクトリが存在していない場合は以下のコマンド等でリポジトリのひな形を設置する必要があります。 + +``` +$ sudo cp -r opentoonz/stuff /Applications/OpenToonz/OpenToonz_1.0_stuff +``` + +### thirdparty 下の tiff をビルド + +``` +$ cd opentoonz/thirdparty/tiff-4.0.3 +$ ./configure && make +``` + +### thirdpaty 下に boost を設置 + +以下のコマンドは `~/Downsloads` に `boost_1_55_0.tar.bz2` がダウンロードされていることを想定しています。 + +``` +$ cd ../boost +$ mv ~/Downloads/boost_1_55_0.tar.bz2 . +$ tar xjvf boost_1_55_0.tar.bz2 +``` + +### 本体のビルド + +``` +$ cd ../../toonz +$ mkdir build +$ cd build +$ cmake ../sources +$ make +``` + +ビルドが長いので気長に待ちます。 + +### 完成 + +``` +$ open ./toonz/OpenToonz_1.0.app +``` diff --git a/doc/how_to_build_win.md b/doc/how_to_build_win.md new file mode 100644 index 0000000..5b050fa --- /dev/null +++ b/doc/how_to_build_win.md @@ -0,0 +1,124 @@ +# Building on Windows + +This software can be built using Visual Studio 2013 and Qt 5.5 + +## Required Software + +### Visual Studio Express 2013 for Windows Desktop +- https://www.microsoft.com/en-us/download/details.aspx?id=44914 +- Since Qt 5.5 does not work with Visual Studio 2015, Visual Studio 2013 must be used. +- Make sure that the target platform is "for Windows Desktop" not "for Windows". +- Community and Provessional versions of Visual Studio 2013 for Windows Desktop also work. + +### CMake +- https://cmake.org/download/ +- This will be used to create the VS2013 project file. + +## Acquiring the Source Code +- Clone the base repository. +- Throughout the explanation `$opentoonz` will represent the root for the base repository. +- Visual Studio 2013 cannot recognize UTF-8 without BOM source code properly. Furthermore, since the endline character is represented with only the LF character, one line comments in Japanese will often cause the following line to be treated as a comment by VS2013 as well. +- In order to prevent this, please change the following setting in git so that it will preserve the proper endline characters: + - `git config core.safecrlf true` + +## Installation of Required Libraries +Because of the size of these libraries, they are not maintained in the git repository. +They will have to be installed seperately as follows. + +### Qt +- http://download.qt.io/official_releases/qt/5.5/5.5.1/ +- Qt is a cross-platform GUI framework. +- This project does not use the latest Qt framework (5.6). +- Select the following file from the above link: + - qt-opensource-windows-x86-msvc2013_64-5.5.1.exe + +### boost +- http://www.boost.org/users/history/version_1_55_0.html +- Download boost_1_55_0.zip from the above link. Extract all contents to the '$opentoonz/thirdparty/boost' directory. +- Install the following path for Visual Studio 2013 + - https://svn.boost.org/trac/boost/attachment/ticket/9369/vc12_fix_has_member_function_callable_with.patch + +## Building + +### Using CMake to Create a Visual Studio Project +1. Launch CMake +2. In `Where is the source code`, navigate to `$opentoonz/toonz/sources` +3. In `Where to build the binaries`, navigate to `$opentoonz/toonz/build` + - Or to wherever you usually build to. + - If the build directory is in the git repository, be sure to add the directory to .gitignore + - If the build directory is different from the one above, be sure to change to the specified directory where appropriate below. +4. Click on Configure and select Visual Studio 12 2013 Win64. +5. If Qt was installed to a directory other than the default, and the error `Specify QT_PATH properly` appears, navigate to the `QT_DIR` install folder and specify the path to `msvc2013_64`. +6. Click Generate + - Should the CMakeLists.txt file change, such as during automatic build cleanup, there is no need to rerun CMake. + +## Setting Up Libraries +Rename the following files: + - `$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` + +## Building +1. Open `$opentoonz/toonz/build/OpenToonz.sln` and change to `Release` +2. The output will be in `$opentoonz/toonz/build/Release` + +## Running the Program +### Setting Up the Program's Path +1. Copy the entire contents of `$opentoonz/toonz/build/Release` to an appropriate folder. +2. In the path for `OpenToonz_1.0.exe`, append the Qt program `windeployqt.exe` as an argument. + - The necessary Qt library files should be in the same folder as `OpenToonz_1.0.exe` +3. Copy the following files to the same folder as `OpenToonz_1.0.exe` + - `$opentoonz/thirdparty/glut/3.7.6/lib/glut64.dll` + - `$opentoonz/thirdparty/glew/glew-1.9.0/bin/64bit/glew32.dll` +4. Copy the `srv` folder from the previous OpenToonz installation to the same folder as `OpenToonz_1.0.exe` + - If there is no `srv` folder, OpenToonz can still be used. However, various file formats such as `mov` cannot be used. + - Creating the files for `srv` is discussed later. + +### Creating the stuff Folder +If a previous binary of OpenToonz was already installed, this step and the following about creating a registry key has already been dealt with. So feel free to skip these parts. + +1. Copy the files from `$opentoonz/stuff` to an appropriate folder. + +### Creating Registry Keys +1. Using the registry editor, create the following key and copy the path of the `$opentoonz/stuff` folder from above to it. + - HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\1.0\TOONZROOT + +### Running +`OpenToonz_1.0.exe` can now be run. Congratulations! + +## Creating the Files for the srv Folder +OpenToonz utilizes the QuickTime SDK's `mov` and associated file formats. Since the QuickTime SDK only comes in 32-bit versions, the 32-bit file `t32bitsrv.exe` from the QuickTime SDK is used in both the 64-bit and 32-bit versions of OpenToonz. As a result, the following instructions apply to both the 32 and 64-bit versions of OpenToonz. + +### Qt +- http://download.qt.io/official_releases/qt/5.5/5.5.1/ +- Find the following file from the above link and install in the appropriate folder. + - qt-opensource-windows-x86-msvc2013-5.5.1.exe + +### QuickTime SDK +1. Sign in using your Apple developer ID and download `QuickTime 7.3 SDK for Windows.zip` from the following url. + - https://developer.apple.com/downloads/?q=quicktime +2. After installing the QuickTime SDK, copy the contents of `C:\Program Files (x86)\QuickTime SDK` to `$opentoonz/thirdparty/quicktime/QT73SDK` + +### Using CMake to Create a Visual Studio 32-bit Project +- Follow the same instructions as for the 64-bit version, but change the following: + - `$opentoonz/toonz/build` → `$opentoonz/toonz/build32` + - Visual Studio 12 2013 Win64 → Visual Studio 12 2013 +- Change `QT_DIR` to the path of your 32-bit version of Qt + +### Building the 32-bit Version +1. Open `$opentoonz/toonz/build32/OpenToonz.sln` + +### Layout of the srv Folder +- For the 64-bit version, copy the following files to the `srv` folder: + - From `$opentoonz/toonz/build32/Release` + - t32bitsrv.exe + - image.dll + - tnzcore.dll + - From the 32-bit version of Qt + - Qt5Core.dll + - Qt5Network.dll + - `$opentoonz/thirdparty/glut/3.7.6/lib/glut32.dll` + +## Creating Translation Files +Qt translation files are generated first from the source code to .ts files, then from .ts files to a .qm file. These files can be created in Visual Studio if the `translation_` project and `Build translation_??? only` (`translation_???`のみをビルド」) is used. These files are not created in the default `Build Project Solution`. diff --git a/doc/how_to_build_win_ja.md b/doc/how_to_build_win_ja.md new file mode 100644 index 0000000..c74d48f --- /dev/null +++ b/doc/how_to_build_win_ja.md @@ -0,0 +1,122 @@ +# ビルド手順(Windows) + +Visual Studio 2013とQt 5.5でビルドできることを確認しています。 + +## 必要なソフトウェアの導入 + +### Visual Studio Express 2013 for Windows Desktop +- https://www.microsoft.com/ja-jp/download/details.aspx?id=44914 +- Qt 5.5がVisual Studio 2015に対応していないため、2013を使う必要があります +- Express版はターゲットプラットフォームごとにバージョンが分かれています。「for Windows」ではなく「for Windows Desktop」を使用します +- Community版やProfessional版などでも構いません + +### CMake +- https://cmake.org/download/ +- Visual Studio用のプロジェクトファイルの生成に使用します + +## ソースコードの取得 +- 本リポジトリをcloneします +- 以下の説明中の`$opentoonz`は、本リポジトリのrootを表します +- Visual Studio 2013はBOMの無いUTF-8のソースコードを正しく認識できず、改行コードがLFで、1行コメントの末尾が日本語の場合に、改行が無視されて次の行もコメントとして扱われる問題があるため、Gitに下記の設定をして改行コードをCRLFに変換すると良いでしょう + - `git config core.safecrlf true` + +## 必要なライブラリのインストール +サイズの大きいライブラリはこのリポジトリには含めていないので、別途インストールする必要があります。 + +### Qt +- http://download.qt.io/official_releases/qt/5.5/5.5.1/ +- クロスプラットフォームのGUIフレームワークです +- 現在はQt 5.6には対応していません +- 上記のURLから以下のファイルをダウンロードして適当なフォルダにインストールします + - qt-opensource-windows-x86-msvc2013_64-5.5.1.exe + +### boost +- http://www.boost.org/users/history/version_1_55_0.html +- 上記のURLからboost_1_55_0.zipをダウンロードして解凍し、boost_1_55_0を`$opentoonz/thirdparty/boost`にコピーします +- Visual Studio 2013用の下記のパッチを当てます + - https://svn.boost.org/trac/boost/attachment/ticket/9369/vc12_fix_has_member_function_callable_with.patch + +## ビルド + +### CMakeでVisual Studioのプロジェクトを生成する +1. CMakeを立ち上げる +2. Where is the source codeに`$opentoonz/toonz/sources`を指定する +3. Where to build the binariesに`$opentoonz/toonz/build`を指定する + - 他の場所でも構いません + - チェックアウトしたフォルダ内に作成する場合は、buildから開始するフォルダ名にするとgitから無視されます + - ビルド先を変更した場合は、以下の説明を適宜読み替えてください +4. Configureをクリックして、Visual Studio 12 2013 Win64を選択します +5. Qtのインストール先がデフォルトではない場合、`Specify QT_PATH properly`というエラーが表示されるので、`QT_DIR`にQt5をインストールしたフォルダ内の`msvc2013_64`のパスを指定します +6. 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` + +## ビルド +1. `$opentoonz/toonz/build/OpenToonz.sln`を開いてRelease構成を選択してビルドします +2. `$opentoonz/toonz/build/Release`にファイルが生成されます + +## 実行 +### 実行可能ファイルなどの配置 +1. `$oepntoonz/toonz/build/Release`の中身を適当なフォルダにコピーします +2. `OpenToonz_1.0.exe`のパスを引数にしてQtに付属の`windeployqt.exe`を実行します + - 必要なQtのライブラリなどが`OpenToonz_1.0.exe`と同じフォルダに集められます +3. 下記のファイルを`OpenToonz_1.0.exe`と同じフォルダにコピーします + - `$opentoonz/thirdparty/glut/3.7.6/lib/glut64.dll` + - `$opentoonz/thirdparty/glew/glew-1.9.0/bin/64bit/glew32.dll` +4. バイナリ版のOpenToonzのインストール先にある`srv`フォルダを`OpenToonz_1.0.exe`と同じフォルダにコピーします + - `srv`が無くてもOpenToonzは動作しますが、mov形式などに対応できません + - `srv`内のファイルの生成方法は後述します + +### Stuffフォルダの作成 +既にバイナリ版のOpenToonzをインストールしている場合、この手順とレジストリキーの作成と同様の処理が行われているため、これらの手順は不要です。 + +1. `$opentoonz/stuff`を適当なフォルダにコピーします + +### レジストリキーの作成 +1. レジストリエディタで下記のキーを作成し、Stuffフォルダの作成でコピーしたstuffフォルダのパスを記載します + - HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\1.0\TOONZROOT + +### 実行 +OpenToonz_1.0.exeを実行して動作すれば成功です。おめでとうございます。 + +## srvフォルダ内のファイルの生成 +OpenToonzはQuickTime SDKを用いてmov形式などへ対応しています。QuickTime SDKは32ビット版しかないため、`t32bitsrv.exe`という32ビット版の実行可能ファイルにQuickTime SDKを組み込み、64ビット版のOpenToonzは`t32bitsrv.exe`を経由してQuickTime SDKの機能を使用しています。以下の手順では`t32bitsrv.exe`などと合わせて、32ビット版のOpenToonzも生成されます。 + +### Qt +- http://download.qt.io/official_releases/qt/5.5/5.5.1/ +- 上記のURLから以下のファイルをダウンロードして適当なフォルダにインストールします + - qt-opensource-windows-x86-msvc2013-5.5.1.exe + +### QuickTime SDK +1. Appleの開発者登録をして下記のURLから`QuickTime 7.3 SDK for Windows.zip`をダウンロードします + - https://developer.apple.com/downloads/?q=quicktime +2. QuickTime SDKをインストールして、`C:\Program Files (x86)\QuickTime SDK`の中身を`thirdparty/quicktime/QT73SDK`の中にコピーします + +### CMakeでVisual Studioの32ビット版のプロジェクトを生成する +- 64ビット版と同様の手順で、次のようにフォルダ名とターゲットを読み替えます + - `$opentoonz/toonz/build` → `$opentoonz/toonz/build32` + - Visual Studio 12 2013 Win64 → Visual Studio 12 2013 +- `QT_DIR`には32ビット版のQtのパスを指定します + +### 32ビット版のビルド +1. `$opentoonz/toonz/build32/OpenToonz.sln`を開いてビルドします + +### srvフォルダの配置 +- 64ビット版のsrvフォルダの中に下記のファイルをコピーします + - `$opentoonz/toonz/build32/Release`から + - t32bitsrv.exe + - 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ファイルの生成が行われます。これらのプロジェクトはソリューションのビルドではビルドされないようになっています。 diff --git a/how_to_build_macosx.md b/how_to_build_macosx.md deleted file mode 100644 index 558294e..0000000 --- a/how_to_build_macosx.md +++ /dev/null @@ -1,71 +0,0 @@ -# MacOSX での開発環境構築 - -## 必要なソフトウェア - -- git -- brew -- Xcode -- cmake - - バージョン 3.2.2 で動作確認済みです。 -- Qt - - http://download.qt.io/official_releases/qt/5.5/5.5.1/ - - qt-opensource-mac-x64-clang-5.5.1.dmg -- boost - - http://www.boost.org/users/history/version_1_55_0.html - -## ビルド手順 - -### brew で必要なパッケージをインストール - -``` -$ brew install glew lz4 libjpeg libpng lzo pkg-config -``` - -### リポジトリを clone - -``` -$ git clone https://github.com/opentoonz/opentoonz -``` - -### stuff ディレクトリの設置 (任意) - -`/Applications/OpenToonz/OpenToonz_1.0_stuff` というディレクトリが存在していない場合は以下のコマンド等でリポジトリのひな形を設置する必要があります。 - -``` -$ sudo cp -r opentoonz/stuff /Applications/OpenToonz/OpenToonz_1.0_stuff -``` - -### thirdparty 下の tiff をビルド - -``` -$ cd opentoonz/thirdparty/tiff-4.0.3 -$ ./configure && make -``` - -### thirdpaty 下に boost を設置 - -以下のコマンドは `~/Downsloads` に `boost_1_55_0.tar.bz2` がダウンロードされていることを想定しています。 - -``` -$ cd ../boost -$ mv ~/Downloads/boost_1_55_0.tar.bz2 . -$ tar xjvf boost_1_55_0.tar.bz2 -``` - -### 本体のビルド - -``` -$ cd ../../toonz -$ mkdir build -$ cd build -$ cmake ../sources -$ make -``` - -ビルドが長いので気長に待ちます。 - -### 完成 - -``` -$ open ./toonz/OpenToonz_1.0.app -``` diff --git a/how_to_build_win.md b/how_to_build_win.md deleted file mode 100644 index c74d48f..0000000 --- a/how_to_build_win.md +++ /dev/null @@ -1,122 +0,0 @@ -# ビルド手順(Windows) - -Visual Studio 2013とQt 5.5でビルドできることを確認しています。 - -## 必要なソフトウェアの導入 - -### Visual Studio Express 2013 for Windows Desktop -- https://www.microsoft.com/ja-jp/download/details.aspx?id=44914 -- Qt 5.5がVisual Studio 2015に対応していないため、2013を使う必要があります -- Express版はターゲットプラットフォームごとにバージョンが分かれています。「for Windows」ではなく「for Windows Desktop」を使用します -- Community版やProfessional版などでも構いません - -### CMake -- https://cmake.org/download/ -- Visual Studio用のプロジェクトファイルの生成に使用します - -## ソースコードの取得 -- 本リポジトリをcloneします -- 以下の説明中の`$opentoonz`は、本リポジトリのrootを表します -- Visual Studio 2013はBOMの無いUTF-8のソースコードを正しく認識できず、改行コードがLFで、1行コメントの末尾が日本語の場合に、改行が無視されて次の行もコメントとして扱われる問題があるため、Gitに下記の設定をして改行コードをCRLFに変換すると良いでしょう - - `git config core.safecrlf true` - -## 必要なライブラリのインストール -サイズの大きいライブラリはこのリポジトリには含めていないので、別途インストールする必要があります。 - -### Qt -- http://download.qt.io/official_releases/qt/5.5/5.5.1/ -- クロスプラットフォームのGUIフレームワークです -- 現在はQt 5.6には対応していません -- 上記のURLから以下のファイルをダウンロードして適当なフォルダにインストールします - - qt-opensource-windows-x86-msvc2013_64-5.5.1.exe - -### boost -- http://www.boost.org/users/history/version_1_55_0.html -- 上記のURLからboost_1_55_0.zipをダウンロードして解凍し、boost_1_55_0を`$opentoonz/thirdparty/boost`にコピーします -- Visual Studio 2013用の下記のパッチを当てます - - https://svn.boost.org/trac/boost/attachment/ticket/9369/vc12_fix_has_member_function_callable_with.patch - -## ビルド - -### CMakeでVisual Studioのプロジェクトを生成する -1. CMakeを立ち上げる -2. Where is the source codeに`$opentoonz/toonz/sources`を指定する -3. Where to build the binariesに`$opentoonz/toonz/build`を指定する - - 他の場所でも構いません - - チェックアウトしたフォルダ内に作成する場合は、buildから開始するフォルダ名にするとgitから無視されます - - ビルド先を変更した場合は、以下の説明を適宜読み替えてください -4. Configureをクリックして、Visual Studio 12 2013 Win64を選択します -5. Qtのインストール先がデフォルトではない場合、`Specify QT_PATH properly`というエラーが表示されるので、`QT_DIR`にQt5をインストールしたフォルダ内の`msvc2013_64`のパスを指定します -6. 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` - -## ビルド -1. `$opentoonz/toonz/build/OpenToonz.sln`を開いてRelease構成を選択してビルドします -2. `$opentoonz/toonz/build/Release`にファイルが生成されます - -## 実行 -### 実行可能ファイルなどの配置 -1. `$oepntoonz/toonz/build/Release`の中身を適当なフォルダにコピーします -2. `OpenToonz_1.0.exe`のパスを引数にしてQtに付属の`windeployqt.exe`を実行します - - 必要なQtのライブラリなどが`OpenToonz_1.0.exe`と同じフォルダに集められます -3. 下記のファイルを`OpenToonz_1.0.exe`と同じフォルダにコピーします - - `$opentoonz/thirdparty/glut/3.7.6/lib/glut64.dll` - - `$opentoonz/thirdparty/glew/glew-1.9.0/bin/64bit/glew32.dll` -4. バイナリ版のOpenToonzのインストール先にある`srv`フォルダを`OpenToonz_1.0.exe`と同じフォルダにコピーします - - `srv`が無くてもOpenToonzは動作しますが、mov形式などに対応できません - - `srv`内のファイルの生成方法は後述します - -### Stuffフォルダの作成 -既にバイナリ版のOpenToonzをインストールしている場合、この手順とレジストリキーの作成と同様の処理が行われているため、これらの手順は不要です。 - -1. `$opentoonz/stuff`を適当なフォルダにコピーします - -### レジストリキーの作成 -1. レジストリエディタで下記のキーを作成し、Stuffフォルダの作成でコピーしたstuffフォルダのパスを記載します - - HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\1.0\TOONZROOT - -### 実行 -OpenToonz_1.0.exeを実行して動作すれば成功です。おめでとうございます。 - -## srvフォルダ内のファイルの生成 -OpenToonzはQuickTime SDKを用いてmov形式などへ対応しています。QuickTime SDKは32ビット版しかないため、`t32bitsrv.exe`という32ビット版の実行可能ファイルにQuickTime SDKを組み込み、64ビット版のOpenToonzは`t32bitsrv.exe`を経由してQuickTime SDKの機能を使用しています。以下の手順では`t32bitsrv.exe`などと合わせて、32ビット版のOpenToonzも生成されます。 - -### Qt -- http://download.qt.io/official_releases/qt/5.5/5.5.1/ -- 上記のURLから以下のファイルをダウンロードして適当なフォルダにインストールします - - qt-opensource-windows-x86-msvc2013-5.5.1.exe - -### QuickTime SDK -1. Appleの開発者登録をして下記のURLから`QuickTime 7.3 SDK for Windows.zip`をダウンロードします - - https://developer.apple.com/downloads/?q=quicktime -2. QuickTime SDKをインストールして、`C:\Program Files (x86)\QuickTime SDK`の中身を`thirdparty/quicktime/QT73SDK`の中にコピーします - -### CMakeでVisual Studioの32ビット版のプロジェクトを生成する -- 64ビット版と同様の手順で、次のようにフォルダ名とターゲットを読み替えます - - `$opentoonz/toonz/build` → `$opentoonz/toonz/build32` - - Visual Studio 12 2013 Win64 → Visual Studio 12 2013 -- `QT_DIR`には32ビット版のQtのパスを指定します - -### 32ビット版のビルド -1. `$opentoonz/toonz/build32/OpenToonz.sln`を開いてビルドします - -### srvフォルダの配置 -- 64ビット版のsrvフォルダの中に下記のファイルをコピーします - - `$opentoonz/toonz/build32/Release`から - - t32bitsrv.exe - - 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ファイルの生成が行われます。これらのプロジェクトはソリューションのビルドではビルドされないようになっています。