NAME

dreamcatcher.pl - generate random povray dreamcatchers

download the script


SYNOPSIS

dreamcatcher.pl [-radius=<radius>] [-branches=<nbr_branches>] [-elasticity=<elasticity>] [-points=<nbr_points>] [-skip=<probability>] [-singleskip] [-noise=<noise_level>] [-string_thickness=<size>] [-hoopsize=<size>] [-nohoop] [-support=<file>] [-output=<file>]


DESCRIPTION

Generate POVRAY code for a dreamcatcher.

-radius=<radius>

Radius of the dreamcatcher's web. Defaults to 1

-elasticity=<elasticity>

Elasticity of the web's string. Takes a value between 0 and 1. 0 means no elasticity at all, and 1 means infinite elasticity. Defaults to 0.05


-elasticity=0

-elasticity=0.2

-elasticity=0.5
-branches=<nbr_branches>

The numbers of points by which the web is tied to the hoop. Defaults to 9.


-branches=4

-branches=6

-branches=15
-points=<nbr_points>

The number of nodes in the web. Defaults to the number of branches times 10.

-skip=<probability>

The probability of a node of the web to be skipped.


-skip=0.05

-skip=0.1

-skip=0.2
-singleskip

Prevents two consecutive points to be skipped.


-skip=0.1 -singleskip
-noise=<noise_level>

How irregular the weaving should be. A value of 0 gives a perfectly regular weaving, and 1 is pretty noisy. Defauts to 0.05.


-noise=0

-noise=0.1

-noise=0.5
-string_thickness=<size>

Thickness of the web's string. Defaults to 0.005.

-hoopsize=<size>

Thickness of the hoop. Default to 0.03.

-output=<file>

Writes the generated code to a file instead of sprouting it on stdout.

-support=<file>

Instead of assuming a circular frame, takes the coordinates in <file> as the support points for the web. The file format consists of one coordinate per line. Coordinates can be entered as 2D (X, Y), or 3D (X, Y, Z). Lines beginning with a # are ignored.

Example:

        # how about a cubic web?
        1   1  1 
        1   1 -1
        -1  1 -1
        -1  1  1
        -1 -1  1
        1  -1  1
        1  -1 -1
        -1 -1 -1

cubic frame.

If the -support argument is used, no hoop shall be created.

-nohoop

Only create the dreamcatcher's web, without the hoop.


AUTHOR

Yanick Champoux (yanick@cpan.org)


VERSION

Version 0.3, December 28th, 2006.