NAME
flydraw - an inline drawing tool
SYNOPSIS
flydraw
DESCRIPTION
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.
DRAWING COMMANDS
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).
comment
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].
AUTHORS
Flydraw was completely rewritten to replace a public domain program
called Fly by XIAO Gang from the University of Nice (France) in April
2000.