summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-marble/CHANGES.md
blob: b041285cf3ce1d14d738baf482544ce11413faa6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# **CHANGES** #
# pst-marble v. 1.0 #
# 2018/10/19 #

    Source:      pst-marble.tex, pst-marble.sty, pst-marble.pro
    Author:      Aubrey Jaffer
    Maintainers: Jürgen Gilg, Manuel Luque
    Info:        Draw marble-like pattern with PSTricks
    License:     LPPL 1.3c

---
    
## Changes in v. 1.0: 

## Complete reorganization of the basic deformation commands 

We reorganized the marbling primitives to have consistent units
which model a 1 m by 1 m region of a much larger tank. All lengths are
in mm, velocities (in mm/s), angles (in degrees), angular velocity (in
degrees/s), and viscosity and circulation (in mm^2/s).

For a convex stylus or tine, **D** (in mm) is the ratio of its submerged
volume to its wetted surface area. For a long cylinder it is diameter.

The deformations take a single argument, **viscosity** (in mm^2/s), which is also
viscosity relative to 20 °C water. Negative viscosity specifies
(raster) reverse-marbling.

## /drop 

**\[ cx cy radinc \[ bgc \] \[ rgb \] /drop \]**

Replaces **/ink**; works as before.

## /offset ##

**\[ dx dy /offset \]**

As before.  Maybe should be changed to take angle and length.

## /stir 

**\[ cx cy \[ r \] w th D /stir \]**

replaces **/circle**.  Tines follow concentric circular tracks.

    cx, cy   Center coordinates in mm
    [ r ]    List of radii in mm
    w        Angular velocity
    th       Displacement at tines
    D        Tine diameter

## /vortex 

**\[ cx cy circ t /vortex \]**

Models a **Lamb-Oseen** vortex.

    cx, cy   Center coordinates in mm
    circ     Circulation (in mm^2/s) is a simple scale factor. 
    Typical value: 30e3 mm^2/s.
    t        Time after circulation impulse at center.  As t gets very large, 
    the whole surface returns to its original pattern, possibly with rigid 
    rotation. Typical value 10 s.

## /stroke 

**\[ bx by ex ey V D /stroke \]**

As before; short stroke.

    bx, by   Beginning of stroke    
    ex, ey   End of stroke
    V        Stylus velocity in mm/s
    D        Stylus diameter in mm.  Make larger to affect paint farther away.

## /rake 

**\[ angle \[ r \] V tU D /rake \]**

replaces **/line**.  Draws a stylus or parallel stylii across the tank.

    angle   Angle from y-axis in degrees; 0 is up.
    [ r ]   List of distances from center of image (0,0).
    V       Stylus velocity in mm/s
    tU      Distance points on the stylus track are moved.
    D       Stylus diameter in mm.  Make larger to affect paint farther away.

## /wiggle 

**\[ angle {func} /wiggle \]**

Parameters changed.

    angle    Wiggle will be perpendicular to angle from y-axis up.
    {func}   Input is distance in mm; output is wiggle displacement in mm.
    
## NEW ACTIONS

## random-drops

**\[ size \[ color \] count random-drops \]**

    count     Number of the drops
    size      Size of the drops
    color     Color of the drops

## random-drops-colors

**\[ size  count random-drops-colors \]**

    count     Number of the drops
    size      Size of the drops

## concentric-bands

**\[ cx  cy RadiusIncrement NumberOfBands  concentric-bands \]**

    cx, cy             Center coordinates
    RadiusIncrement    Multiplication coefficient between the bands
    NumberOfBands      Number of the elements within
                       the [array of colors] list
                       [array of colors]: this is the list of colors
                                          within the colors= key


## ADDITIONAL HINTS

Having stylus diameter, velocity, and viscosity as parameters means
this system has an extra degree of freedom. If you want to reduce the
width of the affected region of a rake by a factor of 10, either
reduce **V** by a factor of 10 or reduce **D** by a factor of 3.1 (sqrt 10).