kaze/orx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add demos to README.md

Browse Source
This commit is contained in:
Abe Pazos
2025-10-06 12:15:47 +00:00
parent 15633e8d42
commit bd71426660
2 changed files with 124 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
orx-marching-squares/README.md
View File

@@ -23,7 +23,20 @@ drawer.contours(contours)
## Demos
### FindContours01
A simple demonstration of using the `findContours` method provided by `orx-marching-squares`.
`findContours` lets one generate contours by providing a mathematical function to be
sampled within the provided area and with the given cell size. Contours are generated
between the areas in which the function returns positive and negative values.
In this example, the `f` function returns the distance of a point to the center of the window minus 200.0.
Therefore, sampled locations which are less than 200 pixels away from the center return
negative values and all others return positive values, effectively generating a circle of radius 200.0.
Try increasing the cell size to see how the precision of the circle reduces.
The circular contour created in this program has over 90 segments. The number of segments depends on the cell
size, and the resulting radius.
![FindContours01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-marching-squares/images/FindContours01Kt.png)
@@ -31,6 +44,13 @@ drawer.contours(contours)
### FindContours02
This Marching Square demonstration shows the effect of wrapping a distance function
within a cosine (or sine). These mathematical functions return values that periodically
alternate between negative and positive, creating nested contours as the distance increases.
The `/ 100.0) * 2 * PI` part of the formula is only a scaling factor, more or less
equivalent to 0.06. Increasing or decreasing this value will change how close the generated
parallel curves are to each other.
![FindContours02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-marching-squares/images/FindContours02Kt.png)
@@ -39,6 +59,10 @@ drawer.contours(contours)
### FindContours03
Demonstrates how Marching Squares can be used to generate animations, by using a time-related
variable like `seconds`. The evaluated function is somewhat more complex than previous ones,
but one can arrive to such functions by exploration and experimentation, nesting trigonometrical
functions and making use of `seconds`, v.x and v.y.
![FindContours03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-marching-squares/images/FindContours03Kt.png)
@@ -47,7 +71,16 @@ drawer.contours(contours)
### FindContours04
Demonstrates using Marching Squares while reading the pixel colors of a loaded image.
Notice how the area defined when calling `findContours` is larger than the window.
Using point coordinates from such an area to read from image pixels might cause problems when points are
outside the image bounds, therefore the `f` function checks whether the requested `v` is within bounds,
and only reads from the image when it is.
The `seconds` built-in variable is used to generate an animated effect, serving as a shifting cut-off point
that specifies at which brightness level to create curves.
![FindContours04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-marching-squares/images/FindContours04Kt.png)