View source for SCI Kernel Documentation/Input Functions

[[Official SCI Documentation]]<br />

<div align="center">
Chapter: 
[[SCI Kernel Documentation/SCI Overview|1]] | 
[[SCI Kernel Documentation/Resource Functions|2]] | 
[[SCI Kernel Documentation/List Functions|3]] | 
[[SCI Kernel Documentation/Object Functions|4]] | 
[[SCI Kernel Documentation/System Functions|5]] | 
[[SCI Kernel Documentation/String Functions|6]] | 
[[SCI Kernel Documentation/Picture Functions|7]] | 
[[SCI Kernel Documentation/Save-Restore Game Functions|8]] | 
[[SCI Kernel Documentation/Animation Functions|9]] | 
[[SCI Kernel Documentation/Graphic Screen Functions|10]] | 
[[SCI Kernel Documentation/Input Functions|11]] | 
[[SCI Kernel Documentation/Menu Functions|12]] | 
[[SCI Kernel Documentation/Window and Text Functions|13]] | 
[[SCI Kernel Documentation/Sound Functions|14]] | 
[[SCI Kernel Documentation/Arithmetic Functions|15]] | 
[[SCI Kernel Documentation/File Functions|16]] | 
[[SCI Kernel Documentation/Debugging Functions|17]] | 
[[SCI Kernel Documentation/Index|Index]]
</div><br />

<div align="center"><span style="font-size: 22pt">Input Functions</span><br />
''Author: [[Jeff Stephenson]]''<br />
''Revision by: David Slayback''</div>

&nbsp;

==<br /> Input Functions ==

===<br /> (Said saidStr) ===

<blockquote>
Checks to see if the parsed input sentence matches the input specified by saidStr. Returns TRUE if the input matched saidStr, FALSE otherwise.
</blockquote>

===<br /> (HaveMouse) ===

<blockquote>
Returns TRUE if the user has a mouse driver installed, FALSE otherwise.
</blockquote>

===<br /> (SetCursor form showOn [x] [y]) ===

<blockquote>
Will set the cursor to the one found in the file "cursor.form" and show the cursor if showOn is TRUE. The optional x & y will  position the cursor to the given position.
</blockquote>

===<br /> (GetEvent eventMask event) ===

<blockquote>
Checks the input buffer for an input event of type specified by eventMask. Returns FALSE if there are none. If an event exists, it fills in the event record of the event instance whose ID is in event and returns TRUE.

The types of events which may be specified in eventMask are:

{|
|mouseDown||a mouse button was pressed
|-
|mouseUp||a mouse button was released
|-
|keyDown||a key was pressed
|-
|keyUp||a key was released
|-
|menuStart||the menu request key was hit
|-
|menuHit||a menu item was selected
|-
|direction||a direction event was received
|-
|saidEvent||a Said statement
|-
|joyDown||a joystick button was pressed
|-
|joyUp||a joystick button was released
|}

These event types may be 'or'ed together to request multiple event types. The symbolic value 'allEvents' requests any event type.
</blockquote>

===<br /> (GlobalToLocal event) ===

<blockquote>
Convert the coordinates in the event object event from global (screen) to local (window) coordinates. Event coordinates are always returned in global coordinates, so this call is necessary to convert to the coordinates within the current window.
</blockquote>

===<br /> (LocalToGlobal event) ===

<blockquote>
The reverse of GlobalToLocal -- converts the coordinates in event from the local window coordinates to global screen coordinates.
</blockquote>

===<br /> (Parse stringPtr) ===

<blockquote>
Parses the string pointed to by stringPtr and returns TRUE if the kernel could parse the string, FALSE otherwise. The kernel can parse the string if all the words in the string are in the game's vocabulary (the file vocab.000) and the sentence structure is one recognized by the kernel's grammar.
</blockquote>

===<br /> 
(SetSynonyms regionList) ===

<blockquote>
Lets the kernel known about the synonyms in each region.
</blockquote>

===<br /> (MapKeyToDir flag) ===

<blockquote>
If flag is TRUE(default), direction keys are mapped to direction events,  otherwise if FALSE, direction keys are mapped to keyDown events.
</blockquote>

&nbsp;

;Notes
<references />

&nbsp;

[[SCI Kernel Documentation | Table of Contents]]

&nbsp;

<span style="float: left">[[SCI Kernel Documentation/Graphic Screen Functions|&lt; Previous: Graphic Screen Functions]]</span>
<span style="float: right">[[SCI Kernel Documentation/Menu Functions|Next: Menu Functions &gt;]]</span>

&nbsp;

[[Category:SCI Documentation]]
[[Category:Kernel Functions]]
[[Category:Input]]
[[Category:Input Functions]]