Showview - Revision history

Oasiz at 16:08, 5 July 2025

2025-07-05T16:08:29Z

← Older revision		Revision as of 09:08, 5 July 2025
Line 57:		Line 57:
	'''showviewunbiased''' x y z ang horiz sect 16 8 56 39		'''showviewunbiased''' x y z ang horiz sect 16 8 56 39

	When using ~~q16~~ variants, you can also use:		When using Q16 variants, you can also use:
	camerax		camerax
	cameray		cameray

Oasiz at 16:07, 5 July 2025

2025-07-05T16:07:45Z

← Older revision		Revision as of 09:07, 5 July 2025
Line 1:		Line 1:
	'''''showview''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2><br/>		'''''showview''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2><br/>
	'''''showviewunbiased''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2>		'''''showviewunbiased''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2><br>
			'''''showviewq16''''' <x> <y> <z> <Q16 angle> <Q16 horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2><br>
			'''''showviewq16unbiased''''' <x> <y> <z> <Q16 angle> <Q16 horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2>

	Displays on-screen the view from in-game coordinates (<x>,<y>,<z>), looking at angle <angle> and with z-angle (up and down) <horiz>, between screen coordinates (<scrn_x1>,<scrn_y1>) and (<scrn_x2>,<scrn_y2>).		Displays on-screen the view from in-game coordinates (<x>,<y>,<z>), looking at angle <angle> and with z-angle (up and down) <horiz>, between screen coordinates (<scrn_x1>,<scrn_y1>) and (<scrn_x2>,<scrn_y2>).
Line 9:		Line 11:

	Their permissible range is 0 to 319 for the screen x coordinate, and 0 to 199 for the screen y coordinate, both inclusive.		Their permissible range is 0 to 319 for the screen x coordinate, and 0 to 199 for the screen y coordinate, both inclusive.

			"Q16" variants exist to provide extra 16 bits of floating point precision beyond the usual limitations of player's horiz and angle, any non-Q16 input values must be bit shifted higher by 16 bits when used as-is.<br>
			When tied to the player, you can use <code>cameraq16horiz</code> and <code>cameraq16ang</code> for ready to use high precision input.<br>
			This function is also software renderer compatible and any extra precision will simply be truncated there.

	== Coordinates ==		== Coordinates ==
Line 50:		Line 56:
	updatesectorz x y z sect		updatesectorz x y z sect
	'''showviewunbiased''' x y z ang horiz sect 16 8 56 39		'''showviewunbiased''' x y z ang horiz sect 16 8 56 39

			When using q16 variants, you can also use:
			camerax
			cameray
			cameraz
			camerasect
			cameraq16horiz
			cameraq16ang

			Note that "camera" coordinates also change when viewing 3rd person mode

	[[Category:EDuke32 specific commands]]		[[Category:EDuke32 specific commands]]
	[[Category:Screen drawing commands]]		[[Category:Screen drawing commands]]

Fox: /* Examples */

2020-02-20T09:17:50Z

Examples

← Older revision		Revision as of 02:17, 20 February 2020
Line 40:		Line 40:
	'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''		'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''

	~~<br/>~~
	This will embed a small version of the player's view near the top left corner of the screen:		This will embed a small version of the player's view near the top left corner of the screen:
	getplayer[THISACTOR].posx x		getplayer[THISACTOR].posx x

Fox: /* Examples */

2020-02-20T09:17:40Z

Examples

← Older revision		Revision as of 02:17, 20 February 2020
Line 36:		Line 36:
	Keep in mind when using this command that the game will have to completely redraw everything from the specified perspective, which can produce a sizeable framerate hit.		Keep in mind when using this command that the game will have to completely redraw everything from the specified perspective, which can produce a sizeable framerate hit.

	===Examples===		==Examples==
	The correct way of drawing to the whole screen is		The correct way of drawing to the whole screen is
	'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''		'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''

Fox: No need for a ultra-long example here...

2020-02-20T08:45:24Z

No need for a ultra-long example here...

Show changes

Hendricks266: /* Realistic examples */ typo fix

2012-06-27T01:47:41Z

Realistic examples: typo fix

← Older revision		Revision as of 18:47, 26 June 2012
Line 34:		Line 34:

	===Realistic examples===		===Realistic examples===
	The correct way of drawing to the ~~whose~~ screen is		The correct way of drawing to the whole screen is
	'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''		'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''

Helixhorned: /* Realistic examples */ whole screen example

2012-06-06T20:52:00Z

Realistic examples: whole screen example

← Older revision		Revision as of 13:52, 6 June 2012
Line 34:		Line 34:

	===Realistic examples===		===Realistic examples===
			The correct way of drawing to the whose screen is
			'''showviewunbiased''' x y z a h s '''''0 0 319 199'''''

			<br/>
	This will embed a small version of the player's view near the top left corner of the screen:		This will embed a small version of the player's view near the top left corner of the screen:

	getplayer[THISACTOR].posx x		getplayer[THISACTOR].posx x
	getplayer[THISACTOR].posy y		getplayer[THISACTOR].posy y
Line 44:		Line 47:
	addvarvar horiz temp		addvarvar horiz temp
	updatesectorz x y z sect		updatesectorz x y z sect
	'''''showviewunbiased''''' x y z ang horiz sect 16 8 56 39		'''showviewunbiased''' x y z ang horiz sect 16 8 56 39

	<br/>		<br/>
Line 143:		Line 146:
	ifvarn sv_sect -1 {		ifvarn sv_sect -1 {
	// x y z ang horiz sect scrn_x scrn_y scrn_x2 scrn_y2		// x y z ang horiz sect scrn_x scrn_y scrn_x2 scrn_y2
	'''''showviewunbiased''''' sv_x sv_y sv_z sv_ang sv_horiz sv_sect sv_scrnx1 sv_scrny1 sv_scrnx2 sv_scrny2		'''showviewunbiased''' sv_x sv_y sv_z sv_ang sv_horiz sv_sect sv_scrnx1 sv_scrny1 sv_scrnx2 sv_scrny2
	}		}
	// display crosshair		// display crosshair

Hendricks266 at 17:06, 31 March 2012

2012-03-31T17:06:14Z

← Older revision		Revision as of 10:06, 31 March 2012
Line 44:		Line 44:
	addvarvar horiz temp		addvarvar horiz temp
	updatesectorz x y z sect		updatesectorz x y z sect
	~~showview~~ x y z ang horiz sect 16 8 56 39		'''''showviewunbiased''''' x y z ang horiz sect 16 8 56 39

	<br/>		<br/>
Line 143:		Line 143:
	ifvarn sv_sect -1 {		ifvarn sv_sect -1 {
	// x y z ang horiz sect scrn_x scrn_y scrn_x2 scrn_y2		// x y z ang horiz sect scrn_x scrn_y scrn_x2 scrn_y2
	~~showview~~ sv_x sv_y sv_z sv_ang sv_horiz sv_sect sv_scrnx1 sv_scrny1 sv_scrnx2 sv_scrny2		'''''showviewunbiased''''' sv_x sv_y sv_z sv_ang sv_horiz sv_sect sv_scrnx1 sv_scrny1 sv_scrnx2 sv_scrny2
	}		}
	// display crosshair		// display crosshair

Helixhorned: Added 'showviewunbiased', corrected limits, added precise definitions of the transformation to the real screen coordinates

2012-03-31T13:00:56Z

Added 'showviewunbiased', corrected limits, added precise definitions of the transformation to the real screen coordinates

@@ Line 1: / Line 1: @@
-'''''showview''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2>
+'''''showview''''' <x> <y> <z> <angle> <horiz> <sector> <scrn_x1> <scrn_y1> <scrn_x2> <scrn_y2><br/>
 Displays on-screen the view from in-game coordinates (<x>,<y>,<z>), looking at angle <angle> and with z-angle (up and down) <horiz>, between screen coordinates (<scrn_x1>,<scrn_y1>) and (<scrn_x2>,<scrn_y2>).
@@ Line 5: / Line 6: @@
 <sector> is the sector that contains the in-game coordinates.
-The on-screen coordinates can be in any shape; they do not have to be in the same x-y ratio as the screen resolution. However, different ratios can result in warping or graphical glitches in the view. The on-screen coordinates are in 320×200 scale.
+The on-screen coordinates can be in any shape; they do not have to be in the same x-y ratio as the screen resolution. However, the aspect ratio at which the scene is drawn in the sub-viewport is unspecified and may differ between renderers and settings of ''r_usenewaspect''. (For example, different ratios may result in warping or graphical glitches in the view.)
 Keep in mind when using this command that the game will have to completely redraw everything from the specified perspective, which can produce a sizeable framerate hit.
-This example will embed a small version of the player's view near the top left corner of the screen:
+===Realistic examples===
   getplayer[THISACTOR].posx x
@@ Line 21: / Line 46: @@
   showview x y z ang horiz sect 16 8 56 39
 This lengthy example will create a "gun camera" that shows a closeup view of wherever the player is currently aiming. In addition to showview and basic EDuke commands, it also uses [[updatesectorz]], [[myos]], and [[hitscan]], as well as the [[event]] [[EVENT_DISPLAYREST]].

TX at 23:41, 10 March 2007

2007-03-10T23:41:51Z

← Older revision		Revision as of 16:41, 10 March 2007
Line 14:		Line 14:
	getplayer[THISACTOR].posy y		getplayer[THISACTOR].posy y
	getplayer[THISACTOR].posz z		getplayer[THISACTOR].posz z
	getplayer[THISACTOR].~~angle~~ ang		getplayer[THISACTOR].ang ang
	getplayer[THISACTOR].horiz horiz		getplayer[THISACTOR].horiz horiz
	getplayer[THISACTOR].horizoff temp		getplayer[THISACTOR].horizoff temp