{"id":16599667,"url":"https://github.com/drewcassidy/quicktex","last_synced_at":"2025-03-21T13:32:38.919Z","repository":{"id":37987150,"uuid":"333971922","full_name":"drewcassidy/quicktex","owner":"drewcassidy","description":"A project intended to add python bindings to rgbcx that somehow resulted in rewriting it entirely","archived":false,"fork":false,"pushed_at":"2023-06-22T00:22:37.000Z","size":30808,"stargazers_count":8,"open_issues_count":11,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-26T09:04:31.075Z","etag":null,"topics":["cplusplus","dds","dxt1","dxt5","python"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drewcassidy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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-01-28T22:23:14.000Z","updated_at":"2024-06-03T01:41:08.299Z","dependencies_parsed_at":"2024-06-03T01:41:07.555Z","dependency_job_id":"13ecc903-a836-42d8-856f-91496e232204","html_url":"https://github.com/drewcassidy/quicktex","commit_stats":{"total_commits":331,"total_committers":2,"mean_commits":165.5,"dds":"0.030211480362537735","last_synced_commit":"aed575edc6f92a50e9560de7370f8cef76eeaba9"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drewcassidy%2Fquicktex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drewcassidy%2Fquicktex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drewcassidy%2Fquicktex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drewcassidy%2Fquicktex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drewcassidy","download_url":"https://codeload.github.com/drewcassidy/quicktex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244806181,"owners_count":20513396,"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":["cplusplus","dds","dxt1","dxt5","python"],"created_at":"2024-10-12T00:12:11.981Z","updated_at":"2025-03-21T13:32:37.180Z","avatar_url":"https://github.com/drewcassidy.png","language":"C++","readme":"# Quicktex\nA python library for using DDS files\n\nQuicktex is a python library and command line tool for encoding and decoding DDS files.\nIt is based on the [RGBCX encoder](https://github.com/richgel999/bc7enc), which is currently\none of the [highest quality S3TC encoders available](https://aras-p.info/blog/2020/12/08/Texture-Compression-in-2020/).\nQuicktex has a python front end, but the encoding and decoding is all done in C++ for speed\ncomparable to the original library.\n\n## Installation\n\n### From Wheel (Easiest)\n\nTo install, run\n\n```shell\npip install quicktex\n```\n\nIf you are on macOS, You need to install openMP from homebrew:\n\n```shell\nbrew install libomp\n```\n\n### From Source\n\nTo build from source, first clone this repo and cd into it, then run:\n\n```shell\ngit submodule update --init\npip install .\n```\n\nand setuptools will take care of any dependencies for you.\n\nIf you are on macOS, it is recommended to first install openMP from homebrew to enable\nmultithreading, since it is not included in the default Apple Clang install:\n\n```shell\nbrew install libomp\n```\n\nThe package also makes tests, stub generation, and docs available. To install the \nrequired dependencies for them, install with options like so:\n\n```shell\npip install .[tests,stubs,docs]\n```\n\n## Usage\n\n```\nUsage: quicktex [OPTIONS] COMMAND [ARGS]...\n\n  Encode and Decode various image formats\n\nOptions:\n  --version  Show the version and exit.\n  --help     Show this message and exit.\n\nCommands:\n  decode  Decode DDS files to images.\n  encode  Encode images to DDS files of the given format.\n```\n\nTo decode DDS files to images, use the `decode` subdommand, along with a glob or a\nlist of files to decode. \n\nTo encode images to DDS files, use the `encode` subcommand, plus an additional\nsubcommand for the format. For example, `quicktex encode bc1 bun.png` will encode\nbun.png in the current directory to a bc1/DXT1 dds file next to it.\n\n`encode` and `decode` both accept several common parameters:\n\n- `-f, --flip / -F, --no-flip`:  Vertically flip image before/after converting. \n  [default: True]\n- `-r, --remove`: Remove input images after converting.\n- `-s, --suffix TEXT`: Suffix to append to output filename(s). \n  Ignored if `output` is a single file.\n- `-o, --output`:  Output file or directory. If outputting to a file, input filenames \n  must be only a single item. By default, files are converted in place.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrewcassidy%2Fquicktex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrewcassidy%2Fquicktex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrewcassidy%2Fquicktex/lists"}