# libspng
**Repository Path**: chan-liang/libspng
## Basic Information
- **Project Name**: libspng
- **Description**: libspng 是一个 C 语言的开发库，用来读写 PNG 格式图片，特点是安全而且易用
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 5
- **Created**: 2021-03-20
- **Last Updated**: 2021-03-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](https://gitter.im/libspng/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://opencollective.com/libspng)
[](https://gitlab.com/randy408/libspng-ci/pipelines/latest)
[](https://oss-fuzz-build-logs.storage.googleapis.com/index.html#libspng)
[](https://scan.coverity.com/projects/randy408-libspng)
[](https://gitlab.com/randy408/libspng-ci/-/graphs/master/charts)
[](https://libspng.org/download)
# libspng
lib**spng** (**s**imple **png**) is a C library for reading and writing Portable Network Graphics (PNG)
format files with a focus on security and ease of use.
libspng is an alternative to libpng, the projects are separate and the APIs are
not compatible.
## Motivation
The goal is to provide a fast PNG library with a simpler API than [libpng](https://github.com/glennrp/libpng/blob/libpng16/png.h),
it outperforms the reference implementation in common use cases.
## Performance
## Features
| Feature | spng | libpng | stb_image | lodepng |
|--------------------------------------|---------|--------------------|-----------|---------|
| Decode from stream | ✅ | ✅ | ✅ | ❌ |
| Gamma correction | ✅ | ✅ | ❌ | ❌ |
| No known security bugs[1] | ✅ | ✅ | ❌ | ✅ |
| Progressive image read | ✅ | ✅ | ❌ | ❌ |
| Parses all standard chunks | ✅ | ✅ | ❌ | ❌ |
| Doesn't require zlib[2] | ✅ | ❌ | ✅ | ✅ |
| Encoding | Planned | ✅ | ✅ | ✅ |
| Animated PNG | Planned | ✅[3] | ❌ | ❌ |
[1] The project is fuzz tested on [OSS-Fuzz](https://github.com/google/oss-fuzz) and vulnerabilities are fixed before they become public.
[2] Building with miniz is [supported](docs/build.md#miniz).
[3] With a 3rd party patch
## Getting spng
Download the [latest release](https://libspng.org/download) and include `spng.c/spng.h` in your project,
you can also build with CMake or Meson, refer to the [documentation](docs/build.md) for details.
## Usage
```c
#include
/* Create a context */
spng_ctx *ctx = spng_ctx_new(0);
/* Set an input buffer */
spng_set_png_buffer(ctx, buf, buf_size);
/* Determine output image size */
spng_decoded_image_size(ctx, SPNG_FMT_RGBA8, &out_size);
/* Decode to 8-bit RGBA */
spng_decode_image(ctx, out, out_size, SPNG_FMT_RGBA8, 0);
/* Free context memory */
spng_ctx_free(ctx);
```
See [example.c](examples/example.c).
## License
Code is licensed under the BSD 2-clause "Simplified" License.
The project contains optimizations and test images from libpng, these are licensed under the
[PNG Reference Library License version 2](http://www.libpng.org/pub/png/src/libpng-LICENSE.txt).
## Security & Testing
Code is written according to the rules of the
[CERT C Coding Standard](https://wiki.sei.cmu.edu/confluence/display/c/SEI+CERT+C+Coding+Standard).
All integer arithmetic is checked for overflow and all error conditions are handled gracefully.
The library is continuously fuzzed by [OSS-Fuzz](https://github.com/google/oss-fuzz),
code is also scanned with Clang Static Analyzer, Coverity Scan and PVS-Studio.
The test suite consists of over 1000 test cases,
175 [test images](http://www.schaik.com/pngsuite/) are decoded with all possible
output format and flag combinations and compared against libpng for [correctness](tests/README.md#Correctness).
## Versioning
Releases follow the [semantic versioning](https://semver.org/) scheme with additional guarantees:
* Releases from 0.4.0 to 0.8.x are stable
* If 1.0.0 will introduce breaking changes then 0.8.x will be maintained as a separate stable branch
Currently 1.0.0 is planned to be [compatible](https://github.com/randy408/libspng/issues/3).
## Documentation
Online documentation is available at [libspng.org/docs](https://libspng.org/docs).
## Known Issues
* Decoding to `SPNG_FMT_G8`, `SPNG_FMT_GA8` and `SPNG_FMT_GA16` output formats is not supported
for all PNG color type and bit depth combinations, see documentation for details.
* Gamma correction is not implemented for `SPNG_FMT_PNG`, `SPNG_FMT_G8`, `SPNG_FMT_GA8`
and `SPNG_FMT_GA16` output formats.
* Non-critical errors may cause an image to not load ([#132](https://github.com/randy408/libspng/issues/132)).
## Supporting spng
You can sponsor development through [OpenCollective](https://opencollective.com/libspng/), funds will be used for maintenance and further development according to the [roadmap](https://github.com/randy408/libspng/milestones).
### OpenCollective backers
#### Individuals
#### Organizations
Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/libspng/contribute)]
