summaryrefslogtreecommitdiff
path: root/manuals/chickadee/Fonts.html
diff options
context:
space:
mode:
authorDavid Thompson <dthompson@vistahigherlearning.com>2020-11-19 20:50:56 -0500
committerDavid Thompson <dthompson@vistahigherlearning.com>2020-11-19 20:50:56 -0500
commit03f0340ae9df26b40855dd78216ff47738957851 (patch)
tree83ea1b646320b958b01757b8e7739783ecf68c91 /manuals/chickadee/Fonts.html
parentfc7097f7368b384f6dc52d32da763af90bd3564a (diff)
manuals: Update chickadee manual to 0.6.0.
Diffstat (limited to 'manuals/chickadee/Fonts.html')
-rw-r--r--manuals/chickadee/Fonts.html46
1 files changed, 31 insertions, 15 deletions
diff --git a/manuals/chickadee/Fonts.html b/manuals/chickadee/Fonts.html
index f4f41ef..4bc0411 100644
--- a/manuals/chickadee/Fonts.html
+++ b/manuals/chickadee/Fonts.html
@@ -18,7 +18,7 @@ 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.6, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Fonts (The Chickadee Game Toolkit)</title>
@@ -28,12 +28,12 @@ http://www.texinfo.org/ (GNU Texinfo).
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
-<link href="index.html#Top" rel="start" title="Top">
-<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html" rel="start" title="Top">
+<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
-<link href="Graphics.html#Graphics" rel="up" title="Graphics">
-<link href="Particles.html#Particles" rel="next" title="Particles">
-<link href="Lines-and-Shapes.html#Lines-and-Shapes" rel="prev" title="Lines and Shapes">
+<link href="Graphics.html" rel="up" title="Graphics">
+<link href="Particles.html" rel="next" title="Particles">
+<link href="Vector-Paths.html" rel="prev" title="Vector Paths">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
@@ -82,7 +82,7 @@ ul.no-bullet {list-style: none}
<body lang="en">
<span id="Fonts"></span><div class="header">
<p>
-Next: <a href="Particles.html#Particles" accesskey="n" rel="next">Particles</a>, Previous: <a href="Lines-and-Shapes.html#Lines-and-Shapes" accesskey="p" rel="prev">Lines and Shapes</a>, Up: <a href="Graphics.html#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="Particles.html" accesskey="n" rel="next">Particles</a>, Previous: <a href="Vector-Paths.html" accesskey="p" rel="prev">Vector Paths</a>, Up: <a href="Graphics.html" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Fonts-1"></span><h4 class="subsection">2.3.6 Fonts</h4>
@@ -93,16 +93,27 @@ Next: <a href="Particles.html#Particles" accesskey="n" rel="next">Particles</a>,
<pre class="example">(draw-text &quot;Hello, world&quot; (vec2 100.0 100.0))
</pre></div>
-<p>Chickadee loads and renders bitmap fonts in the
-<a href="http://www.angelcode.com/products/bmfont/doc/file_format.html">Angel Code format</a>. A default font named &ldquo;Good Neighbors&rdquo; is
-built-in to Chickadee and is used for all text rendering operations
-where a font is not specified, as is the case in the above example.
+<p>Chickadee supports OpenType/TrueType fonts (via the FreeType library),
+bitmap fonts in Angel Code bmfont format, and simple sprite sheet
+bitmap fonts. A default font named Inconsolata is used for all text
+rendering operations where a font is not specified, as is the case in
+the above example.
</p>
-<p>The following procedures can be found in the <code>(chickadee render
+<p>The following procedures can be found in the <code>(chickadee graphics
font)</code> module:
</p>
<dl>
-<dt id="index-load_002dfont">Procedure: <strong>load-font</strong> <em>file</em></dt>
+<dt id="index-load_002dfont">Procedure: <strong>load-font</strong> <em>file-name point-size [#:char-set]</em></dt>
+<dd><p>Load the scalable (OpenType, TrueType, etc.) font in the file
+<var>file-name</var> and display it at the given <var>point-size</var>. By
+default, all the characters in the ASCII character set are loaded.
+This can be changed by passing a different character set
+(see <a href="https://www.gnu.org/software/guile/manual/html_node/Character-Sets.html#Character-Sets">Character Sets</a> in <cite>GNU Guile Reference Manual</cite>) using
+the <var>char-set</var> keyword argument.
+</p></dd></dl>
+
+<dl>
+<dt id="index-load_002dbitmap_002dfont">Procedure: <strong>load-bitmap-font</strong> <em>file</em></dt>
<dd><p>Load the Angel Code font (in either XML or FNT format) in <var>file</var>
and return a new font object.
</p></dd></dl>
@@ -139,7 +150,7 @@ and return a new font object.
<dl>
<dt id="index-draw_002dtext">Procedure: <strong>draw-text</strong> <em>text position</em></dt>
-<dd><p>[#:font] [#:origin] [#:scale] [#:rotation] [#:blend-mode]
+<dd><p>[#:font] [#:color] [#: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
@@ -153,10 +164,15 @@ built-in font is used.
<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
+<p>Refer to <code>draw-sprite</code> (see <a href="Sprites.html">Sprites</a>) for information about
the other arguments.
</p></dd></dl>
+<hr>
+<div class="header">
+<p>
+Next: <a href="Particles.html" accesskey="n" rel="next">Particles</a>, Previous: <a href="Vector-Paths.html" accesskey="p" rel="prev">Vector Paths</a>, Up: <a href="Graphics.html" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
+</div>