/usr/share/doc/sludge/SLUDGEDevKitHelp/say_and_think.html is in sludge-doc 2.1.2-3build1.
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 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<TITLE>say and think</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>say and think</h2>
<HR>
<H3>Syntax:</H3>
<P>
<pre class="syntax">say (<i>thisObject, textToSay</i>);</pre>
</P>
<P>
<pre class="syntax">say (<i>thisObject, textToSay, soundFile</i>);</pre>
</P>
<P>
<pre class="syntax">think (<i>thisObject, textToThink</i>);</pre>
</P>
<P>
<pre class="syntax">think (<i>thisObject, textToThink, soundFile</i>);</pre>
</P>
<H3>Purpose:</H3>
<P>
Makes <i>thisObject</i> say the contents of the <i>textToSay</i> parameter (or think the contents of the <i>textToThink </i>parameter). The text is shown on the screen in the speech colour defined in the object type definition. If a <i>soundFile</i> parameter is specified, the sound may be used instead of (or as well as) the text - this depends on the current <a href="setSpeechMode.html">setSpeechMode</a> setting.
</P>
<P>
<b>If <i>thisObject</i> is a character:</b>
</P>
<P>
Any displayed text will be shown over the head of the character.<b> </b>If the say command is being used, the character's current animation will be changed to the speaking animation (for the character facing its current direction) defined in the <a href="costume.html">costume</a> assigned to the character. When the character has finished speaking, the character's animation will change to the standing still animation. If the think command is being used, the character will not be made to animate.
</P>
<P>
<b>If <i>thisObject</i> is a screen region:</b>
</P>
<P>
Any displayed text will be shown above the last region to have been added which represents the object; that is, if there are three screen regions which represent the same object and the object is told to speak, the text will appear over the third region.
</P>
<P>
<b>If <i>thisObject</i> isn't a character or screen region:</b>
</P>
<P>
Any displayed text will appear centred at the top of the screen.
</P>
<P>
The function from which the say command is called will pause until the object stops speaking. The time this takes depends on the number of characters in <i>textToSay</i> or <i>textToThink </i>and is calculated by the SLUDGE engine at runtime. If the <i>soundFile</i> parameter is specified (and used), the time for which the function pauses is the length of time needed to play the sound.
</P>
<P>
Valid file formats for the <i>soundFile</i> parameter are Windows wave files (.WAV) and Ogg Vorbis (.OGG), as in the <a href="playSound.html">playSound</a> and <a href="loopSound.html">loopSound</a> functions.
</P>
<H3>Return value:</H3>
<P>
No return value.
</P>
<H3>See also:</H3>
<P>
<a href="addCharacter.html">addCharacter</a>
</P>
<P>
<a href="addScreenRegion.html">addScreenRegion</a>
</P>
<P>
<a href="cacheSound.html">cacheSound</a>
</P>
<P>
<a href="setSpeechSpeed.html">setSpeechSpeed</a>
</P>
<P>
<a href="skipSpeech.html">skipSpeech</a>
</P>
<P>
<a href="somethingSpeaking.html">somethingSpeaking</a>
</P>
<P class="copyright-notice">SLUDGE and this SLUDGE documentation are <A HREF="Copyright.html">copyright</A> Hungry Software and contributors 2000-2011
</P>
<HR>
</BODY>
</html>
|