Needle colour mod - Revision history

Cas: /* Custom cars that use this mod */

2024-04-15T18:30:27Z

Custom cars that use this mod

← Older revision		Revision as of 20:30, 15 April 2024
Line 143:		Line 143:

	== Custom cars that use this mod ==		== Custom cars that use this mod ==
	Since the mod was released, car makers have made extensive use of the needle colour set up. Probably the first custom car to use the mod was [[Zapper]]'s [[Caterham Super Seven JPE]], with the two of its instrument needles set to black. [[Ryoma]] also used it for his [[Ford Shelby Mustang GT350x]], with red needles.		Since the mod was released, car makers have made extensive use of the needle colour set up. Probably the first custom car to use the mod was [[Zapper]]'s [[Caterham Super Seven JPE]], with the two of its instrument needles set to black. [[Ryoma]] also used it for his [[Ford Shelby Mustang GT350x]], with red needles and his [[Ferrari 308 GT Rainbow]], which features yellow instrument needles.

Cas: /* Custom cars that use this mod */

2024-04-15T18:28:48Z

Custom cars that use this mod

← Older revision		Revision as of 20:28, 15 April 2024
Line 143:		Line 143:

	== Custom cars that use this mod ==		== Custom cars that use this mod ==
	Since the mod was released, car makers have made extensive use of the needle colour set up. Probably the first custom car to use the mod was [[Zapper]]'s [[Caterham Super Seven JPE]], with the two of its instrument needles set to black.		Since the mod was released, car makers have made extensive use of the needle colour set up. Probably the first custom car to use the mod was [[Zapper]]'s [[Caterham Super Seven JPE]], with the two of its instrument needles set to black. [[Ryoma]] also used it for his [[Ford Shelby Mustang GT350x]], with red needles.

Cas: /* Custom cars that use this mod */

2024-04-15T18:26:54Z

Custom cars that use this mod

← Older revision		Revision as of 20:26, 15 April 2024
Line 143:		Line 143:

	== Custom cars that use this mod ==		== Custom cars that use this mod ==
			Since the mod was released, car makers have made extensive use of the needle colour set up. Probably the first custom car to use the mod was [[Zapper]]'s [[Caterham Super Seven JPE]], with the two of its instrument needles set to black.

Cas: /* Technical details */

2024-04-15T18:18:30Z

Technical details

← Older revision		Revision as of 20:18, 15 April 2024
Line 136:		Line 136:

	Here, new code had to be pushed into the source, so Daniel3D and Cas had to work hard to test alignment, which gave bugs, until they found the three ''nops'' would work. This modification is explained in detail in [https://forum.stunts.hu/index.php?topic=3872.0 this forum post].		Here, new code had to be pushed into the source, so Daniel3D and Cas had to work hard to test alignment, which gave bugs, until they found the three ''nops'' would work. This modification is explained in detail in [https://forum.stunts.hu/index.php?topic=3872.0 this forum post].

			== Using the needle colour mod ==
			To correctly change a car's needle colours, we modify the Red #5 "mysterious" field that appears as "needle colour" in more recent versions of CarWorks. This field is a word, so if we use a value from 0 to 255, the high byte will be left at 0. In this case, both needles will be set to the specified colour. The default value of this field is 16, so by default, both needles will be white.

			If we want to use different colours for the needles, we need to change the high byte to a non-zero value. In that case, the speed-o-meter will take the colour set in the low byte and the tach-o-meter will use the high byte colour. This means the tach-o-meter can't have a 0 colour needle, but there are other values that also produce black or close to black, so that's not a problem.

			== Custom cars that use this mod ==

Cas: /* Technical details */

2024-04-15T18:14:01Z

Technical details

← Older revision		Revision as of 20:14, 15 April 2024
Line 135:		Line 135:
	</tt>		</tt>

	Here, new code had to be pushed into the source, so Daniel3D and Cas had to work hard to test alignment, which gave bugs, until they found the three ''nops'' would work. This modification is explained in [https://forum.stunts.hu/index.php?topic=3872.0\|this forum post].		Here, new code had to be pushed into the source, so Daniel3D and Cas had to work hard to test alignment, which gave bugs, until they found the three ''nops'' would work. This modification is explained in detail in [https://forum.stunts.hu/index.php?topic=3872.0 this forum post].

Cas: /* Technical details */

2024-04-15T18:13:01Z

Technical details

← Older revision		Revision as of 20:13, 15 April 2024
Line 61:		Line 61:

	<tt>push simd_player.field_A6+4</tt>		<tt>push simd_player.field_A6+4</tt>

			Initially, Cas expected it'd be possible to find within the binary file the word corresponding the the ''meter_needle_colour'' pointer and change it to this other point, but this didn't work for some reason. Daniel3D aided in recompiling and testing the code. The first version worked well immediately, but caused both needles to change to that colour. To obtain independently configurable needle colours, Cas came up with this modified code:

			<tt>
			loc_23456:
			cmp [bp+var_6], 0
			jnz short loc_23485
			mov ax, si
			shl ax, 1
			mov [bp+var_20], ax

			; Patch #1 ----*
			; Replaced needle colour for speed-o-meter

			; Original code:
			;push meter_needle_color

			push simd_player.field_A6+8

			mov bx, ax
			mov al, (simd_player.spdpoints+1)[bx]
			sub ah, ah
			push ax
			mov al, simd_player.spdpoints[bx]
			push ax
			push simd_player.spdcenter.y2
			push simd_player.spdcenter.x2
			call preRender_line
			add sp, 0Ah
			loc_23485:
			mov ax, di
			shl ax, 1
			mov [bp+var_20], ax

			; Replaced needle colour for RPM meter
			; Original code:
			;push meter_needle_color

			; This line is for the first version of the patch
			;push simd_player.field_A6+8

			; This block is the new version of the patch
			cmp byte ptr [simd_player.field_A6+9], 0 ; Check to see if the high byte is zero
			jz use_the_same_colour
			push simd_player.field_A6+9 ; It's not, so push this high byte as the colour
			jmp needle_value_successfully_set ; Continue with the old code
			use_the_same_colour:
			push simd_player.field_A6+8 ; It is, so push the low byte as the colour
			needle_value_successfully_set:
			nop ; Alignment bytes
			nop
			nop

			mov bx, ax
			mov al, (simd_player.revpoints+1)[bx]
			sub ah, ah
			push ax
			mov al, simd_player.revpoints[bx]
			push ax
			push simd_player.revcenter.y2
			push simd_player.revcenter.x2
			call preRender_line
			add sp, 0Ah
			mov al, [bp+var_2]
			cbw
			or ax, ax
			jz short loc_234BE
			cmp ax, 2 ; st. whl. position flag
			jz short loc_234EC
			jmp short loc_234DE
			; align 2
			db 144
			</tt>

			Here, new code had to be pushed into the source, so Daniel3D and Cas had to work hard to test alignment, which gave bugs, until they found the three ''nops'' would work. This modification is explained in [https://forum.stunts.hu/index.php?topic=3872.0\|this forum post].

Cas: /* Technical details */

2024-04-15T18:03:27Z

Technical details

← Older revision		Revision as of 20:03, 15 April 2024
Line 57:		Line 57:
	db 144		db 144
	</tt>		</tt>

			Here, ''meter_needle_color'' is a pointer and at that location, there is a single fixed byte with the number 15, which is white in Stunts. Cas searched and found a region of the code where the car information was loaded and among the so-called "mysterious fields", picked one that had the value 16 on all original and old custom cars, because 16 is also white in Stunts. Then he proposed to change the push line to:

			<tt>push simd_player.field_A6+4</tt>

Cas: /* Technical details */

2024-04-15T17:59:33Z

Technical details

← Older revision		Revision as of 19:59, 15 April 2024
Line 14:		Line 14:
	The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:		The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:

	<tt>loc_23456:-		<tt>
			loc_23456:
	cmp [bp+var_6], 0		cmp [bp+var_6], 0
	jnz short loc_23485		jnz short loc_23485
Line 54:		Line 55:
	jmp short loc_234DE		jmp short loc_234DE
	; align 2		; align 2
	db 144</tt>		db 144
			</tt>

Cas: /* Technical details */

2024-04-15T17:58:50Z

Technical details

← Older revision		Revision as of 19:58, 15 April 2024
Line 14:		Line 14:
	The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:		The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:

	<tt> loc_23456:		<tt>loc_23456:-
	cmp [bp+var_6], 0		cmp [bp+var_6], 0
	jnz short loc_23485		jnz short loc_23485

Cas: /* Technical details */

2024-04-15T17:58:11Z

Technical details

← Older revision		Revision as of 19:58, 15 April 2024
Line 14:		Line 14:
	The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:		The code Daniel3D initially identified in ReStunts is located in the seg005.asm segment source file and it looks like this:

	<tt>loc_23456:		<tt> loc_23456:
	cmp [bp+var_6], 0		cmp [bp+var_6], 0
	jnz short loc_23485		jnz short loc_23485