{"id":17975786,"url":"https://github.com/aiekick/magicavoxel_file_writer","last_synced_at":"2025-03-25T15:30:43.139Z","repository":{"id":43483114,"uuid":"135326777","full_name":"aiekick/MagicaVoxel_File_Writer","owner":"aiekick","description":"MagicaVoxel File Writer dependency free cpp class","archived":false,"fork":false,"pushed_at":"2023-08-13T05:17:46.000Z","size":5751,"stargazers_count":39,"open_issues_count":0,"forks_count":11,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-20T13:03:00.982Z","etag":null,"topics":["art","file","file-format","free-library","helper","magicavoxel","procedural","procedural-generation","vox","voxel","voxel-generator","writer"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aiekick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-29T16:53:55.000Z","updated_at":"2025-03-17T15:20:48.000Z","dependencies_parsed_at":"2024-10-29T17:42:07.466Z","dependency_job_id":null,"html_url":"https://github.com/aiekick/MagicaVoxel_File_Writer","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiekick%2FMagicaVoxel_File_Writer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiekick%2FMagicaVoxel_File_Writer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiekick%2FMagicaVoxel_File_Writer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiekick%2FMagicaVoxel_File_Writer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aiekick","download_url":"https://codeload.github.com/aiekick/MagicaVoxel_File_Writer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245489754,"owners_count":20623789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art","file","file-format","free-library","helper","magicavoxel","procedural","procedural-generation","vox","voxel","voxel-generator","writer"],"created_at":"2024-10-29T17:21:21.192Z","updated_at":"2025-03-25T15:30:42.555Z","avatar_url":"https://github.com/aiekick.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MagicaVoxel File Writer\n\nRust Version available here : [MagicaVoxel File Writer for Rust](https://github.com/aiekick/MagicaVoxel_File_Writer_for_Rust)\n\nvox.hm is the file format descriptor for HexaMonkey :\n- original topic about it : https://github.com/ephtracy/voxel-model/issues/19\n- HexaMonkey tool : http://hexamonkey.com/\n\n## App\n\nthe main.cpp file show you how to generate a quick file :\n\nWith this simple code\n\n```cpp\n#include \"VoxWriter.h\"\nint main() \n{\n    const int32_t  SIZE      = 189;\n    const int32_t  OFFSET    = SIZE;\n    const float    Z_SCALE   = 1.0f;\n    const int32_t  FRAMES    = 30;\n    const float    len_ratio = 1.0f / (SIZE * SIZE);\n\t\n    vox::VoxWriter vox;\n    \n    vox.StartTimeLogging();\n    float time = 0.0f;\n    for (int32_t k = 0; k \u003c FRAMES; ++k) {\n        vox.SetKeyFrame(k);\n        for (int32_t i = -SIZE; i \u003c SIZE; ++i) {\n            for (int32_t j = -SIZE; j \u003c SIZE; ++j) {\n                float   len        = (i * i + j * j) * len_ratio;\n                int32_t pz         = (int32_t)((std::sin(len * 10.0 + time) * 0.5 + 0.5) * (std::abs(50.0f - 25.0f * len)) * Z_SCALE);\n                int32_t cube_color = (int32_t)(len * 100.0) % 255 + 1;\n                vox.AddVoxel(i + OFFSET, j + OFFSET, pz, cube_color);  // magicavoxel use the z as up axis\n            }\n        }\n        time += 0.5f;\n    }\n    vox.StopTimeLogging();\n    vox.SaveToFile(\"output_voxwriter.vox\");\n    vox.PrintStats();\n}\n```\n\nyou can generate that (previewed in [Magicavoxel](https://ephtracy.github.io/)\n\n![main](main.gif)\n\npossible console print ( vox.PrintStats() ) : \n\n```cpp\n---- Stats ------------------------------\nVolume : 377 x 377 x 49\ncount cubes : 9\ncount key frames : 30\n-----------------------------------------\n o--\\-\u003e key frame : 0\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.045 secs\n o--\\-\u003e key frame : 1\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.046 secs\n o--\\-\u003e key frame : 2\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.046 secs\n o--\\-\u003e key frame : 3\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.047 secs\n o--\\-\u003e key frame : 4\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.047 secs\n o--\\-\u003e key frame : 5\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 6\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 7\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.047 secs\n o--\\-\u003e key frame : 8\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 9\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 10\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 11\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.047 secs\n o--\\-\u003e key frame : 12\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.047 secs\n o--\\-\u003e key frame : 13\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 14\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 15\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 16\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.05 secs\n o--\\-\u003e key frame : 17\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.048 secs\n o--\\-\u003e key frame : 18\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 19\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 20\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 21\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.05 secs\n o--\\-\u003e key frame : 22\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 23\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.05 secs\n o--\\-\u003e key frame : 24\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.049 secs\n o--\\-\u003e key frame : 25\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.05 secs\n o--\\-\u003e key frame : 26\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.05 secs\n o--\\-\u003e key frame : 27\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.051 secs\n o--\\-\u003e key frame : 28\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.051 secs\n o--\\-\u003e key frame : 29\n     \\-\u003e voxels count : 142884\n      \\-\u003e elapsed time : 0.051 secs\n-----------------------------------------\nvoxels total : 4286520\ntotal elapsed time : 1.472 secs\n-----------------------------------------\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiekick%2Fmagicavoxel_file_writer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faiekick%2Fmagicavoxel_file_writer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiekick%2Fmagicavoxel_file_writer/lists"}