This software can be built using Visual Studio 2015 and Qt 5.6
- https://www.visualstudio.com/ja-jp/products/visual-studio-express-vs.aspx
- Make sure that the target platform is "for Windows Desktop" not "for Windows".
- Community and Professional versions of Visual Studio 2015 for Windows Desktop also work.
- https://cmake.org/download/
- This will be used to create the
MSVC 2015
project file.
- Clone the base repository.
- Throughout the explanation
$opentoonz
will represent the root for the base repository. - Visual Studio 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
MSVS
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
Because of the size of these libraries, they are not maintained in the git repository. They will have to be installed seperately as follows.
lib
anddll
files are tracked by Git Large File Storage.- Execute
git lfs pull
aftergit clone
by using thelfs
client.
- https://www.qt.io/download-open-source/
- Qt is a cross-platform GUI framework.
- Install Qt 5.6 (64-bit version) by Qt Online Installer for Windows.
- Boost 1.55.0 or later is required (tested up to 1.60.0).
- https://www.boost.org/users/history/version_1_61_0.html
- Download boost_1_61_0.zip from the above link. Extract all contents to the '$opentoonz/thirdparty/boost' directory.
- Install the following patch (Make the changes listed in the patch file), if you use Boost 1.55.0 with Visual Studio 2013.
- Launch CMake
- In
Where is the source code
, navigate to$opentoonz/toonz/sources
- 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.
- Click on Configure and select Visual Studio 14 2015 Win64.
- If Qt was installed to a directory other than the default, and the error
Specify QT_PATH properly
appears, navigate to theQT_DIR
install folder and specify the path tomsvc2015_64
. Rerun Configure. - Click Generate
- Should the CMakeLists.txt file change, such as during automatic build cleanup, there is no need to rerun CMake.
Rename the following files:
$opentoonz/thirdparty/LibJPEG/jpeg-9/jconfig.vc
to$opentoonz/thirdparty/LibJPEG/jpeg-9/jconfig.h
$opentoonz/thirdparty/tiff-4.0.3/libtiff/tif_config.vc.h
to$opentoonz/thirdparty/tiff-4.0.3/libtiff/tif_config.h
$opentoonz/thirdparty/tiff-4.0.3/libtiff/tiffconf.vc.h
to$opentoonz/thirdparty/tiff-4.0.3/libtiff/tiffconf.h
$opentoonz/thirdparty/libpng-1.6.21/scripts/pnglibconf.h.prebuilt
to$opentoonz/thirdparty/libpng-1.6.21/pnglibconf.h
- Note that the destination is a different folder for the last file.
Add a guard for snprintf at tif_config.h(50):
+#if _MSC_VER < 1900
#define snprintf _snprintf
+#endif
- Open
$opentoonz/toonz/build/OpenToonz.sln
and change toRelease
- The output will be in
$opentoonz/toonz/build/Release
-
Copy the entire contents of
$opentoonz/toonz/build/Release
to an appropriate folder. -
In the path for
OpenToonz_1.0.exe
, append the Qt programwindeployqt.exe
as an argument.
- The necessary Qt library files should be in the same folder as
OpenToonz_1.0.exe
- These include:
Qt5Core.dll
Qt5Gui.dll
Qt5Network.dll
Qt5OpenGL.dll
Qt5PrintSupport.dll
Qt5Script.dll
Qt5Svg.dll
Qt5Widgets.dll
Qt5Multimedia.dll
- These files should be in the corresponding folders in the same folder
OpenToonz_1.0.exe
/bearer/qgenericbearer.dll
/bearer/qnativewifibearer.dll
/iconengines/qsvgicon.dll
/imageformats/qdds.dll
/imageformats/qgif.dll
/imageformats/qicns.dll
/imageformats/qico.dll
/imageformats/qjpeg.dll
/imageformats/qsvg.dll
/imageformats/qtga.dll
/imageformats/qtiff.dll
/imageformats/qwbmp.dll
/imageformats/qwebp.dll
/platforms/qwindows.dll
- 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
- Copy the
srv
folder from the previous OpenToonz installation to the same folder asOpenToonz_1.0.exe
- If there is no
srv
folder, OpenToonz can still be used. However, various file formats such asmov
cannot be used. - Creating the files for
srv
is discussed later.
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.
- Copy the files from
$opentoonz/stuff
to an appropriate folder.
- 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
OpenToonz_1.0.exe
can now be run. Congratulations!
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.
- https://www.qt.io/download-open-source/
- Install Qt 5.6 (32-bit version) by the by Qt Online Installer for Windows.
- Sign in using your Apple developer ID and download
QuickTime 7.3 SDK for Windows.zip
from the following url.
- After installing the QuickTime SDK, copy the contents of
C:\Program Files (x86)\QuickTime SDK
to$opentoonz/thirdparty/quicktime/QT73SDK
- Follow the same instructions as for the 64-bit version, but change the following:
$opentoonz/toonz/build
to$opentoonz/toonz/build32
Visual Studio 14 2015 Win64
toVisual Studio 14 2015
- Change
QT_PATH
to the path of your 32-bit version of Qt
- Open
$opentoonz/toonz/build32/OpenToonz.sln
- 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
- From
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
.