first commit

.gitattributes

@@ -0,0 +1 @@
+*.lib filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,26 @@
+Debug
+Debug64
+Release
+Release64
+GeneratedFiles
+.vs
+*.opensdf
+*.sdf
+*.suo
+*.user
+build*
+Thumbs.db
+
+.clang_complete
+Debug/
+Debug Library/
+Release/
+Release Library/
+ipch/
+.idea
+
+# qtcreator files
+*.config
+*.creator
+*.files
+*.includes

LICENSE.txt

@@ -0,0 +1,32 @@
+Some of code in this repository is derived from thirdparty libraries.
+For files in the "thirdparty" directory: Please consult with the licenses in the appropriate READMEs or source codes.
+
+- - - - - - - - - - - - - - - -
+
+IwaWarper
+
+All contributions by Shun Iwasawa:
+Copyright (c) 2014 - 2022, Shun Iwasawa
+All rights reserved.
+
+All other contributions:
+Copyright (c) 2022, the respective contributors.
+All rights reserved.
+
+Each contributor holds copyright over their respective contributions.
+The project versioning (Git) records all such contribution source information.
+
+
+LICENSE
+
+BSD 3-Clause "New" or "Revised" License
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,32 @@
+# IwaWarper
+
+[日本語](./doc/README_ja.md)
+
+## What is IwaWarper?
+
+IwaWarper is a 2D warping software. It deforms input images according to specified pairs of Bezier curve shapes.
+
+## Program Requirements
+
+Please refer to the OpenToonz site at <https://opentoonz.github.io/e/index.html>.
+
+## Installation
+
+Please download a zipped binary of IwaWarper from <https://opentoonz.github.io/e/index.html>.
+
+## How to Build Locally
+
+- [Windows](./doc/how_to_build_win.md)
+
+
+## Community
+
+- If you found a bug with the software after troubleshooting, or are a developer, search the [Github issues](https://github.com/opentoonz/iwawarper/issues) and post there.
+
+## Licensing
+
+- Files outside of the `thirdparty` 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.

doc/README_ja.md

@@ -0,0 +1,38 @@
+# OpenToonz
+
+[English](../README.md)
+
+[![](https://ci.appveyor.com/api/projects/status/oa5l5pc964h8fv49/branch/master?svg=true)](https://ci.appveyor.com/project/opentoonz/opentoonz)
+[![](https://travis-ci.org/opentoonz/opentoonz.svg?branch=master)](https://travis-ci.org/opentoonz/opentoonz)
+[![](https://github.com/opentoonz/opentoonz/workflows/Build/badge.svg?branch=master)](https://github.com/opentoonz/opentoonz/actions)
+
+## これは何？
+
+2D アニメーション制作ソフトウェアです。
+イタリアの Digital Video 社が開発し、株式会社スタジオジブリのカスタマイズを経て、ジブリ作品の制作に長年使われてきたソフトウェア `Toonz` が基になっています。
+
+## 動作条件
+
+<https://opentoonz.github.io/> を参照してください。
+
+## インストール
+
+<https://opentoonz.github.io/> から最新安定版のインストーラーをダウンロードしてインストールしてください。
+
+過去のバージョンと不安定な最新版も <https://github.com/opentoonz/opentoonz/releases> から利用することができます。
+
+## ビルド方法
+
+- [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

doc/conf.ini

@@ -0,0 +1,2 @@
+[General]
+IWSTUFFROOT=..\\..\\stuff

doc/how_to_build_win.md

@@ -0,0 +1,77 @@
+
+# Building on Windows
+
+This software can be built using Visual Studio 2019 and Qt 5.15
+
+## Required Software
+
+### Visual Studio Community 2019
+- https://visualstudio.microsoft.com/ja/vs/older-downloads/
+- During the installation, make sure to select all the Visual C++ packages.
+
+### CMake
+- https://cmake.org/download/
+- This will be used to create the `MSVC 2019` project file.
+
+### Qt
+- https://www.qt.io/download-open-source/
+- Qt is a cross-platform GUI framework.
+- Install Qt 5.15.2 64-bit version with the [Qt Online Installer for Windows](http://download.qt.io/official_releases/online_installers/qt-unified-windows-x86-online.exe).
+
+#### Customized Qt v5.15.2 with WinTab support
+- The customized Qt5.15.2 are made with cherry-picking the WinTab feature to be officially introduced from 6.0.
+- You can build OT with WinTab support by using the prebuilt package of the customized version of Qt for MSVC2019-x64 provided [here](https://github.com/shun-iwasawa/qt5/releases/tag/v5.15.2_wintab).
+
+## Acquiring the Source Code
+- Note: You can also perform these next commands with Github for Desktop client.
+- Clone the base repository.
+- Throughout the explanation `$iwawarper` 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`
+
+### lib and dll
+- `lib` and `dll` files are tracked by [Git Large File Storage](https://git-lfs.github.com/).
+- Note: git-lfs is also installed with Github Desktop.
+- Execute `git lfs pull` after `git clone` by using the lfs client.
+
+### Using CMake to Create a Visual Studio Project
+- Launch CMake
+- In `Where is the source code`, navigate to `$iwawarper/sources`
+- In `Where to build the binaries`, navigate to `$iwawarper/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 the version of Visual Studio you are using.
+- If Qt was installed to a directory other than the default, and the error Specify QTDIR properly appears, navigate to the `QTDIR` install folder and specify the path to `msvc2019_64`. Rerun Configure.
+- If red lines appear in the bottom box, you can safely ignore them.
+- Click Generate
+- Should the CMakeLists.txt file change, such as during automatic build cleanup, there is no need to rerun CMake.
+
+## Building
+- Open `$iwawarper/build/IwaWarper.sln` and change to `Debug` or `Release` in the top bar.
+- Compile the build.
+- The output will be in the corresponding folder in `$iwawarper/build/`
+
+## Running the Program
+### Setting Up the Program's Path
+1. Copy the entire contents of `$iwawarper/build/Release` to an appropriate folder.
+
+2. Copy all files under `$iwawarper/thirdparty/OpenToonz/bin` to the same folder as `IwaWarper.exe`
+
+3. Open a Command Prompt and navigate to `QTDIR/msvc2015_64/bin`. Run the Qt program `windeployqt.exe` with the path for `IwaWarper.exe`, `image.dll` and `toonzlib.dll` as an argument. (Another way to do this is navigate to the exe that was created in your Release folder and drag and drop the IwaWarper.exe + dlls and on top of the windeployqt.exe This will automatically generate the QT files and folders you will need.)
+ - The necessary Qt library files should be in the same folder as `IwaWarper.exe`
+
+3. Copy the following files to the same folder as `IwaWarper.exe`
+  - `$opentoonz/thirdparty/glut/3.7.6/lib/glut64.dll`
+  - `$opentoonz/thirdparty/libmypaint/dist/64/*.dll` (4 files)
+
+### Prepare conf.ini (stuff folder location setting)
+
+- Copy `$iwawarper/doc/conf.ini` to the same folder as `IwaWarper.exe`. The file specifies relative path to the stuff folder (the stuff folder is located at `$iwawarper/stuff` by deafault) . If `IwaWarper.exe` is not located in `$iwawarper/build/Release` or you would like to move the location of the stuff folder, change the value of `IWSTUFFROOT` in `conf.ini` to appropriate relative path.
+
+### Running
+`IwaWarper.exe` can now be run.  Congratulations!
+
+## 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`.

doc/how_to_build_win_ja.md

@@ -0,0 +1,71 @@
+# ビルド手順（Windows）
+
+Visual Studio 2019 と Qt 5.15 でビルドできることを確認しています。
+
+## 必要なソフトウェアの導入
+
+### Visual Studio Community 2019
+- https://visualstudio.microsoft.com/ja/vs/older-downloads/
+- C++ によるデスクトップ開発の環境をインストールします。
+
+### CMake
+- https://cmake.org/download/
+- Visual Studio 用のプロジェクトファイルの生成に使用します
+
+### Qt
+- https://www.qt.io/download-open-source/
+- クロスプラットフォームの GUI フレームワークです
+- 上記の URL から以下のファイルをダウンロードして Qt 5.15 (64 ビット版) を適当なフォルダにインストールします
+  - [Qt Online Installer for Windows](http://download.qt.io/official_releases/online_installers/qt-unified-windows-x86-online.exe)
+
+#### WinTabサポート付きカスタマイズ版 Qt5.15.2
+- Qtは5.12以降Windows Ink APIをネイティブで使用しています。5.9まで使用されていたWinTab APIとはタブレットの挙動が異なり、それによる不具合が報告されています。
+- そこで、公式には6.0から導入されるWinTab APIへの切り替え機能をcherry-pickしたカスタマイズ版の5.15.2を頒布しています。
+- MSVC2019-x64向けのビルド済みパッケージは [こちら](https://github.com/shun-iwasawa/qt5/releases/tag/v5.15.2_wintab) から入手できます。
+
+## ソースコードの取得
+- 本リポジトリを `git clone` します
+- 以下の説明中の `$iwawarper` は、本リポジトリの root を表します
+- Visual Studio は BOM の無い UTF-8 のソースコードを正しく認識できず、改行コードが LF で、1行コメントの末尾が日本語の場合に、改行が無視されて次の行もコメントとして扱われる問題があるため、Git に下記の設定をして改行コードを CRLF に変換すると良いでしょう
+  - `git config core.safecrlf true`
+
+### `lib` と `dll`
+- `lib` と `dll` ファイルは [Git Large File Storage](https://git-lfs.github.com/) で管理しています。
+- `lfs` のクライアントを導入して、上記 `git clone` のあとに `git lfs pull` を実行してください。
+
+## ビルド
+
+### CMake で Visual Studio のプロジェクトを生成する
+1. CMake を立ち上げる
+2. Where is the source code に `$iwawarper/sources` を指定する
+3. Where to build the binaries に `$iwawarper/build` を指定する
+  - 他の場所でも構いません
+  - チェックアウトしたフォルダ内に作成する場合は、buildから開始するフォルダ名にするとgitから無視されます
+  - ビルド先を変更した場合は、以下の説明を適宜読み替えてください
+4. Configure をクリックして、 Visual Studio 16 2019 Win64 を選択します
+5. Qt のインストール先がデフォルトではない場合、 `Specify QTDIR properly` というエラーが表示されるので、 `QTDIR` に Qt5 をインストールしたパスを指定します
+6. Generate をクリック
+  - CMakeLists.txt に変更があった場合は、ビルド時に自動的に処理が走るので、以降は CMake を直接使用する必要はありません
+
+## ビルド
+1. `$iwawarper/build/OpenToonz.sln` を開いて Release 構成を選択してビルドします
+2. `$iwawarper/build/Release` にファイルが生成されます
+
+## 実行
+### 実行可能ファイルなどの配置
+1. `$iwawarper/build/Release` の中身を適当なフォルダにコピーします
+2. `IwaWarper.exe` と同じフォルダに`$iwawarper/thirdparty/OpenToonz/bin`の中身をすべてコピーします
+3. `IwaWarper.exe`、`image.dll`、 `toonzlib.dll` のパスを引数にして Qt に付属の `windeployqt.exe` をそれぞれ実行します
+  - 必要な Qt のライブラリなどが `IwaWarper.exe` と同じフォルダに集められます
+3. 下記のファイルを `IwaWarper.exe` と同じフォルダにコピーします
+  - `$iwawarper/thirdparty/glut/3.7.6/lib/glut64.dll`
+  - `$iwawarper/thirdparty/libmypaint/dist/64/*.dll` (4 ファイル)
+
+### conf.ini (Stuffフォルダの場所の設定)
+- `IwaWarper.exe`と同じフォルダに`$iwawarper/doc/conf.ini`をコピーします。このファイルはStuffフォルダまでの相対パスを指定するものです（Stuffフォルダはデフォルトでは`$iwawarper/stuff`にあります）。`IwaWarper.exe`の場所を`$iwawarper/build/Release`以外に移動したり、Stuffフォルダの場所を移動したりした場合は、`conf.ini`の中の`IWSTUFFROOT`の値を変更してください。
+
+### 実行
+IwaWarper.exe を実行して動作すれば成功です。おめでとうございます。
+
+## 翻訳ファイルの生成
+Qt の翻訳ファイルは、ソースコードから `.ts` ファイルを生成して、 `.ts` ファイルに対して翻訳作業を行い、 `.ts` ファイルから `.qm` ファイルを生成します。Visual Studioソリューション中の`translation_`から始まるプロジェクトに対して「 `translation_???` のみをビルド」を実行すると、 `.ts` ファイルと `.qm` ファイルの生成が行われます。これらのプロジェクトはソリューションのビルドではビルドされないようになっています。

sources/.clang-format

@@ -0,0 +1,14 @@
+BasedOnStyle: Google
+Standard: C++11
+UseTab: Never
+AccessModifierOffset: -2
+AlignAfterOpenBracket: true
+AlignConsecutiveAssignments: true
+AlignEscapedNewlinesLeft: false
+AlignTrailingComments: true
+IndentCaseLabels: false
+BreakConstructorInitializersBeforeComma: true
+PointerAlignment: Left
+SortIncludes: false
+
+