Andrew Branscom: 1 revision

2013-08-05T21:23:53Z

1 revision

Andrew Branscom at 23:42, 5 January 2011

2011-01-05T23:42:19Z

New page

=Chapter 8 - Advanced use of control areas=

The main set of SCI tutorials shows that the way to check if the ego is on a particular control area is the following:

<blockquote>
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs">(instance RoomScript of Script
(properties)
(method (doit)
(if(== (send gEgo:onControl()) ctlGREEN)
(send gRoom:newRoom(1))
)
)
)</syntaxhighlight>
</blockquote>

If the ego is on GREEN, then he is sent to a new room.

That's only part of the story. The value returned by '''onControl()''' is actually a bit mask, which can contain any combination of the following values:

<blockquote>
These are defined in sci.sh:
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs">(define ctlBLACK $0001)
(define ctlNAVY $0002)
(define ctlGREEN $0004)
(define ctlTEAL $0008)
(define ctlMAROON $0010)
(define ctlPURPLE $0020)
(define ctlBROWN $0040)
(define ctlSILVER $0080)
(define ctlGREY $0100)
(define ctlBLUE $0200)
(define ctlLIME $0400)
(define ctlCYAN $0800)
(define ctlRED $1000)
(define ctlFUCHSIA $2000)
(define ctlYELLOW $4000)
(define ctlWHITE $8000)</syntaxhighlight>
</blockquote>

This makes sense, because the 'footprint' of the ego (or any '''Act''' class) is actually a two-dimensional area, not a single point.Â Therefore, he may be on several colors at once.

<blockquote>
To detect if the ego is ''completely'' on one color do the following:
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs"> (if (== (send gEgo:onControl()) ctlGREEN)
// Ego is completely on green (no part of his footprint hits black, even).
)</syntaxhighlight>
</blockquote>

<blockquote>
To detect if some part of the ego's footprint is touching a particular color:
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs"> (if (& (send gEgo:onControl()) ctlGREEN)
// Part of ego is touching green.
)</syntaxhighlight>
</blockquote>

<blockquote>
To detect if the ego is touching one or more of ctlGREEN and ctlCYAN, do the following:
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs"> (if (& (send gEgo:onControl()) (| ctlGREEN ctlCYAN))
// Ego is touching green or cyan.
)</syntaxhighlight>
</blockquote>

<blockquote>
To detect if the ego is touching both ctlGREEN and ctlCYAN exclusively, do the following:
<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="sci" class="cs"> (if (& (send gEgo:onControl()) (| ctlGREEN ctlCYAN))
// Ego is touching green or cyan.
)</syntaxhighlight>

Basically, just remember it is a bit-mask, so the '&' and '|' operators are your friends.

 

<span style="float: left">[[Memory Management|< Previous: Chapter 7 - Memory Management (advanced)]]</span><span style="float: right">[[SCI_Point_and_Click_Tutorial|Next: Cloudee1's SCI Point and Click Tutorial >]]</span>

 

[[Category:Control Areas]]
[[Category:Tutorials]]

← Older revision	Revision as of 21:23, 5 August 2013
(No difference)

Advanced Use of Control Areas - Revision history

Andrew Branscom: 1 revision

Andrew Branscom at 23:42, 5 January 2011