From 36cfa27d6c62a2166147dd8c6e81fc2604603313 Mon Sep 17 00:00:00 2001 From: Vanic Date: Fri, 9 Jan 2026 20:39:54 +0300 Subject: [PATCH] Added annotations for `ColorSpec` utilities: `colorspec_to_colorstring`, `colorspec_to_bytes` & `colorspec_to_table` --- core_namespace/utilities.lua | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/core_namespace/utilities.lua b/core_namespace/utilities.lua index b00fe76..10f617d 100644 --- a/core_namespace/utilities.lua +++ b/core_namespace/utilities.lua @@ -353,3 +353,17 @@ function minetest.sha1(data, raw) end --- @param raw boolean optional. return raw bytes instead of hex digits, default: false function minetest.sha256(data, raw) end +--- Converts a ColorSpec to a ColorString. If the ColorSpec is invalid, returns `nil`. +--- @param colorspec ColorSpec The ColorSpec to convert. +--- @return ColorString? +function minetest.colorspec_to_colorstring(colorspec) end + +--- Converts a ColorSpec to a raw string of four bytes in an RGBA layout, returned as a string. +--- @param colorspec ColorSpec The ColorSpec to convert. +--- @return string? +function minetest.colorspec_to_bytes(colorspec) end + +--- Converts a ColorSpec into RGBA table form. If the ColorSpec is invalid, returns nil. You can use this to parse ColorStrings. +--- @param colorspec ColorSpec The ColorSpec to convert. +--- @return {r:number, g:number, b:string, a:number}? +function minetest.colorspec_to_table(colorspec) end