2014-05-25 17:51:23 +01:00
|
|
|
stb
|
|
|
|
===
|
|
|
|
|
2014-05-25 19:07:28 +01:00
|
|
|
single-file public domain libraries for C/C++
|
2014-05-25 18:54:36 +01:00
|
|
|
|
2014-05-25 19:58:26 +01:00
|
|
|
library | category | description
|
|
|
|
--------- | --------- | ---------
|
|
|
|
**stb_image.c** | graphics | image loading/decoding from disk/memory: JPG, PNG, TGA, BMP, PSD, GIF, HDR, PIC
|
|
|
|
**stb_vorbis.c** | audio | decode ogg vorbis files from memory to float/16-bit signed output
|
|
|
|
**stb_truetype.h** | graphics | parse, decode, and rasterize characters from truetype fonts
|
|
|
|
**stb_image_write.h** | graphics | image writing to disk
|
|
|
|
**stb_textedit.h** | UI | guts of a text editor for games etc implementing them from scratch
|
|
|
|
**stb_dxt.h** | 3D graphics | Fabian "ryg" Geisen's real-time DXT compressor
|
|
|
|
**stb_perlin.h** | 3D graphics | revised Perlin noise (3D input, 1D output)
|
|
|
|
**stb_c_lexer.h** | parsing | simplify writing parsers for C-like languages
|
|
|
|
**stb.h** | misc | helper functions for C, mostly redundant in C++; basically author's personal stuff
|
2014-05-25 19:31:31 +01:00
|
|
|
|
|
|
|
FAQ
|
|
|
|
---
|
|
|
|
|
|
|
|
#### What's the license?
|
|
|
|
|
|
|
|
These libraries are in the public domain (or the equivalent where that is not
|
|
|
|
possible). You can do anything you want with them. You have no legal obligation
|
|
|
|
to do anything else, although I appreciate attribution.
|
|
|
|
|
|
|
|
#### If I wrap an stb library in a new library, does the new library have to be public domain?
|
|
|
|
|
|
|
|
No.
|
|
|
|
|
|
|
|
#### A lot of these libraries seem redundant to existing open source libraries. Are they better somehow?
|
|
|
|
|
|
|
|
Generally they're only better in that they're easier to integrate,
|
|
|
|
easier to use, and easier to release (single file; good API; no
|
|
|
|
attribution requirement). They may be less featureful, slower,
|
|
|
|
and/or use more memory. If you're already using an equivalent
|
|
|
|
library, there's probably no good reason to switch.
|
|
|
|
|
|
|
|
#### Will you add more image types to stb_image.c?
|
|
|
|
|
|
|
|
If people submit them, I generally add them, but the goal of stb_image
|
|
|
|
is less for applications like image viewer apps (which need to support
|
|
|
|
every type of image under the sun) and more for things like games which
|
2014-05-25 19:32:53 +01:00
|
|
|
can choose what images to use, so I may decline to add them if they're
|
|
|
|
too rare or if the size of implementation vs. apparent benefit is too low.
|
2014-05-25 19:31:31 +01:00
|
|
|
|
|
|
|
#### Are there other single-file public-domain libraries out there?
|
|
|
|
|
|
|
|
Yes. I'll put a list here when people remind me what they are.
|
|
|
|
|
|
|
|
|