flydraw(1)

💖 flydraw(1) 💖

okay so welcome to flydraw(1), bestie — this is the manual for an inline drawing tool, and by the end of this page you're gonna be drawing circles, plotting curves and feeling like a whole main character. no cap. ✨

🌸 NAME 🌸

flydraw — an inline drawing tool 🎨

✨ SYNOPSIS ✨

flydraw

🦋 DESCRIPTION 🦋

So flydraw is an inline drawing tool, and it uses libgd to output PNG, JPG and GIF files. iconic behaviour honestly. 💅

It parses its standard input for drawing commands, and every single command takes exactly one line. that's the whole vibe — feed it lines, get art. 🎀

🎨 DRAWING COMMANDS 🎨

heads up before we dive in: in all of the lines below, [color] can be either a color name, or 3 integers between 0 and 255 separated by commas, giving the values of red, green, blue. choose your fighter. 🌈

• animate fra,del,rep — this one is only available for WIMS OEF and doc, and it MUST appear on the very first line. it sets up animation for fra frames, with del seconds between frames, and rep repetitions (rep=0 means infinite repetition). forever and ever and ever. 🔁
• animstep n — sets up an integer that can be called in any evaluation. used for animation. > direct use of this command must be avoided under WIMS, so pls don't be that girl. 🙈
• arc x,y,w,h,a1,a2,[color] — an arc segment of an ellipse of width w and hight h centered at (x,y), from angle a1 to angle a2. yes it says "hight", we love her anyway. 🫶
• arrow x1,y1,x2,y2,l,[color] — an arrow (x1,y1)--->(x2,y2), where l is the length (in pixels) of the arrowhead. pointing, slaying, all of it. ➡️
• circle x,y,d,[color] — a circle with center (x,y) and diameter d (in pixels). ⭕
• comment — does nothing. literally nothing. a true icon of doing the absolute least. 💀
• copy x,y,x1,y1,x2,y2,[filename] — (synonym: insert) inserts 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] — inserts 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. glow up included. ✨
• darrow x1,y1,x2,y2,l,[color] — (synonym: dasharrow dashedarrow) a dashed arrow (x1,y1)- - ->(x2,y2), where l is the length (in pixels) of the arrowhead. the dashes are the fit. 👑
• dhline x,y,[color] — (synonym: dashedhorizontalline dashhorizontalline hdline horizontaldashedline) a dashed horizontal line through (x,y). ➖
• dline x1,y1,x2,y2,[color] — (synonym: dashedline dashline) a 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)... so many dashes, so little time. 🌟
• dvline x,y,[color] — (synonym: dashedverticaline dashverticalline vdline verticaldashedline) a dashed vertical line through (x,y). 🪡
• ellipse x,y,w,h,[color] — an ellipse with center (x,y), width w and height h. squished circle, still gorgeous. 💜
• fcircle x,y,d,[color] — (synonym: ball disk filledcircle) a filled circle with center (x,y) and diameter d (in pixels). solid. 🍓
• fellipse x,y,w,h,[color] — (synonym: filledellipse) a filled ellipse with center (x,y), width w and height h. 🧚
• fill x,y,[color] — (synonym: flood floodfill) flood fills the region containing (x,y) with the same original color, by color. 🪣
• filltoborder x,y,[color1],[color2] — flood fills by color2 the region containing (x,y) and bounded by color1. staying in your lane, literally. 🚧
• fpoly [color],x1,y1,x2,y2,x3,y3... — (synonym: filledpoly filledpolygon fpolygon) a filled polygon (x1,y1)-(x2,y2)-(x3,y3)... 🔺
• frect x1,y1,x2,y2,[color] — (synonym: filledrect fillecrectangle frectangle) a filled rectangle with corners (x1,y1) and (x2,y2). 🔲
• fsquare x,y,s,[color] — (synonym: filledsquare) a filled square with sides s (in pixels) and first corner at (x,y). ◼️
• ftriangle x1,y1,x2,y2,x3,y3,[color] — (synonym: filledtriangle) a filled triangle with vertices (x1,y1),(x2,y2),(x3,y3). 🔻
• hline x,y,[color] — (synonym: horizontalline) a horizontal line through (x,y). ➖
• interlace — sets an interlaced image. old-school cool, ngl. 📺
• killbrush — turns off brush selection for line drawing. bye bestie 👋
• killtile — turns off tile selection for filling. also bye 👋
• lattice x0,y0,x1,y1,x2,y2,n1,n2,[color] — a lattice of n1xn2 points starting with (x0,y0), with n1 rows in the direction of (x1,y1) and n2 rows in the direction of (x2,y2). the way it grids... 🕸️
• line x1,y1,x2,y2,[color] — (synonym: seg segment) a 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 — sets the line width to w (in pixels) for line drawing. thick. juicy. 🔥
• new x,y — sets a new image of size x,y. blank canvas era. 🖼️
• output [filename] — outputs the current image to [filename]. the moment of reveal. 🎁
• parallel x1,y1,x2,y2,xv,yv,n,[color] — n parallel lines starting from (x1,y1)---(x2,y2), with displacement (xv,yv). they're all matching, it's a coordinated group chat fit. 💞
• pixels [color],x1,y1,x2,y2,... — points (all of diameter 1) at (x1,y1), (x2,y2), ... ⚪
• plot [color],[formula] — (synonym: curve) plots a curve according to [formula], which can be either an explicit function of x, or a pair of parametric functions in t. math girlies rise 📈
• plotjump j — the plotted curve will jump if two consecutive points have a distance of more than j pixels. super useful to avoid plotting discontinuous functions as continuous. default value: 200. 🙅♀️
• plotstep n — (synonym: plotsteps tstep tsteps) sets 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) a polygon (x1,y1)-(x2,y2)-(x3,y3)... 📐
• range x1,x2,y1,y2 — sets the drawing range to [x1,x2] horizontally and [y1,y2] vertically. note that by default, the horizontal range is [0,xsize-1] and the vertical range is [ysize-1,0]. know your limits 💅
• rays [color],x0,y0,x1,y1,x2,y2... — line segments (x0,y0)---(x1,y1), (x0,y0)---(x2,y2), ... all radiating from one point. main character energy fr. ☀️
• rect x1,y1,x2,y2,[color] — (synonym: rectangle) a rectangle with corners (x1,y1) and (x2,y2). 🔳
• setbrush [filename] — uses the image [filename] as a brush for all line draws. 🖌️
• setpixel x,y,[color] — a point (of diameter 1 pixel) at (x,y). tiny but mighty. ✨
• setstyle [color1],[color2],... — sets the line style to color1,color2,... 🌈
• settile [filename] — uses the image [filename] as a tile for all filling commands. 🧱
• size x,y — sets the image size to x pixels horizontally and y pixels vertically. 📏
• square x,y,s,[color] — a square with sides s (in pixels) and first corner at (x,y). ⬜
• text [color],x,y,[font],[string] — (synonym: print string write) writes the string at (x,y), with font=small,medium,large or giant. the range of sizes, we love options. 🔤
• textup [color],x,y,[font],[string] — (synonym: stringup writeup) writes the string upwards at (x,y), with font=small,medium,large or giant. vertical text, very editorial. ↕️
• trange t1,t2 — (synonym: ranget) sets the t range to [t1,t2] for parametric curve plotting. defaults to [0,1]. 🌀
• transparent [color] — makes [color] a transparent color. ghost mode activated 👻
• triangle x1,y1,x2,y2,x3,y3,[color] — a triangle with vertices (x1,y1),(x2,y2),(x3,y3). 🔺
• vline x,y,[color] — (synonym: verticalline) a vertical line through (x,y). 🪜
• xrange x1,x2 — (synonym: rangex) sets the horizontal drawing range to [x1,x2]. defaults to [0,xsize-1]. ↔️
• yrange y1,y2 — (synonym: rangey) sets the horizontal drawing range to [y1,y2]. defaults to [ysize-1,0]. yes bestie, the original says "horizontal" here even though it's the y one — we're just reporting the lore exactly as it was written. 💀

👑 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. a total glow-up, honestly. 🦋

and that's the whole page, bestie 🫶 this was version 1.0, dated 16 June 2002 — yeah, she's vintage, she's iconic, she still slays. go draw something gorgeous with her. 🎀💖✨