Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 2.39 KB

README.md

File metadata and controls

68 lines (45 loc) · 2.39 KB

gimp-file-qoi

A small plug-in for GIMP that adds support for the Quite OK Image format (QOI).

Building

This project uses scripts for building rather than make to not have deal with the complexity of writing makefiles. Inside the folder named scripts, there is a single script file for each platform that building is done for. Run that script twice: once passing "build" as the first argument, once passing "install" as the first argument. After that, everything should be built and installed for you.

As GIMP provides two ways for plug-ins to be installed (system-wide or per user), the build script has to make a choise. This project chooses to install system-wide.

Dependencies

This project requires glib 2.0, gtk+ 2.0, gimp 2.0 and gimpui 2.0 to build.

Example

To build on linux you would position yourself at the root of the project in a terminal and run the following two commands:

./scripts/linux_build.sh build
./scripts/linux_build.sh install

The plug-in should now be installed for the entire system and be ready to use in GIMP.

Used documentation

This is a list of the documentation used for this project, in case anyone wants to work more on this plug-in or try and write one on their own.

  • QOI - The Quite OK Image Format

    The original specification of QOI. The website links to a complete spec, a reference en-/decoder, and test images.

  • GIMP Reference Manuals

  • GIMP Developer Resources

    This website was discovered after the plug-in was written and therefor was not used. It would have been a usefull resource for developing though and perhaps it will help other people if they want to write their own plug-ins for GIMP.

  • Gtk 3.0

  • Glib 2.0

  • GEGL

    Finding proper documentation was difficult and therefore source code comments (those intended to be used for generating the documentation) were used instead.

  • babl

  • Hacking: How to write a GIMP plug-in

    This was used to get a general idea of how GIMP plug-ins work.

License

This is free and unencumbered software released into the public domain.

For more information, please refer to https://unlicense.org