orx/orx-shapes/README.md

# orx-shapes

Collection of 2D shape generators and modifiers.

<!-- __demos__ -->
## Demos
### adjust/DemoAdjustContour01

Demonstrates how to use `adjustContour` to select and modify three vertices
in a circular contour. In OPENRNDR circles contain 4 cubic bézier
segments connecting 4 vertices.

On every animation frame the circular contour is created and transformed
using sines, cosines and the variable `seconds` for an animated effect.

![adjust-DemoAdjustContour01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour01Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour01.kt)

### adjust/DemoAdjustContour02

Demonstrates how to use `adjustContour` to select and remove vertex 0
from a circular contour, then select and animate the position and scale the new vertex 0.

![adjust-DemoAdjustContour02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour02Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour02.kt)

### adjust/DemoAdjustContour03

Demonstrates how to select and alter the edges of a rectangle.

The rectangle is a scaled-down version window bounds.

By default, the edges of a rectangular contour are linear, so the `edge.toCubic()` method
is called to make it possible to bend them.

Then various edges are selected one by one and transformed over time using operations like
scale, rotate, splitAt and moveBy.


![adjust-DemoAdjustContour03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour03Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour03.kt)

### adjust/DemoAdjustContour04

Demonstrates an `adjustContour` animated effect where edge 0 of a contour
is replaced by a point sampled on that edge. The specific edge point oscillates between
0.0 (at the start) and 1.0 (at the end) using a cosine and the `seconds` variable.

The base contour used for the effect alternates every second
between a rectangular and a circular contour.


![adjust-DemoAdjustContour04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour04Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour04.kt)

### adjust/DemoAdjustContour05



![adjust-DemoAdjustContour05Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour05Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour05.kt)

### adjust/DemoAdjustContour06



![adjust-DemoAdjustContour06Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour06Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour06.kt)

### adjust/DemoAdjustContour07



![adjust-DemoAdjustContour07Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour07Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour07.kt)

### adjust/DemoAdjustContour08



![adjust-DemoAdjustContour08Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour08Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour08.kt)

### adjust/DemoAdjustContour09



![adjust-DemoAdjustContour09Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContour09Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContour09.kt)

### adjust/DemoAdjustContourContinue01



![adjust-DemoAdjustContourContinue01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/adjust-DemoAdjustContourContinue01Kt.png)

[source code](src/jvmDemo/kotlin/adjust/DemoAdjustContourContinue01.kt)

### alphashape/DemoAlphaShape



![alphashape-DemoAlphaShapeKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/alphashape-DemoAlphaShapeKt.png)

[source code](src/jvmDemo/kotlin/alphashape/DemoAlphaShape.kt)

### arrangement/DemoArrangement01



![arrangement-DemoArrangement01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/arrangement-DemoArrangement01Kt.png)

[source code](src/jvmDemo/kotlin/arrangement/DemoArrangement01.kt)

### arrangement/DemoArrangement02



![arrangement-DemoArrangement02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/arrangement-DemoArrangement02Kt.png)

[source code](src/jvmDemo/kotlin/arrangement/DemoArrangement02.kt)

### arrangement/DemoArrangement04



![arrangement-DemoArrangement04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/arrangement-DemoArrangement04Kt.png)

[source code](src/jvmDemo/kotlin/arrangement/DemoArrangement04.kt)

### bezierpatch/DemoBezierPatch01

Shows how to
- create a [bezierPatch] out of 4 [LineSegment]
- create a sub-patch out of a [bezierPatch]
- create horizontal and vertical [ShapeContour]s out of [bezierPatch]es

The created contours are horizontal and vertical in "bezier-patch space" but
are rendered deformed following the shape of the bezier patch.

![bezierpatch-DemoBezierPatch01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch01Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch01.kt)

### bezierpatch/DemoBezierPatch02

Shows how to create a [bezierPatch] out of a
closed [ShapeContour] with 4 curved segments.

Calling [Circle.contour] is one way of producing
such a contour with vertices at the cardinal points
but one can manually create any other 4-segment closed contour
to use in bezier patches.

![bezierpatch-DemoBezierPatch02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch02Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch02.kt)

### bezierpatch/DemoBezierPatch03

Shows how to distort [ShapeContour]s using a [bezierPatch]

In this case the contours are regular stars and the bezier patch
is created using a circular contour with the required 4 segments.

![bezierpatch-DemoBezierPatch03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch03Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch03.kt)

### bezierpatch/DemoBezierPatch04

Shows how to get positions and gradient values of those positions
from a [bezierPatch]

You can think of bezierPatch.position() as requesting points
in a wavy flag (the bezier patch) using normalized uv coordinates.

![bezierpatch-DemoBezierPatch04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch04Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch04.kt)

### bezierpatch/DemoBezierPatch05

Shows how to
- create a [bezierPatch] out of 4 [Segment3D]
- create a sub-patch out of a [bezierPatch]
- create horizontal and vertical [Path3D]s out of [bezierPatch]es
- add colors to a [bezierPatch]
- draw a [bezierPatch] surface

The created contours are horizontal and vertical in "bezier-patch space" but
are rendered deformed following the shape of the bezier patch.

![bezierpatch-DemoBezierPatch05Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch05Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch05.kt)

### bezierpatch/DemoBezierPatch06

Shows how to
- create a [bezierPatch] out of 4 curved Segment2D instances
- apply an image texture to the patch using a shadeStyle


![bezierpatch-DemoBezierPatch06Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatch06Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatch06.kt)

### bezierpatch/DemoBezierPatchDrawer01



![bezierpatch-DemoBezierPatchDrawer01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatchDrawer01Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatchDrawer01.kt)

### bezierpatch/DemoBezierPatchDrawer02



![bezierpatch-DemoBezierPatchDrawer02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatchDrawer02Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatchDrawer02.kt)

### bezierpatch/DemoBezierPatchDrawer03



![bezierpatch-DemoBezierPatchDrawer03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatchDrawer03Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatchDrawer03.kt)

### bezierpatch/DemoBezierPatches01

Shows how to create a [bezierPatch] out of a
closed [ShapeContour] with 4 curved segments.

Calling [Circle.contour] is one way of producing
such a contour with vertices at the cardinal points
but one can manually create any other 4-segment closed contour
to use in bezier patches.

![bezierpatch-DemoBezierPatches01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/bezierpatch-DemoBezierPatches01Kt.png)

[source code](src/jvmDemo/kotlin/bezierpatch/DemoBezierPatches01.kt)

### blend/DemoContourBlend01

Demonstration of uniform contour blending

![blend-DemoContourBlend01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/blend-DemoContourBlend01Kt.png)

[source code](src/jvmDemo/kotlin/blend/DemoContourBlend01.kt)

### blend/DemoContourBlend02

Demonstration of non-uniform contour blending

![blend-DemoContourBlend02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/blend-DemoContourBlend02Kt.png)

[source code](src/jvmDemo/kotlin/blend/DemoContourBlend02.kt)

### frames/DemoFrames01



![frames-DemoFrames01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/frames-DemoFrames01Kt.png)

[source code](src/jvmDemo/kotlin/frames/DemoFrames01.kt)

### hobbycurve/DemoHobbyCurve01



![hobbycurve-DemoHobbyCurve01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/hobbycurve-DemoHobbyCurve01Kt.png)

[source code](src/jvmDemo/kotlin/hobbycurve/DemoHobbyCurve01.kt)

### hobbycurve/DemoHobbyCurve02



![hobbycurve-DemoHobbyCurve02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/hobbycurve-DemoHobbyCurve02Kt.png)

[source code](src/jvmDemo/kotlin/hobbycurve/DemoHobbyCurve02.kt)

### hobbycurve/DemoHobbyCurve03



![hobbycurve-DemoHobbyCurve03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/hobbycurve-DemoHobbyCurve03Kt.png)

[source code](src/jvmDemo/kotlin/hobbycurve/DemoHobbyCurve03.kt)

### hobbycurve/DemoHobbyCurve3D01



![hobbycurve-DemoHobbyCurve3D01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/hobbycurve-DemoHobbyCurve3D01Kt.png)

[source code](src/jvmDemo/kotlin/hobbycurve/DemoHobbyCurve3D01.kt)

### operators/DemoRoundCorners01



![operators-DemoRoundCorners01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/operators-DemoRoundCorners01Kt.png)

[source code](src/jvmDemo/kotlin/operators/DemoRoundCorners01.kt)

### ordering/DemoHilbertOrder01



![ordering-DemoHilbertOrder01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/ordering-DemoHilbertOrder01Kt.png)

[source code](src/jvmDemo/kotlin/ordering/DemoHilbertOrder01.kt)

### ordering/DemoHilbertOrder02



![ordering-DemoHilbertOrder02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/ordering-DemoHilbertOrder02Kt.png)

[source code](src/jvmDemo/kotlin/ordering/DemoHilbertOrder02.kt)

### path3d/DemoPath3DProjection



![path3d-DemoPath3DProjectionKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/path3d-DemoPath3DProjectionKt.png)

[source code](src/jvmDemo/kotlin/path3d/DemoPath3DProjection.kt)

### primitives/DemoArc01



![primitives-DemoArc01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoArc01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoArc01.kt)

### primitives/DemoCircleInversion01



![primitives-DemoCircleInversion01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoCircleInversion01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoCircleInversion01.kt)

### primitives/DemoCircleInversion02



![primitives-DemoCircleInversion02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoCircleInversion02Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoCircleInversion02.kt)

### primitives/DemoCircleInversion03



![primitives-DemoCircleInversion03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoCircleInversion03Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoCircleInversion03.kt)

### primitives/DemoNet01



![primitives-DemoNet01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoNet01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoNet01.kt)

### primitives/DemoPulley01



![primitives-DemoPulley01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoPulley01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoPulley01.kt)

### primitives/DemoRectangleDistribute01

of rectangles, which are generated and manipulated based on time and random parameters. The application
follows these steps:

1. Initializes a random generator seeded with the elapsed seconds since the start of the program.
2. Creates a sequence of rectangles using the `uniformSub` function to generate random sub-rectangles
within the bounding rectangle of the canvas.
3. Distributes the generated rectangles horizontally within the canvas using the `distributeHorizontally` method.
4. Aligns the rectangles vertically according to their position in relation to the bounding rectangle
and a dynamic anchor point derived from the cosine of elapsed time.
5. Renders the rectangles on the canvas in the output window.

![primitives-DemoRectangleDistribute01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleDistribute01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleDistribute01.kt)

### primitives/DemoRectangleFitHorizontally



![primitives-DemoRectangleFitHorizontallyKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleFitHorizontallyKt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleFitHorizontally.kt)

### primitives/DemoRectangleGrid01



![primitives-DemoRectangleGrid01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleGrid01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleGrid01.kt)

### primitives/DemoRectangleGrid02



![primitives-DemoRectangleGrid02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleGrid02Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleGrid02.kt)

### primitives/DemoRectangleGrid03



![primitives-DemoRectangleGrid03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleGrid03Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleGrid03.kt)

### primitives/DemoRectangleIntersection01

Demonstrate rectangle-rectangle intersection


![primitives-DemoRectangleIntersection01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleIntersection01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleIntersection01.kt)

### primitives/DemoRectangleIrregularGrid



![primitives-DemoRectangleIrregularGridKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectangleIrregularGridKt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectangleIrregularGrid.kt)

### primitives/DemoRectanglePlace01

Demo for rendering a 10x10 grid of rectangles within the bounds
of the canvas. Each rectangle's position is calculated relative to its anchors, filling the entire
canvas with evenly placed items.

The rectangles are drawn using the default white color. The `place` function is applied to each
rectangle to position them dynamically based on their relative anchor points within the bounding area.

This serves as a demonstration of positioning and rendering shapes in a structured grid layout.

![primitives-DemoRectanglePlace01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRectanglePlace01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRectanglePlace01.kt)

### primitives/DemoRegularPolygon



![primitives-DemoRegularPolygonKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRegularPolygonKt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRegularPolygon.kt)

### primitives/DemoRegularStar01



![primitives-DemoRegularStar01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRegularStar01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRegularStar01.kt)

### primitives/DemoRegularStar02



![primitives-DemoRegularStar02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRegularStar02Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRegularStar02.kt)

### primitives/DemoRoundedRectangle



![primitives-DemoRoundedRectangleKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoRoundedRectangleKt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoRoundedRectangle.kt)

### primitives/DemoSplit01



![primitives-DemoSplit01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoSplit01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoSplit01.kt)

### primitives/DemoTear01



![primitives-DemoTear01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/primitives-DemoTear01Kt.png)

[source code](src/jvmDemo/kotlin/primitives/DemoTear01.kt)

### rectify/DemoRectifiedContour01



![rectify-DemoRectifiedContour01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/rectify-DemoRectifiedContour01Kt.png)

[source code](src/jvmDemo/kotlin/rectify/DemoRectifiedContour01.kt)

### rectify/DemoRectifiedContour02



![rectify-DemoRectifiedContour02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/rectify-DemoRectifiedContour02Kt.png)

[source code](src/jvmDemo/kotlin/rectify/DemoRectifiedContour02.kt)

### rectify/DemoRectifiedContour03



![rectify-DemoRectifiedContour03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/rectify-DemoRectifiedContour03Kt.png)

[source code](src/jvmDemo/kotlin/rectify/DemoRectifiedContour03.kt)

### rectify/DemoRectifiedContour04



![rectify-DemoRectifiedContour04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/rectify-DemoRectifiedContour04Kt.png)

[source code](src/jvmDemo/kotlin/rectify/DemoRectifiedContour04.kt)

### rectify/DemoRectifiedPath3D01



![rectify-DemoRectifiedPath3D01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/rectify-DemoRectifiedPath3D01Kt.png)

[source code](src/jvmDemo/kotlin/rectify/DemoRectifiedPath3D01.kt)

### text/DemoText01



![text-DemoText01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/text-DemoText01Kt.png)

[source code](src/jvmDemo/kotlin/text/DemoText01.kt)

### tunni/DemoTunniAdjuster01



![tunni-DemoTunniAdjuster01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/tunni-DemoTunniAdjuster01Kt.png)

[source code](src/jvmDemo/kotlin/tunni/DemoTunniAdjuster01.kt)

### tunni/DemoTunniPoint01



![tunni-DemoTunniPoint01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/tunni-DemoTunniPoint01Kt.png)

[source code](src/jvmDemo/kotlin/tunni/DemoTunniPoint01.kt)