Vertical Text Rendering Plug-in for GIMP2

Tategaki Dialog

Index

Features

This plugin renders vertical writing characters. Make a layer of vertically writing letters. In addition to simply arranging letters vertically, you can use Japanese-specific typographic processing such as ruby, horizontal line in vertical line (called tate-chu-yoko), dot mark for emphasizing, combining voice sound marks, mixed font, unicode ivs, etc. Also, since it interpret fonts ourselves, it can output surrogate pairs and IVS characters even if the OS does not support them.

Requirements

How to install

Microsoft Window

Get pre-compiled binary. It contains tategaki.exe and gimp20-tategaki.po (japanese locale). Copy tategaki.exe to plug-in folder. By the default, the folder is may be C:\Program Files\GIMP 2\lib\gimp\2.0\plug-ins.

Unix/Linux

configure, make, make install.

Apple OS X

Copy tategaki to /Applications/GIMP.app/Contents/Resources/lib/gimp/2.0/plug-ins/

How to use

Start from <Filter>/ReddogPlug/Tategaki...
You must set Font directory and restart plugin before use it.

Basic Settings

Font
Select Fonts
Font Size
Select font size and units.
text dir
Select text direction. vertical or horizontal.
Line Align
Select Line alignment.Top, Center, Bottom, Both.
Yakumono
Yakumono means Japanese punctuation mark. Select yakumono spacing. BetaGumiDoes not spacing. It use advance of font.
YakuTsumeyakumono that has EM square size makes half size advance.
JISX4051yakumono are treated as defined by JISX4051.
Line Pitch
Pitch of lines.
Tracking
Pitch of chars.
Kerning
Enable kerning.
Antialias
Enable antialias.
Edging
Draw font edge used background color.

Mixed Font

Allow to use another font according to char class.

Ruby

Enable Ruby Transform
If ruby-string is longer than parent-string, transform ruby-string.
Ruby Max Transform Rate
max transfrom rate.
Use Ruby commands to set ruby.

Horizontal line in vertical line

Auto Yoko
Sequence of Ascii number and ! and ? are rotated 90 digree in vertical text direction automatically
Auto Yoko Digits
sequence max digits of tate-chu-yoko.
Use Yoko commands to set yoko manually.

Dot

Ignore Yakumono
Does not put dot on punctuation marks
Align dot
Align dots if glyph size is not same.
Use Dot commands to put int on side (or top) of chars.

Tool

Preset

Load
Restore from preset.
Save
Save current parameter to preset.
Delete
Remove preset from preset list.
Update List
Update preset list.

Font Directory

Set Font directory in FontDir Tab. And then restart tategaki plug-in.

Buttons

Modify
If selected layer is created by tategaki plugin, enter modify mode and you can change parameters. Press Apply button to save it again.
Apply
Apply changed paramter to layer and exit modify mode.
Cancel
exit modify mode
Create
create new tategaki plugin layer.
Close
Close dialog window.

Other

Hide...
Hide tabs of parameters
Topmost
Prevent the dialog from hiding behind.

Commands

By inserting a command in a sentence, you can add special effects. The basic syntax of the command is [command-name arg1 arg2 ...] , enclosing the command name and arguments, separated by a space. Argument characters can not contain spaces. If it contains spaces, escape whitespace with \ or enclose the string with "".

Ruby commands

[ruby parent-string ruby-string]
Args
parent-string
string of base(parent).
ruby-string
string of ruby.
Example
[ruby 京都 きようと]
Ruby commands
rubysame as rjje
rt top
rc center
rb bottom
rja both(0:1:0)
rjj 1:2:1(JIS X 4051)
If ruby is longer than parent, then parent have empty spaces.
rte top
rce center
rbe bottom
rjaeboth(0:1:0)
rjje1:2:1(JIS X 4051)

Yoko command

[yoko string]
[yoko string trans-rate]
[yoko string trans-rate alignment]
Args
string
string for horizontal
trans-rate
0(default) makes the object to EM square. If 1.0 then not compressed.
alignment
t(top), c(center), b(bottom)
Example
[yoko km]
[yoko !!!!! 1]
[yoko '90 1 bottom]

Dot commands

It support dot and goma(sesame dot).
[dot string]
[goma string]
Args
string
string to dot.
Example
[dot 猛犬注意]
[goma 猛猫注意]

Scale command

Use scaling command to shrink strings.
[scale string trans-rateA]
[scale string trans-rateA trans-rateB]
Args
string
string to scale.
trans-rateA
if text-dir is vertical then x, when horizontal then y. 1.0 has no scaling. 0.5 is half size.
trans-rateB
if text-dir is vertical then y, when horizontal then x.
Example
[scale 巨大文字 2]
[scale 長い文字 0.5 1]

Bold command

Use bold command to embold strings.
[bold string]
[bold string strength]
Args
string
string to embold.
strength
Embold string. default is 4.0. 0.0 is not embolded. Minus value makes string slim.
Example
[bold 普通の太字]
[bold 細字 -3.0]

Font command

Use font command to specify a font.
[font string font-namae]
Args
string
string to change a font
font-name
The font name, a japanese, english or postscript name enabled. It is required to escape white space by \.
Example
[font Japanese-Name IPA明朝]
[font English-Name MS\ Gothic]
[font Postscript-Name HiraMinProN-W3]

Color command

Uset color command to change color of substring.
[color string color-name]
Args
string
string to change a color
color-name
Enable to use #FFFFFF style, hsv(D,N%,N%) style, hsl(D,N%,N%) style, CSS3 Color Names, JIS Color Names and etc. If color name contains white space, it requires quote with "" or escape by \. See also colors.html.
Example
[color Eagle #FF0000]
[color Shark blue]
[color Panther 黄]
[color HSV-Blue "hsv(240, 100%, 100%)"]
[color HSL-Blue "hsl(240, 100%,  50%)"]

Batch Creation

You can create multiple Tategaki layers by separating sentences with the ---- line and holding down the Shift key and pressing the Create button.

Copyright

OHTSUKA, Yoshio <ohtsuka.yoshio@gmail.com>