Giter Club home page Giter Club logo

gmic-animation-tools's Introduction

G'MIC Filter Animator

This C# Windows Forms application leverages the G'MIC image processing engine to create animations from still images by iteratively applying filters with varying parameters.

Examples (Continuous Droste Effect)

Image 1 Image 2
Image 3 Image 4

Features

Filter Parameter Interpolation

  • Enables animation by interpolating between two sets of filter parameters.
  • Provides a user-friendly interface to input and adjust start and end parameters.
  • Offers flexibility in choosing the master parameter that drives the animation.
  • Supports both linear and exponential interpolation for different animation styles.
  • Allows for more complex animations by defining parameter values using mathematical expressions.
  • Provides various normalization options to control the range of parameter values during interpolation.
  • Enables direct control over parameter values instead of relying on interpolation through "Absolute Mode."

GIF Creation

  • Generates animated GIFs from the sequence of processed images.
  • Utilizes FFmpeg for GIF creation, ensuring high-quality output.
  • Optionally allows the user to create a GIF with a crossfade loop effect.

GIF Utility Tools

  • Includes tools for importing, merging, and fixing sequences of image frames.
  • Provides detailed analysis of GIF files, including frame count, duration, and frame durations.
  • Provides the ability to add a crossfade effect to a looping gif.

Parameter Management

  • Loads filter parameters from a JSON file for easy configuration.
  • Allows users to save and load custom parameter sets.
  • Provides a visual interface to easily adjust parameters.

Output Customization

  • Enables users to specify the output directory for generated frames.
  • Supports custom file naming conventions for organized output.
  • Automatic naming to prevent over-writing

Expression-Based Parameter Animation and Graphing

  • The Expressions window allows users to enter mathematical expressions to control how parameters change over time.
  • A graph in the Expressions window provides a visual preview of how the expression will affect the animation.

Other Notable Features

  • Automatic logging of each run's details for reproducability - Including parameters used and other settings
  • Additional option to log and save console output of G'MIC itself for debugging
  • Optional use of config file to customize the settings applied at application startup

Getting Started

➤ Quick Start Guide available on the Wiki Here


Prerequisites

  • Download G'MIC CLI and ensure gmic.exe is the application directory.
    1. Go to the G'MIC download page here
    2. Scroll down to G'MIC for Windows - Other interfaces
    3. Download the Zip Archive for the Command-line interface (CLI) version
    4. Extract the G'MIC zip file and place GmicAnimator.exe in there next to all the other Gmic files
  • Install FFmpeg and ensure ffmpeg.exe is in your system's PATH or the application directory.

Usage

  1. Select an input image.
  2. Choose a G'MIC filter and adjust its parameters.
  3. Set the desired number of frames and master parameter increment.
  4. Click "Start" to generate the animation.
  5. Optionally, create a GIF from the generated frames.

Tip / Recommendation: Use in Combination with G'MIC GUI

  • G'MIC has a standalone GUI version which can also be found on the download page, right above the CLI version download
  • You can use the G'MIC GUI version to preview the effect settings you want to use for the starting and ending parameters, then copy them right over to the animator
  • Note you'll still need to download the CLI version, this is in addition to that

Screenshots

Main Window & Parameter Editing Window

Main Window Parameter Window

Mathematical Expressions Window

Expressions Window

GIF Tools Window

Gif Tools Window

gmic-animation-tools's People

Contributors

thiojoe avatar

Stargazers

Ivan Oonincx avatar Vihaan Pundir avatar  avatar Ümit Solmaz avatar Yeah Jack avatar Dominik Wajda avatar Atticus Cornett avatar  avatar Daniel (aka. rotgruengelb) avatar Media Explorer avatar Shehab Ali Tweel avatar Mustafa Dursun. avatar Ahmed Walid avatar

Watchers

 avatar

Forkers

jessycakeboy

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.