Warning, /graphics/glaxnimate/README.md is written in an unsupported language. File is not indexed.

 Glaxnimate
 =======================================
 
 About
 ---------------------------------------
 
 A simple vector graphics animation program.
 
 
 Dependencies
 ---------------------------------------
 
 * C++17 compliant compiler
 * Qt5 >= 5.12
 * CMake >= 3.5
 * Python3
 * Potrace
 * libav (libavformat, libswscale, libavcodec, libavutil) >= 59
 * libarchive
 * KF5 or KF6
 
 
 Getting the Latest Code
 ---------------------------------------
 
 You can find the code on [GitLab](https://gitlab.com/mattbas/glaxnimate).
 
 To clone with git:
 
     git clone --recursive https://gitlab.com/mattbas/glaxnimate.git
 
 
 Building
 ---------------------------------------
 
 ### Generic Overview
 
 If you are building from git, ensure your submodules are up to date
 
     git submodule update --init --recursive
 
 Standard CMake build commands work
 
     mkdir build
     cd build
     cmake ..
     make -j 4 # This uses 4 cores to compile
 
 It will produce the executable `bin/glaxnimate` relative to the build directory
 
 
 ### Deb-based systems (Ubuntu, Debian, etc)
 
 Install the dependencies:
 
     apt-get install -y g++ cmake qtbase5-dev qttools5-dev libqt5svg5-dev \
     qt5-image-formats-plugins libpython3-dev libpotrace-dev \
     libarchive-dev libavformat-dev libswscale-dev libavcodec-dev libavutil-dev \
     libkf5coreaddons-dev libkf5crash-dev libkf5widgetsaddons-dev libkf5xmlgui-dev \
     libkf5archive-dev libkf5completion-dev
 
 The generic `cmake` commands listed above should work.
 
 
 ### Arch-based systems
 
 Install the dependencies:
 
     pacman -S git base-devel cmake python zlib hicolor-icon-theme \
     potrace ffmpeg qt5-base qt5-tools qt5-imageformats qt5-svg
 
 The generic `cmake` commands listed above should work.
 
 
 ### MacOS
 
 Install the dependencies with homebrew:
 
     brew install cmake qt python potrace ffmpeg libarchive
 
 Build with `cmake`, specifying the Qt installation path:
 
     mkdir build
     cd build
     cmake .. -DQt5_DIR="$(brew --prefix qt@5)/lib/cmake/Qt5" -DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)/lib/cmake/Qt5Designer"
     make
 
 To simplify the build process, you can also use the provided scripts:
 
     ./deploy/mac_build.sh deps
     ./deploy/mac_build.sh configure
     ./deploy/mac_build.sh build
 
 
 ### Windows
 
 Install [MSYS2](https://www.msys2.org/), select "Mingw-w64 64 bit".
 
 To simplify the build process, you can use the provided scripts:
 
     ./deploy/win_build.sh deps
     ./deploy/win_build.sh configure
     ./deploy/win_build.sh build
     
 
 ### Android
 
 Note that these instructions have been tested on an Ubuntu host, on different
 systems things might vary.
 
 #### Setting up Java
 
 Ensure you have the JVM and JDK installed on your system.
 
     sudo apt install default-jdk
 
 #### Installing Qt
 
 See also <https://doc.qt.io/qt-5/android-getting-started.html>.
 
 Download the Qt Installer for the open source edition 
 <https://www.qt.io/download-open-source>.
 
 For some reason Qt wants you to have an account even if you install 
 the open source version so you might have to set that up;
 
 Install Qt Creator and Qt 5 Android. 
 Qt versions in the 5.12.* line should work, some newer Qt versions have issues with the
 android build tools so it's better to stick with 5.12.
 
 Select "Custom Installation", then on the following page check
 Qt > Qt 5.12.11 (or whatever version you prefer) > Android.
 You can also install additional components such as Qt for Desktop and such.
 
 Accept the licenses and proceed to install.
 
 #### Setting up Qt for Android
 
 Once Qt is installed, you can download and install the Android development tools
 from Qt Creator.
 
 You can follow the instructions from here:
 <https://doc.qt.io/qtcreator/creator-developing-android.html#specifying-android-device-settings>.
 
 From Qt Creator:
 
 * Tools > Options... > Devices > Android
 * Click "Setup SDK"
 * Install additional packages if prompted (you might need to accept some licenses)
 * Wait for everything to be downloaded and installed
 * Under "SDK Manager" (which is at the bottom of the dialog) 
     * click the "Install" checkbox for one of the available images
         (eg: Android 11 > Google API Atom x86 System Image)
     * click "Apply" on the side (not the one at the bottom that closes the dialog)
     * after it's downloaded, you can click OK to close the dialog
 
 #### Building
 
 You need to know the paths for Qt and Android stuff, or use `cmake_helper.py` to simplify the process
 
     mkdir build
     cd build
 
     ../src/android/tools/cmake_helper.py --abi x86 --qt 5.12.11 ..
     make -j8
 
 #### Running
 
 There are some utility `make` targets to run the apk
 
     # List available virtual devices (you need to create them separately)
     make android_avd_list
     # Start virtual device ("device" is from `make android_avd_list`)
     make android_avd_start DEVICE="device"
 
     # Build the APK
     make glaxnimate_apk -j8
     # Install and run the APK on the running AVD
     make android_install
     # Attach to the output
     make android_log
 
 Once you have an AVD running (or a debug phone connected) you can run a single line:
 
     make glaxnimate_apk -j8 && make android_install && make android_log
 
 #### Troubleshooting
 
 **Could not determine java version**
 
 Qt downloads an old version of `gradle`, so if you get an error that your
 Java version cannot be recognize find the file `gradle-wrapper.properties`
 and update it to version 5.1 or later.
 
 **Incompatible target / Undefined reference / Redefinition**
 
 Sometimes `qmake` messes up the build, the best option is to remove the build
 directory created by Qt Creator and rebuild.
 
 **Invalid MinSdkVersion**
 
 Depending on which version of the Android SDK you have, you might have to select 
 a different value in `src/android/android/AndroidManifest.xml`.
 
 
 **libc++.so not found**
 
 The Android toolkit stuff has some wrong paths, it can be fixed like this:
 
     sudo mkdir /opt/android 
     sudo ln -s $HOME/Android/Sdk/ndk/21.1.6352462/ /opt/android/android-ndk-r19c
     
 Where `$HOME/Android/Sdk/ndk/21.1.6352462/` is the directory that Qt creator 
 used to install the Android NDK, and `/opt/android/android-ndk-r19c` is the 
 directory mentioned in the error message.
 
 **Cannot set up Android, not building an APK / Application binary is not in output directory**
 
 Sometimes it does that, building again usually fixes it.
 
 
 ### Installation / Packaging
 
 Assuming you configured / compiled for your target system, to install
 to a specific directory, run the following commands:
 
 ```bash
 # Ensure the translations files are compiled
 make translations
 # Install under /installation/path
 make install DESTDIR=/installation/path
 ```
 
 If you want to just install on your system, you don't need to specify `DESTDIR`.
 
 
 Contacts
 ---------------------------------------
 
 * [Telegram (Chat)](https://t.me/Glaxnimate)
 * [GitLab (Code, Issues)](https://gitlab.com/mattbas/glaxnimate)
 * [User Manual](https://glaxnimate.mattbas.org)
 
 
 License
 ---------------------------------------
 
 GPLv3 or later, see COPYING.
 
 Copyright (C) 2020 Mattia Basaglia
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.