summaryrefslogtreecommitdiff
path: root/manuals/chickadee/Fonts.html
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2018-12-12 09:20:10 -0500
committerDavid Thompson <dthompson2@worcester.edu>2018-12-12 09:20:10 -0500
commitf16fed3d50fd3d56deb46a3d4641a81460e389de (patch)
tree71659ed643b65eadb17110b3f8f0c5d5cfdd3031 /manuals/chickadee/Fonts.html
parentc4b418c2dcfba3c741f67058a51a3e490aa4b297 (diff)
Update Chickadee manual and home page for 0.3.0.
Better late than never!
Diffstat (limited to 'manuals/chickadee/Fonts.html')
-rw-r--r--manuals/chickadee/Fonts.html38
1 files changed, 20 insertions, 18 deletions
diff --git a/manuals/chickadee/Fonts.html b/manuals/chickadee/Fonts.html
index 198bddb..a4ed5c6 100644
--- a/manuals/chickadee/Fonts.html
+++ b/manuals/chickadee/Fonts.html
@@ -16,16 +16,16 @@ Foundation Web site at http://www.gnu.org/licenses/fdl.html.
The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
-->
-<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>The Chickadee Game Toolkit: Fonts</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Fonts (The Chickadee Game Toolkit)</title>
-<meta name="description" content="The Chickadee Game Toolkit: Fonts">
-<meta name="keywords" content="The Chickadee Game Toolkit: Fonts">
+<meta name="description" content="Fonts (The Chickadee Game Toolkit)">
+<meta name="keywords" content="Fonts (The Chickadee Game Toolkit)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
@@ -94,7 +94,7 @@ Next: <a href="Blending-and-Depth-Testing.html#Blending-and-Depth-Testing" acces
</div>
<hr>
<a name="Fonts-1"></a>
-<h4 class="subsection">2.4.5 Fonts</h4>
+<h4 class="subsection">2.3.6 Fonts</h4>
<p>Unlike the traditional TrueType font format that many are accustomed
to, Chickadee loads and renders bitmap fonts in the
@@ -122,9 +122,7 @@ each font size needed. This is where the &ldquo;signed distance field&rdquo;
rendering technique comes in. Introduced by
<a href="http://www.valvesoftware.com/.../2007/SIGGRAPH2007_AlphaTestedMagnification.pdf">Valve</a> in 2007, signed distance field fonts can be efficiently stored
in a bitmap and be rendered at arbitrary scale factors with good
-results. Chickadee can render both traditional bitmap fonts and
-signed distance field fonts. <em>Signed distance field font
-rendering is not yet available, so be patient.</em>
+results.
</p>
<p>While Chickadee does not yet offer a tool for converting TTF fonts
into FNT fonts, tools such as
@@ -135,44 +133,45 @@ in the meantime.
font)</code> module.
</p>
<dl>
-<dt><a name="index-load_002dfont"></a>Scheme Procedure: <strong>load-font</strong> <em><var>file</var></em></dt>
+<dt><a name="index-load_002dfont"></a>Procedure: <strong>load-font</strong> <em><var>file</var></em></dt>
<dd><p>Load the Angel Code formatted XML document in <var>file</var> and return a
new font object.
</p></dd></dl>
<dl>
-<dt><a name="index-font_003f"></a>Scheme Procedure: <strong>font?</strong> <em><var>obj</var></em></dt>
+<dt><a name="index-font_003f"></a>Procedure: <strong>font?</strong> <em><var>obj</var></em></dt>
<dd><p>Return <code>#t</code> if <var>obj</var> is a font object.
</p></dd></dl>
<dl>
-<dt><a name="index-font_002dface"></a>Scheme Procedure: <strong>font-face</strong> <em><var>font</var></em></dt>
+<dt><a name="index-font_002dface"></a>Procedure: <strong>font-face</strong> <em><var>font</var></em></dt>
<dd><p>Return the name of <var>font</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-font_002dline_002dheight"></a>Scheme Procedure: <strong>font-line-height</strong> <em><var>font</var></em></dt>
+<dt><a name="index-font_002dline_002dheight"></a>Procedure: <strong>font-line-height</strong> <em><var>font</var></em></dt>
<dd><p>Return the line height of <var>font</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-font_002dline_002dheight-1"></a>Scheme Procedure: <strong>font-line-height</strong> <em><var>font</var></em></dt>
+<dt><a name="index-font_002dline_002dheight-1"></a>Procedure: <strong>font-line-height</strong> <em><var>font</var></em></dt>
<dd><p>Return the line height of <var>font</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-font_002dbold_003f"></a>Scheme Procedure: <strong>font-bold?</strong> <em><var>font</var></em></dt>
+<dt><a name="index-font_002dbold_003f"></a>Procedure: <strong>font-bold?</strong> <em><var>font</var></em></dt>
<dd><p>Return <code>#t</code> if <var>font</var> is a bold font.
</p></dd></dl>
<dl>
-<dt><a name="index-font_002ditalic_003f"></a>Scheme Procedure: <strong>font-italic?</strong> <em><var>font</var></em></dt>
+<dt><a name="index-font_002ditalic_003f"></a>Procedure: <strong>font-italic?</strong> <em><var>font</var></em></dt>
<dd><p>Return <code>#t</code> if <var>font</var> is an italicized font.
</p></dd></dl>
<dl>
-<dt><a name="index-draw_002dtext"></a>Scheme Procedure: <strong>draw-text</strong> <em><var>font</var> <var>text</var> <var>position</var></em></dt>
-<dd><p>[#:scale] [#:rotation] [#:blend-mode]
+<dt><a name="index-draw_002dtext"></a>Procedure: <strong>draw-text</strong> <em><var>font</var> <var>text</var> <var>position</var></em></dt>
+<dd><p>[#:origin] [#:scale] [#:rotation] [#:blend-mode]
+ [#:start 0] [#:end <code>(string-length text)</code>]
</p>
<p>Draw the string <var>text</var> with the first character starting at
<var>position</var> using <var>font</var>.
@@ -181,6 +180,9 @@ new font object.
<pre class="example">(draw-text font &quot;Hello, world!&quot; (vec2 128.0 128.0))
</pre></div>
+<p>To render a substring of <var>text</var>, use the <var>start</var> and <var>end</var>
+arguments.
+</p>
<p>Refer to <code>draw-sprite</code> (see <a href="Sprites.html#Sprites">Sprites</a>) for information about
the other arguments.
</p></dd></dl>