summaryrefslogtreecommitdiffstats
path: root/src/boost/libs/gil/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:45:59 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:45:59 +0000
commit19fcec84d8d7d21e796c7624e521b60d28ee21ed (patch)
tree42d26aa27d1e3f7c0b8bd3fd14e7d7082f5008dc /src/boost/libs/gil/README.md
parentInitial commit. (diff)
downloadceph-19fcec84d8d7d21e796c7624e521b60d28ee21ed.tar.xz
ceph-19fcec84d8d7d21e796c7624e521b60d28ee21ed.zip
Adding upstream version 16.2.11+ds.upstream/16.2.11+dsupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/boost/libs/gil/README.md')
-rw-r--r--src/boost/libs/gil/README.md115
1 files changed, 115 insertions, 0 deletions
diff --git a/src/boost/libs/gil/README.md b/src/boost/libs/gil/README.md
new file mode 100644
index 000000000..dc78e1c55
--- /dev/null
+++ b/src/boost/libs/gil/README.md
@@ -0,0 +1,115 @@
+![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-11-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 | AppVeyor | Azure Pipelines | Travis CI | CircleCI | Regression
+--------------|-----------------|-----------------|-----------------|-----------------|------------
+[![develop](https://img.shields.io/badge/doc-develop-blue.svg)](https://boostorg.github.io/gil/develop/) | [![AppVeyor](https://ci.appveyor.com/api/projects/status/w4k19d8io2af168h/branch/develop?svg=true)](https://ci.appveyor.com/project/stefanseefeld/gil/branch/develop) | [![Azure](https://dev.azure.com/boostorg/gil/_apis/build/status/boostorg.gil?branchName=develop)](https://dev.azure.com/boostorg/gil/_build/latest?definitionId=4?branchName=develop) | [![Travis](https://travis-ci.org/boostorg/gil.svg?branch=develop)](https://travis-ci.org/boostorg/gil) | [![CircleCI](https://circleci.com/gh/boostorg/gil/tree/develop.svg?style=shield)](https://circleci.com/gh/boostorg/workflows/gil/tree/develop) | [![gil](https://img.shields.io/badge/gil-develop-blue.svg)](http://www.boost.org/development/tests/develop/developer/gil.html)
+[![master](https://img.shields.io/badge/doc-master-blue.svg)](https://boostorg.github.io/gil/) | [![AppVeyor](https://ci.appveyor.com/api/projects/status/w4k19d8io2af168h?svg=true)](https://ci.appveyor.com/project/stefanseefeld/gil/branch/master) | [![Azure](https://dev.azure.com/boostorg/gil/_apis/build/status/boostorg.gil?branchName=master)](https://dev.azure.com/boostorg/gil/_build/latest?definitionId=4?branchName=master) | [![Travis](https://travis-ci.org/boostorg/gil.svg?branch=master)](https://travis-ci.org/boostorg/gil) | [![CircleCI](https://circleci.com/gh/boostorg/gil/tree/master.svg?style=shield)](https://circleci.com/gh/boostorg/workflows/gil/tree/master) | [![gil](https://img.shields.io/badge/gil-master-blue.svg)](http://www.boost.org/development/tests/master/developer/gil.html)
+
+# 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++11** 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
+
+**NOTE:** The library source code is currently being modernized for C++11.
+
+The Boost Generic Image Library (GIL) requires:
+
+- C++11 compiler (GCC 4.9, clang 3.3, MSVC++ 14.0 (1900) 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:
+
+- 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).