Color - Revision history

Frank@tygron.nl at 09:14, 1 May 2026

2026-05-01T09:14:52Z

← Older revision		Revision as of 09:14, 1 May 2026
Line 54:		Line 54:
	* For single value notation, including a transparency (alpha) value involves adding an additional value based on a base value of 256³. However, in this situation an integer roll-over may occur while calculating the required value, which leads to the slightly more complex formula.		* For single value notation, including a transparency (alpha) value involves adding an additional value based on a base value of 256³. However, in this situation an integer roll-over may occur while calculating the required value, which leads to the slightly more complex formula.
	\|seealso=		\|seealso=
	* [[~~Roof~~ color (Function Value)]]		* [[Basement color (Function Value)]]
	* [[Ground color (Function Value)]]		* [[Ground color (Function Value)]]
	* [[Extra color (Function Value)‎]]		* [[Extra color (Function Value)‎]]
	* [[Top color (Function Value)‎]]		* [[Top color (Function Value)‎]]
			* [[Roof color (Function Value)]]
	* [[Color (Terrain Attribute)]]		* [[Color (Terrain Attribute)]]
	* [[Color (Panel Attribute)]]		* [[Color (Panel Attribute)]]

Frank@tygron.nl: /* Combo Overlay Functions */

2026-04-29T15:07:32Z

Combo Overlay Functions

← Older revision		Revision as of 15:07, 29 April 2026
Line 42:		Line 42:
	==Combo Overlay Functions==		==Combo Overlay Functions==
	The Combo Overlay provides the following functions to convert between RGBA values and a Tygron Color value:		The Combo Overlay provides the following functions to convert between RGBA values and a Tygron Color value:
	*COLOR: Create a color given a red, green and blue value. A fourth alpha value is optional.		*''COLOR'': Create a color given a red, green and blue value. A fourth alpha value is optional.
	*RED: Get a red channel value (0-255) for a legend color or pixel value.		*''RED'': Get a red channel value (0-255) for a legend color or pixel value.
	*GREEN: Get a green channel value (0-255) for a legend color or pixel value.		*''GREEN'': Get a green channel value (0-255) for a legend color or pixel value.
	*BLUE: Get a blue channel value (0-255) for a legend color or pixel value.		*''BLUE'': Get a blue channel value (0-255) for a legend color or pixel value.
	*ALPHA: Get an alpha channel value (0-255) for a legend color or pixel value.		*''ALPHA'': Get an alpha channel value (0-255) for a legend color or pixel value.

	Always use these functions for conversions instead of writing your own.		Always use these functions for conversions instead of writing your own.

Frank@tygron.nl: /* HEX format */

2026-04-29T15:07:10Z

HEX format

← Older revision		Revision as of 15:07, 29 April 2026
Line 37:		Line 37:
	==HEX format==		==HEX format==
	When requesting an items Color by executing a [[Select color (TQL)]] query, the result is returned in a HEX format, such that it can be used directly in HTML. A hexadecimal color is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. A hexadecimal number is represented by a number from 0 to 9 or by a letter A to F, where A represents the number 10 and F the number 15. Two hexadecimal numbers support 256 unique decimal numbers.		When requesting an items Color by executing a [[Select color (TQL)]] query, the result is returned in a HEX format, such that it can be used directly in HTML. A hexadecimal color is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. A hexadecimal number is represented by a number from 0 to 9 or by a letter A to F, where A represents the number 10 and F the number 15. Two hexadecimal numbers support 256 unique decimal numbers.

			See also: [https://www.w3schools.com/html/html_colors_hex.asp HTML HEX Colors]

	==Combo Overlay Functions==		==Combo Overlay Functions==

Frank@tygron.nl: /* Combo Overlay Functions */

2026-04-29T15:07:06Z

Combo Overlay Functions

← Older revision		Revision as of 15:07, 29 April 2026
Line 48:		Line 48:
	Always use these functions for conversions instead of writing your own.		Always use these functions for conversions instead of writing your own.


	~~See also: [https://www.w3schools.com/html/html_colors_hex.asp HTML HEX Colors]~~
	{{article end		{{article end
	\|notes=		\|notes=

Frank@tygron.nl at 15:06, 29 April 2026

2026-04-29T15:06:54Z

@@ Line 37: / Line 37: @@
 ==HEX format==
 When requesting an items Color by executing a [[Select color (TQL)]] query, the result is returned in a HEX format, such that it can be used directly in HTML. A hexadecimal color is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. A hexadecimal number is represented by a number from 0 to 9 or by a letter A to F, where A represents the number 10 and F the number 15. Two hexadecimal numbers support 256 unique decimal numbers.
 See also: [https://www.w3schools.com/html/html_colors_hex.asp HTML HEX Colors]

Rudolf@tygron.nl at 07:21, 12 March 2026

2026-03-12T07:21:28Z

← Older revision		Revision as of 07:21, 12 March 2026
Line 49:		Line 49:
	* [[Color (Terrain Attribute)]]		* [[Color (Terrain Attribute)]]
	* [[Color (Panel Attribute)]]		* [[Color (Panel Attribute)]]
			* [[Color (Area Attribute)]]
	}}		}}
	[[Category:unit]]		[[Category:unit]]

Rudolf@tygron.nl at 13:50, 11 February 2026

2026-02-11T13:50:54Z

← Older revision		Revision as of 13:50, 11 February 2026
Line 41:		Line 41:
	{{article end		{{article end
	\|notes=		\|notes=
	* For single value notation, including a transparency (alpha) value involves adding an additional value based on a base value of 256³. However, in this situation an integer roll-over may occur while calculating the required value.		* For single value notation, including a transparency (alpha) value involves adding an additional value based on a base value of 256³. However, in this situation an integer roll-over may occur while calculating the required value, which leads to the slightly more complex formula.
	\|seealso=		\|seealso=
	*[[ Roof color (Function Value)]]		* [[Roof color (Function Value)]]
	*[[Ground color (Function Value) ]]		* [[Ground color (Function Value)]]
	*[[Extra color (Function Value) ‎]]		* [[Extra color (Function Value)‎]]
	*[[Top color (Function Value) ‎]]		* [[Top color (Function Value)‎]]
	* [[Color (Terrain Attribute)]]		* [[Color (Terrain Attribute)]]
	* [[Color (Panel Attribute)]]		* [[Color (Panel Attribute)]]
	}}		}}
	[[Category:unit]]		[[Category:unit]]

Rudolf@tygron.nl at 13:49, 11 February 2026

2026-02-11T13:49:47Z

← Older revision		Revision as of 13:49, 11 February 2026
Line 9:		Line 9:

	A proper color value can be calculated as follows:		A proper color value can be calculated as follows:
	{{code\|1=color = -16777216 + (red * 256²) + (green * 256) + (blue)</code>}}		{{code\|1=color = -16777216 + (alpha * 256³) + (red * 256²) + (green * 256) + (blue)</code>}}

	RGB values (with ranges of 0-255) can be calculated as follows:		RGB values (with ranges of 0-255) can be calculated as follows:
	{{code\|1=		{{code\|1=
	B = ( color + 16777216) % 256		B = ( color + 16777216 ) % 256
	G = (( color + 16777216) / 256 ) % 256		G = (( color + 16777216 ) / 256 ) % 256
	R = (( color + 16777216) / 256² ) % 256		R = (( color + 16777216 ) / 256² ) % 256
	}}		}}
			In which the result of each division is strictly rounded down.

			===Alpha value===
			An alpha value is included in the calculation as follows:
			{{code\|1=color = ( 2147483648 + (red * 256²) + (green * 256) + (blue) ) % 4294967296 ) - 2147483648 </code>}}

			RGBA values (with ranges of 0-255) can be calculated as follows:
			{{code\|1=
			B = ( color % 4294967296 ) % 256
			G = (( color % 4294967296 ) / 256 ) % 256
			R = (( color % 4294967296 ) / 256² ) % 256
			A = (( color % 4294967296 ) / 256³ ) % 256
			}}
			In which the result of each division is strictly rounded down.

	==RGB(A) format==		==RGB(A) format==

Rudolf@tygron.nl at 12:33, 11 February 2026

2026-02-11T12:33:04Z

← Older revision		Revision as of 12:33, 11 February 2026
Line 26:		Line 26:
	See also: [https://www.w3schools.com/html/html_colors_hex.asp HTML HEX Colors]		See also: [https://www.w3schools.com/html/html_colors_hex.asp HTML HEX Colors]
	{{article end		{{article end
			\|notes=
			* For single value notation, including a transparency (alpha) value involves adding an additional value based on a base value of 256³. However, in this situation an integer roll-over may occur while calculating the required value.
	\|seealso=		\|seealso=
	*[[ Roof color (Function Value)]]		*[[ Roof color (Function Value)]]

Rudolf@tygron.nl: /* Single value format */

2024-08-21T12:04:36Z

Single value format

← Older revision		Revision as of 12:04, 21 August 2024
Line 6:		Line 6:

	==Single value format==		==Single value format==
	For optimal compatibility between formats which only allow the reading and setting of a single value, the color can be read and stored as a single value as well. The numeric value corresponds to an RGB color value, calculated by combining the red, green and blue values of the desired color together, multiplied by powers of 256. The amount of red, green, and blue are values between 0 and 255, inclusive. These are added to a base value of -16777216. A proper color value can be calculated as follows: -16777216 + (red * 256²) + (green * 256) + (blue).		For optimal compatibility between formats which only allow the reading and setting of a single value, the color can be read and stored as a single value as well. The numeric value corresponds to an RGB color value, calculated by combining the red, green and blue values of the desired color together, multiplied by powers of 256. The amount of red, green, and blue are values between 0 and 255, inclusive. These are added to a base value of -16777216.

			A proper color value can be calculated as follows:
			{{code\|1=color = -16777216 + (red * 256²) + (green * 256) + (blue)</code>}}

			RGB values (with ranges of 0-255) can be calculated as follows:
			{{code\|1=
			B = ( color + 16777216) % 256
			G = (( color + 16777216) / 256 ) % 256
			R = (( color + 16777216) / 256² ) % 256
			}}

	==RGB(A) format==		==RGB(A) format==