Jackalope / jrf (public) (License: GPLv3 or later version) (since 2019-11-21) (hash sha1)
Libriary for reading and writing resource files: vertices, indices, meshes, images, models and scene data.
Supports reading from filesystem as well as from zip files.
It uses unique binary container format for those resources.
It is used in tool for converting popular formats like wavefront .obj file, TARGA image to this container and also used in resource loader as part of graphics framework.

It requires jlib libriary (see my user repositories) and libzip.
It is possible to remove libzip dependency.
Clone URLs: https://rocketgit.com/user/Jackalope/jrf ssh://rocketgit@ssh.rocketgit.com/user/Jackalope/jrf git://git.rocketgit.com/user/Jackalope/jrf
v0.1.0 v0.1.1 v0.2.0 v0.2.1 v0.2.2 v0.3.0 master tool
List of commits:
Subject Hash Author Date (UTC)
Changed image formats, BGR->RGB convertion while reading from TARGA 297dd913b6084e890e5bd3d53f88d06a8f14657a Jackalope 2020-05-19 17:17:53
Changed cmake library interface 9c704c515769a03e5b1f82dcb1fd947884f1bd1e Jackalope 2020-05-12 06:58:47
added copyright notice to convert.cpp and convert.h a778f4f4a4783656fefac85440e135ddcda3788c Jackalope 2020-05-12 05:18:35
fixes after prev commit changes fc46b4bacf1c69f6eae0c679b26e3b88d1796217 Jackalope 2020-05-11 08:14:50
convert image from tga and add alpha channel functions 4541972149b6b19afda05c608d4abe88a72098bb Jackalope 2020-05-11 07:49:43
more image formats 77bf7ec016cfb604e4a8e06734a4eb71bb299df0 Jackalope 2020-05-11 07:48:46
added license d7c63a0b6199c7f5c1680559953eef1699ec9a48 Jackalope 2020-05-10 01:01:00
refactoring 66f541c32f51d6ed6f90fba1f3b58561726e8659 Jackalope 2020-05-10 00:55:34
extra vertices check c3bd2141d2eaeb96beb5c8ad29e3333c015db4c8 jp.larry 2019-12-26 14:38:29
removed dead code f4ddde689122f1b96fda5292e69f612bf2ca327d jp.larry 2019-12-26 14:38:06
removed forgotten vertex data_size writing 25244188b395b6cca35502f4156d3e78cc1e74ec jp.larry 2019-12-26 13:19:31
better read errors d6d7bc5df695d694ea0dee225905212ef1dfe41b jp.larry 2019-12-26 13:18:55
changed vertices file structure to prevent undefined behaviour 603e283ccf234f87f6e8c38a669280be36a5aafb jp.larry 2019-12-26 12:35:05
vertex attributes is separated, not inteleaved now d3e7b79c74e9fae7b8b788d1a55db2e664feb107 jp.larry 2019-12-26 01:19:17
compiled on windows with mingw 51eacaf02dd542415cea1edd615d88234fb5b344 Jackalope 2019-12-15 07:05:58
added mesh to read and write functions 173144a8516441420feb4327a66d26fa3f57376d Your Name 2019-12-07 22:09:04
warning hidden by implicit cast f49b32439aa1e8719bd340da9fc3bb7e9b906d0d Your Name 2019-12-07 21:01:08
Vertices have vertices count value cf3b63932cdcdb88b72e70df93a4dd8b478d163b jp.larry 2019-12-07 16:02:55
removed IndicesArrays, added Mesh resource and Vertices attributes is not dynamically allocated a54a61cfc285bbec4246b1affdc5fe9251c059d0 jp.larry 2019-12-06 17:04:06
new obj file error f4385161fdd1ad8038e2d0924e1d3de2a6506cc9 Your Name 2019-12-01 10:26:18
Commit 297dd913b6084e890e5bd3d53f88d06a8f14657a - Changed image formats, BGR->RGB convertion while reading from TARGA
Author: Jackalope
Author date (UTC): 2020-05-19 17:17
Committer name: Jackalope
Committer date (UTC): 2020-05-19 17:17
Parent(s): 9c704c515769a03e5b1f82dcb1fd947884f1bd1e
Signing key:
Tree: 4f6e318929c2ab731ab587ad80063954b55df269
File Lines added Lines deleted
include/jrf/image.h 8 11
src/convert.cpp 20 8
File include/jrf/image.h changed (mode: 100644) (index 23a0775..8af9e6d)
24 24 namespace jrf { struct Image; } namespace jrf { struct Image; }
25 25 struct jrf::Image struct jrf::Image
26 26 { {
27 enum Format : uint32_t {
28 R_8,
29 RG_8,
30 RGB_8,
31 RGBA_8,
32 RGB_8_sRGB,
33 RGBA_8_sRGB,
34 };
27 35 constexpr static const uint16_t DEPTH_LIMIT = uint16_t(~0u); constexpr static const uint16_t DEPTH_LIMIT = uint16_t(~0u);
28 36 struct Extent { struct Extent {
29 37 [[nodiscard]] uint64_t pixel_count() { [[nodiscard]] uint64_t pixel_count() {
 
... ... struct jrf::Image
40 48 uint16_t depth; uint16_t depth;
41 49 uint16_t pixelSize; uint16_t pixelSize;
42 50 }; };
43 static_assert (sizeof (Extent) == 8, "Important for compatibility");
44
45 enum Format {
46 B8G8R8_UINT = 34,
47 B8G8R8_SRGB = 36,
48 R8G8B8A8_SRGB = 43,
49 B8G8R8A8_UINT = 48,
50 B8G8R8A8_SRGB = 50,
51 };
52 static_assert (sizeof(Format) == 4, "Important for compatibility");
53
54 51 [[nodiscard]] bool init(Extent extent, Format format) { [[nodiscard]] bool init(Extent extent, Format format) {
55 52 this->extent = extent; this->extent = extent;
56 53 this->size = extent.size(); this->size = extent.size();
File src/convert.cpp changed (mode: 100644) (index c59a1fb..1c78579)
... ... from_tga(const jl::byte_array_ro &data, Image *p_dst) {
72 72 extent.pixelSize /= 8; extent.pixelSize /= 8;
73 73 Image::Format format; Image::Format format;
74 74 switch (extent.pixelSize) { switch (extent.pixelSize) {
75 case 3: format = Image::Format::B8G8R8_UINT;
75 case 3: format = Image::Format::RGB_8;
76 76 break; break;
77 case 4: format = Image::Format::B8G8R8A8_UINT;
77 case 4: format = Image::Format::RGBA_8;
78 78 break; break;
79 79 default: return Result::PIXEL_SIZE_UNSUPPORTED; default: return Result::PIXEL_SIZE_UNSUPPORTED;
80 80 } }
 
... ... from_tga(const jl::byte_array_ro &data, Image *p_dst) {
83 83 return Result::FILE_UNEXPECTED_EOF; return Result::FILE_UNEXPECTED_EOF;
84 84 if (not p_dst->init(extent, format)) if (not p_dst->init(extent, format))
85 85 return Result::ALLOCATION_FAIL; return Result::ALLOCATION_FAIL;
86 memcpy(p_dst->p_pixels, data.begin() + HEADER_SIZE, pixels_size);
86 const uint8_t *p_src = data.begin() + HEADER_SIZE;
87 uint8_t *p_p = p_dst->p_pixels;
88 auto write_component = [&p_p, &p_src] (uint8_t src_i, uint8_t dst_i) {
89 memcpy(p_p + dst_i, p_src + src_i, 1);
90 };
91 uint8_t *p_end = p_p + pixels_size;
92 do { // BGR -> RGB
93 write_component(0, 2); // B -> B
94 write_component(1, 1); // G -> G
95 write_component(2, 0); // R -> R
96 if (extent.pixelSize > 3)
97 write_component(3, 3); // A -> A
98 p_p += extent.pixelSize;
99 p_src += extent.pixelSize;
100 } while (p_p < p_end);
87 101 return Result::SUCCESS; return Result::SUCCESS;
88 102 } }
89 103 [[nodiscard]] jrf::Result jrf::convert:: [[nodiscard]] jrf::Result jrf::convert::
90 104 add_alpha_channel(const Image &src, Image *p_dst) { add_alpha_channel(const Image &src, Image *p_dst) {
91 105 Image::Format result_format; Image::Format result_format;
92 106 switch(src.format) { switch(src.format) {
93 case Image::Format::B8G8R8_SRGB:
94 result_format = Image::Format::B8G8R8A8_SRGB; break;
95 case Image::Format::B8G8R8_UINT:
96 result_format = Image::Format::B8G8R8A8_UINT; break;
97 default: return FORMAT_UNSUPPORTED;
107 case Image::Format::RGB_8:
108 result_format = Image::Format::RGBA_8; break;
109 default: return Result::FORMAT_UNSUPPORTED;
98 110 } }
99 111 *p_dst = src; *p_dst = src;
100 112 p_dst->format = result_format; p_dst->format = result_format;
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/Jackalope/jrf

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/Jackalope/jrf

Clone this repository using git:
git clone git://git.rocketgit.com/user/Jackalope/jrf

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main