Button Functionality and Frob Triggers - Revision history

RJFerret: /* Assign targets to the button */ +wikilink

2014-03-03T03:18:53Z

Assign targets to the button: +wikilink

← Older revision		Revision as of 03:18, 3 March 2014
Line 14:		Line 14:
	=== Assign targets to the button ===		=== Assign targets to the button ===
	(Add the property : 'target' to the button and the value will be the name of the entity to be functioned)		(Add the property : 'target' to the button and the value will be the name of the entity to be functioned)
	They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.		They will now be [[Triggers\|triggered]] when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.

	=== To add a custom script to the button ===		=== To add a custom script to the button ===

Tels: fix methods

2012-08-24T09:58:55Z

fix methods

← Older revision		Revision as of 09:58, 24 August 2012
Line 73:		Line 73:
	{		{
	// open the secret door for 30 seconds		// open the secret door for 30 seconds
	$secret_door_1.~~ToggleOpen~~();		$secret_door_1.Open();
	sys.wait( 30 );		sys.wait( 30 );

	// close the secret door after 30 seconds		// close the secret door after 30 seconds
	$secret_door_1.~~ToggleOpen~~();		$secret_door_1.Close();

	// pop the button back up		// pop the button back up

Greebo: /* Comparison of Methods A and B */

2008-07-02T13:01:40Z

Comparison of Methods A and B

← Older revision		Revision as of 13:01, 2 July 2008
Line 91:		Line 91:
	'''Also: Added generic response of triggering of targets into the global frob action scripts (/scripts/tdm_frobactions.script).'''		'''Also: Added generic response of triggering of targets into the global frob action scripts (/scripts/tdm_frobactions.script).'''

	To create an entity that only triggers another entity when frobbed, either place a ~~"func_darkmod_frobable_base~~," or place any other item, set "frobable" to "1" ~~and set~~ "frob_action_script" to "frob_trigger"		To create an entity that only triggers another entity when frobbed, either place a [[atdm:frobable_base]], which works right out of the box or place any other item and set
			"frobable" "1"
			"frob_action_script" "frob_trigger"
	Inventory items trigger their targets when frobbed, doors trigger their targets when frobbed. Note that in these cases, the trigger is sent on every frob. That means if a player spasmadically presses frob 30 times in a second, the trigger will be sent 30 times, so you'd better make sure it is a target is a trigger_once or something like that if you don't want your trigger executing 30 times. Also if an item is trapped when you pick it up, make sure the trap can only get triggered once and then stops receiving triggers, otherwise it will keep going off if you drop the item and pick it up again and again.		Inventory items trigger their targets when frobbed, doors trigger their targets when frobbed. Note that in these cases, the trigger is sent on every frob. That means if a player spasmadically presses frob 30 times in a second, the trigger will be sent 30 times, so you'd better make sure it is a target is a trigger_once or something like that if you don't want your trigger executing 30 times. Also if an item is trapped when you pick it up, make sure the trap can only get triggered once and then stops receiving triggers, otherwise it will keep going off if you drop the item and pick it up again and again.

Greebo: /* Levers */

2008-07-02T12:59:03Z

Levers

← Older revision		Revision as of 12:59, 2 July 2008
Line 10:		Line 10:

	=== Levers ===		=== Levers ===
	Levers are ~~essentially rotating~~ buttons. Create exactly as for a button but assign a rotate property with X Y Z values for the direction and amount of rotation you want, eg, 45 0 0. Make sure the translate property is set to 0 0 0 (though they do work together if you want a lever that both rotates and translates as well.) Obviously also assign a lever shaped brush or model.		Levers are similar to buttons, but you need to use the atdm:mover_lever subclass (see also [[CFrobLever]]). Create exactly as for a button but assign a rotate property with X Y Z values for the direction and amount of rotation you want, eg, 45 0 0. Make sure the translate property is set to 0 0 0 (though they do work together if you want a lever that both rotates and translates as well.) Obviously also assign a lever shaped brush or model.

	=== Assign targets to the button ===		=== Assign targets to the button ===

Tels: shorten headline and cleanup

2007-11-02T02:24:42Z

shorten headline and cleanup

Fidcal: /* Place a func_darkmod_button in your map */

2007-11-02T01:03:25Z

Place a func_darkmod_button in your map

← Older revision		Revision as of 01:03, 2 November 2007
Line 6:		Line 6:

	= To create a simple button that triggers one or more entities when depressed =		= To create a simple button that triggers one or more entities when depressed =
	== Place a ~~func_darkmod_button~~ in your map ==		== Place a atdm:mover_button in your map ==
	Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).		Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).

Fidcal: /* Place a func_darkmod_button in your map */

2007-11-02T00:43:29Z

Place a func_darkmod_button in your map

← Older revision		Revision as of 00:43, 2 November 2007
Line 8:		Line 8:
	== Place a func_darkmod_button in your map ==		== Place a func_darkmod_button in your map ==
	Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).		Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).

			== Levers ==
			Levers are essentially rotating buttons. Create exactly as for a button but assign a rotate property with X Y Z values for the direction and amount of rotation you want, eg, 45 0 0. Make sure the translate property is set to 0 0 0 (though they do work together if you want a lever that both rotates and translates as well.) Obviously also assign a lever shaped brush or model.

	== Assign targets to the button ==		== Assign targets to the button ==

Fidcal: /* Assign targets to the button */

2007-09-24T19:11:29Z

Assign targets to the button

← Older revision		Revision as of 19:11, 24 September 2007
Line 10:		Line 10:

	== Assign targets to the button ==		== Assign targets to the button ==
			(Add the property : 'target' to the button and the value will be the name of the entity to be functioned)
	They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.		They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.

Greebo at 05:43, 11 September 2006

2006-09-11T05:43:14Z

New page

{{Original_Reference|Ishtvan|4022}}

I added some global frob action scripts and button defs to make buttons more intuitive for the mapper.

Note: This doc relies on other information in the door documentation.

= To create a simple button that triggers one or more entities when depressed =
== Place a func_darkmod_button in your map ==
Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).

== Assign targets to the button ==
They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.

== To add a custom script to the button ==
If you want your button to do more than just trigger something, you'll need to write a script. There's two ways to go about this:

= Entity Scriptobject Method (7 steps) =
# Create your button as described above.
# Place a new entity of class: target_callobjectfunction
# Set the target of the target_callobjectfunction to itself (alternatively you could set it to another entity and call the script on that entity, but that's not necessary)
# Set the key "call" to the name of the script you will write
# Set the key "scriptobject" to the name of the script object you will define
# Go into the map's script file and create a new object, using the following code:
# Define a member function of this object with the script that you want to run, and write the script.

The code below describes generally how to do steps 6 and 7:

=== Code in <your map name>.script ===
object <object name>
{
// your script function declaration
}

<object name>::<your script function name>
{
// your script function implementation
}

= Global scope method (4 steps - probably easier) =
* Create your button as described above.
* Set the key "state_change_callback" to the name of a script you'll define globally in the script file for your map. (Must be named <map name>.script).
* Unfortunately, due to how D3 scripting works, you'll have to copy the code to pop the button back up if you use the global scope method. Also, this script must have certain arguments because that's how it's called from the SDK. Copy and paste the following script for your button, replacing it with the name:

void <your function name>(entity button, boolean bOpen, boolean bLocked, boolean bInterrupted)
{
if(bOpen)
{
button.Close(1);
}
}

* Now, insert the script code that you want to run when the button is pressed here:

void state_change_button(entity button, boolean bOpen, boolean bLocked, boolean bInterrupted)
{
if(bOpen)
{
// YOUR CODE GOES HERE
button.Close(1);
}
}

== Example ==
Optionally, you could add some interesting behavior here, like the button stays down for a while and then calls another script when it pops back up. To do that, you could do this:

void state_change_secret_door(entity button, boolean bOpen, boolean bLocked, boolean bInterrupted)
{
if(bOpen)
{
// open the secret door for 30 seconds
$secret_door_1.ToggleOpen();
sys.wait( 30 );

// close the secret door after 30 seconds
$secret_door_1.ToggleOpen();

// pop the button back up
button.Close(1);
}
}

== Comparison of Methods A and B ==
In Method A, you did not have to copy & paste the code to pop the button back up, because you were not creating a new state change function, the state change happens as usual and then triggers the target_callobjectfunction to call the script. This is probably the only advantage of Method A, other than being more OO to have local script functions instead of map-global ones.

In Method B you do have to copy the code to pop the button back up, but it's probably easier in terms of the number of steps required, since you can just change one key on the button and then put a global-scope script in the map.script file.

'''Also: Added generic response of triggering of targets into the global frob action scripts (/scripts/tdm_frobactions.script).'''

To create an entity that only triggers another entity when frobbed, either place a "func_darkmod_frobable_base," or place any other item, set "frobable" to "1" and set "frob_action_script" to "frob_trigger"

Inventory items trigger their targets when frobbed, doors trigger their targets when frobbed. Note that in these cases, the trigger is sent on every frob. That means if a player spasmadically presses frob 30 times in a second, the trigger will be sent 30 times, so you'd better make sure it is a target is a trigger_once or something like that if you don't want your trigger executing 30 times. Also if an item is trapped when you pick it up, make sure the trap can only get triggered once and then stops receiving triggers, otherwise it will keep going off if you drop the item and pick it up again and again.

If you want more complicated behavior for doors to trigger their targets only when completely open or closed, you'll have to either write your own state_change_callback script or use Sparhawk's setup for frobables triggering other frobables that should be covered in the door documentation.

[[Category:Scripting]]
[[Category:Editing]]

← Older revision		Revision as of 02:24, 2 November 2007
Line 3:		Line 3:
	I added some global frob action scripts and button defs to make buttons more intuitive for the mapper.		I added some global frob action scripts and button defs to make buttons more intuitive for the mapper.

	Note: This doc relies on other information in the door ~~documentation~~.		Note: This doc relies on other information in the [[doors\|door tutorial]].

	= ~~To create a~~ simple button that triggers one or more entities ~~when depressed~~ =		== A simple button that triggers one or more entities ==
	== Place a atdm:mover_button in your map ==		=== Place a atdm:mover_button in your map ===
	Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).		Assign a brush or model for it as you would for a func_darkmod_door. Modify the translation direction and speed so that the button moves in the direction you want. (Again see the documentation for translation in doors, or see the "entity usage" tab in the editor).

	== Levers ==		=== Levers ===
	Levers are essentially rotating buttons. Create exactly as for a button but assign a rotate property with X Y Z values for the direction and amount of rotation you want, eg, 45 0 0. Make sure the translate property is set to 0 0 0 (though they do work together if you want a lever that both rotates and translates as well.) Obviously also assign a lever shaped brush or model.		Levers are essentially rotating buttons. Create exactly as for a button but assign a rotate property with X Y Z values for the direction and amount of rotation you want, eg, 45 0 0. Make sure the translate property is set to 0 0 0 (though they do work together if you want a lever that both rotates and translates as well.) Obviously also assign a lever shaped brush or model.

	== Assign targets to the button ==		=== Assign targets to the button ===
	(Add the property : 'target' to the button and the value will be the name of the entity to be functioned)		(Add the property : 'target' to the button and the value will be the name of the entity to be functioned)
	They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.		They will now be triggered when the button is depressed. For example, if you assign a light, the light will be turned on and off by the button.

	== To add a custom script to the button ==		=== To add a custom script to the button ===
	If you want your button to do more than just trigger something, you'll need to write a script. There's two ways to go about this:		If you want your button to do more than just trigger something, you'll need to write a script. There's two ways to go about this:

	= Entity Scriptobject Method (7 steps) =		== Entity Scriptobject Method (7 steps) ==
	# Create your button as described above.		# Create your button as described above.
	# Place a new entity of class: target_callobjectfunction		# Place a new entity of class: target_callobjectfunction
Line 30:		Line 30:
	The code below describes generally how to do steps 6 and 7:		The code below describes generally how to do steps 6 and 7:

	=== Code in <your map name>.script ===		==== Code in <your map name>.script ====
	object <object name>		object <object name>
	{		{
Line 41:		Line 41:
	}		}

	= Global scope method (4 steps - probably easier) =		== Global scope method (4 steps - probably easier) ==
	* Create your button as described above.		* Create your button as described above.
	* Set the key "state_change_callback" to the name of a script you'll define globally in the script file for your map. (Must be named <map name>.script).		* Set the key "state_change_callback" to the name of a script you'll define globally in the script file for your map. (Must be named <map name>.script).
Line 65:		Line 65:
	}		}

			=== Example ===
	== Example ==
	Optionally, you could add some interesting behavior here, like the button stays down for a while and then calls another script when it pops back up. To do that, you could do this:		Optionally, you could add some interesting behavior here, like the button stays down for a while and then calls another script when it pops back up. To do that, you could do this:

Line 85:		Line 84:
	}		}

	== Comparison of Methods A and B ==		=== Comparison of Methods A and B ===
	In Method A, you did not have to copy & paste the code to pop the button back up, because you were not creating a new state change function, the state change happens as usual and then triggers the target_callobjectfunction to call the script. This is probably the only advantage of Method A, other than being more OO to have local script functions instead of map-global ones.		In Method A, you did not have to copy & paste the code to pop the button back up, because you were not creating a new state change function, the state change happens as usual and then triggers the target_callobjectfunction to call the script. This is probably the only advantage of Method A, other than being more OO to have local script functions instead of map-global ones.

Line 98:		Line 97:
	If you want more complicated behavior for doors to trigger their targets only when completely open or closed, you'll have to either write your own state_change_callback script or use Sparhawk's setup for frobables triggering other frobables that should be covered in the door documentation.		If you want more complicated behavior for doors to trigger their targets only when completely open or closed, you'll have to either write your own state_change_callback script or use Sparhawk's setup for frobables triggering other frobables that should be covered in the door documentation.

	~~[[Category:Scripting]]~~		{{scripting}}
	~~[[Category:Editing]]~~