TBO is an easy and fun program to draw comic and make your
presentations funnier.

Building
--------

TBO now uses Meson as its build system and GTK4 as its UI toolkit.

Required tools and libraries:

 * meson
 * ninja
 * pkg-config
 * gtk4
 * cairo
 * librsvg-2.0
 * gettext

Build it from a fresh checkout with:

    meson setup build
    meson compile -C build

Run the application with:

    ./build/tbo

Open the bundled sample comic with:

    ./build/tbo data/tut.tbo

Install it locally with:

    meson install -C build

Run the smoke-test suite with:

    meson test -C build --no-rebuild --print-errorlogs --num-processes 1

Translations
------------

Translations are stored in `po/` and built automatically by Meson when gettext
tools are available.

Packaging
---------

The repository includes packaging metadata for:

 * Arch Linux: `archlinux/PKGBUILD`
 * Debian-based systems: `debian/`

These files are intended to install the desktop file, icons and locale data in
their standard system locations.

Using TBO
---------

When you run TBO you are in "page view", and here you can:

 * Create a new comic
 * Open an existing .tbo file
 * Save the current comic in a .tbo file
 * Export the current comic as png, pdf or svg
 ---------------------------------------------------------
 * Create a new page
 * Move between pages
 * Delete current page
 * Select/move/resize current page frames with select tool
 * You can remove a frame selecting it and pressing "del" key
 * You can clone a frame pressing ctrl+d
 * Create new page frames

When you have a frame you can go to "frame view" by selecting it and
double clicking it or pressing Enter.
In frame view you can draw:

 * You can add some doodle with doodle-tool, selecting what you want
   from tool-area and drag&drop it into drawing area.
 * You can add some bubbles with bubble-tool, selecting what you want
   from tool-area and drag&drop it into drawing area.
 * You can add text to doodle with text-tool
 * You can select/Move/resize/rotate objects in frame with select-tool
 * You can resize an object using "<" and ">" keys.
 * With arrows keys you can move the selected object
 * To flip the current object use "v" key and "h" key
 * You can remove a frame object selecting it and pressing "del" key
 * You can clone an object pressing "ctrl+d"
 * To return to "page view" press "esc" key

You can control the zoom with "+" and "-" keys or with zoom tools. You
can set the 1:1 zoom with "1" key or fit to window with "2" key.

.tbo files
----------

A .tbo file is a simple xml with the state of a TBO comic. You can
create .tbo files to save you unfinished projects or to save projects
in a modifiable format.

A .tbo file looks like that:


    <tbo width="800" height="450">
     <page>
      <frame x="63" y="37" width="237" height="202" border="1" r="1,000000" g="1,000000" b="1,000000">
       <svgimage x="99" y="42" width="114" height="197" angle="0,000000" flipv="0" fliph="0" path="bar/body/left-hand.svg">
        </svgimage>
       <text x="16" y="22" width="100" height="46" angle="-0,410127" flipv="0" fliph="0" font="Sans 12" r="0,000000" g="0,000000" b="0,000000">
    Text
       </text>
      </frame>
     </page>
    </tbo>

This repository is self-contained and intended to be cloned, built and run directly with Meson.