https://github.com/ericoporto/agsfastwfc
AGS Fast Wave Function Collapse Plugin
https://github.com/ericoporto/agsfastwfc
adventure-game-studio adventuregamestudio ags
Last synced: 11 months ago
JSON representation
AGS Fast Wave Function Collapse Plugin
- Host: GitHub
- URL: https://github.com/ericoporto/agsfastwfc
- Owner: ericoporto
- License: other
- Created: 2019-08-17T02:55:38.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-06-23T18:57:39.000Z (about 6 years ago)
- Last Synced: 2025-08-18T08:02:05.816Z (11 months ago)
- Topics: adventure-game-studio, adventuregamestudio, ags
- Language: C++
- Homepage: https://www.adventuregamestudio.co.uk/forums/index.php?topic=57410.0
- Size: 1.21 MB
- Stars: 15
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# agsfastwfc
🚨THIS IS VERY EXPERIMENTAL🚨 | [](https://dev.azure.com/ericoporto/agsfastwfc/_build/latest?definitionId=7&branchName=master)
**AGS Fast Wave Function Collapse Plugin**
Using the [fast-wfc library code](https://github.com/math-fehr/fast-wfc) from Mathieu Fehr and Nathanaël Courant. I just made a simple interface with Adventure Game Studio. Read more on [Wafe Function Collapse here](https://github.com/mxgmn/WaveFunctionCollapse).
## AgsFastWFC Script API usage
agsfastwfc can generate sprites that are locally similar to the input bitmap.
### Overlapping
```
bool AgsFastWFC.Overlapping(
int destination, int sprite,
int seed,
bool periodic_input, bool periodic_output,
int N=3, int ground=0)
```
- **`int destination`** The Graphic property of a Dynamic Sprite you have created to draw the result.
- **`int sprite`** The source sprite you want to feed FastWFC Overlapping algorithm.
- **`int seed`** An integer number, will provide the randomness of the output.
- **`bool periodic_input`** Should be true if the input is periodic.
- **`bool periodic_output`** Should be true if the desired output is periodic.
- **`int N`** A NxN pattern of pixels in the output should occur at least once in the input. Default is 3x3 pixels.
- **`int ground`** Default is 0.
Example:
```
dynspr_dest = DynamicSprite.Create(60, 120, true);
int result = AgsFastWFC.Overlapping(
dynspr_dest.Graphic, obj_source.Graphic,
Random(100000),
true, true, 3, 0);
obj_destination.Graphic = dynspr_dest.Graphic;
```
## Building agsfastwfc plugin
first you need to clone this repository to the folder you clone your repos (ex: ~/git).
If you haven't already, also clone AGS and set the branch for ags3.
```
git clone https://github.com/ericoporto/agsfastwfc.git
git clone https://github.com/adventuregamestudio/ags.git
pushd ags
git checkout ags3
popd
```
### Windows
Just load the solution on Visual Studio 2019 or 2017, and hit build.
### Linux
You need gcc that supports C++17. Load a terminal and do the below after cloning.
```
cd agsfastwfc/agsfastwfc/
make
```
### MacOS
MacOS build is untested, but should work the same way as Linux.
## Image samples
The image samples come from [https://github.com/mxgmn/WaveFunctionCollapse](https://github.com/mxgmn/WaveFunctionCollapse)
## Licence
This plugin interface is made with MIT License Copyright (c) 2019 Érico Vieira Porto.
fast-wfc Copyright (c) 2018-2019 Mathieu Fehr and Nathanaël Courant.
MIT License, see [`LICENSE`](LICENSE) for further details.