Difference between revisions of "Slow Motion Bug"

Revision as of 06:23, 12 November 2020

Bugs

Bugs in alphabetic order

Advanced information

Overview

Like a PC, the Wii is a computer system with a set amount of memory (RAM), processing (CPU) power, and graphics (GPU) power. When it does not have enough CPU or GPU power to calculate what is rendered on screen, the action on screen (the frames per second or FPS) can slow down dramatically. While this technically isn't a bug in the traditional sense, it is a symptom of poor optimization and can indicate that the track author did not test the level thoroughly before release.

Six King Labyrinth Slow Motion Bug

Types of Slowdown

There are several different types of slowdown that can occur in-game, depending on the component(s) being bottlenecked.

CPU Bottleneck

Symptoms:

Game slows down in 12 player online rooms.

Causes:

An infinite loop is occurring in a KMP route.
A model is using too many draw calls/materials.
There are too many NodeTree or NodeMix definitions.
There are too many particle generator objects.

GPU Bottleneck

Symptoms:

Game slows down in 2 player splitscreen.

Causes:

Culling is being used improperly (no culling at all times).
A model is too geometrically complex.
A model has improper texture coordinate scale.
A model's shader is using too many stages.
There are too many large textures onscreen at once.
There are too many large texture formats (RGBA8).

Troubleshooting

Optimize Model Geometry

You can find problem areas by looking at your model in SZS Modifier with the wireframe view option enabled. To optimize your model, delete as many unnecessary lines/faces/textures in your model as you can. To reduce the complexity of curves, explode curves on your model and delete intermediate lines on the curved surface. This is an important step if you are creating objects with the Follow Me tool as it can drastically reduce their complexity.

Note that OBJ exporter plugins for SketchUp are not perfect; some may cause duplication of textures if components are not exploded, while others may create garbage polygons if they are exploded. You will need to experiment to get the best results. Some authors recommended using the 3ds Max .dae exporter and BrawlBox to import models. The The HardPCM plugin is a good free option.

Figure 1. Overlapped polygons.

Figure 2. The same polygons on different planes.

Figure 3. The previous image from a different angle.

Some custom tracks define faces from both sides. But for nearly all of the drivable faces (road, offroad, boost, water and some more) only face up triangles are needed. So the first possibility to reduce the number of faces is to remove all drivable face down triangles. In the the example on the right this may save 41 of the 82 triangles (90 triangles total).

Using face down roads has also another negative effect: If jumping down to the road the player touches sometimes the face down triangle and the vehicle will drive head down for a moment into a complete wrong direction. So it is an obligation to remove the face down triangles of drivable KCL types. Not only roads, but also walls are candidate for removing triangles.

The general rules are:

Remove triangles (faces) that can never be seen. Do this for the visual model and also for the KCL.
Remove triangles from the KCL that can never be reached.

You can save much more triangles if you think in 3D. See the 3 pictures at the right: green is grass, blue the road, yellow are boost and brown a small hill. In the first picture you see, that 49 triangles are used. It's because the developer thinks only in 2D and lays all triangles side by side.

And now let's take a look, how Nintendo did it for the newer tracks. They think in 3D and define the grass level with only 2 triangles. Then they place a street 2-4 units higher and use again only a few triangles. And in a third level they place the boost parts. And the hill is also placed in the grass and may go below the grass.

In the third picture you see a schematic 3D view of the second one. Watch out the black shadows. In the first picture 49 face up triangles are used and in the two other pictures only 19; this saves 61% triangles in this example. Nintendo raises the above levels about 2-4 units (100 units in this demonstration).

Optimize Objects

Your level might also have too many objects. This may be caused by:

Too many objects in the KMP.
Unused objects that are still rendered.
Objects with model animations set to display in all game modes.

The easy solution would be to remove all unnecessary items from the KMP. Some decoration objects should only appear in single player mode, such as animated characters like piantas, flowers, and shy guy groups. See »presence flags« for more details.

Optimize Textures

Be sure to check the SZS for duplicated textures before releasing. You can find them by browsing through the textures in course_model.brres. Likewise, check the mtl file for "#Distorted Textures." These are twisted or skewed copies of textures used in your level, usually used on just a single face of the model. You can find the locations of these textures on your model by replacing the distorted texture with a texture that contrasts well with the rest of the textures in your level, such as lime green or neon orange, then loading the model in-game or in the BRRES Editor. Reset the alignment of these textures on your model and re-export to eliminate the distorted duplicates.

Large resolution textures like 1024x1024 are rarely necessary and it is best practice to avoid them. Reducing the resolution of textures may help, although the impact of a few hi-res textures usually won't be noticed unless there are other problems. Just like the images below, you should try to make your images as unique as possible. You should also use the best possible texture format. Very simple gray-scaled Textures should use I4. More complex ones should use I8. If a gray-scaled image requires an Alpha Channel, it should use IA4 or IA8. For basic colored textures, you should choose CMPR. CMPR can have a better quality in Brawlbox's Importer than RGB565, which does not support an Alpha Channel and creates bigger files. RGBA32 or RGBA8 should be only used if you need True Color images with opacity, due to this file format creating large files. If you also don't know how to enable mipmaps in the MDL0 or don't need/want them, you should not create them in the Texture Importer.

Figure 4a. A redundantly tiled texture.
Figure 4b. The same texture tiled only once.
Figure 5a. Another example of redundancy.
Figure 5b. The same texture tiled only once.

Optimize KCL

Between the time of the SZS Modifier's KCL Editor and Wiimm's KCL Tool, people used workarounds to generate a bigger KCL than the ones from original game files. After Chadderz sent Tock a Beta version of his own KCL Editor, Tock was able to create a 3.29 MB sized KCL by importing the raw model of GCN Sherbet Land twice. This has helped many people to create KCLs easier for their own Custom Tracks. Sadly, this means the SZS nowadays is blown up by much unused data. This can be fixed by simply decoding the KCL to a .obj file with Wiimms KCL Tool and re-encoding it to a KCL. The KCL files from Tock's old GCN Sherbet Land was reduced from 3.29 MB to 630 KB.

Additionally, it is best to simplify collision not only to avoid getting snagged or stuck on parts of the level, but also so that the CPU makes fewer collision calculations as players move through the level, reducing slowdown. Creating a separate simplified collision model allows you to optimize collision in a way that does not impact the look of your level.

Known Tracks with Slow Motion Bug

Major problems

Bowser's Lava Road ~42 000 facepoints
Daisy's Palace RC2: ~80 000 facepoints, RC3: ~46 000 facepoints
Dry Coast ~40 000 facepoints
GBA Ribbon Road Single Player ~102 000 facepoints, Multiplayer ~72 000 facepoints
GCN Wario Colosseum ~98 000 facepoints
GP Mario Beach ~90 000 facepoints
Grease Beach
Nightmare to Dream World ~83 000 facepoints
Peach's Beach Party v1.5-beta ~101 500 facepoints, v1.6 ~45 000 facepoints
River Bridge
Six King Labyrinth

Minimal problems

Yoshi Mountain

More tracks (Category Slow Motion Bug)

Category Slow Motion Bug not found

@@ Line 1: / Line 1: @@
-==Overview==
+{{Bugs}}
+== Overview ==
 Like a PC, the [[Wii]] is a computer system with a set amount of memory (''RAM''), processing (''CPU'') power, and graphics (''GPU'') power. When it does not have enough CPU or GPU power to calculate what is rendered on screen, the action on screen (the frames per second or ''FPS'') can slow down dramatically. While this technically isn't a bug in the traditional sense, it is a symptom of poor optimization and can indicate that the track author did not test the level thoroughly before release.
 {{youtube-box|bug|x7auiQJ6QtI|Six King Labyrinth Slow Motion Bug}}
-==Types of Slowdown==
+== Types of Slowdown ==
 There are several different types of slowdown that can occur in-game, depending on the component(s) being bottlenecked.
-===CPU Bottleneck===
+=== CPU Bottleneck ===
 Symptoms:
 * Game slows down in 12 player online rooms.
@@ Line 17: / Line 18: @@
 * There are too many particle generator objects.
-===GPU Bottleneck===
+=== GPU Bottleneck ===
 Symptoms:
 * Game slows down in 2 player splitscreen.
@@ Line 29: / Line 30: @@
 * There are too many large texture formats (RGBA8).
-==Troubleshooting==
+== Troubleshooting ==
-===Optimize Model Geometry===
+=== Optimize Model Geometry ===
-You can find problem areas by looking at your model in the [[SZS Modifier]] with the ''wireframe view'' option enabled.  To optimize your model, delete as many unnecessary lines/faces/textures in your model as you can.  To reduce the complexity of curves, explode curves on your model and delete intermediate lines on the curved surface.  This is an important step if you are creating objects with the Follow Me tool as it can drastically reduce their complexity.
+You can find problem areas by looking at your model in [[SZS Modifier]] with the ''wireframe view'' option enabled. To optimize your model, delete as many unnecessary lines/faces/textures in your model as you can. To reduce the complexity of curves, explode curves on your model and delete intermediate lines on the curved surface. This is an important step if you are creating objects with the Follow Me tool as it can drastically reduce their complexity.
-Note that OBJ exporter plugins for [[SketchUp]] are not perfect; some may cause duplication of textures if components ''are not'' exploded, while others may create garbage polygons if they ''are'' exploded.  You will need to experiment to get the best results.  Some authors recommended using the [[3ds Max]] .dae exporter and [[BrawlBox]] to import models.  The [http://www.vgmp3.org/DLs/HSKP2UNR_v103-Sketchup_Plugin.zip The HardPCM plugin] is a good free option.
+Note that OBJ exporter plugins for [[SketchUp]] are not perfect; some may cause duplication of textures if components ''are not'' exploded, while others may create garbage polygons if they ''are'' exploded. You will need to experiment to get the best results. Some authors recommended using the [[3ds Max]] .dae exporter and [[BrawlBox]] to import models. The [http://www.vgmp3.org/DLs/HSKP2UNR_v103-Sketchup_Plugin.zip The HardPCM plugin] is a good free option.
 [[file:reduce-faces-1.png|thumb|right|'''Figure 1.''' Overlapped polygons.]]
@@ Line 41: / Line 42: @@
 Some [[custom tracks]] define faces from both sides. <!-- I believe this mainly happened in the mspaint era. --> But for nearly all of the drivable faces (road, offroad, boost, water and some more) only face up triangles are needed. So the first possibility to reduce the number of faces is to remove all drivable face down triangles. In the the example on the right this may save 41 of the 82 triangles (90 triangles total).
-Using face down roads has also another negative effect: If jumping down to the road the player touches sometimes the face down triangle and the vehicle will drive head down for a moment into a complete wrong direction. So it is a obligation to remove the face down triangles of drivable [[KCL]] types. Not only roads, but also walls are candidate for removing triangles.
+Using face down roads has also another negative effect: If jumping down to the road the player touches sometimes the face down triangle and the vehicle will drive head down for a moment into a complete wrong direction. So it is an obligation to remove the face down triangles of drivable [[KCL]] types. Not only roads, but also walls are candidate for removing triangles.
 The general rules are:
 * Remove triangles (faces) that can never be seen. Do this for the visual model and also for the KCL.
-* Remove triangles from the KCL that can never reached.
+* Remove triangles from the KCL that can never be reached.
-You can save much more triangles if you think 3D. See the the 3 pictures at the right: green is grass, blue the road, yellow are boost and brown a small hill. In the first picture you see, that 49 triangles are used. It's because the developer thinks only in 2D and lays all triangles side by side.
+You can save much more triangles if you think in 3D. See the 3 pictures at the right: green is grass, blue the road, yellow are boost and brown a small hill. In the first picture you see, that 49 triangles are used. It's because the developer thinks only in 2D and lays all triangles side by side.
-And now let's take a look, how Nintendo did it for the newer tracks. They think 3D and define the grass level with only 2 triangles. Then they place a street 2-4 units higher and use again only a few triangles. And in a third level they place the boost parts. And the hill is also placed in the grass and may go below the grass.
+And now let's take a look, how Nintendo did it for the newer tracks. They think in 3D and define the grass level with only 2 triangles. Then they place a street 2-4 units higher and use again only a few triangles. And in a third level they place the boost parts. And the hill is also placed in the grass and may go below the grass.
-In the third picture you see a schematic 3D view of the second one. Watch out the black shadows. In the first picture 49 face up triangles are used and in the two others pictures only 19; this saves 61% triangles in this example. Nintendo raises the above levels about 2-4 units (100 units in this demonstration).
+In the third picture you see a schematic 3D view of the second one. Watch out the black shadows. In the first picture 49 face up triangles are used and in the two other pictures only 19; this saves 61% triangles in this example. Nintendo raises the above levels about 2-4 units (100 units in this demonstration).
-===Optimize Objects===
+=== Optimize Objects ===
 Your level might also have too many objects. This may be caused by:
 * Too many objects in the KMP.
@@ Line 59: / Line 60: @@
 * Objects with model animations set to display in all game modes.
-The easy solution would be to remove all unnecessary items from the KMP. Some items should only appear in single player mode, such as animated characters like piantas, flowers, and shy guy groups. In SZS Modifier's KMP Editor the final box will have a value like 0000003F. 3F means that object will appear in all game modes. Change it to 00000009 to disable those objects in split screen modes.
+The easy solution would be to remove all unnecessary items from the KMP. Some decoration [[object]]s should only appear in single player mode, such as animated characters like piantas, flowers, and shy guy groups. See »[[presence flag]]s« for more details.
-===Optimize Textures===
+=== Optimize Textures ===
-Be sure to check the [[SZS]] for duplicated textures before releasing.  You can find them by [[Texturing|browsing through the textures]] in course_model.brres.  Likewise, check the mtl file for "#Distorted Textures." These are twisted or skewed copies of textures used in your level, usually used on just a single face of the model. You can find the locations of these textures on your model by replacing the distorted texture with a texture that contrasts well with the rest of the textures in your level, such as lime green or neon orange, then loading the model in-game or in the BRRES Editor.  Reset the alignment of these textures on your model and re-export to eliminate the distorted duplicates.
+Be sure to check the [[SZS]] for duplicated textures before releasing. You can find them by [[Texturing|browsing through the textures]] in course_model.brres. Likewise, check the mtl file for "#Distorted Textures." These are twisted or skewed copies of textures used in your level, usually used on just a single face of the model. You can find the locations of these textures on your model by replacing the distorted texture with a texture that contrasts well with the rest of the textures in your level, such as lime green or neon orange, then loading the model in-game or in the BRRES Editor. Reset the alignment of these textures on your model and re-export to eliminate the distorted duplicates.
-Large resolutions textures like 1024x1024 are rarely necessary and it is best practice to avoid them.  Reducing the resolution of textures may help, although the impact of a few hi-res textures usually won't be noticed unless there are other problems.  Just like the images below, you should try to make your images as unique as possible. You should also use the best possible texture format. Very simple gray-scaled Textures should use I4. More complex ones should use I8. If a gray-scaled image requires an Alpha Channel, it should use IA4 or IA8. For basic colored textures, you should choose CMPR. CMPR can have a better quality in Brawlbox's Importer than RGB565, which does not support an Alpha Channel and creates bigger files. RGBA32 or RGBA8 should be only used if you need True Color images with opacity, due to this fileformat creating large files. If you also don't know how to enable mipmaps in the MDL0 or don't need/want them, you should not create them in the Texture importer.
+Large resolution textures like 1024x1024 are rarely necessary and it is best practice to avoid them. Reducing the resolution of textures may help, although the impact of a few hi-res textures usually won't be noticed unless there are other problems. Just like the images below, you should try to make your images as unique as possible. You should also use the best possible texture format. Very simple gray-scaled Textures should use I4. More complex ones should use I8. If a gray-scaled image requires an Alpha Channel, it should use IA4 or IA8. For basic colored textures, you should choose CMPR. CMPR can have a better quality in Brawlbox's Importer than RGB565, which does not support an Alpha Channel and creates bigger files. RGBA32 or RGBA8 should be only used if you need True Color images with opacity, due to this file format creating large files. If you also don't know how to enable mipmaps in the MDL0 or don't need/want them, you should not create them in the Texture Importer.
 <gallery>
@@ Line 73: / Line 74: @@
 </gallery>
-===Optimize KCL===
+=== Optimize KCL ===
-Between the time of the SZS Modifier's KCL Editor and Wiimm's KCL Tool, people used workarounds to generate a bigger KCL than the ones from original game files. After [[Chadderz]] sent [[Tock]] a Beta version of his own KCL Editor, Tock was able to create a 3.29 MB sized KCL by importing the raw Model of GCN Sherbet Land twice. This has helped many people to create KCLs easier for their own Custom Tracks. Sadly, this means the SZS nowadays is blown up by much unused data. This can be fixed by simply decoding the KCL to a .obj file with Wiimms KCL Tool and re-encoding it to a KCL. The KCL files from Tock's old GCN Sherbet Land was reduced from 3.29 MB to 630 KB.
+Between the time of the SZS Modifier's KCL Editor and Wiimm's KCL Tool, people used workarounds to generate a bigger KCL than the ones from original game files. After [[Chadderz]] sent [[Tock]] a Beta version of his own KCL Editor, Tock was able to create a 3.29 MB sized KCL by importing the raw model of GCN Sherbet Land twice. This has helped many people to create KCLs easier for their own Custom Tracks. Sadly, this means the SZS nowadays is blown up by much unused data. This can be fixed by simply decoding the KCL to a .obj file with Wiimms KCL Tool and re-encoding it to a KCL. The KCL files from Tock's old GCN Sherbet Land was reduced from 3.29 MB to 630 KB.
-Additionally, it is best to simplify collision not only to avoid getting snagged or stuck on parts of the level, but also so that the CPU makes fewer collision calculations as players move through the level, reducing slowdown.  <!-- Collision can be huge, and shouldn't be underestimated.  I recently fixed a UT2004 level that was unplayable during certain conditions by turning collision off on most of the small, decorative meshes in the map.  Like night and day. - Jefe -->  Creating a separate [[Solidity#Collision_Models|simplified collision model]] allows you to optimize collision in a way that does not impact the look of your level.
+Additionally, it is best to simplify collision not only to avoid getting snagged or stuck on parts of the level, but also so that the CPU makes fewer collision calculations as players move through the level, reducing slowdown. <!-- Collision can be huge, and shouldn't be underestimated. I recently fixed a UT2004 level that was unplayable during certain conditions by turning collision off on most of the small, decorative meshes in the map. Like night and day. - Jefe -->  Creating a separate [[Solidity#Collision_Models|simplified collision model]] allows you to optimize collision in a way that does not impact the look of your level.
-==Known Tracks with Slow Motion Bug==
+== Known Tracks with Slow Motion Bug ==
 ; Major problems:
-* [[Bowser's Lava Road]] ~42.000 facepoints.
+* [[Bowser's Lava Road]] ~42 000 facepoints
-* [[Daisy's Palace]] RC2: ~'''80.000''' Facepoints, RC3: ~46.000 Facepoints.
+* [[Daisy's Palace (Vulcanus2)|Daisy's Palace]] RC2: ~'''80 000''' facepoints, RC3: ~46 000 facepoints
-* [[Dry Coast]] ~40.000 facepoints.
+* [[Dry Coast (Putinas)|Dry Coast]] ~40 000 facepoints
-* [[GBA_Ribbon_Road_(DemyxIX)|GBA Ribbon Road]] Singleplayer: ~'''102.000''' facepoints, Multiplayer: ~'''72.000''' facepoints.
+* [[GBA Ribbon Road (DemyxIX)|GBA Ribbon Road]] Single Player ~'''102 000''' facepoints, Multiplayer ~'''72 000''' facepoints
-* [[GCN_Wario_Colosseum_(MKDasher)|GCN Wario Colosseum]] ~'''98.000''' facepoints.
+* [[GCN Wario Colosseum (MKDasher)|GCN Wario Colosseum]] ~'''98 000''' facepoints
-* [[GP Mario Beach]] RC2 ~'''90.000''' facepoints.
+* [[GP Mario Beach]] ~'''90 000''' facepoints
-* [[Nightmare to Dream World]] ~'''83.000''' facepoints.
+* [[Grease Beach]]
+* [[Nightmare to Dream World]] ~'''83 000''' facepoints
+* [[Peach's Beach Party]] v1.5-beta ~'''101 500''' facepoints, v1.6 ~45 000 facepoints
 * [[River Bridge]]
 * [[Six King Labyrinth]]
-* [[Peach's Beach Party]] v1.5-beta ~'''101.500''' facepoints, v1.6 ~45.000 facepoints.
 ; Minimal problems:
-* [[SNES_Bowser_Castle_2_(MKDasher)|SNES Bowser Castle 2]] v1.2
 * [[Yoshi Mountain]]
@@ Line 99: / Line 100: @@
 [[Category:Bug]]
+[[Category:Slow Motion Bug| ]]
 [[Category:Optimization]]