Findnearactor - Revision history

Helixhorned: Fix findnear* semantics. If they returned the closest sprite, there would be no point having the argument.

2013-02-17T12:55:37Z

Fix findnear* semantics. If they returned the closest sprite, there would be no point having the <distance> argument.

← Older revision		Revision as of 05:55, 17 February 2013
Line 12:		Line 12:
	'''findnearsprite3dvar''' <[[tile number]]> <distance> <[[gamevar]]>		'''findnearsprite3dvar''' <[[tile number]]> <distance> <[[gamevar]]>

	These commands get the sprite ID of ~~the closest~~ <[[tile number]]> ~~within~~ <distance> into a <[[gamevar]]>. If no sprite within range is found, the [[gamevar]] is set to -1. The input for <[[tile number]]> may be its tile number (example: 2000) or its defined label (example: PIGCOP).		These commands get the sprite ID of ''one'' <[[tile number]]> with distance strictly less than <distance> into a <[[gamevar]]>. Note that this does not have to be the ''closest'' such <[[tile number]]>. If no sprite within range is found, the [[gamevar]] is set to -1. The input for <[[tile number]]> may be its tile number (example: 2000) or its defined label (example: PIGCOP).

	By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.		By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.

Hendricks266 at 03:35, 25 February 2011

2011-02-25T03:35:08Z

Hendricks266 at 02:36, 25 February 2011

2011-02-25T02:36:05Z

← Older revision		Revision as of 19:36, 24 February 2011
Line 20:		Line 20:
	The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height extending <zdistance> both above and below. The "3d" commands work within a sphere, with a radius of <distance>.		The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height extending <zdistance> both above and below. The "3d" commands work within a sphere, with a radius of <distance>.

	Commands with a "var" suffix take [[gamevar]]s rather than constants for their distance value(s).		Commands with an additional "var" suffix take [[gamevar]]s rather than constants for their distance value(s).

	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

Hendricks266 at 01:06, 25 February 2011

2011-02-25T01:06:56Z

← Older revision		Revision as of 18:06, 24 February 2011
Line 18:		Line 18:
	The ''actor'' finding commands work on a subset of sprites: currently awake, valid actors. The ''sprite'' finding commands work on a superset of actors: all sprites, including non-actor sprites or sleeping actors.		The ''actor'' finding commands work on a subset of sprites: currently awake, valid actors. The ''sprite'' finding commands work on a superset of actors: all sprites, including non-actor sprites or sleeping actors.

	The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height ~~of 2 times~~ <zdistance>. The "3d" commands work within a sphere, with a radius of <distance>.		The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height extending <zdistance> both above and below. The "3d" commands work within a sphere, with a radius of <distance>.

	Commands with a "var" suffix take [[gamevar]]s rather than constants for their distance value(s).		Commands with a "var" suffix take [[gamevar]]s rather than constants for their distance value(s).

Hendricks266 at 04:24, 8 January 2011

2011-01-08T04:24:28Z

← Older revision		Revision as of 21:24, 7 January 2011
Line 1:		Line 1:
	'''findnearactor''' <[[~~actor~~]]> <distance> <[[gamevar]]>		'''findnearactor''' <[[tile number]]> <distance> <[[gamevar]]><br>
			'''findnearactorvar''' <[[tile number]]> <distancevar> <[[gamevar]]><br>
			'''findnearactorz''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
			'''findnearactorzvar''' <[[tile number]]> <xydistancevar> <zdistancevar> <[[gamevar]]><br>
			'''findnearactor3d''' <[[tile number]]> <distance> <[[gamevar]]><br>
			'''findnearactor3dvar''' <[[tile number]]> <distancevar> <[[gamevar]]><br>
			'''findnearsprite''' <[[tile number]]> <distance> <[[gamevar]]><br>
			'''findnearspritevar''' <[[tile number]]> <distancevar> <[[gamevar]]><br>
			'''findnearspritez''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
			'''findnearspritezvar''' <[[tile number]]> <xydistancevar> <zdistancevar> <[[gamevar]]><br>
			'''findnearsprite3d''' <[[tile number]]> <distance> <[[gamevar]]><br>
			'''findnearsprite3dvar''' <[[tile number]]> <distancevar> <[[gamevar]]>

	~~Gets~~ the ~~actor~~ ID of the closest <[[~~actor~~]]> within <distance> into a <[[gamevar]]>. If no ~~actor~~ within range is found, the [[gamevar]] is set to -1. The input for <[[~~actor~~]]> may be its tile number (example: 2000) or its defined ~~name~~ (example: PIGCOP)~~. The <distance> will be determined on the x and y plane only; for finding actors on the x, y, and z axes use [[findnearactor3d]] instead~~.		These commands get the sprite ID of the closest <[[tile number]]> within <distance> into a <[[gamevar]]>. If no sprite within range is found, the [[gamevar]] is set to -1. The input for <[[tile number]]> may be its tile number (example: 2000) or its defined label (example: PIGCOP).

	By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.		By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.

	~~For~~ non-actor sprites or ~~asleep~~ actors, ~~use~~ [[~~findnearsprite~~]].		The ''actor'' finding commands work on a subset of sprites: currently awake, valid actors. The ''sprite'' finding commands work on a superset of actors: all sprites, including non-actor sprites or sleeping actors.

			The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height of 2 times <zdistance>. The "3d" commands work within a sphere, with a radius of <distance>.

			Commands with a "var" suffix take [[gamevar]]s rather than constants for their distance value(s).

	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

201.37.65.156 at 03:06, 25 September 2009

2009-09-25T03:06:30Z

← Older revision		Revision as of 20:06, 24 September 2009
Line 5:		Line 5:
	By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.		By getting the actor ID of a nearby actor, the current actor can use [[getactor]]/[[setactor]] to edit the properties of the target actor or [[getangle]] to face the target actor, among other potential uses.

	~~Also note that if the <[[~~actor~~]]> being located within the <distance> is~~ asleep ~~this will return a value of -1~~		For non-actor sprites or asleep actors, use [[findnearsprite]].

	~~Also see~~ [[findnearsprite]].
	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

One at 19:18, 4 May 2009

2009-05-04T19:18:29Z

← Older revision		Revision as of 12:18, 4 May 2009
Line 1:		Line 1:
	findnearactor <[[actor]]> <distance> <[[gamevar]]>		'''findnearactor''' <[[actor]]> <distance> <[[gamevar]]>

	Gets the actor ID of the closest <[[actor]]> within <distance> into a <[[gamevar]]>. If no actor within range is found, the [[gamevar]] is set to -1. The input for <[[actor]]> may be its tile number (example: 2000) or its defined name (example: PIGCOP). The <distance> will be determined on the x and y plane only; for finding actors on the x, y, and z axes use [[findnearactor3d]] instead.		Gets the actor ID of the closest <[[actor]]> within <distance> into a <[[gamevar]]>. If no actor within range is found, the [[gamevar]] is set to -1. The input for <[[actor]]> may be its tile number (example: 2000) or its defined name (example: PIGCOP). The <distance> will be determined on the x and y plane only; for finding actors on the x, y, and z axes use [[findnearactor3d]] instead.

85.137.208.231 at 12:35, 12 March 2009

2009-03-12T12:35:04Z

← Older revision		Revision as of 05:35, 12 March 2009
Line 7:		Line 7:
	Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1		Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1

	~~See also~~ [[findnearsprite]].		Also see [[findnearsprite]].
	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

Herejex at 00:14, 12 March 2009

2009-03-12T00:14:30Z

← Older revision		Revision as of 17:14, 11 March 2009
Line 7:		Line 7:
	Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1		Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1

	See also [[findnearsprite]]		See also [[findnearsprite]].
	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

Herejex at 00:13, 12 March 2009

2009-03-12T00:13:01Z

← Older revision		Revision as of 17:13, 11 March 2009
Line 7:		Line 7:
	Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1		Also note that if the <[[actor]]> being located within the <distance> is asleep this will return a value of -1

			See also [[findnearsprite]]
	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]

← Older revision		Revision as of 20:35, 24 February 2011
Line 1:		Line 1:
	'''findnearactor''' <[[tile number]]> <distance> <[[gamevar]]><br>		'''findnearactor''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearactorvar''' <[[tile number]]> <~~distancevar~~> <[[gamevar]]><br>		'''findnearactorvar''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearactorz''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>		'''findnearactorz''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
	'''findnearactorzvar''' <[[tile number]]> <~~xydistancevar~~> <~~zdistancevar~~> <[[gamevar]]><br>		'''findnearactorzvar''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
	'''findnearactor3d''' <[[tile number]]> <distance> <[[gamevar]]><br>		'''findnearactor3d''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearactor3dvar''' <[[tile number]]> <~~distancevar~~> <[[gamevar]]><br>		'''findnearactor3dvar''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearsprite''' <[[tile number]]> <distance> <[[gamevar]]><br>		'''findnearsprite''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearspritevar''' <[[tile number]]> <~~distancevar~~> <[[gamevar]]><br>		'''findnearspritevar''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearspritez''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>		'''findnearspritez''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
	'''findnearspritezvar''' <[[tile number]]> <~~xydistancevar~~> <~~zdistancevar~~> <[[gamevar]]><br>		'''findnearspritezvar''' <[[tile number]]> <xydistance> <zdistance> <[[gamevar]]><br>
	'''findnearsprite3d''' <[[tile number]]> <distance> <[[gamevar]]><br>		'''findnearsprite3d''' <[[tile number]]> <distance> <[[gamevar]]><br>
	'''findnearsprite3dvar''' <[[tile number]]> <~~distancevar~~> <[[gamevar]]>		'''findnearsprite3dvar''' <[[tile number]]> <distance> <[[gamevar]]>

	These commands get the sprite ID of the closest <[[tile number]]> within <distance> into a <[[gamevar]]>. If no sprite within range is found, the [[gamevar]] is set to -1. The input for <[[tile number]]> may be its tile number (example: 2000) or its defined label (example: PIGCOP).		These commands get the sprite ID of the closest <[[tile number]]> within <distance> into a <[[gamevar]]>. If no sprite within range is found, the [[gamevar]] is set to -1. The input for <[[tile number]]> may be its tile number (example: 2000) or its defined label (example: PIGCOP).
Line 20:		Line 20:
	The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height extending <zdistance> both above and below. The "3d" commands work within a sphere, with a radius of <distance>.		The normal finding commands limit distance on the x and y plane only. If you were to visualize its range, it would be an infinitely tall/deep vertical cylinder, with a radius of <distance>. The "z" commands work within a finite cylinder, with a radius of <xydistance> and a height extending <zdistance> both above and below. The "3d" commands work within a sphere, with a radius of <distance>.

	~~Commands with an additional "var" suffix take [[gamevar]]s rather than constants for their distance value(s).~~		{{varsuffix}}

	[[Category:EDuke commands]]		[[Category:EDuke commands]]
	[[Category:Sprite manipulation]]		[[Category:Sprite manipulation]]