Skip to content

opentoonz/GTS

Repository files navigation

What is GTS?

GTS is a scanning tool developed by Studio Ghibli.

It's specialized in hand-drawn animation frames.

Specification

GTS uses TWAIN on Windows and SANE on other operating systems, so you need scanner drivers that support these APIs in order to run it.

The interface is in English and scanned images are saved as TIFF/Targa.

Requirements

Please refer to the OpenToonz site.

Installation (Windows)

Download and unzip the most recent GTS-x.y.z.zip file.

How to Execute (Windows)

Execute "./gts" in the unzipped folder.

How to Build Locally (Windows)

  1. Environment for development

Microsoft Visual C++ 2017 (tested on a Windows 7 Enterprise SP1)

  1. Get source code

Get the source code from Github:

$ git clone https://github.com/opentoonz/GTS.git
  1. Get third party libraries
  • Unzip third party libraries on the spot.

    • GTS/thirdparty/fltk/fltk-1.3.4-2.zip
    • GTS/thirdparty/glew/glew-2.1.0.zip
    • GTS/thirdparty/libtiff/tiff-4.0.9.zip
  • How to build fltk

    • Open GTS/thirdparty/fltk/fltk-1.3.4-2/ide/VisualC2010/fltk.sln at Visual Studio 2017
    • Set to Release about Solution Configuration
    • Set to Win32 about Solution Platform
    • Set to /MD about Runtime Library
    • Execute Solution Build
  • How to build glew

    • Open GTS/thirdparty/glew/glew-2.1.0/build/vc12/glew.sln at Visual Studio 2017
    • Set to Release about Solution Configuration
    • Set to Win32 about Solution Platform
    • Set to /MD about Runtime Library
    • Execute Solution Build
  • How to build libtiff

    • vc2017(32bit) Command Prompt
$ cd GTS/thirdparty/libtiff/tiff-4.0.9/
$ nmake /f Makefile.vc lib
  1. How to build

The Windows application is compiled as 32-bit because the reference TWAIN driver used during development was only available in 32-bit. After building fltk and tiff with Visual C++, following their own instructions, go to GTS/sources/ and run the batch file one_step_build_vc2017.bat from a console.

  1. Preparation for Execute

Nothing

  1. How to Execute

In GTS/build/bin_x86/ you'll find the executable gts.exe. Run it.

How to Build Locally (Linux)

  1. Environment for development

Tested simply on a Ubuntu 16.04-desktop 64bits(on a VMware Workstation 12.5.9 Player(on a Windows 7 Enterprise SP1))

  1. Get source code

Same as Windows.

  1. Get third party libraries
$ sudo apt install autoconf libtool autoconf-archive libtiff5-dev libfltk1.3-dev libglew-dev libsane-dev libglu1-mesa-dev
  1. How to build
$ ./autogen.sh && ./configure && make

If you're a developer and you need a debug build, do it like this:

$ ./autogen.sh && CFLAGS="-O2 -ggdb -march=native" CXXFLAGS="$CFLAGS" ./configure && make -j8
# now you can use gdb:
$ gdb --args ./gts -bv
  1. Configuration file

After installing the package with "make install", copy "/usr/local/share/GTS/gts_initial_configuration.txt" to "~/.GTS/" and open it from the main menu (File -> Open Config). Change some settings, then save your configuration with File -> Save config.

It will be loaded automatically the next time you open the program.

  1. How to Execute
./gts

How to Build Locally (macOS)

  1. Environment for development

Mac OS X 10.x

  1. Get source code

Same as Windows.

  1. Get third party libraries
$ brew install automake autoconf autoconf-archive libtool pkgconfig libtiff sane-backends glew boost
$ sudo port install fltk-devel #not in homebrew
  1. How to build
$ ./autogen.sh && ./configure && make
  1. Configuration file

Same as Linux.

  1. How to Execute
./gts

License

  • Files outside of the thirdparty directory are based on the New BSD License.
  • For files in the thirdparty directory:
lib homepage license license page
fltk http://www.fltk.org/index.php GPLv2 with exceptions that allow for static linking http://www.fltk.org/index.php
libtiff http://www.simplesystems.org/libtiff/ LibTIFF Software License http://www.simplesystems.org/libtiff/misc.html
twain https://www.twain.org/ TWAIN License https://www.twain.org/twain-license/
glew http://glew.sourceforge.net/ The source code is licensed under the Modified BSD License , the Mesa 3-D License(MIT) and the Khronos License(MIT). The automatic code generation scripts are released under the GNU GPL. https://github.com/nigels-com/glew#copyright-and-licensing

Attention:Please prioritize with the licenses in the appropriate READMEs or source codes.