R5K engine - Revision history

Cas: /* Culling and Z-bias */

2025-02-28T20:11:31Z

Culling and Z-bias

← Older revision		Revision as of 22:11, 28 February 2025
Line 15:		Line 15:

	=== Culling and Z-bias ===		=== Culling and Z-bias ===
	The original engine uses culling flags, which makes the code more complex and prone to errors in exchange for accelerating rendering a little bit. R5KE ignores culling flags because it uses ~~face~~ 1-sided orientation to resolve this and because today's computers are extremely fast and don't need this optimisation. In Stunts, a Z-bias flag allows for two layers of rendering per model, which makes it possible to create rendering exceptions and simplify models. R5KE has a 4-layer system instead and recognises Stunts' Z-bias flag as a first layer, so more complex models can be handled by R5KE. The way Stunts handles Z-bias and one-sided polygons, though, appears to be different from what one would expect and R5KE is more conservative on this.		The original engine uses culling flags, which makes the code more complex and prone to errors in exchange for accelerating rendering a little bit. R5KE ignores culling flags because it uses 1-sided face orientation to resolve this and because today's computers are extremely fast and don't need this optimisation. In Stunts, a Z-bias flag allows for two layers of rendering per model, which makes it possible to create rendering exceptions and simplify models. R5KE has a 4-layer system instead and recognises Stunts' Z-bias flag as a first layer, so more complex models can be handled by R5KE. The way Stunts handles Z-bias and one-sided polygons, though, appears to be different from what one would expect and R5KE is more conservative on this.

	=== Model rotation and displacement ===		=== Model rotation and displacement ===

Cas: /* Bugs and unfinished details */

2025-02-28T20:10:23Z

Bugs and unfinished details

← Older revision		Revision as of 22:10, 28 February 2025
Line 21:		Line 21:

	=== Bugs and unfinished details ===		=== Bugs and unfinished details ===
	R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Clouds are currently not drawn, while wheels are generated using a simplified code that, depending on the perspective, may not look that good. Some glitches could be seen in the past in grilles because of a bug in FreeBasic graphics functions. This has been fixed in FBC now, but it could've still been avoided by replacing the textured line primitive with an assembly based one. For a long time, the horizon could only be drawn horizontal, so when banking, models rotated normally, but the horizon did not follow. This was fixed with '''Daniël walls''', a clever idea by [[Daniel3D]]. Animations have still not been implemented. This includes Joe's diner's blinking sign and windmill sails "rotation".		R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Clouds are currently not drawn, while wheels are generated using a simplified code that, depending on the perspective, may not look that good. Some glitches could be seen in the past in grilles because of a bug in FreeBasic graphics functions. This has been fixed in FBC now, but it could've still been avoided by replacing the textured line primitive with an assembly based one. For a long time, the horizon could only be drawn horizontal, so when banking, models rotated normally, but the horizon did not follow. This was fixed with ''Daniël walls'', a clever idea by [[Daniel3D]]. Animations have still not been implemented. This includes Joe's diner's blinking sign and windmill sails "rotation".

	== Track viewer ==		== Track viewer ==

Cas: /* Bugs and unfinished details */

2025-02-28T20:10:08Z

Bugs and unfinished details

← Older revision		Revision as of 22:10, 28 February 2025
Line 21:		Line 21:

	=== Bugs and unfinished details ===		=== Bugs and unfinished details ===
	R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. ~~Wheels and clouds~~ are currently not drawn~~. Grilles~~ are ~~drawn~~, ~~but some artifacts can~~ be seen ~~at times. This is~~ because of a bug in ~~the~~ FreeBasic's graphics ~~function that draws dotted lines and can be~~ fixed by ~~using~~ an assembly ~~function instead~~. ~~The~~ horizon ~~can currently~~ only be drawn horizontal, so when banking, models ~~do rotate~~ normally, but the horizon ~~does~~ not follow. Animations have still not been implemented. This includes Joe's diner's blinking sign and windmill sails "rotation".		R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Clouds are currently not drawn, while wheels are generated using a simplified code that, depending on the perspective, may not look that good. Some glitches could be seen in the past in grilles because of a bug in FreeBasic graphics functions. This has been fixed in FBC now, but it could've still been avoided by replacing the textured line primitive with an assembly based one. For a long time, the horizon could only be drawn horizontal, so when banking, models rotated normally, but the horizon did not follow. This was fixed with '''Daniël walls''', a clever idea by [[Daniel3D]]. Animations have still not been implemented. This includes Joe's diner's blinking sign and windmill sails "rotation".

	== Track viewer ==		== Track viewer ==

Cas at 21:37, 18 November 2023

2023-11-18T21:37:27Z

← Older revision		Revision as of 23:37, 18 November 2023
Line 1:		Line 1:
	[[image:R5ke.png\|400px\|right\|thumb\|View of the track 4:00am using R5KE]]		[[image:R5ke.png\|400px\|right\|thumb\|View of the track 4:00am using R5KE]]
	'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.		'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.

			The project started in August 2020 under the name ''StuntsLegacyEngine'', for which [https://forum.stunts.hu/index.php?topic=3594.0 this forum thread] was created and has been evolving slowly and in steps in the last years. The original repository was at https://notabug.org/xlucas/sle, where an early copy can be found. It can also be obtained from [[Race For Kicks]], at https://www.raceforkicks.com/projects/engine.html, where it comes with the track viewer included.

	== Capabilities ==		== Capabilities ==
Line 19:		Line 21:

	=== Bugs and unfinished details ===		=== Bugs and unfinished details ===
	R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Wheels and clouds are currently not drawn. Grilles are drawn, but some artifacts can be seen at times. This is because of a bug in the FreeBasic's graphics function that draws dotted lines and can be fixed by using an assembly function instead. The horizon can currently only be drawn horizontal, so when banking, models do rotate normally, but the horizon does not follow.		R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Wheels and clouds are currently not drawn. Grilles are drawn, but some artifacts can be seen at times. This is because of a bug in the FreeBasic's graphics function that draws dotted lines and can be fixed by using an assembly function instead. The horizon can currently only be drawn horizontal, so when banking, models do rotate normally, but the horizon does not follow. Animations have still not been implemented. This includes Joe's diner's blinking sign and windmill sails "rotation".

	== Track viewer ==		== Track viewer ==

Cas: /* Capabilities */

2023-11-18T21:24:29Z

Capabilities

← Older revision		Revision as of 23:24, 18 November 2023
Line 14:		Line 14:
	=== Culling and Z-bias ===		=== Culling and Z-bias ===
	The original engine uses culling flags, which makes the code more complex and prone to errors in exchange for accelerating rendering a little bit. R5KE ignores culling flags because it uses face 1-sided orientation to resolve this and because today's computers are extremely fast and don't need this optimisation. In Stunts, a Z-bias flag allows for two layers of rendering per model, which makes it possible to create rendering exceptions and simplify models. R5KE has a 4-layer system instead and recognises Stunts' Z-bias flag as a first layer, so more complex models can be handled by R5KE. The way Stunts handles Z-bias and one-sided polygons, though, appears to be different from what one would expect and R5KE is more conservative on this.		The original engine uses culling flags, which makes the code more complex and prone to errors in exchange for accelerating rendering a little bit. R5KE ignores culling flags because it uses face 1-sided orientation to resolve this and because today's computers are extremely fast and don't need this optimisation. In Stunts, a Z-bias flag allows for two layers of rendering per model, which makes it possible to create rendering exceptions and simplify models. R5KE has a 4-layer system instead and recognises Stunts' Z-bias flag as a first layer, so more complex models can be handled by R5KE. The way Stunts handles Z-bias and one-sided polygons, though, appears to be different from what one would expect and R5KE is more conservative on this.

			=== Model rotation and displacement ===
			R5KE is not a tile-based renderer, so when loading a track, model sets are transformed and placed and then, the engine draws them generically. This means that it's possible to place objects that are not aligned to the grid or that are rotated at an arbitrary vertical angle.

			=== Bugs and unfinished details ===
			R5KE sorts models independently of their size, which currently creates some issues when rendering models larger than 1x1 that are placed on a hill or on water. Wheels and clouds are currently not drawn. Grilles are drawn, but some artifacts can be seen at times. This is because of a bug in the FreeBasic's graphics function that draws dotted lines and can be fixed by using an assembly function instead. The horizon can currently only be drawn horizontal, so when banking, models do rotate normally, but the horizon does not follow.

	== Track viewer ==		== Track viewer ==

Cas: /* Capabilities */

2023-11-18T21:16:25Z

Capabilities

← Older revision		Revision as of 23:16, 18 November 2023
Line 8:		Line 8:
	=== Resolution and viewing distance ===		=== Resolution and viewing distance ===
	In the original Stunts graphics engine, the resolution is always 320x200. With R5KE, the code can be compiled for any resolution and it's possible to make this dynamic. The maximum viewing distance could be configured in some versions of Stunts, but the best quality that could be set was still pretty low. R5KE allows for depth levels that can easily render a complete track.		In the original Stunts graphics engine, the resolution is always 320x200. With R5KE, the code can be compiled for any resolution and it's possible to make this dynamic. The maximum viewing distance could be configured in some versions of Stunts, but the best quality that could be set was still pretty low. R5KE allows for depth levels that can easily render a complete track.

			=== Derivative models ===
			Like the original engine, R5KE can produce derivative models, that is, transformations of existing models on disk can be generated in memory at load time. Thus, only one model is required for each ramp type, then this can not just be rotated, but also tilted if necessary, when on a slope. In the same way, it can convert any paved-road-based model to a different surface type, including things that are not seen in Stunts (although its engine probably can do it) like dirt road ramps.

			=== Culling and Z-bias ===
			The original engine uses culling flags, which makes the code more complex and prone to errors in exchange for accelerating rendering a little bit. R5KE ignores culling flags because it uses face 1-sided orientation to resolve this and because today's computers are extremely fast and don't need this optimisation. In Stunts, a Z-bias flag allows for two layers of rendering per model, which makes it possible to create rendering exceptions and simplify models. R5KE has a 4-layer system instead and recognises Stunts' Z-bias flag as a first layer, so more complex models can be handled by R5KE. The way Stunts handles Z-bias and one-sided polygons, though, appears to be different from what one would expect and R5KE is more conservative on this.

	== Track viewer ==		== Track viewer ==

Cas at 21:05, 18 November 2023

2023-11-18T21:05:00Z

← Older revision		Revision as of 23:05, 18 November 2023
Line 3:		Line 3:

	== Capabilities ==		== Capabilities ==
			=== Slight model incompatilibities ===
			R5KE is based on a [https://en.wikipedia.org/wiki/Painter%27s_algorithm painter's algorithm], just like Stunts original graphics engine, but there are a number of differences in their internals. Some of these differences allow the new engine for more flexibility, while others only make things look a little different. Some 3D models will not render the same across engines because the exact workings of the original engine are not known and these models seem to exploit its uniqueness instead of trying to be conservative. This is the case of the lines inside a tunnel or the yellow stripes on ramps, for example. To have R5KE display these models similar to Stunts, one could create some alternative, more conservative models to avoid having to push a lot of exceptions into the new engine's code.

			=== Resolution and viewing distance ===
			In the original Stunts graphics engine, the resolution is always 320x200. With R5KE, the code can be compiled for any resolution and it's possible to make this dynamic. The maximum viewing distance could be configured in some versions of Stunts, but the best quality that could be set was still pretty low. R5KE allows for depth levels that can easily render a complete track.

	== Track viewer ==		== Track viewer ==
Line 9:		Line 14:
	== Integration with ReplDump ==		== Integration with ReplDump ==
	In March 2023, [[Daniel3D]] had the idea of a bridge between [[ReplDump]] and R5KE and he wrote to [[Cas]] about it. Cas then got to [[Duplode]] to ask for some help on ReplDump and began work on integrating the two pieces of software. [https://forum.stunts.hu/index.php?topic=4107.0 This forum thread]] documents the work held back then. By combining them, it's possible to create images and videos of races from arbitrary perspectives and with several cars running together.		In March 2023, [[Daniel3D]] had the idea of a bridge between [[ReplDump]] and R5KE and he wrote to [[Cas]] about it. Cas then got to [[Duplode]] to ask for some help on ReplDump and began work on integrating the two pieces of software. [https://forum.stunts.hu/index.php?topic=4107.0 This forum thread]] documents the work held back then. By combining them, it's possible to create images and videos of races from arbitrary perspectives and with several cars running together.

			[[Category:Modding]]
			[[Category:Internals]]
			[[Category:Tools]]

Cas at 20:53, 18 November 2023

2023-11-18T20:53:00Z

← Older revision		Revision as of 22:53, 18 November 2023
Line 1:		Line 1:
	[[image:R5ke.png\|400px\|right\|thumb\|View of the track 4:00am using R5KE]]		[[image:R5ke.png\|400px\|right\|thumb\|View of the track 4:00am using R5KE]]
	'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.		'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.

			== Capabilities ==

			== Track viewer ==
			The currently published implementation of R5KE comes as a track viewer. You need to provide a track file as well as the GAME.3SH files that result from decompressing the GAME.P3S original files. This allows you to move more or less freely around the track and view it in high resolution with maximum field depth rendering.

			== Integration with ReplDump ==
			In March 2023, [[Daniel3D]] had the idea of a bridge between [[ReplDump]] and R5KE and he wrote to [[Cas]] about it. Cas then got to [[Duplode]] to ask for some help on ReplDump and began work on integrating the two pieces of software. [https://forum.stunts.hu/index.php?topic=4107.0 This forum thread]] documents the work held back then. By combining them, it's possible to create images and videos of races from arbitrary perspectives and with several cars running together.

Cas at 22:00, 21 September 2022

2022-09-21T22:00:06Z

← Older revision		Revision as of 00:00, 22 September 2022
Line 1:		Line 1:
			[[image:R5ke.png\|400px\|right\|thumb\|View of the track 4:00am using R5KE]]
	'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.		'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.

Cas at 21:58, 21 September 2022

2022-09-21T21:58:48Z

← Older revision		Revision as of 23:58, 21 September 2022
Line 1:		Line 1:
	''R5K Engine'' (or ''R5KE'') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.		'''R5K Engine''' (or '''R5KE''') is a graphics rendering engine project worked on by [[Cas]] that aims to provide a new, native graphics engine for Stunts under modern operating systems while preserving its classical qualities.