Lua camState - Revision history

Picassoct: /* The raw info */

2018-09-18T20:09:03Z

The raw info

← Older revision		Revision as of 21:09, 18 September 2018
Line 194:		Line 194:
	</pre>		</pre>
	[[Category: Lua]]		[[Category: Lua]]

			Camtime is optional, and currently not used

2018-09-18T19:59:50Z

The raw info

← Older revision		Revision as of 20:59, 18 September 2018
Line 173:		Line 173:

	I guess px,py,pz could be the postion, while dx,dy,dz could be the direction?		I guess px,py,pz could be the postion, while dx,dy,dz could be the direction?
			px,py,pz is the position.
			https://github.com/spring/spring/blob/30862626214bd263b1c4489bb197ef1c3dbc0738/rts/Game/Camera/CameraController.cpp#L75
			dx,dy,dz is the directional vector, this determinates where the camera points towards.
			fov is the field of view.

			These values are part of the inherited base class, thus apply to all camera controllers.
			rx,ry,rz - are part of a derived class and thus can not be found in all cameras.
			https://github.com/spring/spring/blob/30862626214bd263b1c4489bb197ef1c3dbc0738/rts/Game/Camera.cpp#L383
			It denotes the rotation of the camera, found in some camera controllers- theroretically these cameras could tilt and tumble around the viewing direction. In practice, setting the direction - always overrides the rotation.

			All the other values are also part of the derived classes. Found here:
			https://github.com/spring/spring/blob/30862626214bd263b1c4489bb197ef1c3dbc0738/rts/Game/Camera/FreeController.cpp#L380

2012-10-26T16:48:05Z

TL;DR: seems at least some of this info is only applicable to free cam

← Older revision		Revision as of 17:48, 26 October 2012
Line 2:		Line 2:
	'''px''', '''py''' and '''pz''' are camera position in world coords.		'''px''', '''py''' and '''pz''' are camera position in world coords.

			=== Free camera ===
	'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively, where an rx of 0 is horizontal and an ry of 0 is facing south, positive values running anticlockwise. '''rz''' currently (91.0) does nothing.		'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively, where an rx of 0 is horizontal and an ry of 0 is facing south, positive values running anticlockwise. '''rz''' currently (91.0) does nothing.

2012-10-26T16:23:37Z

TL;DR

← Older revision		Revision as of 17:23, 26 October 2012
Line 2:		Line 2:
	'''px''', '''py''' and '''pz''' are camera position in world coords.		'''px''', '''py''' and '''pz''' are camera position in world coords.

	'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively, where an rx of 0 is horizontal and an ry of 0 is facing south. '''rz''' currently (91.0) does nothing.		'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively, where an rx of 0 is horizontal and an ry of 0 is facing south, positive values running anticlockwise. '''rz''' currently (91.0) does nothing.

	'''dx''', '''dy''' and '''dz''' have ''nothing'' to do with camera rotation.		'''dx''', '''dy''' and '''dz''' have ''nothing'' to do with camera rotation.

2012-10-26T16:21:45Z

TL;DR

← Older revision		Revision as of 17:21, 26 October 2012
Line 2:		Line 2:
	'''px''', '''py''' and '''pz''' are camera position in world coords.		'''px''', '''py''' and '''pz''' are camera position in world coords.

	'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively. '''rz''' currently (91.0) does nothing.		'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively, where an rx of 0 is horizontal and an ry of 0 is facing south. '''rz''' currently (91.0) does nothing.

	'''dx''', '''dy''' and '''dz''' have ''nothing'' to do with camera rotation.		'''dx''', '''dy''' and '''dz''' have ''nothing'' to do with camera rotation.

2012-10-26T16:20:56Z

A small amount of info gleaned from my testing.

← Older revision		Revision as of 17:20, 26 October 2012
Line 1:		Line 1:
			== TL;DR ==
			'''px''', '''py''' and '''pz''' are camera position in world coords.

			'''rx''' and '''ry''' are camera rotation in radians about the X and Y axes respectively. '''rz''' currently (91.0) does nothing.

			'''dx''', '''dy''' and '''dz''' have ''nothing'' to do with camera rotation.

			== The raw info ==
	<pre>		<pre>
	I wanted to use Spring.SetCameraState( table camState, number camTime) -> nil \| boolean		I wanted to use Spring.SetCameraState( table camState, number camTime) -> nil \| boolean

2010-03-13T17:23:46Z

fix category

← Older revision		Revision as of 18:23, 13 March 2010
Line 172:		Line 172:
	From testing, I found out zscale is how horizontal/vertical are some camera, 10 for almost horizontal TA overhead, 0.05 for almost vertical TA overhead.		From testing, I found out zscale is how horizontal/vertical are some camera, 10 for almost horizontal TA overhead, 0.05 for almost vertical TA overhead.
	</pre>		</pre>
			[[Category: Lua]]

2009-08-18T18:44:29Z

added some info - need to clean up this whole mess, but has been quite useful

← Older revision		Revision as of 19:44, 18 August 2009
Line 22:		Line 22:
	dx,dy,dz : Camera direction vector?		dx,dy,dz : Camera direction vector?
	zscale: how tilted is the camera, from 10 (near horizontal) to 0.05 (near vertical). We have y/z = 1.0/zscale (with a -1 thrown in if flipped)		zscale: how tilted is the camera, from 10 (near horizontal) to 0.05 (near vertical). We have y/z = 1.0/zscale (with a -1 thrown in if flipped)
	height : how much above the ground is the camera, cannot be negative		height : how much above the ground is the camera, cannot be negative -- '' it's absolute height of the camera, ie the camera positions y value, actually (so no difference if cam is above mountain or valley)~~~~''
	flipped : -1 for when south is down, 1 for when north is down		flipped : -1 for when south is down, 1 for when north is down

Line 53:		Line 53:
	name : "rot"		name : "rot"
	mode : 3		mode : 3
	px,py,pz : Position of the ground point in screen center (not camera position)		px,py,pz : Position of the ground point in screen center (not camera position) -- '' actually it seems to be the camera position to me (I set the height with py, not so sure about the others...) ~~~~''
	dx,dy,dz : Camera direction vector?		dx,dy,dz : Camera direction vector?
	rx,ry,rz : Camera rotation?		rx,ry,rz : Camera rotation?

2009-03-01T16:59:11Z

← Older revision		Revision as of 17:59, 1 March 2009
Line 51:		Line 51:

	Switching to Rotatable overhead camera		Switching to Rotatable overhead camera
			name : "rot"
			mode : 3
			px,py,pz : Position of the ground point in screen center (not camera position)
			dx,dy,dz : Camera direction vector?
			rx,ry,rz : Camera rotation?
			oldHeight : how much above the ground is the camera, cannot be negative, cannot be changed (I guess it's just in for when switching to a view that requires it next)


			exemple:
	px, 522.32415771484		px, 522.32415771484
	py, 600		py, 600

2009-03-01T16:48:32Z

← Older revision		Revision as of 17:48, 1 March 2009
Line 21:		Line 21:
	px,py,pz : Position of the ground point in screen center (not camera position)		px,py,pz : Position of the ground point in screen center (not camera position)
	dx,dy,dz : Camera direction vector?		dx,dy,dz : Camera direction vector?
	zscale: how tilted is the camera, from 10 (near horizontal) to 0.05 (near vertical)		zscale: how tilted is the camera, from 10 (near horizontal) to 0.05 (near vertical). We have y/z = 1.0/zscale (with a -1 thrown in if flipped)
	height : how much above the ground is the camera, cannot be negative		height : how much above the ground is the camera, cannot be negative
	flipped : -1 for south down, 1 for north down ?		flipped : -1 for when south is down, 1 for when north is down

	exemple:		exemple: