flydraw - an inline drawing tool
flydraw is an inline drawing tool, which uses libgd to
output PNG, JPG, GIF files. It parse its standard input for drawing
commands. Each command takes one line.
In the following lines, [color] may be either a color name, or 3
integers between 0 and 255, separated by commas, for the values of
red,green,blue.
- animate
fra,del,rep
- This command is only available for WIMS OEF and doc, and MUST appear on
the first line. Set up animation for fra frames, with del seconds between
frames, and rep repetitions (rep=0 means infinite repetition).
- animstep
n
- Set up an integer which can be called in any evaluation. Used for
animation. Direct use of this command must be avoided under WIMS.
- arc
x,y,w,h,a1,a2,[color]
- Arc segment of an ellipse of width w and hight h centered at (x,y), from
angle a1 to angle a2.
- arrow
x1,y1,x2,y2,l,[color]
- Arrow (x1,y1)--->(x2,y2), where l is the length (in pixels) of
arrowhead.
- circle
x,y,d,[color]
- Circle of center (x,y) and diameter d (in pixels).
- Does nothing.
- copy
x,y,x1,y1,x2,y2,[filename]
- (Synonym: insert) Insert the region from (x1,y1) to (x2,y2) (in
pixels) of [filename] to (x,y). If x1=y1=x2=y2=-1, the whole [filename] is
copied.
- copyresized
x1,y1,x2,y2,dx1,dy1,dx2,dy2,[filename]
- Insert the region from (x1,y1) to (x2,y2) (in pixels) of [filename],
possibly resized, to the region of (dx1,dy1) to (dx2,dy2). If
x1=y1=x2=y2=-1, the whole [filename] is copied and resized.
- darrow
x1,y1,x2,y2,l,[color]
- (Synonym: dasharrow dashedarrow) Dashed arrow (x1,y1)- -
->(x2,y2), where l is the length (in pixels) of arrowhead.
- dhline
x,y,[color]
- (Synonym: dashedhorizontalline dashhorizontalline hdline
horizontaldashedline) Dashed horizontal line through (x,y).
- dline
x1,y1,x2,y2,[color]
- (Synonym: dashedline dashline) Dashed line segment
(x1,y1)---(x2,y2).
- dlines
[color],x1,y1,x2,y2,x3,y3...
- (Synonym: dashedlines) dashlines n dashed line segments
(x1,y1)---(x2,y2)---(x3,y3)...
- dvline
x,y,[color]
- (Synonym: dashedverticaline dashverticalline vdline
verticaldashedline) Dashed vertical line through (x,y).
- ellipse
x,y,w,h,[color]
- Ellipse with center (x,y), width w and height h.
- fcircle
x,y,d,[color]
- (Synonym: ball disk filledcircle) Filled circle of center (x,y) and
diameter d (in pixels).
- fellipse
x,y,w,h,[color]
- (Synonym: filledellipse) Filled ellipse with center (x,y), width w
and height h.
- fill
x,y,[color]
- (Synonym: flood floodfill) Flood fill the region containing (x,y)
with the same original color, by color.
- filltoborder
x,y,[color1],[color2]
- Flood fill by color2 the region containing (x,y) and bounded by
color1.
- fpoly
[color],x1,y1,x2,y2,x3,y3...
- (Synonym: filledpoly filledpolygon fpolygon) Filled polygon
(x1,y1)-(x2,y2)-(x3,y3)...
- frect
x1,y1,x2,y2,[color]
- (Synonym: filledrect fillecrectangle frectangle) Filled rectangle
with corners (x1,y1) and (x2,y2).
- fsquare
x,y,s,[color]
- (Synonym: filledsquare) Filled square with sides s (in pixels) and
first corner at (x,y).
- ftriangle
x1,y1,x2,y2,x3,y3,[color]
- (Synonym: filledtriangle) Filled triangle with vertices
(x1,y1),(x2,y2),(x3,y3).
- hline
x,y,[color]
- (Synonym: horizontalline) Horizontal line through (x,y).
- interlace
- Set interlaced image
- killbrush
- Turns off brush selection for line drawing.
- killtile
- Turns off tile selection for filling.
- lattice
x0,y0,x1,y1,x2,y2,n1,n2,[color]
- A lattice of n1xn2 points starting with (x0,y0), with n1 rows in direction
of (x1,y1) and n2 rows in direction of (x2,y2).
- line
x1,y1,x2,y2,[color]
- (Synonym: seg segment) Line segment (x1,y1)---(x2,y2).
- lines
[color],x1,y1,x2,y2,x3,y3...
- n line segments (x1,y1)---(x2,y2)---(x3,y3)...
- linewidth
w
- Set line width to w (in pixels) for line drawing.
- new x,y
- Set a new image of size x,y.
- output
[filename]
- Output the current image to [filename].
- parallel
x1,y1,x2,y2,xv,yv,n,[color]
- n parallel lines starting from (x1,y1)---(x2,y2), with displacement
(xv,yv).
- pixels
[color],x1,y1,x2,y2,...
- Points (all of diameter 1) at (x1,y1), (x2,y2), ...
- plot
[color],[formula]
- (Synonym: curve) Plot a curve according to [formula] which can be
either an explicit function of x, or a pair of parametric functions in
t.
- plotjump
j
- Plotted curve willjump is two consecutive points have distance more than j
pixels. Useful to avoid plotting discontinuous functions as continuous.
Default value: 200.
- plotstep
n
- (Synonym: plotsteps tstep tsteps) Set the number of point
computations in curve plot. Defaults to 100.
- point
x,y,[color]
- A (fat) point at (x,y), whose diameter is equal to linewidth. points
[color],x1,y1,x2,y2,... (Fat) points at (x1,y1), (x2,y2), ..., whose
diameters are equal to linewidth.
- poly
[color],x1,y1,x2,y2,x3,y3...
- (Synonym: polygon) Polygon (x1,y1)-(x2,y2)-(x3,y3)...
- range
x1,x2,y1,y2
- Set the drawing range to [x1,x2] horizontally and [y1,y2] vertically. Note
that by default, horizontal range is [0,xsize-1] and vertical range is
[ysize-1,0].
- rays
[color],x0,y0,x1,y1,x2,y2...
- Line segments (x0,y0)---(x1,y1), (x0,y0)---(x2,y2), ...
- rect
x1,y1,x2,y2,[color]
- (Synonym: rectangle) Rectangle with corners (x1,y1) and
(x2,y2).
- setbrush
[filename]
- Use the image [filename] as a brush for all line draws.
- setpixel
x,y,[color]
- A point (of diameter 1 pixel) at (x,y).
- setstyle
[color1],[color2],...
- Set the line style to color1,color2,...
- settile
[filename]
- Use the image [filename] as a tile for all filling commands.
- size x,y
- Set the image size to x pixels horizontally and y pixels vertically.
- square
x,y,s,[color]
- Square with sides s (in pixels) and first corner at (x,y).
- text
[color],x,y,[font],[string]
- (Synonym: print string write) Write the string at (x,y), with
font=small,medium,large or giant.
- textup
[color],x,y,[font],[string]
- (Synonym: stringup writeup) Write upwards the string at (x,y), with
font=small,medium,large or giant.
- trange
t1,t2
- (Synonym: ranget) Set the t range to [t1,t2] for parametric curve
plotting. Defaults to [0,1].
- transparent
[color]
- Makes [color] a transparent color.
- triangle
x1,y1,x2,y2,x3,y3,[color]
- Triangle with vertices (x1,y1),(x2,y2),(x3,y3).
- vline
x,y,[color]
- (Synonym: verticalline) Vertical line through (x,y).
- xrange
x1,x2
- (Synonym: rangex) Set the horizontal drawing range to [x1,x2].
Defaults to [0,xsize-1].
- yrange
y1,y2
- (Synonym: rangey) Set the horizontal drawing range to [y1,y2].
Defaults to [ysize-1,0].
Flydraw was completely rewritten to replace a public domain
program called Fly by XIAO Gang from the University of Nice (France) in
April 2000.