libavifinfo is a standalone library that can be used to extract the width, height, bit depth, number of channels and other metadata from an AVIF payload.
See avifinfo.h
for details on the API and avifinfo.c
for the implementation. See tests/avifinfo_demo.cc
for API usage examples.
libavifinfo can be used when only a few AVIF features are needed and when linking to or including libavif is not an option. For decoding an image or extracting more features, please rely on libavif.
Note: The C implementation AvifInfoGetFeatures()
is designed to return the same avifImage
field values as avifDecoderParse()
. However libavifinfo is often more permissive and may return features of images considered invalid by libavif.
Google C/C++ Style Guide is used in this project.
avifinfo.c
is written in C. To build from this directory:
cmake -S . -B build && \ cmake --build build --config Release
GoogleTest is required for the C++ tests (e.g. sudo apt install libgtest-dev
).
cmake -S . -B build -DAVIFINFO_BUILD_TESTS=ON && \ cmake --build build --config Debug && \ ctest --test-dir build build
The PHP implementation of libavifinfo is a subset of the C API.
libavifinfo
was implemented into php-src natively and is available through getimagesize()
at head. If it is not available in the PHP release version you use, you can fallback to avifinfo.php
instead.
See avifinfo_test.php
for a usage example.
cd tests && \ php avifinfo_test.php
If you would like to contribute to libavifinfo, please follow the steps for libaom at https://aomedia.googlesource.com/aom/#submitting-patches. Summary:
cd libavifinfo && curl -Lo .git/hooks/commit-msg https://chromium-review.googlesource.com/tools/hooks/commit-msg && chmod u+x .git/hooks/commit-msg
git push https://aomedia.googlesource.com/libavifinfo/ HEAD:refs/for/main
Bug reports can be filed in the Alliance for Open Media issue tracker.