bitmap font for 3D rendering
Usage
Make sure to add an appropriate section, like alpha
or stable
, of the cppget.org
repository to your project's repositories.manifest
to be able to fetch required packages.
:
role: prerequisite
location: https://pkg.cppget.org/1/stable
# trust: ...
If cppget.org
is not an option then add this Git repository itself instead as a prerequisite.
:
role: prerequisite
location: https://github.com/build2-packaging/stb.git
Add the respective dependency in your project's manifest
file to make the required packages available for import.
depends: stb_c_lexer ^0.12.0
depends: stb_connected_components ^0.96.0
depends: stb_divide ^0.94.0
depends: stb_ds ^0.67.0
depends: stb_dxt ^1.12.0
depends: stb_easy_font ^1.1.0
depends: stb_herringbone_wang_tile ^0.7.0
depends: stb_hexwave ^0.5.0
depends: stb_image ^2.28.0
depends: stb_image_resize ^0.97.0
depends: stb_image_write ^1.16.0
depends: stb_include ^0.2.0
depends: stb_leakcheck ^0.6.0
depends: stb_perlin ^0.5.0
depends: stb_rect_pack ^1.1.0
depends: stb_sprintf ^1.10.0
depends: stb_textedit ^1.14.0
depends: stb_tilemap_editor ^0.42.0
depends: stb_truetype ^1.26.0
depends: stb_vorbis ^1.22.0
depends: stb_voxel_render ^0.89.0
Libraries can then simply be imported by the following declarations in a buildfile
.
import stb_c_lexer = stb_c_lexer%lib{stb_c_lexer}
import stb_connected_components = stb_connected_components%lib{stb_connected_components}
import stb_divide = stb_divide%lib{stb_divide}
import stb_ds = stb_ds%lib{stb_ds}
import stb_dxt = stb_dxt%lib{stb_dxt}
import stb_easy_font = stb_easy_font%lib{stb_easy_font}
import stb_herringbone_wang_tile = stb_herringbone_wang_tile%lib{stb_herringbone_wang_tile}
import stb_hexwave = stb_hexwave%lib{stb_hexwave}
import stb_image = stb_image%lib{stb_image}
import stb_image_resize = stb_image_resize%lib{stb_image_resize}
import stb_image_write = stb_image_write%lib{stb_image_write}
import stb_include = stb_include%lib{stb_include}
import stb_leakcheck = stb_leakcheck%lib{stb_leakcheck}
import stb_perlin = stb_perlin%lib{stb_perlin}
import stb_rect_pack = stb_rect_pack%lib{stb_rect_pack}
import stb_sprintf = stb_sprintf%lib{stb_sprintf}
import stb_textedit = stb_textedit%lib{stb_textedit}
import stb_tilemap_editor = stb_tilemap_editor%lib{stb_tilemap_editor}
import stb_truetype = stb_truetype%lib{stb_truetype}
import stb_vorbis = stb_vorbis%lib{stb_vorbis}
import stb_voxel_render = stb_voxel_render%lib{stb_voxel_render}
Configuration
There are no configuration options vailable.
Issues and Notes
- Each package provides its own version. That makes updates to new specific versions and the support of older versions much harder.
- When compiling C code, for some libraries
-lm
needs to added manually for static builds. This might be a bug in build2. - Working on these packages is quite generic. You should use in-place shell programming to add features to all packages at once.
for x in stb*
echo $x:
...
end
- Tests with file I/O fail on Emscripten-based target configurations.
stb_herringbone_wang_tile
andstb_sprintf
exhibit errors for a few other target configurations.- For
stb_image_write
, there are still some unused-function warnings. - Other warnings are not disabled. They show potential flaws in the upstream libraries.
- Precompiled targets are not supported as all the libraries provide too many configuration macros.
- The documentation of each library can be found in their respective header file itself.
Contributing
Thanks in advance for your help and contribution to keep these packages up-to-date. For now, please, file an issue on GitHub for everything that is not described below.
Recommend Updating Version
Please, file an issue on GitHub with the new recommended version.
Update Version by Pull Request
- Fork the repository on GitHub and clone it to your local machine.
- Run
git submodule init
andgit submodule update
to get the current upstream directory. - Inside the
upstream
directory, checkout the new commit. - If needed, change source files,
buildfiles
, and symbolic links accordingly to create a working build2 package. Make sure not to directly depend on the upstream directory inside the build system but use symbolic links instead. - Update library version in
manifest
file if it has changed or add package update by using+n
for then
-th update. - Make an appropriate commit message by using imperative mood and a capital letter at the start and push the new commit to the
master
branch. - Run
bdep ci
and test for errors. - If everything works fine, make a pull request on GitHub and write down the
bdep ci
link to your CI tests. - After a successful pull request, we will run the appropriate commands to publish a new package version.
Update Version Directly if You Have Permissions
- Inside the
upstream
directory, checkout the new commit. - If needed, change source files,
buildfiles
, and symbolic links accordingly to create a working build2 package. Make sure not to directly depend on the upstream directory inside the build system but use symbolic links instead. - Update library version in
manifest
file if it has changed or add package update by using+n
for then
-th update. - Make an appropriate commit message by using imperative mood and a capital letter at the start and push the new commit to the
master
branch. - Run
bdep ci
and test for errors and warnings. - When successful, run
bdep release --tag --push
to push new tag version to repository. - Run
bdep publish
to publish the package to cppget.org.
license | MIT or Unlicense |
---|---|
project | stb |
url | github.com/nothings/stb |
sean+github@nothings.org |
1 Version
version | 1.1.0+1 |
---|---|
repository | https://pkg.cppget.org/1/stable |
depends | 0 |
reviews | +1 |