GetColorName - Revision history

IManGaaX at 11:18, 5 September 2025

2025-09-05T11:18:08Z

← Older revision		Revision as of 11:18, 5 September 2025
Line 16:		Line 16:
	===Returns===		===Returns===
	* Does not return a value directly.		* Does not return a value directly.
	* Calls the `callback` function with the color name when the API responds.		* Calls the 'callback' function with the color name when the API responds.
	* Possible callback values:		* Possible callback values:
	* 'Error' if the request failed.		* 'Error' if the request failed.

IManGaaX at 11:17, 5 September 2025

2025-09-05T11:17:29Z

← Older revision		Revision as of 11:17, 5 September 2025
Line 20:		Line 20:
	* 'Error' if the request failed.		* 'Error' if the request failed.
	* 'Unknown' if the API did not return a valid name.		* 'Unknown' if the API did not return a valid name.
	* Color name string, e.g., `'Dark Orange'`.		* Color name string, e.g., 'Dark Orange'.

	==Code==		==Code==

IManGaaX at 11:15, 5 September 2025

2025-09-05T11:15:19Z

← Older revision		Revision as of 11:15, 5 September 2025
Line 26:		Line 26:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function getColorName(r, g, b, callback)		function getColorName(r, g, b, callback)
	local url = string.format("https://www.thecolorapi.com/id?rgb=rgb(%d,%d,%d)", r, g, b)		local url = string.format("https://www.thecolorapi.com/id?rgb=rgb(%d,%d,%d)", r, g, b)
	fetchRemote(url, function(data, errno)		fetchRemote(url, function(data, errno)
	if errno == 0 then		if errno == 0 then
	local result = fromJSON(data)		local result = fromJSON(data)
	if result and result.name and result.name.value then		if result and result.name and result.name.value then
	callback(tostring(result.name.value))		callback(tostring(result.name.value))
	else		else
	callback("Unknown")		callback("Unknown")
	end		end
	else		else
	callback("Error")		callback("Error")
	end		end
	end, "", true)		end, "", true)
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 49:		Line 49:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	getColorName(255, 127, 0, function(name)		getColorName(255, 127, 0, function(name)
	outputChatBox("Color Name: "..name)		outputChatBox("Color Name: "..name)
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>
Line 56:		Line 56:
	local r, g, b = getVehicleColor(getPedOccupiedVehicle(imangaax))		local r, g, b = getVehicleColor(getPedOccupiedVehicle(imangaax))
	getColorName(r, g, b, function(name)		getColorName(r, g, b, function(name)
	outputChatBox("Your Vehicle Color Name: "..name, imangaax)		outputChatBox("Your Vehicle Color Name: "..name, imangaax)
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>

IManGaaX at 11:14, 5 September 2025

2025-09-05T11:14:25Z

← Older revision		Revision as of 11:14, 5 September 2025
Line 18:		Line 18:
	* Calls the `callback` function with the color name when the API responds.		* Calls the `callback` function with the color name when the API responds.
	* Possible callback values:		* Possible callback values:
	* Error if the request failed.		* 'Error' if the request failed.
	* Unknown if the API did not return a valid name.		* 'Unknown' if the API did not return a valid name.
	* Color name string, e.g., `'Dark Orange'`.		* Color name string, e.g., `'Dark Orange'`.

IManGaaX at 11:14, 5 September 2025

2025-09-05T11:14:04Z

← Older revision		Revision as of 11:14, 5 September 2025
Line 18:		Line 18:
	* Calls the `callback` function with the color name when the API responds.		* Calls the `callback` function with the color name when the API responds.
	* Possible callback values:		* Possible callback values:
	* `'Error'` if the request failed.		* Error if the request failed.
	* `'Unknown'` if the API did not return a valid name.		* Unknown if the API did not return a valid name.
	* Color name string, e.g., `'Dark Orange'`.		* Color name string, e.g., `'Dark Orange'`.

IManGaaX: Created page with "{{Useful Function}} NOTOC This function retrieves the nearest color name for a given RGB value using an online API. {{Note|This function requires an active internet connection and fetches the color name from an external API asynchronously. The result is returned via a callback function.}} ==Syntax== getColorName( int r, int g, int b, function callback(name) ) ===Required Arguments=== *..."

2025-09-05T11:13:36Z

Created page with "{{Useful Function}} __NOTOC__ <lowercasetitle></lowercasetitle> This function retrieves the nearest color name for a given RGB value using an online API. {{Note|This function requires an active internet connection and fetches the color name from an external API asynchronously. The result is returned via a callback function.}} ==Syntax== <syntaxhighlight lang="lua">getColorName( int r, int g, int b, function callback(name) )</syntaxhighlight> ===Required Arguments=== *..."

New page

{{Useful Function}} __NOTOC__
<lowercasetitle></lowercasetitle>
This function retrieves the nearest color name for a given RGB value using an online API.

{{Note|This function requires an active internet connection and fetches the color name from an external API asynchronously. The result is returned via a callback function.}}

==Syntax==
<syntaxhighlight lang="lua">getColorName( int r, int g, int b, function callback(name) )</syntaxhighlight>

===Required Arguments===
* '''r''': Red component (0-255) of the color.
* '''g''': Green component (0-255) of the color.
* '''b''': Blue component (0-255) of the color.
* '''callback''': A function that will receive the color name as a string.

===Returns===
* Does not return a value directly.
* Calls the `callback` function with the color name when the API responds.
* Possible callback values:
* `'Error'` if the request failed.
* `'Unknown'` if the API did not return a valid name.
* Color name string, e.g., `'Dark Orange'`.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getColorName(r, g, b, callback)
local url = string.format("https://www.thecolorapi.com/id?rgb=rgb(%d,%d,%d)", r, g, b)
fetchRemote(url, function(data, errno)
if errno == 0 then
local result = fromJSON(data)
if result and result.name and result.name.value then
callback(tostring(result.name.value))
else
callback("Unknown")
end
else
callback("Error")
end
end, "", true)
end
</syntaxhighlight>
</section>

'''Author:''' [[User:IManGaaX|Youssef Maged (iManGaaX)]]

==Examples==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
getColorName(255, 127, 0, function(name)
outputChatBox("Color Name: "..name)
end)
</syntaxhighlight>
<syntaxhighlight lang="lua">
local imangaax = getPlayerFromName("iManGaaX")
local r, g, b = getVehicleColor(getPedOccupiedVehicle(imangaax))
getColorName(r, g, b, function(name)
outputChatBox("Your Vehicle Color Name: "..name, imangaax)
end)
</syntaxhighlight>
<syntaxhighlight lang="lua">
-- If a player owns a vehicle and you want to retrieve detailed information about the vehicle, such as its color name
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}