Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mbasaglia/glaxnimate

Simple vector animation program. https://glaxnimate.mattbas.org/
https://github.com/mbasaglia/glaxnimate

Last synced: about 2 months ago
JSON representation

Simple vector animation program. https://glaxnimate.mattbas.org/

Awesome Lists containing this project

README 

        
Glaxnimate

=======================================



About

---------------------------------------



A simple vector graphics animation program.



Dependencies

---------------------------------------



* C++17 compliant compiler

* Qt5 >= 5.12

* CMake >= 3.5

* Python3

* ZLib

* Potrace

* libav (libavformat, libswscale, libavcodec, libavutil) >= 59

* libarchive



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 zlib1g-dev libpotrace-dev \

    libarchive-dev libavformat-dev libswscale-dev libavcodec-dev libavutil-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" when asked, and run these commands on a it:



    # Set up dependencies

    pacman --noconfirm -Sy

    pacman --noconfirm -Su

    # Restart msys2 before continuing

    pacman --noconfirm -S \

        git zip base-devel \

        unzip               \

        mingw-w64-x86_64-qt5 \

        mingw-w64-x86_64-zlib \

        mingw-w64-x86_64-cmake \

        mingw-w64-x86_64-python \

        mingw-w64-x86_64-potrace \

        mingw-w64-x86_64-ffmpeg   \

        mingw-w64-x86_64-toolchain \

        mingw-w64-x86_64-python-pip \

        mingw-w64-x86_64-libarchive  \

        mingw-w64-x86_64-libimagequant



    # Build

    # cd to where the code is

    mkdir build

    cd build

    cmake.exe .. \

        -DQt5_DIR=/mingw64/lib/cmake/Qt5 \

        -DZLIB_LIBRARY=/mingw64/lib/libz.a \

        -DCMAKE_PREFIX_PATH="/mingw64/lib/" \

        -DZLIB_INCLUDE_DIR=/mingw64/include \

        -G "MSYS Makefiles"

    make



    # Copy library files because windows is weird like that

    windeployqt.exe bin/glaxnimate.exe

    cp /mingw64/bin/*.dll bin

    cp ./external/Qt-Color-Widgets/libQtColorWidgets.dll bin



To simplify the build process, you can also 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 .



Download the Qt Installer for the open source edition 

.



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:

.



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.



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 .