Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
test
.gitignore
LICENSE
README.rdoc
Rakefile
textorize.gemspec

README.rdoc

textorize: for a more beautiful web

Official homepage: textorize.org

textorize produces beautifully subpixel antialiased text graphics on OS X, through a Rubycocoa Ruby script.

Output format is always PNG.

Learn more

Visit textorize.org and view the presentation on why this is awesome and how it compares to other “web typography” solutions and techniques.

Install

Grab the textorize gem, and you're done:

$ gem install textorize

This will install the textorize Ruby Gem, and the textorize command line tool.

textorize used gemcutter, so if you haven't installed it yet, do:

$ gem install gemcutter

If you're not using the default ruby environment on OS X, you'll need to install RubyCocoa.

Here's how: rubycocoa.sourceforge.net/GettingStarted

Usage (command line tool)

Usage: textorize [options] string
    -f, --font=[FONT]                Font name
    -s, --size=[SIZE]                Font size in point
    -l, --lineheight=[HEIGHT]        Line height in point
    -t, --ligatures=[TYPE]           Ligatures usage: all, standard or off
        --list-fonts                 List available fonts
    -k, --kerning=[VALUE]            Kerning adjustment
    -p, --padding=[VALUE]            Padding in px
    -o, --output=[FILENAME]          Specify filename for saving
    -b, --obliqueness=[ANGLE]        Slant angle
    -c, --color=[COLOR]              Render text in specific color (CSS color value)
    -g, --background=[COLOR]         Render background in specific color (CSS color value)
    -a, --smoothing=[VALUE]          Font smoothing: 0=no subpixel AA, 1=light, 2=normal, 3=strong
    -h, --help                       Display this message and exit

The color parameters take any CSS color, in #abc, #aabbcc, rgb(1,2,3) or rgba(1,2,3,0.5) format.

Examples

textorize -f"Gotham" -s200 Hello

textorize -fLucida\ Grande -s150 --color=rgba\(12,56,99,0.5\) --background=#ff8080 foo\ bar

Contribute!

Contributions in the form of bug fixes, features and documentation are always welcome!

textorize is released under the MIT license. © 2009 Thomas Fuchs <thomas@fesch.at>.

NSColor extensions taken from LimeChat, github.com/psychs/limechat. LimeChat is copyrighted free software by Satoshi Nakagawa <psychs@limechat.net>.

Something went wrong with that request. Please try again.