A Short Guide To Textual

You tell textual what to do via query parameters. Those are the bits at the end of the URL after the first ?. Query parameters look like this: key=value and are seperated with &. So, if you wanted to set the color and text parameters, it would look like this: ?color=turquoise&text=Textual.

Textual is stateful. When you change the font or color et al. it will be changed for every following text you specify. You may specify parameters multiple times. If, say, you wanted to write "RedBlue" with the words being their color, you might do: ?color=red&text=Red&color=blue&text=Blue (see it)

text

The text to draw. Parameters before this are applied to this text and parameters after this are applied to the next text.

info

Ignore all other parameters and get some information on the server

me

Get information on how you appear to the server

forceraw

Force the server to return the image instead of the HTML page.

font

Set the font to write subsequent text in.

weight; fontweight

What weight of font to use. Ex: thin, light, bold

style; fontstyle

What style of font to use. Ex: italic, oblique, normal

fs; fontsize

The size of the following texts in pixels, or suffix with pt for points.

c; color; colour

The color of the following texts. This will override pattern if it was previously set. See accepted color formats

pattern

Currently only accepts three pre-programmed pattern: trans, enby, ace. This will override color if it was previously set.

align

Sets the alignment of every text. Accepted values are: right, center, left

aspect

Force the image into the specified aspect ratio. Accepts floats.

bc; bcolor; bcolour

Background color. If set multiple times, the last one will be taken.

bpattern

Overrides bcolor

pad

Pad all sides of the image by this number of pixels

lh; lineheight

Adjust the height of following texts lines. "font" will use the line height the font suggests. "ratio 1.1" will multiple the fonts suggestion by 1.1

Colors

Hex (no #)

  • rrggbb
  • rrggbbaa
  • rgb
  • rgba

Named

  • transparent
  • black
  • white
  • red
  • green
  • blue
  • yellow
  • fuchsia magenta
  • aquacyan

authored by gennyble
source