= Font
* ((< Font赡ǽ>))
* ((<SDL::TTF>))
* ((<SDL::BMFont>))
* ((<SDL::Kanji>))
* եȴϢ᥽å
TOC

== Font赡ǽ
Ruby/SDL 3ΰۤʤե襷ƥäƤޤ
((<SDL_ttf|URL:http://www.libsdl.org/projects/SDL_ttf/index.html>))
Ǥ True Type Font 衢
((<SGE|URL:http://www.etek.chalmers.se/~e8cal1/sge/index.html>))
Ǥȼ/SFontǤΥӥåȥޥåץեȤ衢
((<SDL_kanji|URL:http://shinh.skr.jp/sdlkanji/>)) Ǥ bdf եȤ
Ǥ
Τ줾ˡ@[TTF]@[BMFont]@[Kanji] Ȥ饹Ƥ
ơ줾ۤʤ᥽åɡǽޤ

ˤϤ줾ʲΤ褦ħޤŬڤ˻Ȥ櫓Ƥ
* SDL::TTF

  եȥե̾ *.ttf  *.ttc ŪǤ
  եȥǡξ󤬥٥ȥǡǤ뤿ᡢĤ
  եȥǡǤդ礭ʸǤޤ
  եȥǡΤݤȤǤȤ˼
  ΤѤǤ礦

* SDL::BMFont

  եȥեϤʤӥåȥޥåץե(*.bmp)  PNG ե(*.png)
  Ȥޤȼξ硢ʸǡ򲣤256¤٤Τ
  ߤʤΤ줾줬 ASCII ɤбƤȤβᤵޤ
  Ĥޤ  8 ԥ롢⤵ 16ԥΥǡʤ
   8*256 = 2048⤵ 16ԥβȤʤޤ
  եȥǡ򼫺ΤŪưפʤȤǤ
  ʿ̾褬Ǥʤȡ̾ʸ
  ǤʤȤǤ

  ⤦ġΥ饹 ((<SFont|URL:http://www.linux-games.com/sfont/>))
  ⰷȤǤޤӥåȥޥåץեȤΰǤ
  ʸѤǤʤɤǤܤϥ򸫤Ƥ
  
* SDL::Kanji

  եȥեγĥҤˤbdfȤޤӥåȥޥåץեȤ
  ǤʣΥեȥե(㤨Хե٥åȤܸ)
  ΥǡʻƻȤǽäƤޤ
  ʿ̾褬ǽǤ
  ϡbdf եȤϤޤŪʷǤϤʤեȤѰդ
  ݤǤ뤳ȤǤ

== SDL::TTF
METHODS(TTF)

TrueTypeFontɽ魯饹ǤΥ饹Ȥˤϡ
((<SDL_ttf|URL:http://www.libsdl.org/projects/SDL_ttf/index.html>))
ɬפǤХåɤ((<Freetype|URL:http://www.freetype.org/>))
Ѥޤ

ޤեȤΥ饤󥹤ˤդƤ㤨 Windows °
եȤϺۤǧƤޤ

== SDL::BMFont
METHODS(BMFont)

ӥåȥޥåץեȤɽ魯饹ǤΥ饹Ȥˤ
((<SGE|URL:http://www.etek.chalmers.se/~e8cal1/sge/index.html>))
ɬפǤ

== SDL::Kanji
METHODS(Kanji)

bdfեȤɽ魯饹Ǥ

== եȴϢ᥽å
%%%
NAME init
MOD TTF
TYPE .
DEP SDL_ttf
PURPOSE TTF赡ǽޤ

PROTO
init

DESC
TTF赡ǽޤ
@[TTF] ¾Υ᥽åɤƤˤƤǤ
@[init] Ƥ˸ƤǤ⤫ޤޤ

SEEALSO
TTF.init?

%%
NAME init?
MOD TTF
TYPE .
DEP SDL_ttf
PURPOSE TTF赡ǽƤ뤫ɤޤ
RVAL true/false

PROTO
init?

DESC
TTF赡ǽ˽Ƥtrue򡢤ʤ
false֤ޤ

SEEALSO
TTF.init

%%
NAME open
MOD TTF
TYPE .
DEP SDL_ttf
PURPOSE ե뤫եȤɤߤߤޤ
RVAL SDL::TTF

PROTO
open(filename, ptsize, index=nil)

DESC
$[filename] ǻꤷեȥե $[ptsize] ݥ
ɤ߹ߤޤ$[index]  face index Ǥޤ
ǥեȤǤ 0 Ǥ

RET
@[TTF] Υ󥹥󥹤֤ޤ

EXCEPTION *

EXAMPLE
SDL::TTF.init
font = SDL::TTF.open("font.ttf", 32, 0)

%%
NAME style
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤ襹֤ޤ
RVAL UINT

PROTO
style

DESC
ե $[self] 襹ʲͤ¤ȤäΤ֤ޤ
* SDL::TTF::STYLE_BOLD
* SDL::TTF::STYLE_ITALIC
* SDL::TTF::STYLE_UNDERLINE
ʾΤɤꤵƤʤ SDL::TTF::STYLE_NORMAL ֤ޤ

EXAMPLE
print "The font style is:"

print " normal" if font.style == SDL::TTF::STYLE_NORMAL
print " bold" if (font.style & SDL::TTF::STYLE_BOLD) != 0
print " italic" if (font.style & SDL::TTF::STYLE_ITALIC) != 0
print " italic" if (font.style & SDL::TTF::STYLE_UNDERLINE) != 0

print "\n"

SEEALSO
TTF#style=

%%
NAME style=
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤ襹ꤷޤ

PROTO
style=(new_style)

DESC
ե $[self] 襹 $[new_style] ꤷޤ
$[new_style] ϰʲ¤ͿƤ
* SDL::TTF::STYLE_BOLD
* SDL::TTF::STYLE_ITALIC
* SDL::TTF::STYLE_UNDERLINE

NOTES
Υ᥽åɤƤ֤Υ󥰺ѤʸΥå夬
äޤ

EXAMPLE
# åΤĥܡΤꤹ
font.style = SDL::TTF::STYLE_ITALIC | SDL::TTF::STYLE_BOLD

# 褹

# ᤹̾
font.style = SDL::TTF::STYLE_NORMAL

SEEALSO
TTF#style

%%
NAME height
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤʸι⤵֤ޤ
RVAL Integer

PROTO
height

DESC
եȤʸǰֽĤι⤵⤤Τι⤵ԥ֤ޤ
ͤʸĤˤǤŤ褹뤿˻Ȥޤξ
ͤ1­ʸƱΤʤʤޤ
Ruby/SDLʣθƤʤᡢԴ֤򤭤ȼΤ
ʬǤʤФʤޤ@[TTF#line_skip] ⻲ͤˤƤ

%%
NAME ascent
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤascent֤ޤ
RVAL Integer

PROTO
ascent

DESC
ʸascent(١饤󤫤ξʬι⤵)κ֤ͤޤ
Ĥޤʸξü١饤ޤǤεΥǤ

COMMENT
It could be used when drawing an individual glyph relative to a top point, by combining
it with the glyph's maxy metric to resolve the top of the rectangle used when blitting
the glyph on the screen.

SEEALSO
TTF#height
TTF#descent
TTF#line_skip

%%
NAME descent
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤdescent֤ޤ
RVAL Integer

PROTO
descent

DESC
ʸdescent(١饤󤫤鲼ʬι⤵)κ֤ͤޤ
Ĥޤʸβü١饤ޤǤεΥǤ

COMMENT
It could be used when drawing an individual glyph relative to a bottom point, by
combining it with the glyph's maxy metric to resolve the top of the rectangle used when
blitting the glyph on the screen.

SEEALSO
TTF#height
TTF#ascent
TTF#line_skip

%%
NAME line_skip
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤΰԤο侩⤵֤
RVAL Integer

PROTO
line_skip

DESC
ΥեȤ˰Ԥ겿ԥι⤵Ƥ٤
֤ޤʣ褷ˤ @[TTF#height] ͤ
ͤȤäۤɤ⤷ޤ
ͤ̾ @[TTF#height] ͤ礭Ǥ

SEEALSO
TTF#height
TTF#ascent
TTF#descent

%%
NAME faces
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եο֤ޤ
RVAL Integer

PROTO
faces

DESC
եȤ˴ޤޤѲǽʥե(֥֥եȡ)ο֤ޤ
̾盧ͤѲͤϤʤǤ礦ȤΤϤͤ @[TTF] ¾
᥽åɤˤʤƶͿʤǤ

%%
NAME fixed_width?
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȥեɤޤ
RVAL true/false

PROTO
fixed_width?

DESC
$[self] Ǥ true 򡢤ʤ false ֤
եȤϤ٤ƤʸƱǤꡢʸ󥰤
Υեñˡʸ * ʸĹפˤʤޤ

SEEALSO
TTF#faces
TTF#family_name

%%
NAME family_name
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤθߤΥե̾ޤ
RVAL String/nil

PROTO
family_name
familyName

DESC
$[self] θߤΥեȥե֤̾ޤ
̵̾ nil ֤ޤ

SEEALSO
TTF#faces
TTF#fixed_width?
TTF#style_name

%%
NAME style_name
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE եȤθߤΥեΥ̾ޤ
RVAL String/nil

PROTO
style_name
styleName

DESC
$[self] θߤΥեȥեΥ֤̾ޤ
̵̾ nil ֤ޤ

SEEALSO
TTF#faces
TTF#fixed_width?
TTF#family_name

%%
NAME text_size
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸΥ󥰤ɬפʥեΥޤ
RVAL [Integer, Integer]

PROTO
text_size(text)
textSize(text)

DESC
$[text] Ϳ줿ʸ󥰤Τɬפ@[ե|Surface]
Υ׻⤵֤ޤ$[text] Υ󥳡ǥ󥰤
UTF8ǤʤФʤޤ
ºݤˤϰڥ󥰤ޤ󤬡˥󥰤αƶθ
ޤ
⤵ @[TTF#height] Ʊͤޤ

EXCEPTION *

EXAMPLE
w, h = font.size_text("Hello World!")
puts "width=#{w} height=#{h}"

SEEALSO
TTF#render_solid_utf8
TTF#render_shaded_utf8
TTF#render_blended_utf8
TTF#draw_solid_utf8
TTF#draw_shaded_utf8
TTF#draw_blended_utf8

%%
NAME render_solid_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ󥰤ե֤ޤ
RVAL SDL::Surface/nil

PROTO
render_solid_utf8(text, r, g, b)
renderSolidUTF8(text, r, g, b)

DESC
$[text] ǻꤷʸ(󥳡ǥ󥰤UTF8)
$[r], [g], $[b] ǻꤷǥ󥰤̤
@[Surface] Υ󥹥󥹤֤ޤ

@[TTF#render_shaded_utf8]  @[TTF#render_blended_utf8]
®ǤܤϤɤޤ

륵ե8bppΥեǡꤷ
Ʃ2Τ߻Ȥޤ
ƩȤ 0 Υԥͤ ʸʬ 1 Υԥͤ
Ȥ졢ѥåȤ1˻ꤷ֤ͤޤ
Τƥ󥰤뤳ȤʤʸοѤ뤳ȤǤޤ
0 ϥ顼ǡƩǤ顢
ѥå 0 ο¾Υե@[ž|blit_surface]Ƥ
褵ޤ󡣼¤Ϥο (255-$[r], 255-$[g], 255-$[b])
Ǥ
 @[TTF#render_shaded_utf8]  @[TTF#render_blended_utf8]
٤ƹ®ʥ󥰤Ǥޤ
ꥢϤäƤޤ
ޤΥ᥽åɤǺäեϡ
@[TTF#render_blended_utf8] ե @[ž|blit_surface]
®žǤޤ
Ȥˤ®ưɬפʾ˻ȤȤ褤Ǥ礦

SEEALSO
TTF#render_shaded_utf8
TTF#render_blended_utf8
TTF#draw_solid_utf8

%%
NAME render_shaded_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ򥢥ꥢ󥰤ƥ󥰤ե֤ޤ
RVAL SDL::Surface/nil

PROTO
render_shaded_utf8(text,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)
renderShadedUTF8(text,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)

DESC
$[text] ǻꤷʸ(󥳡ǥ󥰤UTF8)
$[fg_r], [fg_g], $[fg_b] ǻꤷʸο
$[bg_r], [bg_g], $[bg_b] ǻꤷطʤοȤ
󥰤̤
@[Surface] Υ󥹥󥹤֤ޤ

@[TTF#render_solid_utf8]󥰤®Ǥ
ܤ @[TTF#render_solid_utf8] ͥƤޤ

@[ե|Surface]8bppǡԥ 0 طʤǡ
¾ΥԥͤطʿʿȤ֤οɽ뤿
˻ȤޤʸˤϥꥢƤޤ
󥰤®٤ @[TTF#render_solid_utf8] ®ǡ
@[TTF#render_blended_utf8] Ʊ餤Ǥ
ޤΥ᥽åɤǺäեϡ
@[TTF#render_solid_utf8] ե@[ž|blit_surface]
ΤƱ餤®٤žǤޤ
顼ˤȴ䥢ե֥ɤʤɤϻȤ߾ȤʤΤǡ
ʼʥ󥰤ɬפǡطʤ쿧ʤ˻ȤäƤ

SEEALSO
TTF#render_solid_utf8
TTF#render_blended_utf8
TTF#draw_shaded_utf8

%%
NAME render_blended_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ򥢥եȤäƥꥢե֤ޤ
RVAL SDL::Surface/nil

PROTO
render_blended_utf8(text, r, g, b)
render_blended_utf8(text, r, g, b)

DESC
$[text] ǻꤷʸ(󥳡ǥ󥰤UTF8)
$[r], [g], $[b] ǻꤷǥ󥰤̤
@[Surface] Υ󥹥󥹤֤ޤ

@[TTF#render_solid_utf8]󥰤®Ǥ
ܤͥƤޤ

륵ե32bppARGBΤΤǡեȤǥ
򤷹ʼʸ򤷤ޤطʤϥեͤƩͤʤΤǡ
@[TTF#render_shaded_utf8] Τ褦ʸΤޤ˻ͳѤ
ȤϤޤʸˤϥꥢ󥰤Ƥޤ
󥰤ɬפʻ֤ @[TTF#render_solid_utf8] Ĺ
@[TTF#render_shaded_utf8] Ʊ餤Ǥ
ޤե@[ blit ž|blit_surface]Τˤϡ
@[TTF#render_solid_utf8]  @[TTF#render_shaded_utf8] 
եž֤ޤ
Υ᥽åɤϹʼʥ󥰤ɬפǡ®٤ۤɬפ
ʤѤƤ

SEEALSO
TTF#render_solid_utf8
TTF#render_shaded_utf8
TTF#draw_blended_utf8

%%
NAME draw_solid_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ褷ޤ

PROTO
draw_solid_utf8(dest, text, x, y, r, g, b)
drawSolidUTF8(dest, text, x, y, r, g, b)

DESC
$[text] ǻꤷʸ $[dest] ǻꤷ@[ե|Surface]
($[x], $[y]) 򺸾Ȥ($[r], $[g], $[b])ǻꤷ
褷ޤ褵ʸʼ®٤ʤɤ @[TTF#render_solid_utf8]
ƱޤܤϤ򸫤Ƥ

SEEALSO
TTF#draw_shaded_utf8
TTF#draw_blended_utf8
TTF#render_solid_utf8

%%
NAME draw_shaded_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ򥢥ꥢ褷ޤ

PROTO
draw_shaded_utf8(dest, text, x, y, fg_r, fg_g, fg_b, bg_r, bg_g, bg_b)
drawShadedUTF8(dest, text, x, y, fg_r, fg_g, fg_b, bg_r, bg_g, bg_b)

DESC
$[text] ǻꤷʸ $[dest] ǻꤷ@[ե|Surface]
($[x], $[y]) 򺸾Ȥ($[fg_r], $[fg_g], $[fg_b])ǻꤷ
ʸ($[bg_r], $[bg_g], $[bg_b])ǻꤷطʤȤ
褷ޤ褵ʸʼ®٤ʤɤ @[TTF#render_shaded_utf8]
ƱޤΤ($[x], $[y])򺸾Ȥ
@[TTF#size_text]($[text]) ⤵ȤĹꤷطʿ
ɤĤ֤ޤ

SEEALSO
TTF#draw_solid_utf8
TTF#draw_blended_utf8
TTF#render_shaded_utf8

%%
NAME draw_blended_utf8
MOD TTF
TYPE #
DEP SDL_ttf
PURPOSE ʸ򥢥եǥꥢ褷ޤ

PROTO
draw_blended_utf8(dest, text, x, y, r, g, b)
drawBlendedUTF8(dest, text, x, y, r, g, b)

DESC
$[text] ǻꤷʸ $[dest] ǻꤷ@[ե|Surface]
($[x], $[y]) 򺸾Ȥ($[r], $[g], $[b])ǻꤷ
褷ޤ褵ʸʼ®٤ʤɤ @[TTF#render_blended_utf8]
ƱޤܤϤ򸫤Ƥ

SEEALSO
TTF#draw_solid_utf8
TTF#draw_shaded_utf8
TTF#render_blended_utf8

%%
NAME open
MOD BMFont
TYPE .
DEP SGE
PURPOSE եȤɤޤ
RVAL SDL::BMFont

PROTO
open(filename, flags)

DESC
$[filename] ǻꤷեȤɤΥեȤɽ魯
֥Ȥ @[BMFont] Υ󥹥󥹤Ȥ֤ޤ

$[flags] ȤƤϰʲͤͿ뤳ȤǤޤ
:SDL::BMFont::TRANSPARENT
  @[Surface#set_color_key] ŬƩῧͿ(˻Ȥ٤)
:SDL::BMFont::NOCONVERT
  ɤ߹եȲФ @[Surface#display_format] ƤФʤ
:SDL::BMFont::SFONT
  ɤ߹եȲ SFont եޥåȤȲꤹ롣
  ͿʤȼȲꤹ롣
:SDL::BMFont::PALETTE
  ɤߤե 8bppѥåդեѴ롣
   SFont ΥեȤФƤϻȤޤ
  򤹤褬٤ʤޤ @[BMFont#set_color] ®ʤޤ

%%
NAME set_color
MOD BMFont
TYPE #
DEP SGE
PURPOSE եȤοѹޤ

PROTO
set_color(r, g, b)
setColor(r, g, b)

DESC
եȤο ($[r], $[g], $[b]) ѹޤ¿եȤ
SFontФƤѤǤޤ󡣤Υ᥽åɤ٤Ƥ֤ΤǤ
@[BMFont.open]  ((<SDL::BMFont::PALETTE>)) ͿƤɤǤ礦

%%
NAME height
MOD BMFont
TYPE #
DEP SGE
PURPOSE եȤι⤵ޤ
RVAL Integer

PROTO
height

DESC
եȤι⤵֤ޤ

SEEALSO
BMFont#width

%%
NAME width
MOD BMFont
TYPE #
DEP SGE
PURPOSE եȤޤ
RVAL Integer

PROTO
width

DESC
ʸʬ֤ޤSFont ФƤϻȤޤ

SEEALSO
BMFont#height

%%
NAME text_size
MOD BMFont
TYPE #
DEP SGE
PURPOSE ʸɬפʥե礭ޤ
RVAL [Integer, Integer]

PROTO
text_size(string)
textSize(string)

DESC
$[self] ɽ蘆եȤ $[string] 褹Τɬפ
ե礭 [, ⤵] Ȥ֤ޤ
Ĺñ̤ϥԥǤ

SEEALSO
BMFont#textout

%%
NAME textout
MOD BMFont
TYPE #
DEP SGE
PURPOSE ʸ褷ޤ

PROTO
textout(surface, string, x, y)

DESC
$[string]  $[surface]  ($[x], $[y]) 褷ޤ

COMMENT
lock롩

SEEALSO
BMFont#text_size

%%
NAME open
MOD Kanji
TYPE .
PURPOSE bdfեɤ߹ࡣ
RVAL SDL::Kanji

PROTO
open(filename, size)

DESC
$[filename] ǻꤷ bdf եɤߤߡ@[Kanji] Υ󥹥
֤ޤ$[size] ʸΥꤷޤͤ
ʸι⤵ޤޤȾʸ2ʸʬˤʤޤ

SEEALSO
Kanji#add

%%
NAME add
MOD Kanji
TYPE #
PURPOSE ɤ߹ǤեȤɲäƥեȤɤߤߤޤ

PROTO
add(filename)

DESC
$[filename] ǻꤷ bdf եɤߤߡ$[self] ̵äʸ
եȤ䴰ޤȤäƱѸܸ̤Υե
ɤߤࡢȤäȤǤޤ

SEEALSO
Kanji#open

%%
NAME set_coding_system
MOD Kanji
TYPE #
PURPOSE ʸɤꤷޤ

PROTO
set_coding_system(sys)
setCodingSystem(sys)

DESC
ʸɤꤷޤ $[sys] ȤưʲΤ줫Ǥޤ
* SDL::Kanji::SJIS
* SDL::Kanji::EUC
* SDL::Kanji::JIS
ǥեȤǤ SDL::Kanji::JIS ꤵƤޤ

%%
NAME height
MOD Kanji
TYPE #
PURPOSE ʸι⤵ޤ
RVAL Integer

PROTO
height

DESC
եȤι⤵ԥ֤ޤϤʸǤꡢ
Ⱦʸ2ܤͤǤ

%%
NAME textwidth
MOD Kanji
TYPE #
PURPOSE ʸޤ
RVAL Integer

PROTO
textwidth(text)

DESC
$[text] ǻꤷʸ褹Τɬפԥ֤ޤ

SEEALSO
Kanji#width

%%
NAME width
MOD Kanji
TYPE #
PURPOSE ʸޤ

PROTO
width

DESC
Ⱦʸ1ʸԥޤ

SEEALSO
textwidth

%%
NAME put
MOD Kanji
TYPE #
PURPOSE ʸ褷ޤ

PROTO
put(surface, text, x, y, r, g, b)

DESC
$[text] ǻꤷʸ $[surface]  ($[x], $[y])  ($[r], $[g], $[b])
ǻꤷ褷ޤ

SEEALSO
Kanji#put_tate

%%
NAME put_tate
MOD Kanji
TYPE #
PURPOSE ʸĽ񤭤褷ޤ

PROTO
put_tate(surface, x, y, r, g, b)
putTate(surface, x, y, r, g, b)

DESC
$[text] ǻꤷʸ $[surface]  ($[x], $[y])  ($[r], $[g], $[b])
ǻꤷǽĽ񤭤褷ޤ

ASCIIʸϽĽ񤭤ˤǤޤ

SEEALSO
Kanji#put