Andrew Korson: Created page with "The '''set.key''' command assigns a keyboard shortcut to a controller. == Syntax == set.key(byt ASCII, byt SCAN, ctl cCTRL); == Remark..."

2019-04-21T17:39:18Z

Created page with "The '''set.key''' command assigns a keyboard shortcut to a controller. == Syntax == set.key(byt ASCII, byt SCAN, ctl cCTRL); == Remark..."

New page

The '''set.key''' command assigns a keyboard shortcut to a controller.

== Syntax ==

set.key([[number|byt]] ASCII, [[number|byt]] SCAN, [[controllers|ctl]] cCTRL);

== Remarks ==

The key combination derived from '''ASCII''' and '''SCAN''' codes are assigned to [[controller]] '''cCTRL'''. To assign an '''ASCII''' key press to a controller, the '''SCAN''' value should be zero. To assign a '''SCAN''' code key press, the '''ASCII''' value should be zero.

For a list of usable '''ASCII''' and '''SCAN''' code values that can be assigned, see the [[Setting Up Keyboard Shortcuts]] topic.

== Possible Errors ==

If an invalid combination of '''ASCII''' and '''SCAN''' is used, AGI will assign the controller, but it will just take up space in the [[controller assignment table]] and not do anything.

Similarly, if you use an invalid [[controller]] value, you will waste a space in the [[controller assignment table]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
set.key(0, 59, c1); [ F1 to controller 1
set.key(9, 0, c2); [ Tab key to controller 2
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 121 (0x79 hex)
|}

== See Also ==

[[Player Input Commands]]<br />
[[Category:Commands]]<br />

Set.key - Revision history

Andrew Korson: Created page with "The '''set.key''' command assigns a keyboard shortcut to a controller. == Syntax == set.key(byt ASCII, byt SCAN, ctl cCTRL); == Remark..."