capnramses/apg

mini libraries / experimental tools and reusable snippets

Hi there 👋

• 📚 I wrote a couple of books; one for learning 3D graphics, and one explaining a range of programming tools.
• 🔭 I’m working on a hobby voxel video game (working title Antonkraft).
• 🌱 I’m learning PyTorch.

apg's Issues

face number in ray-obb is bugged

apg/apg_maths/apg_maths.h

Line 646 in 601f1b6

*face_num = tmin > 0 ? imin + 1 : imax + 1;

License?

Would you mind adding a license to this very nice collection of reusable bits ?

Something like ISC/MIT/BSD would be nice :)

Thanks! 😸

[apg_bmp] RLE flag for apg_bmp_write

• e.g. in case you want to use fast BMP output to dump a screenshot without much of a stutter in your app.
• and don't wan't a folder of massive uncompressed true-colour images.
• note that this would only support 24-bit RGB indexed images, so more code may be required there than for RGBA 32-bit true-colours.
• the palette would have to be created using a table of colour distances, which might not be so fast.
• if an existing 256-colour palette was supplied as a field, then this would speed up the output using colour-distances.
• therefore 2 functions could be created:
  1. create_palette( from image )
  2. write_bmp( using palette )
• this might be more expedient to use in external tools to compress existing images or apply a palette to a folder of images

[apg.h] make pseudo-random numbers thread-safe and support > 1 random number stream

[apg_pixfont]

• Pull in glyph changes from gfx repo (quotations, brackets, etc).
• Code for ampersand 1 pixel wider spacing.
• Atlas gen tool start at space (32).
• Atlas gen tool skip control codes between ASCII and Latin-1.
• Update codepoint fetch to accom the above mapping changes.
• Put spacing for atlas function in interface so that apg_pixfont can be used for atlas rasterisation as well.
• Add missing Latin-1 glyph images - might be tricky to add to strip image.

[apg_bmp] - uint32_t returned as -1

might throw a warning in some compilers. perhaps return 0 instead.

apg/apg_bmp/apg_bmp.c

Line 128 in 0a432bf

return -1;

move all thirdparty stuff into a global thirdparty/ folder

• update any build scripts and makefiles
• and instructions about compilation in code headers
• test

[apg_pixfont] escape sequences formatting example

Use the same escape codes as windows console/printf/bash

• bold/italic/etc
• colours

https://learn.microsoft.com/en-us/windows/console/console-virtual-terminal-sequences?redirectedfrom=MSDN

hash function is bad

use one from class - single with shift and double hash perhaps
it suffers from integer overflow and .: UB

[apg] this WIN32 looks likes a mistake

apg/apg/apg.h

Line 421 in 8f51112

#ifdef WIN32

• should be _WIN32
• maybe it should rather detect GCC / mingw and use the unix/posix version on windows if that is true

[apg_tga] - writing seems to be mirrored on x and y axis

• write tests

[apg] remove apg_loopi

too confusing/specific.
make sure its not used anywhere/in tests.

[apg_maths] angle wrap malfunction

[apg_bmp] support GIMP's RLE compression

• for non-palette RGB/RGBA images
• try with palette indexed option and compare size
• find spec somewhere - presume this doesnt work with bitwise encoded/older formats
• alternative - make a custom RLE compression implementation option using e.g. 3 or 4-byte clusters of image data/indexes.

write script to run test programs as part of GitHub Actions

apg_file_to_str is not portable

needs to be "rb" for wintendo

[apg_bmp] load from memory, not just from file

[apg_console] bug - current text stdout dump not working until \n entered

[apg_bmp] review alpha blending vs MS docs

https://learn.microsoft.com/en-us/windows/win32/gdi/alpha-blending

[apg] add is_directory() and is_file()