/usr/share/doc/sludge/SLUDGEDevKitHelp/setFont.html is in sludge-doc 2.2.1-2build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<TITLE>setFont</TITLE>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<BODY>
<HR>
<div align="center"><img id="headerGraphic" src="images/sludge300.png" alt="SLUDGE"/></div>
<h2>setFont</h2>
<HR>
<H3>Syntax:</H3>
<P>
<pre class="syntax">setFont (<i>spriteBank, charactersSupported, height</i>);</pre>
</P>
<H3>Purpose:</H3>
<P>
Changes to a new font. The font must be contained in a sprite bank, and the <i>spriteBank</i> parameter should be a file handle for this file - that is, the name of the file in single quotes. The <i>charactersSupported</i> parameter must be a string made up of - in order - each of the characters which are supported in this font. Therefore, if the fifth character in the <i>charactersSupported</i> string is A, the character A will be drawn on the screen using the fifth image in the sprite bank file.
</P>
<P>
Characters which are not present in the <i>charactersSupported</i> string are
drawn as the first sprite in the sprite bank. It is therefore wise to have the
first character in the font be a symbol used to represent this fact, such as an
empty box or a question mark. The function <a href="inFont.html">inFont</a> can
be used to check if a character exists in the current font.
</P>
<P>
The <i>height</i> value must be numerical, and will be used as the gap between rows of text when using multiple status bars (created by the <a href="addStatus.html">addStatus</a> command) and when spoken text (created by the <a href="say_and_think.html">say and think</a> commands) wraps onto more than one line.
</P>
<H3>Return value:</H3>
<P>
No return value.
</P>
<H3>Example:</H3>
<P>
<pre># Load a font which only contains a question mark and numbers
# Numbers will be drawn as the second to 11th sprites in the file
# All other characters will be displayed as question marks
setFont ('numbers.duc', "?0123456789", 32);</pre>
</P>
<H3>See also:</H3>
<P>
<a href="inFont.html">inFont</a>
</P>
<P>
<a href="pasteString_and_burnString.html">pasteString and burnString</a>
</P>
<P>
<a href="setFontSpacing.html">setFontSpacing</a>
</P>
<P class="copyright-notice">SLUDGE and this SLUDGE documentation are <A HREF="Copyright.html">copyright</A> Hungry Software and contributors 2000-2012
</P>
<HR>
</BODY>
</html>
|