{"id":21379385,"url":"https://github.com/tgstation/icon-cutter","last_synced_at":"2025-07-13T11:32:36.709Z","repository":{"id":47469006,"uuid":"357731387","full_name":"tgstation/icon-cutter","owner":"tgstation","description":"Creates .dmi files tailored to use with an 8-bit bitmasking system for smooth icons in the DM game programming language.","archived":false,"fork":false,"pushed_at":"2024-07-08T19:45:33.000Z","size":135,"stargazers_count":3,"open_issues_count":1,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-07-09T00:36:39.180Z","etag":null,"topics":["byond","dmi","icon-generator","ss13"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tgstation.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":"2021-04-14T01:01:37.000Z","updated_at":"2023-04-29T04:09:01.000Z","dependencies_parsed_at":"2024-07-09T00:06:39.594Z","dependency_job_id":"1feed38b-fb1f-49dc-90ae-69c9780b8653","html_url":"https://github.com/tgstation/icon-cutter","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgstation%2Ficon-cutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgstation%2Ficon-cutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgstation%2Ficon-cutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgstation%2Ficon-cutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tgstation","download_url":"https://codeload.github.com/tgstation/icon-cutter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225878739,"owners_count":17538500,"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":["byond","dmi","icon-generator","ss13"],"created_at":"2024-11-22T10:19:28.363Z","updated_at":"2024-11-22T10:19:29.174Z","avatar_url":"https://github.com/tgstation.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# icon-cutter\n\nicon-cutter is a library which creates .dmi files tailored to use with an 8-bit bitmasking system for smooth icons in in the [DM] game programming language.\n\nA pre-compiled exe version can be found on the [releases page], but you can build your own from this repo at your preference.\n\n## Dependencies\n\nThe [Rust] compiler:\n\n1. Install the Rust compiler's dependencies (primarily the system linker):\n\n   * Ubuntu: `sudo apt-get install gcc-multilib`\n   * Windows (MSVC): [Build Tools for Visual Studio 2017][msvc]\n   * Windows (GNU): No action required\n\n1. Use [the Rust installer](https://rustup.rs/), or another Rust installation method,\n   or run the following:\n\n    ```sh\n    curl https://sh.rustup.rs -sSfo rustup-init.sh\n    chmod +x rustup-init.sh\n    ./rustup-init.sh\n    ```\n\n## Compiling\n\nThe [Cargo] tool handles compilation, as well as automatically downloading and\ncompiling all Rust dependencies. To compile in release mode (recommended for speed):\n\n```sh\ncargo build --release\n```\n\n## Running\n\nSimply drag your input .png file(s) onto the produced executable. You can also run it from the command line and provide the file path(s) as arguments.\n\nIn addition, there needs to be a `config.yaml` file present in the executable's directory that complies with the format specified in `examples/config-documentation.yaml`.\n\nExample formats for the .png and config.yaml files can be found in `examples/`.\nAll you have to do is copy the template and config file from one of them into the same folder in where the program will be executed.\n\n**Note:** The final products in dmi forms are fully functional but uncompressed. In order to reduce memory usage, open the DMI with DreamMaker and save it without changing anything. The file size should be noticeably reduced.\n\nIf you're still having problems, ask in the [Coderbus Discord]'s\n`#tooling-questions` channel.\n\n[releases page]: https://github.com/tgstation/icon-cutter/releases\n[DM]: https://secure.byond.com/\n[Rust]: https://rust-lang.org\n[Cargo]: https://doc.rust-lang.org/cargo/\n[rustup]: https://rustup.rs/\n[msvc]: https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools\u0026rel=15\n[Coderbus Discord]: https://discord.gg/Vh8TJp9\n\n## License\n\nThis project is licensed under the [AGPL license](https://en.wikipedia.org/wiki/Affero_General_Public_License).\n\nSee [LICENSE](./LICENSE) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgstation%2Ficon-cutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftgstation%2Ficon-cutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgstation%2Ficon-cutter/lists"}