{"id":32173557,"url":"https://github.com/lfex/loise","last_synced_at":"2025-10-21T18:58:22.001Z","repository":{"id":9039777,"uuid":"10802327","full_name":"lfex/loise","owner":"lfex","description":"A noise library for LFE/Erlang","archived":false,"fork":true,"pushed_at":"2025-01-15T22:20:57.000Z","size":2696,"stargazers_count":8,"open_issues_count":24,"forks_count":1,"subscribers_count":1,"default_branch":"release/1.4.x","last_synced_at":"2025-10-07T00:56:27.438Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"LFE","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"oubiwann/loise","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lfex.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}},"created_at":"2013-06-19T18:03:34.000Z","updated_at":"2025-01-15T22:20:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lfex/loise","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/lfex/loise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lfex%2Floise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lfex%2Floise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lfex%2Floise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lfex%2Floise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lfex","download_url":"https://codeload.github.com/lfex/loise/tar.gz/refs/heads/release/1.4.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lfex%2Floise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280317282,"owners_count":26309998,"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","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-10-21T18:58:15.936Z","updated_at":"2025-10-21T18:58:21.992Z","avatar_url":"https://github.com/lfex.png","language":"LFE","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Loise\n\n[![Build Status][gh-actions-badge]][gh-actions]\n[![LFE Versions][lfe-badge]][lfe]\n[![Erlang Versions][erlang-badge]][versions]\n[![Tags][github-tags-badge]][github-tags]\n[![Downloads][hex-downloads]][hex-package]\n\n*A noise library for LFE/Erlang*\n\n[![Loise project logo][logo]][logo]\n\n#### Contents\n\n* [Introduction](#introduction-)\n* [Dependencies](#dependencies-)\n* [Building and Starting](#building-and-starting-)\n* [Usage Examples](#usage-examples-)\n* [Documentation](#documentation-)\n* [License](#license-)\n\n## Introduction [\u0026#x219F;](#contents)\n\nThis is a library, written in [LFE](http://lfe.io/), useful for generating\nPerlin and Simplex noise. There's more info in the docs on\n[the background of both](docs/BACKGROUND.md). This LFE noise library may be\nused as simply that (a library) but it also supports more: stateful management\nof multiple \"matrices\" (renderable as images) and the navigation / examination\nof that generated noise data.\n\n## Dependencies [\u0026#x219F;](#contents)\n\nThis project requires that you have Erlang installed (tested with R15B03, R16B03, 17.5, 18.0, and 18.3). It also assumes that you have [rebar3](https://github.com/erlang/rebar3)\ninstalled somwhere in your ``$PATH``.\n\n## Building and Starting [\u0026#x219F;](#contents)\n\nPreliminary steps:\n\n```bash\nrebar3 compile\nrebar3 lfe repl\n```\n\nThe loise library maintains state and as such must be run in order to use, even\nwhen simply used as a library. From the REPL:\n\n``` cl\nlfe\u003e (loise:start)\n#(ok (loise))\n```\n\nFor non-REPL use, in your project, simply add `loise` to the `applications`\nlist:\n\n``` erlang\n{applications, [\n    kernel,\n    stdlib,\n    loise\n]},\n```\n\n## Usage Examples [\u0026#x219F;](#contents)\n\nThe following usage example is just the merest fraction of what you can do with\nloise. Be sure to see the [Documentation](#documentation-) section below for\nlinks to usage examples for specific features.\n\nPerlin smooth:\n\n```cl\nlfe\u003e (set opts #m(noise perlin multiplier 1))\nlfe\u003e (loise:image \"perlin-4.png\" (mupd opts 'multiplier 4))\nok\n```\n\n\u003cimg src=\"priv/images/perlin-4.png\" /\u003e\n\nPerlin graded:\n\n```cl\nlfe\u003e (set opts `#m(noise perlin\n                   multiplier 4\n                   graded? true\n                   grades-count 8))\nlfe\u003e (loise:image \"perlin-8-shades.png\" opts)\nok\n```\n\n\u003cimg src=\"priv/images/perlin-8-shades.png\" /\u003e\n\nSimplex smooth:\n\n``` cl\nlfe\u003e (set opts #m(noise simplex multiplier 4))\nlfe\u003e (loise:image \"simplex-4.png\" opts)\nok\n```\n\n\u003cimg src=\"priv/images/simplex-4.png\" /\u003e\n\nSimplex graded:\n\n```cl\nlfe\u003e (set opts (mset opts 'graded? 'true\n                          'grades-count 5\n                          'multiplier 4))\nlfe\u003e (loise:image \"simplex-5-shades.png\" opts)\nok\n```\n\n\u003cimg src=\"priv/images/simplex-5-shades.png\" /\u003e\n\nSimplex as coloured ASCII:\n\n```cl\nlfe\u003e (loise:format-ascii #m(color? true))\n```\n\n\u003cimg src=\"priv/images/simplex-ascii.png\" /\u003e\n\n## Documentation [\u0026#x219F;](#contents)\n\n* [Background Information](docs/BACKGROUND.md)\n* Usage\n  * [In LFE Modules](docs/USAGE-MODULE.md)\n  * In the REPL:\n    * [Basic Usage](docs/USAGE-REPL-BASIC.md)\n    * [Perlin Noise](docs/USAGE-REPL-PERLIN.md) (more images)\n    * [Simplex Noise](docs/USAGE-REPL-SIMPLEX.md) (more images)\n    * [ASCII Renderings](docs/USAGE-REPL-ASCII.md) (more iamges)\n    * [Layer Management](docs/USAGE-LAYERS.md)\n      * [Creating Layers](docs/USAGE-LAYERS.md#create-layers)\n      * [Random Walks](docs/USAGE-LAYERS.md#brownian-motion--random-walk)\n\n## License [\u0026#x219F;](#contents)\n\n```\n\nCopyright © 2013-2025 Duncan McGreggor\n\nDistributed under the Apache License, Version 2.0.\n```\n\n[//]: ---Named-Links---\n\n[gh-actions-badge]: https://github.com/lfex/loise/workflows/ci%2Fcd/badge.svg\n[gh-actions]: https://github.com/lfex/loise/actions\n[logo]: priv/images/loise.jpg\n[lfe]: https://github.com/lfe/lfe\n[lfe-badge]: https://img.shields.io/badge/lfe-2.1+-blue.svg\n[erlang-badge]: https://img.shields.io/badge/erlang-20+-blue.svg\n[versions]: https://github.com/lfex/loise/blob/master/.github/workflows/cicd.yml\n[github-tags]: https://github.com/lfex/loise/tags\n[github-tags-badge]: https://img.shields.io/github/tag/lfex/loise.svg\n[github-downloads]: https://img.shields.io/github/downloads/lfex/loise/total.svg\n[hex-badge]: https://img.shields.io/hexpm/v/loise.svg?maxAge=2592000\n[hex-package]: https://hex.pm/packages/loise\n[hex-downloads]: https://img.shields.io/hexpm/dt/loise.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flfex%2Floise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flfex%2Floise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flfex%2Floise/lists"}