Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/boostorg/gil

Boost.GIL - Generic Image Library | Requires C++14 since Boost 1.80
https://github.com/boostorg/gil

boost cplusplus cplusplus-11 generic-image-library gil image image-processing image-processing-library raster raster-processing

Last synced: about 17 hours ago
JSON representation

Boost.GIL - Generic Image Library | Requires C++14 since Boost 1.80

Host: GitHub
URL: https://github.com/boostorg/gil
Owner: boostorg
License: bsl-1.0
Created: 2013-01-13T15:59:22.000Z (almost 12 years ago)
Default Branch: develop
Last Pushed: 2024-12-11T23:42:09.000Z (11 days ago)
Last Synced: 2024-12-14T20:03:42.136Z (8 days ago)
Topics: boost, cplusplus, cplusplus-11, generic-image-library, gil, image, image-processing, image-processing-library, raster, raster-processing
Language: C++
Homepage: https://boostorg.github.io/gil
Size: 75.3 MB
Stars: 178
Watchers: 18
Forks: 165
Open Issues: 101
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt

Awesome Lists containing this project

README

        ![Boost Generic Image Library (GIL)](https://raw.githubusercontent.com/boostorg/gil/develop/doc/_static/gil.png)

[![Language](https://img.shields.io/badge/C%2B%2B-14-blue.svg)](https://en.wikipedia.org/wiki/C%2B%2B#Standardization)

[![License](https://img.shields.io/badge/license-BSL-blue.svg)](https://opensource.org/licenses/BSL-1.0)

[![Documentation](https://img.shields.io/badge/gil-documentation-blue.svg)](http://boostorg.github.com/gil/)

[![Wiki](https://img.shields.io/badge/gil-wiki-blue.svg)](https://github.com/boostorg/gil/wiki)

[![Mailing List](https://img.shields.io/badge/gil-mailing%20list-4eb899.svg)](https://lists.boost.org/mailman/listinfo.cgi/boost-gil)

[![Gitter](https://img.shields.io/badge/gil-chat%20on%20gitter-4eb899.svg)](https://gitter.im/boostorg/gil)

[![Try it online](https://img.shields.io/badge/on-wandbox-blue.svg)](https://wandbox.org/permlink/isNgnMuqWcqTqzy7)

[![Conan](https://img.shields.io/badge/on-conan-blue.svg)](https://bintray.com/bincrafters/public-conan/boost_gil%3Abincrafters)

[![Vcpkg](https://img.shields.io/badge/on-vcpkg-blue.svg)](https://github.com/Microsoft/vcpkg/tree/master/ports/boost-gil)

Documentation | GitHub Actions | AppVeyor | Regression | Codecov

--------------|----------------|----------|------------|----------

[![develop](https://img.shields.io/badge/doc-develop-blue.svg)](https://boostorg.github.io/gil/develop/) | [![GitHub Actions](https://github.com/boostorg/gil/workflows/CI/badge.svg?branch=develop)](https://github.com/boostorg/gil/actions?query=branch:develop) | [![AppVeyor](https://ci.appveyor.com/api/projects/status/w4k19d8io2af168h/branch/develop?svg=true)](https://ci.appveyor.com/project/stefanseefeld/gil/branch/develop) | [![gil](https://img.shields.io/badge/gil-develop-blue.svg)](http://www.boost.org/development/tests/develop/developer/gil.html) | [![codecov](https://codecov.io/gh/boostorg/gil/branch/develop/graphs/badge.svg)](https://app.codecov.io/gh/boostorg/gil/branch/develop)

[![master](https://img.shields.io/badge/doc-master-blue.svg)](https://boostorg.github.io/gil/) | [![GitHub Actions](https://github.com/boostorg/gil/workflows/CI/badge.svg?branch=master)](https://github.com/boostorg/gil/actions?query=branch:master) | [![AppVeyor](https://ci.appveyor.com/api/projects/status/w4k19d8io2af168h?svg=true)](https://ci.appveyor.com/project/stefanseefeld/gil/branch/master) | [![gil](https://img.shields.io/badge/gil-master-blue.svg)](http://www.boost.org/development/tests/master/developer/gil.html) | [![codecov](https://codecov.io/gh/boostorg/gil/branch/master/graphs/badge.svg)](https://app.codecov.io/gh/boostorg/gil/branch/master)

 

# Boost.GIL

- [Introduction](#introduction)

- [Documentation](#documentation)

- [Requirements](#requirements)

- [Branches](#branches)

- [Community](#community)

- [Contributing](#contributing-we-need-your-help)

- [License](#license)

## Introduction

Boost.GIL is a part of the [Boost C++ Libraries](http://github.com/boostorg).

The Boost Generic Image Library (GIL) is a **C++14** header-only library that abstracts image

representations from algorithms and allows writing code that can work on a

variety of images with performance similar to hand-writing for a specific image type.

## Documentation

- [Latest release](https://boost.org/libs/gil)

- [Branch master](http://boostorg.github.io/gil/) (latest release with minor changes)

- [Branch develop](http://boostorg.github.io/gil/develop/)

See [RELEASES.md](RELEASES.md) for release notes.

See [CONTRIBUTING.md](CONTRIBUTING.md) for instructions about how to build and

run tests and examples using Boost.Build or CMake.

See [example/README.md](example/README.md) for GIL usage examples.

See [example/b2/README.md](example/b2/README.md) for Boost.Build configuration examples.

See [example/cmake/README.md](example/cmake/README.md) for CMake configuration examples.

## Requirements

The Boost Generic Image Library (GIL) requires:

- C++14 compiler (GCC 6, clang 3.9, MSVC++ 14.1 (1910) or any later version)

- Boost header-only libraries

Optionally, in order to build and run tests and examples:

- Boost.Filesystem

- Boost.Test

- Headers and libraries of libjpeg, libpng, libtiff, libraw for the I/O extension and some of examples.

## Branches

The official repository contains the following branches:

- [**master**](https://github.com/boostorg/gil/tree/master) This

  holds the most recent snapshot with code that is known to be stable.

- [**develop**](https://github.com/boostorg/gil/tree/develop) This

  holds the most recent snapshot. It may contain unstable code.

## Community

There is number of communication channels to ask questions and discuss Boost.GIL issues:

- [GitHub Discussions](https://github.com/boostorg/gil/discussions/)

- Mailing lists ([Boost discussion policy](https://www.boost.org/more/discussion_policy.html))

    - [boost-gil](https://lists.boost.org/mailman/listinfo.cgi/boost-gil) (*recommended*) official Boost.GIL mailing list ([archive](https://lists.boost.org/boost-gil/))

    - [boost-users](https://lists.boost.org/mailman/listinfo.cgi/boost-users) for all Boost users

    - [boost](https://lists.boost.org/mailman/listinfo.cgi/boost) for all Boost developers

- Slack at [cpplang.slack.com](https://cppalliance.org/slack/) with Boost channels:

    - [\#boost-gil](https://cpplang.slack.com/archives/CSVT0STV2) (*recommended*) official Boost.GIL channel

    - [\#boost-user](https://cpplang.slack.com/messages/CEWTCFDN0/) for all Boost users

    - [\#boost](https://cpplang.slack.com/messages/C27KZLB0X/) for all Boost developers

- Gitter room [boostorg/gil](https://gitter.im/boostorg/gil) (old real-time chat space)

- You can also ask questions via GitHub issue.

## Contributing (We Need Your Help!)

If you would like to contribute to Boost.GIL, help us improve the library

and maintain high quality, there is number of ways to do it.

If you would like to test the library, contribute new feature or a bug fix,

see the [CONTRIBUTING.md](CONTRIBUTING.md) where the whole development

infrastructure and the contributing workflow is explained in details.

You may consider performing code reviews on active

[pull requests](https://github.com/boostorg/gil/pulls) or help

with solving reported issues, especially those labelled with:

- [status/need-help](https://github.com/boostorg/gil/labels/status%2Fneed-help)

- [status/need-feedback](https://github.com/boostorg/gil/labels/status%2Fneed-feedback)

- [need-minimal-example](https://github.com/boostorg/gil/labels/status%2Fneed-minimal-example)

Any feedback from users and developers, even simple questions about how things work

or why they were done a certain way, carries value and can be used to improve the library.

## License

Distributed under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).