Sensor degradation with range or facing - Revision history

SypheDMar: /* Nested 'when'-based event */

2013-03-05T17:17:20Z

Nested 'when'-based event

← Older revision		Revision as of 17:17, 5 March 2013
Line 104:		Line 104:
	- <span style="color:red">op</span> ship-unstealthy		- <span style="color:red">op</span> ship-unstealthy
	# <argument>		# <argument>
	~~Notte~~ the use of nested 'when' operators to cover three distinct sets of possibilities (in this case, distance brackets, but anything goes) within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).		Note the use of nested 'when' operators to cover three distinct sets of possibilities (in this case, distance brackets, but anything goes) within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).

	The trigger conditions for each distance bracket are complicated by the fact that for this example, the direction the player is facing is also taken into account - If a ship is within a 60-degree forward cone of the player, it can be targeted at a significantly greater distance than otherwise. To account for this, each distance bracket actually has two distinct sets of trigger conditions, one for when the player is facing the right way, and one for when he isn't. And each of those sets in itself may require multiple conditions. This is all accomplished with a combination of [[and]] operators and [[or]] operators, allowing very precise tuning of when an given action should be triggered.		The trigger conditions for each distance bracket are complicated by the fact that for this example, the direction the player is facing is also taken into account - If a ship is within a 60-degree forward cone of the player, it can be targeted at a significantly greater distance than otherwise. To account for this, each distance bracket actually has two distinct sets of trigger conditions, one for when the player is facing the right way, and one for when he isn't. And each of those sets in itself may require multiple conditions. This is all accomplished with a combination of [[and]] operators and [[or]] operators, allowing very precise tuning of when an given action should be triggered.

SypheDMar at 16:43, 3 October 2011

2011-10-03T16:43:05Z

← Older revision		Revision as of 16:43, 3 October 2011
Line 229:		Line 229:

	Also note that the last case is not an 'if-then-else', but a 'when', just as in the first version of the event. This is because it is the last case, and as such there is no 'else' if this fails as well. However, it is NOT a default case which will always be carried out should the other two fail. Were that the case, the actions in it could simply be tacked onto the third-and-beyond argument of the second 'if-then-else', with no need for the 'when'.		Also note that the last case is not an 'if-then-else', but a 'when', just as in the first version of the event. This is because it is the last case, and as such there is no 'else' if this fails as well. However, it is NOT a default case which will always be carried out should the other two fail. Were that the case, the actions in it could simply be tacked onto the third-and-beyond argument of the second 'if-then-else', with no need for the 'when'.

			==See also==
			*[[FreeSpace 2 Tactical#Stealth Missions\|Stealth missions]]
			*[[Stealthing ships to force target loss]]


	[[Category:FRED Examples]]		[[Category:FRED Examples]]

Shade: Fixed up to make it actually work. This time, tested!

2011-02-22T19:28:13Z

Fixed up to make it actually work. This time, tested!

← Older revision		Revision as of 19:28, 22 February 2011
Line 80:		Line 80:
	# <argument>		# <argument>
	- <span style="color:red">op</span> when		- <span style="color:red">op</span> when
	- <span style="color:red">op</span> ~~and~~		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> =		- <span style="color:red">op</span> <=
	~~# 1~~		- <span style="color:red">op</span> distance
	- <span style="color:red">op</span> ~~is-ship-visible~~
	# <argument>		# <argument>
	- <span style="color:red">op</span> ~~is-ship-stealthy~~		# Alpha 1
			# 1000
			- <span style="color:red">op</span> facing
	# <argument>		# <argument>
	- <span style="color:red">op</span> or		# 60
	- <span style="color:red">op</span> ~~and~~		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> <=		- <span style="color:red">op</span> <=
	- <span style="color:red">op</span> ~~distance~~		- <span style="color:red">op</span> distance
	~~# <argument>~~		# <argument>
	~~# Alpha 1~~		# Alpha 1
	~~# 1000~~		# 300
			- <span style="color:red">op</span> not
	- <span style="color:red">op</span> facing		- <span style="color:red">op</span> facing
	# <argument>		# <argument>
	# 60		# 60
	~~- <span style="color:red">op</span> and~~		- <span style="color:red">op</span> ship-visible
	~~- <span style="color:red">op</span> <=~~		# <argument>
	~~- <span style="color:red">op</span> distance~~		- <span style="color:red">op</span> ship-unstealthy
	~~# <argument>~~		# <argument>
	~~# Alpha 1~~		Notte the use of nested 'when' operators to cover three distinct sets of possibilities (in this case, distance brackets, but anything goes) within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).
	~~# 300~~
	~~- <span style="color:red">op</span> not~~
	~~- <span style="color:red">op</span> facing~~
	~~# <argument>~~
	~~# 60~~
	- <span style="color:red">op</span> ship-visible
	# <argument>
	- <span style="color:red">op</span> ship-unstealthy
	# <argument>

	~~Note~~ the use of nested 'when' operators to cover three distinct sets of possibilities (in this case, distance brackets, but anything goes) within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).

	The trigger conditions for each distance bracket are complicated by the fact that for this example, the direction the player is facing is also taken into account - If a ship is within a 60-degree forward cone of the player, it can be targeted at a significantly greater distance than otherwise. To account for this, each distance bracket actually has two distinct sets of trigger conditions, one for when the player is facing the right way, and one for when he isn't. And each of those sets in itself may require multiple conditions. This is all accomplished with a combination of [[and]] operators and [[or]] operators, allowing very precise tuning of when an given action should be triggered.		The trigger conditions for each distance bracket are complicated by the fact that for this example, the direction the player is facing is also taken into account - If a ship is within a 60-degree forward cone of the player, it can be targeted at a significantly greater distance than otherwise. To account for this, each distance bracket actually has two distinct sets of trigger conditions, one for when the player is facing the right way, and one for when he isn't. And each of those sets in itself may require multiple conditions. This is all accomplished with a combination of [[and]] operators and [[or]] operators, allowing very precise tuning of when an given action should be triggered.

Shade: /* If-then-else-based Event */ layout

2011-02-22T18:52:41Z

If-then-else-based Event: layout

← Older revision		Revision as of 18:52, 22 February 2011
Line 203:		Line 203:
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> =		- <span style="color:red">op</span> =
	# 1		# 1
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> is-ship-visible
	# <argument>		# <argument>
	- <span style="color:red">op</span> is-ship-stealthy		- <span style="color:red">op</span> is-ship-stealthy
	# <argument>		# <argument>

Shade: minor fix

2011-02-19T14:01:43Z

minor fix

← Older revision		Revision as of 14:01, 19 February 2011
Line 83:		Line 83:
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> =		- <span style="color:red">op</span> =
	# 0		# 1
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> is-ship-visible
	# <argument>		# <argument>
Line 203:		Line 203:
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> =		- <span style="color:red">op</span> =
	# 0		# 1
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> is-ship-visible
	# <argument>		# <argument>

Shade: Fixed an error in the event

2011-02-19T13:44:36Z

Fixed an error in the event

← Older revision		Revision as of 13:44, 19 February 2011
Line 39:		Line 39:
	- <span style="color:red">op</span> and		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> =
	# <argument>		# 2
			- <span style="color:red">op</span> is-ship-visible
			# <argument>
	- <span style="color:red">op</span> is-ship-stealthy		- <span style="color:red">op</span> is-ship-stealthy
	# <argument>		# <argument>
Line 80:		Line 82:
	- <span style="color:red">op</span> and		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> ~~not~~		- <span style="color:red">op</span> =
			# 0
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> is-ship-visible
	# <argument>		# <argument>
Line 154:		Line 157:
	- <span style="color:red">op</span> and		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> is-ship-visible		- <span style="color:red">op</span> =
	# <argument>		# 2
			- <span style="color:red">op</span> is-ship-visible
			# <argument>
	- <span style="color:red">op</span> is-ship-stealthy		- <span style="color:red">op</span> is-ship-stealthy
	# <argument>		# <argument>
Line 197:		Line 202:
	- <span style="color:red">op</span> and		- <span style="color:red">op</span> and
	- <span style="color:red">op</span> or		- <span style="color:red">op</span> or
	- <span style="color:red">op</span> ~~not~~		- <span style="color:red">op</span> =
	- <span style="color:red">op</span> is-ship-visible		# 0
	# <argument>		- <span style="color:red">op</span> is-ship-visible
			# <argument>
	- <span style="color:red">op</span> is-ship-stealthy		- <span style="color:red">op</span> is-ship-stealthy
	# <argument>		# <argument>

Shade: Improved comments

2011-02-19T13:22:31Z

Improved comments

← Older revision		Revision as of 13:22, 19 February 2011
Line 1:		Line 1:
	The following event is based on an idea by SypheDMar, as proposed in #freespace. It will, in theory, make a set of fighters either be invisible, show up as a fuzzy radar blip, or be fully targetable, all depending on their range to the player as well as whether the player is facing them (or more specifically if he has them within a 60-degree forward cone). Detailed explanation below, but without further ado, the event itself:		The following event is based on an idea by SypheDMar, as proposed in #freespace. It will, in theory, make a set of fighters either be invisible, show up as a fuzzy radar blip, or be fully targetable, all depending on their range to the player as well as whether the player is facing them (or more specifically if he has them within a 60-degree forward cone).

			==Nested 'when'-based event==

			The following version of the event demonstrates a number of things, not the least of which are nested 'when' operators, shared argument list between the nested whens, and considerable use of and/or-operators to fine tune triggers. Detailed explanation below, but without further ado, the event itself:

	- <span style="color:red">op</span> when-argument		- <span style="color:red">op</span> when-argument
Line 106:		Line 110:
	# <argument>		# <argument>

	Note the use of nested 'when' operators to cover three distinct sets of possibilities within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).		Note the use of nested 'when' operators to cover three distinct sets of possibilities (in this case, distance brackets, but anything goes) within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).

			The trigger conditions for each distance bracket are complicated by the fact that for this example, the direction the player is facing is also taken into account - If a ship is within a 60-degree forward cone of the player, it can be targeted at a significantly greater distance than otherwise. To account for this, each distance bracket actually has two distinct sets of trigger conditions, one for when the player is facing the right way, and one for when he isn't. And each of those sets in itself may require multiple conditions. This is all accomplished with a combination of [[and]] operators and [[or]] operators, allowing very precise tuning of when an given action should be triggered.

			Finally, each distance bracket has a further condition which checks whether the ship currently being looked at is already set up for the bracket. Why? There's no point changing anything if nothing needs to be changed, and it's a waste of resources to, say, go setting invisibility flags for twenty ships every frame if they already have it set. It isn't strictly necessary to include such a check, but optimising where you can is a good habit to get into.

			==If-then-else-based Event==

	Now, using the above event (or three seperate ones), every distance bracket will get checked every frame against the argument list. Which, on the surface of it, is exactly what you want. But what if you could make it so the distance brackets are checked in turn, the next one in line only checked if the first one fails? That would surely save some CPU cycles. The thing is, you can. FreeSpace_Open now includes an [[if-then-else]] operator, which will let us do precisely that:		Now, using the above event (or three seperate ones), every distance bracket will get checked every frame against the argument list. Which, on the surface of it, is exactly what you want. But what if you could make it so the distance brackets are checked in turn, the next one in line only checked if the first one fails? That would surely save some CPU cycles. The thing is, you can. FreeSpace_Open now includes an [[if-then-else]] operator, which will let us do precisely that:

Shade: Improved comments

2011-02-16T17:23:06Z

Improved comments

← Older revision		Revision as of 17:23, 16 February 2011
Line 219:		Line 219:
	In the revised event above, [[if-then-else]] is used to check the three distance brackets in sequence. If a ship is shown to place within a bracket, it acts on that and breaks out, whereas if a ship is not within the bracket being checked, it moves on to the next bracket and checks that instead. This reduces the amount of checks that happen compared to the first version of the event, and as a result will place a slightly lower demand on system resources. And while this is generally not a noticable effect, every CPU cycle does count.		In the revised event above, [[if-then-else]] is used to check the three distance brackets in sequence. If a ship is shown to place within a bracket, it acts on that and breaks out, whereas if a ship is not within the bracket being checked, it moves on to the next bracket and checks that instead. This reduces the amount of checks that happen compared to the first version of the event, and as a result will place a slightly lower demand on system resources. And while this is generally not a noticable effect, every CPU cycle does count.

	Note the use of an additional nested 'when' in the second if-then-else. This is necessary as there is more than one action to be taken, and only the second argument of the if-then-else operator is the action to be taken if it is true - Third and beyond is for when it is false. Hence, the 'when' is used to group two actions into one argument.		Note the use of an additional nested 'when' in the second 'if-then-else'. This is necessary as there is more than one action to be taken, and only the second argument of the 'if-then-else' operator is the action to be taken if it is true - Third and beyond is for when it is false. Hence, the 'when' is used to group two actions into one argument.

			Also note that the last case is not an 'if-then-else', but a 'when', just as in the first version of the event. This is because it is the last case, and as such there is no 'else' if this fails as well. However, it is NOT a default case which will always be carried out should the other two fail. Were that the case, the actions in it could simply be tacked onto the third-and-beyond argument of the second 'if-then-else', with no need for the 'when'.

	[[Category:FRED Examples]]		[[Category:FRED Examples]]

Shade: Added an if-then-else version of the example event

2011-02-16T17:15:28Z

Added an if-then-else version of the example event

← Older revision		Revision as of 17:15, 16 February 2011
Line 107:		Line 107:

	Note the use of nested 'when' operators to cover three distinct sets of possibilities within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).		Note the use of nested 'when' operators to cover three distinct sets of possibilities within the same event, which allows them to draw on the same argument list. This is not terribly important in this particular case, as no arguments are invalidated or revalidated, but it is kept as one event for demonstration purposes. If one prefers, the event could easily be split in three without any change in functionality (one for each distance bracket).

			Now, using the above event (or three seperate ones), every distance bracket will get checked every frame against the argument list. Which, on the surface of it, is exactly what you want. But what if you could make it so the distance brackets are checked in turn, the next one in line only checked if the first one fails? That would surely save some CPU cycles. The thing is, you can. FreeSpace_Open now includes an [[if-then-else]] operator, which will let us do precisely that:

			- <span style="color:red">op</span> when-argument
			- <span style="color:red">op</span> any-of
			# <list of ships for which to apply range/facing-based targetability>
			- <span style="color:red">op</span> true
			- <span style="color:red">op</span> if-then-else
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> not
			- <span style="color:red">op</span> is-ship-stealthy
			# <argument>
			- <span style="color:red">op</span> or
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> >
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 3000
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> >
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 1000
			- <span style="color:red">op</span> not
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> ship-stealthy
			# <argument>
			- <span style="color:red">op</span> if-then-else
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> or
			- <span style="color:red">op</span> is-ship-visible
			# <argument>
			- <span style="color:red">op</span> is-ship-stealthy
			# <argument>
			- <span style="color:red">op</span> or
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> <=
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 3000
			- <span style="color:red">op</span> >
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 1000
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> <=
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 1000
			- <span style="color:red">op</span> >
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 300
			- <span style="color:red">op</span> not
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> when
			- <span style="color:red">op</span> true
			- <span style="color:red">op</span> ship-invisible
			# <argument>
			- <span style="color:red">op</span> ship-unstealthy
			# <argument>
			- <span style="color:red">op</span> when
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> or
			- <span style="color:red">op</span> not
			- <span style="color:red">op</span> is-ship-visible
			# <argument>
			- <span style="color:red">op</span> is-ship-stealthy
			# <argument>
			- <span style="color:red">op</span> or
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> <=
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 1000
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> and
			- <span style="color:red">op</span> <=
			- <span style="color:red">op</span> distance
			# <argument>
			# Alpha 1
			# 300
			- <span style="color:red">op</span> not
			- <span style="color:red">op</span> facing
			# <argument>
			# 60
			- <span style="color:red">op</span> ship-visible
			# <argument>
			- <span style="color:red">op</span> ship-unstealthy
			# <argument>

			In the revised event above, [[if-then-else]] is used to check the three distance brackets in sequence. If a ship is shown to place within a bracket, it acts on that and breaks out, whereas if a ship is not within the bracket being checked, it moves on to the next bracket and checks that instead. This reduces the amount of checks that happen compared to the first version of the event, and as a result will place a slightly lower demand on system resources. And while this is generally not a noticable effect, every CPU cycle does count.

			Note the use of an additional nested 'when' in the second if-then-else. This is necessary as there is more than one action to be taken, and only the second argument of the if-then-else operator is the action to be taken if it is true - Third and beyond is for when it is false. Hence, the 'when' is used to group two actions into one argument.

	[[Category:FRED Examples]]		[[Category:FRED Examples]]

Shade: minor fix

2011-02-16T16:52:47Z

minor fix

← Older revision		Revision as of 16:52, 16 February 2011
Line 4:		Line 4:
	- <span style="color:red">op</span> any-of		- <span style="color:red">op</span> any-of
	# <list of ships for which to apply range/facing-based targetability>		# <list of ships for which to apply range/facing-based targetability>
			- <span style="color:red">op</span> true
	- <span style="color:red">op</span> when		- <span style="color:red">op</span> when
	- <span style="color:red">op</span> and		- <span style="color:red">op</span> and