This library provides a cross-platform foundation library in C providing basic support data types and functions to write applications and games in a platform-independent fashion. It provides:
- Abstractions and unification of basic data types
- Pluggable memory management
- Threads and synchronization
- Atomic operations
- Timing and profiling
- Object lifetime management
- Events processing
- File system access
- Dynamic library loading
- Process spawning
- Logging, error reporting and asserts
- String handling in UTF-8 and UTF-16
- Murmur hasing and statically hashed strings
- Math support for 32 and 64 bit floats
- Configuration repository with config file I/O
- Application, environment and system queries and control
- Regular expressions
- Crash utilities (SEH, signals)
It is written with the following API design principles in mind:
- Consistent. All functions, parameters and types should follow a well defined pattern in order to make it easy to remember how function names are constructed and how to pass the expected parameters.
- Orthogonal. A function should not have any side effects, and there should be only one way to perform an operation in the system.
- Specialized. A function in an API should perform a single task. Functions should not do completely different unrelated tasks or change behaviour depending on the contents of the variables passed in.
- Compact. The API needs to be compact, meaning the user can use it without using a manual. Note though that "compact" does not mean "small". A consistent naming scheme makes the API easier to use and remember.
- Contained. Third party dependencies are kept to an absolute minimum and prefer to use primitive or well-defined data types.
Platforms and architectures currently supported:
- Windows (x86, x86-64), Vista or later
- MacOS X (x86-64), 10.7+
- Linux (x86, x86-64, PPC, ARM)
- FreeBSD (x86, x86-64, PPC, ARM)
- iOS (ARM7, ARM7s, ARM64), 6.0+
- Android (ARM6, ARM7, ARM8-AARCH64, x86, x86-64, MIPS, MIPS64)
- Raspberry Pi (ARM6)
- PNaCl
The latest source code maintained by Rampant Pixels is always available at
https://github.com/rampantpixels/foundation_lib
Pre-generated documentation in HTML format for the latest release can be found at
http://rampantpixels.github.io/foundation_lib/doc
Master branch is used for stable releases. Development is done in feature branches from the develop branch
https://github.com/rampantpixels/foundation_lib/tree/develop
Cross-platform build system uses Ninja
http://martine.github.io/ninja
The PNaCl build of the latest release can be tested at
http://www.rampantpixels.com/foundation_lib/pnacl/
Test suite coverage report:
This library is put in the public domain; you can redistribute it and/or modify it without any restrictions.