Index of /code/art/examples

Examples

You can run these with the makefile: make examples.

Note: examples that depend on the PNG library (i.e. WFC) will not run in Saxon 12.0 unless you add additional JAR files (e.g. JDOM2) to the classpath. The makefile is set up to use $ALT-CLASSPATH here.

Note: examples that depend on writing files will not run in Saxon-JS as the EXPath file module is not available in that context.

Art and geometry

fish.xqy

Draws a simple picture of random fish with a random polynomial spiral over a neutral background.

Output is SVG; save to a file to view.

Demonstrating the use various geometric and artistic components:

• Randomization: ../core/random.xqy, ../types/distributions.xqy
• Paths and transforms: ../geo/path.xqy, ../geo/transform.xqy
• Fish: ../components/fish.xqy
• Backgrounds: ../components/backgrounds.xqy
• Polynomial spirals: ../shapes/paths.xqy

More: ../core/api.html, ../geo/api.html, ../components/api.html

fish.xsl

Same as fish.xqy, but using XSLT versions of the API.

render.xqy

Generates SVG from a few simple shapes. The scene consists of a couple of circles, a straight edge, a curved edge, a little text, and a dense adhoc colour fill.

The output is SVG; save to a file to view.

See ../svg/draw.xqy, ../geo/ellipse.xqy, ../geo/edge.xqy, ../types/text.xqy.

More: ../geo/api.html

render.xsl

Same as render.xqy, but using XSLT versions of the API.

tactile.xqy

Constructs a sample isohedral tiling.

Output is SVG; save to a file to view.

Takes command line parameters:

• type: what kind of tiling type to generate (see type/isohedral-tiling)

  • "random": pick a random tiling type (default)
  • "triangle": pick a random triangular tiling type
  • "sqaure": pick a random square tiling type
  • "pentagon": pick a random pentagonal tiling type
  • "hexagon": pick a random hexagonal tiling type
  • nn: nn is an integer, use that type

• edge: what kind of edges to draw

  • "default": use straight edges (default)
  • "random": use randomized edges
  • "wild": use wilder randomized edges (may have self-crossings)
  • "complex": like "wild" but with multiple segments for J edges

• parms: what kind of vertex parameters to use

  • "default": default vertex parameters (default)
  • "random": use randomly jittered vertex parameters

See ../tiling/isohedral-tiling.xqy, ../types/isohedral-tiling.xqy

tactile.xsl

Same as tactile.xqy, but using XSLT versions of the API.

tree.xqy

Draws a simple picture of random tree created with a stochastic L-system.

Output is SVG; save to a file to view.

• Randomization: ../core/random.xqy, ../types/distributions.xqy
• Paths: ../geo/path.xqy
• L-systems: ../shapes/systems.xqy

More: ../core/api.html, ../geo/api.html, ../shapes/api.html

tree.xsl

Same as tree.xqy, but using XSLT versions of the API.

wfc.xqy

Simple adhoc tiling using Wave Function Collapse algorithm (explainer at https://mathling.com/art/20220719_wfc.html).

Output is an SVG file representing the tiling. If the collapse failed, you'll see "pick failed" in the output and a blank canvas.

See ../wfc/adhoc-tiled-model.xqy.

More ../wfc/api.html.

wfc.xsl

Same as wfc.xqy, but using XSLT versions of the API.

Algorithms

delaunay.xqy

Contruct the Delaunay triangulation of a set of random points, or the Voronoi cells (dual of the triangulation).

Output is SVG of the triangulation or cells plus the seed points. Save to a file to view.

The parameter "mode" controls whether to show triangulation or Voronoi cells:

• "delaunay" (default) shows Delaunay triangulation
• "voronoi" shows Voronoi cells

delaunay.xsl

Same as delaunay.xqy, but using XSLT versions of the API.

layout.xqy

Layout a set of randomly connected random points using ARF algorithm.

Output is SVG file with the original graph (silver) and the laid out graph (blue). Save to file to view.

See ../geo/arf.xqy.

More ../geo/api.html.

layout.xsl

Same as layout.xqy, but using XSLT versions of the API.

contours.xqy

Contruct simple contours (unconnected edges) of the rounded union of two random circles.

Output is SVG of the contour edges. Save to a file to view.

contours.xsl

Same as contours.xqy, but using XSLT versions of the API.

splittree.xqy

Computes a fair split tree over a set of points, and then a well-separated pairwise decomposition and spanning edges with two different distance metrics.

Output is adhoc XML showing the splits.

See ../geo/rectangle.xqy, ../geo/splittree.xqy, ../geo/wspd.xqy.

More ../geo/api.html.

splittree.xsl

Same as splittree.xqy, but using XSLT versions of the API.

Entity matching and extraction

compile.xqy

Demonstrates compilation of entity dictionary as JSON from text file.

Output is the compiled JSON entity dictionary suitable for use by entity:extract() or entity:markup().

See ../string/entity.xqy.

More ../string/api.html.

compile.xsl

Same as compile.xqy, but using XSLT versions of the API.

extract.xqy

Constructs an ad hoc entity dictionary of dramatis personae and uses it to extract and count instances of those names in Hamlet.

Output is text of names and their counts.

See ../string/aho.xqy.

More ../string/api.html.

extract.xsl

Same as extract.xqy, but using XSLT versions of the API.

tag.xqy

Applies full entity markup to all matches for all nouns in the compiled noun entity dictionary to the play Hamlet.

See ../string/entity.xqy/

More ../string/api.html.

Images

dither.xqy

Reads an image, dithered, and writes it out again as a P3 file. P3 files are textual raw image files: they can be converted and read by some programs such as ImageMagick, Gimp, or InkScape.

Requires EXPath binary and file functions.

Output is in two files: examples/dither_raw.p3 and examples/dither_dither4.p3, written to $TMPDIR (default is /tmp).

See ../image/dithering.xqy, ../image/ppm.xqy.

More ../image/api.html.

dither.xsl

Same as dither.xqy, but using XSLT versions of the API.

Output is in two files: examples/dither_raw.xsl.p3 and examples/dither_dither4.xsl.p3, written to $TMPDIR (default is /tmp).

imagemap.xqy

Constructs a simple colour map based on Perlin noise and renders it out as a P3, P6, and PAM file. P3 files are textual raw image files. P6 files are binary raw image files. PAM files are binary raw image files with more capabilities. They all can be converted and read by some programs such as ImageMagick, Gimp, or InkScape.

Requires EXPath binary and file functions.

Output is in three files: examples/imagemap.p3, examples/imagemap.p6, and examples/imagemap.pam, written to $TMPDIR (default is /tmp).

See ../image/ppm.xqy, ../noise/perlin.xqy, ../noise/modifiers.xqy, ../noise/noise-map.xqy.

More ../image/api.html.

imagemap.xsl

Same as imagemap.xqy, but using XSLT versions of the API.

Output is in three files: examples/imagemap.xsl.p3, examples/imagemap.xsl.p6, and examples/imagemap.xsl.pam, written to $TMPDIR (default is /tmp).

sdf.xqy

Computes the colouring of a simple 3D scene using SDF functions to construct the colour matrix and output the result as a P6 file. A P6 file is a binary raw image file that can be converted and read by some programs such as ImageMagick, Gimp, or InkScape.

Requires EXPath binary and file functions.

This takes a while: the larger the canvas the longer it takes!

Output is in a file: examples/sdf.p6, written to $TMPDIR (default is /tmp).

See ../sdf/sdf.xqy, ../sdf/sd3.xqy.

sdf.xsl

Same as sdf.xqy, but using XSLT versions of the API.

Output is in a file: examples/sdf.xsl.p6, written to $TMPDIR (default is /tmp).

Randomization Testing

loop.xqy

Tests random selection in a loop. Returns a textual description of what happened.

See ../core/random.xqy.

More ../core/api.html.

loop.xsl

Same as loop.xqy, but using XSLT versions of the API.