{"id":15723223,"url":"https://github.com/britzl/template-lowres","last_synced_at":"2025-04-15T11:55:02.805Z","repository":{"id":48192051,"uuid":"142653787","full_name":"britzl/template-lowres","owner":"britzl","description":"Defold template project for lowres/pixel-art games.","archived":false,"fork":false,"pushed_at":"2025-03-01T09:24:34.000Z","size":90,"stargazers_count":33,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T19:53:40.099Z","etag":null,"topics":["defold","defold-library","lowrezjam","pixel-art"],"latest_commit_sha":null,"homepage":"","language":"GLSL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/britzl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07-28T06:42:13.000Z","updated_at":"2025-03-11T18:25:25.000Z","dependencies_parsed_at":"2023-08-20T17:13:54.652Z","dependency_job_id":"85f3c63d-ada5-4629-a370-54669055bf89","html_url":"https://github.com/britzl/template-lowres","commit_stats":null,"previous_names":["britzl/lowrezjam-template"],"tags_count":8,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Ftemplate-lowres","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Ftemplate-lowres/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Ftemplate-lowres/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Ftemplate-lowres/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/britzl","download_url":"https://codeload.github.com/britzl/template-lowres/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067775,"owners_count":21207395,"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":["defold","defold-library","lowrezjam","pixel-art"],"created_at":"2024-10-03T22:10:44.343Z","updated_at":"2025-04-15T11:55:02.784Z","avatar_url":"https://github.com/britzl.png","language":"GLSL","funding_links":[],"categories":["Libraries"],"sub_categories":["Programming Language"],"readme":"# template-lowres\nDefold template project for creation of low-res pixel art games. The project provides a render script for rendering the game to a low-res texture that will be centered and upscaled to fit the screen dimensions. The project also provides fonts for use in low resolution pixel art games.\n\nThe template project also contains presets for the following formats:\n\n* [LOWREZJAM-2018](https://itch.io/jam/lowrezjam-2018) - 64x64 pixel template with support for on-screen controls\n* [Nokia 3310 Jam](https://itch.io/jam/3310jam) - 84x48 pixel template\n\nHTML5 demo: https://britzl.github.io/LOWREZJAM/\n\n\n# Installation\nYou can use the template in your own project by adding this project as a [Defold library dependency](http://www.defold.com/manuals/libraries/). Open your game.project file and in the dependencies field under project add:\n\nhttps://github.com/britzl/template-lowres/archive/master.zip\n\nOr point to the ZIP file of a [specific release](https://github.com/britzl/template-lowres/releases).\n\nThis repository is also available as a [GitHub Template repository](https://help.github.com/en/articles/creating-a-repository-from-a-template).\n\n# Usage\nIt is quite easy to setup and use the template:\n\n* Open `game.project` and use the render script (`lowrez/render/lowrez.render`) instead of the default one from builtins.\n* Add one of the provided game objects to your bootstrap collection\n  * `lowrez/lowrezjam.go`\n  * `lowrez/nokia3310jam.go`\n  * `lowrez/custom.go`\n\nExpand the game object, select the attached script component and configure how the graphics should render. You can modify `width`, `height` and `snap` (see below).\n\n## Lowrez render script\nThe template provides a render script that renders to a low-res texture and upscales to fit screen dimensions. The texture will be centered in the window.\n\n## Changing size\nChange the screen size by posting a `set_size` message to the render script with a `width` and `height` message property.\n\n```lua\nmsg.post(\"@render:\", \"set_size\", { width = 320, height = 240 })\n```\n\n## Configure scale snapping\nThe upscaled low-res texture will by default be scaled to fill as much of the window as possible. It is possible to ensure that the upscaled texture will have a zoom that is set to an integer value. You can toggling scale snapping via the `toggle_scale_snap` message or explicity set snapping using the `set_scale_snap` message with `snap` set to true or false.\n\n```lua\nmsg.post(\"@render:\", \"toggle_scale_snap\")\nmsg.post(\"@render:\", \"set_scale_snap\", { snap = true })\n```\n\n## On screen controls\nThe render script will also in a separate pass draw on-screen controls as per allowed rules for the jam. The on-screen controls must be a gui with material set to the provided `controls.material`.\n\n\n# Fonts\nThe template ships with the following fonts suitable for low resolution pixel art games:\n\n* 04b font - 5x5 pixel font (Freeware - http://www.04.jp.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbritzl%2Ftemplate-lowres","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbritzl%2Ftemplate-lowres","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbritzl%2Ftemplate-lowres/lists"}