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.