Friction is a powerful and versatile motion graphics application that allows you to create stunning vector and raster animations for web and video platforms with ease.
We accept any contributions, big or small. Before submitting a PR it's recommended that you communicate with the developers first (in issues or discussions).
It's always preferred to submit PR's against the main
branch.
Friction uses X.Y.Z
version numbers and vX.Y
branches.
X
= MajorY
= MinorZ
= PatchBranch main
is always the current branch for the next X
or Y
release.
A new stable branch is cut from main
on each X
or Y
release and is maintained until a new stable branch is created. Patch (Z
) releases comes from the parent stable branch (vX.Y
).
Critical fixes to main
will be backported to active stable branches when possible (and within reason).
Generic build instructions.
git
must be available in PATH
cmake
must be available in PATH
python3
must be available in PATH
friction\src\qt
friction\src\qscintilla
friction\src\ffmpeg
git clone --recurse-submodules https://github.com/friction2d/friction
Or download a release tarball (friction-VERSION.tar.bz2).
mkdir build
cd build
cmake -G Ninja \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DCMAKE_CXX_COMPILER=clang++ \
-DCMAKE_C_COMPILER=clang \
..
Note that on some configurations you may need to specify qscintilla
paths:
-DQSCINTILLA_INCLUDE_DIRS=<PATH_TO_QSCINTILLA_INCLUDE_DIR> \
-DQSCINTILLA_LIBRARIES_DIRS=<PATH_TO_LIBS> \
-DQSCINTILLA_LIBRARIES=<QSCINTILLA_LIBRARY_NAME> \
Now build:
cmake --build . --config Release
All requirements must be installed in the correct folders, this is an example and should be adjusted to fit your enviroment.
call "C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\Common7\Tools\VsDevCmd.bat"
set QT_DIR=%cd%\src\qt
set PATH=C:\Python;%ProgramFiles%\CMake\bin;%ProgramFiles%\Git\bin;%QT_DIR%\bin;%PATH%
mkdir build
cd build
cmake -G "Visual Studio 15 2017" -A x64 -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=%QT_DIR% ..
cmake --build . --config Release
Copyright © Friction contributors.
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.