Draw commands#

Draw commands are the bread and butter of ttt. Here's all the wonderful things you can do with this command group:

  • Draw images and built-in Icons:

    โฑ ttt draw icon -d 39


     ๐œทฅ๐œถฌโ–‚โ–‚๐œท–๐œตˆ 
 ๐œทฅโ–›โ–œโ–ˆโ–€๐œตˆ 
 โ–€๐œด‡๐œดฅ๐Ÿฎ…๐œด”โ–˜ 
๐Ÿฏง๐œด—โ–Ÿโ–€โ–œโ–ž๐œดด

  • Cut off sprites from sprite atlases:

    โฑ ttt draw atlas icons.png -w 16 -h 16 -ox 8 -oy 8 -gx 8 -gy 8 -i 318


    โ–—๐œทŸ๐œทŸ๐œทŸ๐œทŸ๐œทŸ๐œทž 
๐œถ–๐œด”๐œถท๐œด†๐œด†๐œด†๐œถจ 
โ–๐œบซ    โ– 
โ–๐œทคโ–†โ–†โ–†๐œท‡๐œทš

  • Draw banners of repeating patterns:

    โฑ ttt draw banner -d flo1


    ๐œตท๐œท“โ–ˆโ–€๐Ÿฎ…๐Ÿฎ…๐œด—    ๐œทกโ–†๐œทž    ๐œดฆ๐Ÿฎ…๐Ÿฎ…โ–€โ–ˆ๐œถฟ๐œต€๐œตท๐œท“โ–ˆโ–€๐Ÿฎ…๐Ÿฎ…๐œด—    ๐œทกโ–†๐œทž    ๐œดฆ๐Ÿฎ…๐Ÿฎ…โ–€โ–ˆ๐œถฟ๐œต€๐œตท๐œท“โ–ˆโ–€๐Ÿฎ…๐Ÿฎ…๐œด—    ๐œทกโ–†๐œทž    ๐œดฆ๐Ÿฎ…๐Ÿฎ…โ–€โ–ˆ๐œถฟ๐œต€๐œตท๐œท“
โ–ˆโ–€โ–ˆโ–ˆโ–†โ–– ๐œทฅโ–ˆ๐œทค๐œบฃ๐œถซโ–ˆ๐œตฐ๐œบ ๐œทฅโ–ˆ๐œทค โ–—โ–†โ–ˆโ–ˆโ–€โ–ˆโ–ˆโ–€โ–ˆโ–ˆโ–†โ–– ๐œทฅโ–ˆ๐œทค๐œบฃ๐œถซโ–ˆ๐œตฐ๐œบ ๐œทฅโ–ˆ๐œทค โ–—โ–†โ–ˆโ–ˆโ–€โ–ˆโ–ˆโ–€โ–ˆโ–ˆโ–†โ–– ๐œทฅโ–ˆ๐œทค๐œบฃ๐œถซโ–ˆ๐œตฐ๐œบ ๐œทฅโ–ˆ๐œทค โ–—โ–†โ–ˆโ–ˆโ–€โ–ˆโ–ˆโ–€
โ–ˆโ–Œโ–๐Ÿฎ…๐Ÿฎ…โ–˜ ๐œด…๐œดฆ๐œถซ๐œทค๐œทฅ๐Ÿฎ…๐œทค๐œทฅ๐œตฐ๐œด—๐œด‚ โ–๐Ÿฎ…๐Ÿฎ…โ–˜โ–โ–ˆโ–ˆโ–Œโ–๐Ÿฎ…๐Ÿฎ…โ–˜ ๐œด…๐œดฆ๐œถซ๐œทค๐œทฅ๐Ÿฎ…๐œทค๐œทฅ๐œตฐ๐œด—๐œด‚ โ–๐Ÿฎ…๐Ÿฎ…โ–˜โ–โ–ˆโ–ˆโ–Œโ–๐Ÿฎ…๐Ÿฎ…โ–˜ ๐œด…๐œดฆ๐œถซ๐œทค๐œทฅ๐Ÿฎ…๐œทค๐œทฅ๐œตฐ๐œด—๐œด‚ โ–๐Ÿฎ…๐Ÿฎ…โ–˜โ–โ–ˆโ–ˆโ–Œ
โ–€๐œบจ   ๐œถ–โ–ˆโ–ˆ๐œทค๐œทฅโ–›โ–—โ–†โ––โ–œ๐œทค๐œทฅโ–ˆโ–ˆ๐œตˆ   ๐œบซโ–€โ–€๐œบจ   ๐œถ–โ–ˆโ–ˆ๐œทค๐œทฅโ–›โ–—โ–†โ––โ–œ๐œทค๐œทฅโ–ˆโ–ˆ๐œตˆ   ๐œบซโ–€โ–€๐œบจ   ๐œถ–โ–ˆโ–ˆ๐œทค๐œทฅโ–›โ–—โ–†โ––โ–œ๐œทค๐œทฅโ–ˆโ–ˆ๐œตˆ   ๐œบซโ–€โ–€๐œบจ
โ–ˆ๐œตˆ โ–‚โ–‚๐œบซโ–€โ–€๐œตท๐œท–โ–ˆโ–„๐œถฎโ–„โ–ˆ๐œท‚๐œต€โ–€โ–€๐œบจโ–‚โ–‚ ๐œถ–โ–ˆโ–ˆ๐œตˆ โ–‚โ–‚๐œบซโ–€โ–€๐œตท๐œท–โ–ˆโ–„๐œถฎโ–„โ–ˆ๐œท‚๐œต€โ–€โ–€๐œบจโ–‚โ–‚ ๐œถ–โ–ˆโ–ˆ๐œตˆ โ–‚โ–‚๐œบซโ–€โ–€๐œตท๐œท–โ–ˆโ–„๐œถฎโ–„โ–ˆ๐œท‚๐œต€โ–€โ–€๐œบจโ–‚โ–‚ ๐œถ–โ–ˆโ–ˆ๐œตˆ
โ–ˆโ–˜โ–Ÿโ–ˆโ–ˆโ–Œ ๐œทฅโ–ˆโ–ˆ๐œด๐œท–โ–ˆ๐œท‚๐œดขโ–ˆโ–ˆ๐œทค โ–โ–ˆโ–ˆโ–™โ–โ–ˆโ–ˆโ–˜โ–Ÿโ–ˆโ–ˆโ–Œ ๐œทฅโ–ˆโ–ˆ๐œด๐œท–โ–ˆ๐œท‚๐œดขโ–ˆโ–ˆ๐œทค โ–โ–ˆโ–ˆโ–™โ–โ–ˆโ–ˆโ–˜โ–Ÿโ–ˆโ–ˆโ–Œ ๐œทฅโ–ˆโ–ˆ๐œด๐œท–โ–ˆ๐œท‚๐œดขโ–ˆโ–ˆ๐œทค โ–โ–ˆโ–ˆโ–™โ–โ–ˆโ–ˆโ–˜
๐œดฆ๐œถซโ–ˆโ–€๐œถฎโ–‚๐œบฃ๐œด…โ–€๐œด‚ โ–ˆโ–ˆโ–ˆ ๐œด…โ–€๐œด‚๐œบ โ–‚๐œถฎโ–€โ–ˆ๐œตฐ๐œด—๐œดฆ๐œถซโ–ˆโ–€๐œถฎโ–‚๐œบฃ๐œด…โ–€๐œด‚ โ–ˆโ–ˆโ–ˆ ๐œด…โ–€๐œด‚๐œบ โ–‚๐œถฎโ–€โ–ˆ๐œตฐ๐œด—๐œดฆ๐œถซโ–ˆโ–€๐œถฎโ–‚๐œบฃ๐œด…โ–€๐œด‚ โ–ˆโ–ˆโ–ˆ ๐œด…โ–€๐œด‚๐œบ โ–‚๐œถฎโ–€โ–ˆ๐œตฐ๐œด—๐œดฆ๐œถซ
๐œด‡๐œบซโ–€โ–€โ–€โ–€โ–€    ๐œบซ๐Ÿฎ‚๐œบจ    โ–€โ–€โ–€โ–€โ–€๐œบจ๐œดˆ๐œด‡๐œบซโ–€โ–€โ–€โ–€โ–€    ๐œบซ๐Ÿฎ‚๐œบจ    โ–€โ–€โ–€โ–€โ–€๐œบจ๐œดˆ๐œด‡๐œบซโ–€โ–€โ–€โ–€โ–€    ๐œบซ๐Ÿฎ‚๐œบจ    โ–€โ–€โ–€โ–€โ–€๐œบจ๐œดˆ๐œด‡๐œบซ

ttt draw image#

Usage:

ttt draw image [OPTIONS] FILE | URL

Draw a picture provided by the given FILE or URL.

Options:

Name Type Description Default
--invert boolean Draw using inverted colors. False
--braille boolean Draw using braille dots instead of block characters. False
-o,
--outline		 "none" | "soft" | "hard" | "shadow" Draw using an outline effect. This option can be repeated. None
--help boolean Show this message and exit. False

ttt draw icon#

Usage:

ttt draw icon [OPTIONS]

Draw a built-in icon.

Icons by PiiiXL (https://piiixl.itch.io).

Options:

Name Type Description Default
-d,
--design		 text Icon design number or alias. Use command 'list icons' to see all icons. 31
--invert boolean Draw using inverted colors. False
--braille boolean Draw using braille dots instead of block characters. False
-o,
--outline		 "none" | "soft" | "hard" | "shadow" Draw using an outline effect. This option can be repeated. None
--help boolean Show this message and exit. False

ttt draw atlas#

Usage:

ttt draw atlas [OPTIONS] FILE | URL

Draw a sprite from the sprite atlas provided by the given FILE or URL.

Options for width, height, offsets, and gaps are used to define the sprite layout, and the index option specifies a particular sprite to draw. If no index is provided, all sprites are drawn consecutively.

Options:

Name Type Description Default
-w,
--width		 integer Width of each sprite in the atlas (in pixels). required
-h,
--height		 integer Height of each sprite in the atlas (in pixels). required
-ox,
--offset-x		 integer Horizontal offset from the top-left corner of the atlas to the first sprite (in pixels). Default is 0. 0
-oy,
--offset-y		 integer Vertical offset from the top-left corner of the atlas to the first sprite (in pixels). Default is 0. 0
-gx,
--gap-x		 integer Horizontal gap between sprites in the atlas (in pixels). Default is 0. 0
-gy,
--gap-y		 integer Vertical gap between sprites in the atlas (in pixels). Default is 0. 0
-i,
--index		 integer Index of the sprite to draw (0-based). If not provided, all sprites are drawn consecutively. 0
--invert boolean Draw using inverted colors. False
--braille boolean Draw using braille dots instead of block characters. False
-o,
--outline		 "none" | "soft" | "hard" | "shadow" Draw using an outline effect. This option can be repeated. None
--help boolean Show this message and exit. False

ttt draw banner#

Usage:

ttt draw banner [OPTIONS]

Draw a full-width banner using repeating patterns.

Patterns by Lettercore (https://lettercore.itch.io).

Options:

Name Type Description Default
-l,
--lines		 integer Number of text lines to fill (overriden by '-repeat'). None
-r,
--repeat		 integer range [1, โˆž) Repeat the full pattern x times. None
-d,
--design		 text Pattern design number or alias. Use command 'list patterns' to see all patterns. flo1
--invert boolean Draw using inverted colors. False
--braille boolean Draw using braille dots instead of block characters. False
-o,
--outline		 "none" | "soft" | "hard" | "shadow" Draw using an outline effect. This option can be repeated. None
--help boolean Show this message and exit. False