Racket Libraries

• text
• hline, vline
• frame
• ellipse, circle, filled-ellipse, disk
• rectangle, filled-rectangle
• rounded-rectangle
• filled-rounded-rectangle
• bitmap: read a bitmap image
• arrow, arrowhead

Use pin to create lines connecting picts

• pin-line, pin-arrow-line, pin-arrows-line: add lines onto a pict. It finds positions in the src and dst picts, and can set angle to create curve

• various of append
  • syntax: v and h, then alignment
  • vl, vc, vr, ht, htl, hc, hbl, hb
  • v and h for vertical and horizontal
  • t,b for top, bottom
  • l,c,r for left, center, right
• superimpose
  • Syntax: horizontal alignment, vertical alignment
  • lt,ltl,lc,lbl,lb,ct,ctl,cc,cbl,cb,rt,rtl,rc,rbl,rb
  • l,c,r for left, center, and right
  • t,b for top and bottom
• pin
  • pin-over
  • pin-under
• table

• scale, scale-to-fit, scale/improve-new-text
• rotate
• ghost: does not draw (invisible), but use the size
• cellophane: make is semi-transparent
• clip, inset/clip
• freeze: to bitmap

The followings can be used to specify parameters

• linewidth
• linestyle
• colorize
• black-and-white

• inset
• clip-decent
• lift-above-baseline
• drop-below-ascent
• baseless
• refocus: focus on the top most sub-pict
• panorama: enclose all sub-picts
• use-last, use-last*

• with -find suffix
  • lt,ltl,lc,lbl,lb,ct,ctl,cc,cbl,cb,rt,rtl,rc,rbl,rb

tree-layout creates a layout containing edges. The layout can be rendered to pict by

• naive-layered (seems to be good)
• binary-tidier
• hv-alternating

The length is measured in terms of pixels, angle means degree. When using names, both string and symbol are acceptable, and case-insensitive.

Mode can be 'solid or 'outline. The string format is also supported. Solid fills, outline only draws the outside line. A integer between 0 and 255 instead will indicate the transparency.

Color can be name or color structure. If the name is not recognized, no error is reported, and black is used. The complete list (plus transparent) is in the document of color-database<%>. This is an interface, defined in racket/draw.

The color structure is

(struct color (red green blue alpha))

In many places, the color also accepts a pen. pen is a structure. It seems only for drawing lines, so outline mode will support it. Its definition is

(struct pen (color width style cap join))

style

solid, dot, long-dash, short-dash, dot-dash

cap

round, projecting, butt

join

round, bevel, miter

When doing alignment, you can use pinhole, only if all the images have a pinhole. You can add pinhole to image by

• center-pinhole image
• put-pinhole x y image
• clear-pinhole

And retrieve pinhole by

• pinhole-x
• pinhole-y

• shape
  • (circle radius mode color)
  • (ellipse width height mode color)
  • triangle
    • (triangle side-length mode color)
    • right-triangle
    • isosceles-triangle
    • triangle/sss
  • square x
  • rectangle x y
  • rhombus x θ
  • star
    • star x
    • star-polygon
    • radial-star
  • polygon
    • regular-polygon
    • polygon
    • add-polygon
    • scene+polygon
• line
  • (line x y color): draw a line from (0,0) to (x,y).
  • (add-line image x1 y1 x2 y2 color): add line to image, from (x1,y1) to (x2,y2)
  • add-curve
  • add-solid-curve
• text
  • (text string font-size color)
  • text/font: this will use a complete font specification, including
    • face: which font name
    • family: default, script, modern, etc
    • style: normal, italic
    • weight: normal, bold, light
    • underline?: #t #f

• overlay accepts a sequence of images, with the first being on top. Images are aligned on their center.
• overlay/align x-place y-place controls where to align the images.
  • x: left, right, middle, center, pinhole
  • y: top, bottom, middle, center, baseline, pinhole
• overlay/offset i1 x y i2: moves i2 by (x,y) compared to (0,0), thus to down right
• overlay/align/offset combines both options
• overlay/xy: what's the difference from offset?
• overlay/pinhole

There's also an underlay version that does the reverse order, for all above.

• beside accepts images, and placing them in horizontal row, aligned on their centers
• beside/align y
• above: in a vertical row
• above/align x

Typically you place images on a scene. If an image is placed (using those place functions) or add lines (using scene+XXX) on scene, it is cropped based on the size of scene. You can still compose the image by overlay or add-line, but those does not respect the size of scene.

• empty-scene x y color
• place-image image x y scene: the (x,y) is according to the top-left corner of scene
• place-image/align image
• place-images: just a list of images and a list of positions
• place-images/align
• scene+line: add a line to the scene
• scene+curve

• rotate angle image
• scale factor image
• scale/xy: using different factor for x and y
• flip-horizontal image
• flip-vertical image
• crop x y width height image
• crop/align
• frame image: return an image with a black frame around the bounding box of the it. Even if the image might be a circle, the bounding box is still rectangle.
• color-frame color image

You can load a bit map file by (bitmap filename), or (bitmap/url url) to download from web. For a vector image you created in racket, you can "freeze" it to bitmap by freeze image.

Finally, you can save image to file by

• save-image image filename [width height]: png
• save-svg-image image filename [width height]: svg

• image-width
• image-height
• image-baseline

The package is html-parsing. It has only one function, html->xexp.

The xexp is a list like this:

(*TOP* (html (head (title) (title "whatever"))
  (body "\n"
    (a (@ (href "url")) "link"))))

The xexp needs to use sxml (needs install) package to parse. sxpath is a function for XPath like query. Use like this

((sxpath '(html body table tr td a @ (*or* href title)))
 table)

sxpath itself returns a function, apply that function on an xexp data, a list will be returned for matched results.

1. the xexp must begin with *TOP*, the query result will not have it. So if you want to parse it again, construct it by `(*TOP* ,x)
2. the xpath starts from root (html)
3. you can use '(// table) to query tables at arbitrary level

require the package net/url (needs install) and net/url-string. First, construct a url by string->url, then, open input port by get-pure-port, this is using GET method. The port can be used as input, e.g. port->string. How to download binary file, like pdf? It should be bytes streaming, so maybe

• copy-port in out
• port->bytes then write-bytes

The call/input-url URL connect handle will call handle on the port, and close the port on return. The connect is a procedure, e.g. get-pure-port.