This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 13:29, 4 May 2007 (edit) Sandman (Talk | contribs) m ← Previous diff		Current revision (11:23, 21 July 2008) (edit) (undo) Sandman (Talk | contribs) m
(3 intermediate revisions not shown.)
Line 3:		Line 3:
	== Definition ==		== Definition ==
-	'''INT''' Signal ( <'''INT''' processID|processTypeID> , <'''INT''' signal> )	+	'''INT''' signal ( <'''INT''' processID|processTypeID> , <'''INT''' signal> )
-	Allows a [[process]] or a range of processes of certain [[processType]] to be controlled in a limited number of ways, by sending [[signals]].	+	Allows a [[process]]/[[function]] or a range of processes/functions of certain [[processType]] to be controlled in a limited number of ways, by sending [[signals]].
	== Parameters ==		== Parameters ==
Line 15:		Line 15:
	== Returns ==		== Returns ==
-	'''INT''' : Successrate	+	'''INT''' :
	{|		{|
-	| [[false]] || - There was an error.	+	| [[false]] || - The specified processID<nowiki>|</nowiki>processTypeID was 0 or a [[processTypeID]].
	|-		|-
-	| [[true]] || - Sending was successful.	+	| [[true]] || - The specified processID<nowiki>|</nowiki>processTypeID was a [[processID]].
	|}		|}
	== Errors ==		== Errors ==
	{|		{|
-	| Invalid signal || - The specified signal is invalid.	+	| Invalid processID || - The [[process]] with specified processID is not alive. ''(Pre [[0.90.2]] only)''
		+	|-
		+	| Invalid signal || - The specified [[signals|signal]] is invalid.
	|}		|}
Line 30:		Line 32:
	To obtain the processType of a function, the operator [[Type]] can be used.		To obtain the processType of a function, the operator [[Type]] can be used.
	For a process to send a signal to itself, the [[local variable]] [[id]] can be used.		For a process to send a signal to itself, the [[local variable]] [[id]] can be used.
-	The parameter signal is passed by way of a set of [[constants|signals]] which denote the signal which is to be sent.	+	The parameter signal is passed by way of a set of [[signals]] which denote the signal which is to be sent.
		+
		+	To kill all processes at once, except the calling one, use [[let_me_alone]]().
	== Example ==		== Example ==
	<pre>		<pre>
-	Signal( get_id(type enemy) , s_kill ); // Kills a process of type enemy	+	signal( get_id(type enemy) , s_kill ); // Kills a process of type enemy
-	Signal( id , s_kill_tree ); // Kills the process that calls it, and all of its descendants	+	signal( id , s_kill_tree ); // Kills the process that calls it, and all of its descendants
-	Signal( Type player , s_freeze ); // Freezes all processes of type player so that they are	+	signal( Type player , s_freeze ); // Freezes all processes of type player so that they are
	// still displayed, but do not execute any code.		// still displayed, but do not execute any code.
	</pre>		</pre>
		+
		+	{{Funcbox
		+	| category = Processinteraction
		+	}}

---

Current revision

Contents 1 Definition 2 Parameters 3 Returns 4 Errors 5 Notes 6 Example

[edit] Definition

INT signal ( <INT processID|processTypeID> , <INT signal> )

Allows a process/function or a range of processes/functions of certain processType to be controlled in a limited number of ways, by sending signals.

[edit] Parameters

INT processID|processTypeID	- The ProcessID of the process or the ProcessTypeID of the type of processes to which the signal is to be sent.
INT signal	- The code of the signal that is to be sent to the target process.

[edit] Returns

INT :

false	- The specified processID|processTypeID was 0 or a processTypeID.
true	- The specified processID|processTypeID was a processID.

[edit] Errors

Invalid processID	- The process with specified processID is not alive. (Pre 0.90.2 only)
Invalid signal	- The specified signal is invalid.

[edit] Notes

To obtain the processType of a function, the operator Type can be used. For a process to send a signal to itself, the local variable id can be used. The parameter signal is passed by way of a set of signals which denote the signal which is to be sent.

To kill all processes at once, except the calling one, use let_me_alone().

[edit] Example

signal( get_id(type enemy) , s_kill ); // Kills a process of type enemy
signal( id , s_kill_tree );            // Kills the process that calls it, and all of its descendants
signal( Type player , s_freeze );      // Freezes all processes of type player so that they are
                                       //     still displayed, but do not execute any code.

Processinteraction Functions

• Advance() • Collision() • Exists() • Get_angle() • Get_dist() • Get_id() • Let_me_alone() • Signal() • Xadvance() •