1
0
mirror of https://github.com/VCMP-SqMod/SqMod.git synced 2024-11-08 08:47:17 +01:00
SqMod/module/Base/Color3.cpp
2022-09-18 15:02:39 +03:00

799 lines
25 KiB
C++

// ------------------------------------------------------------------------------------------------
#include "Base/Color3.hpp"
#include "Base/Color4.hpp"
#include "Base/DynArg.hpp"
#include "Core/Buffer.hpp"
#include "Core/Utility.hpp"
#include "Library/JSON.hpp"
#include "Library/Numeric/Random.hpp"
// ------------------------------------------------------------------------------------------------
namespace SqMod {
// ------------------------------------------------------------------------------------------------
SQMOD_DECL_TYPENAME(Typename, _SC("Color3"))
// ------------------------------------------------------------------------------------------------
const Color3 Color3::NIL = Color3();
const Color3 Color3::MIN = Color3(std::numeric_limits< Color3::Value >::min());
const Color3 Color3::MAX = Color3(std::numeric_limits< Color3::Value >::max());
// ------------------------------------------------------------------------------------------------
SQChar Color3::Delim = ',';
bool Color3::UpperCaseHex = false;
// ------------------------------------------------------------------------------------------------
Color3::Color3(Value sv) noexcept
: r(sv), g(sv), b(sv)
{
/* ... */
}
// ------------------------------------------------------------------------------------------------
Color3::Color3(Value rv, Value gv, Value bv) noexcept
: r(rv), g(gv), b(bv)
{
/* ... */
}
// ------------------------------------------------------------------------------------------------
Color3::Color3(Value rv, Value gv, Value bv, Value /*av*/) noexcept
: r(rv), g(gv), b(bv)
{
/* ... */
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator = (Value s)
{
r = s;
g = s;
b = s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator = (const Color4 & c)
{
r = c.r;
g = c.g;
b = c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator += (const Color3 & c)
{
r += c.r;
g += c.g;
b += c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator -= (const Color3 & c)
{
r -= c.r;
g -= c.g;
b -= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator *= (const Color3 & c)
{
r *= c.r;
g *= c.g;
b *= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator /= (const Color3 & c)
{
r /= c.r;
g /= c.g;
b /= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator %= (const Color3 & c)
{
r %= c.r;
g %= c.g;
b %= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator &= (const Color3 & c)
{
r &= c.r;
g &= c.g;
b &= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator |= (const Color3 & c)
{
r |= c.r;
g |= c.g;
b |= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator ^= (const Color3 & c)
{
r ^= c.r;
g ^= c.g;
b ^= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator <<= (const Color3 & c)
{
r <<= c.r;
g <<= c.g;
b <<= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator >>= (const Color3 & c)
{
r >>= c.r;
g >>= c.g;
b >>= c.b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator += (Value s)
{
r += s;
g += s;
b += s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator -= (Value s)
{
r -= s;
g -= s;
b -= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator *= (Value s)
{
r *= s;
g *= s;
b *= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator /= (Value s)
{
r /= s;
g /= s;
b /= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator %= (Value s)
{
r %= s;
g %= s;
b %= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator &= (Value s)
{
r &= s;
g &= s;
b &= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator |= (Value s)
{
r |= s;
g |= s;
b |= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator ^= (Value s)
{
r ^= s;
g ^= s;
b ^= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator <<= (Value s)
{
r <<= s;
g <<= s;
b <<= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator >>= (Value s)
{
r >>= s;
g >>= s;
b >>= s;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator ++ ()
{
++r;
++g;
++b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::operator -- ()
{
--r;
--g;
--b;
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator ++ (int) // NOLINT(cert-dcl21-cpp)
{
Color3 state(*this);
++r;
++g;
++b;
return state;
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator -- (int) // NOLINT(cert-dcl21-cpp)
{
Color3 state(*this);
--r;
--g;
--b;
return state;
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator + (const Color3 & c) const
{
return {static_cast<Value>(r + c.r), static_cast<Value>(g + c.g), static_cast<Value>(b + c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator - (const Color3 & c) const
{
return {static_cast<Value>(r - c.r), static_cast<Value>(g - c.g), static_cast<Value>(b - c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator * (const Color3 & c) const
{
return {static_cast<Value>(r * c.r), static_cast<Value>(g * c.g), static_cast<Value>(b * c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator / (const Color3 & c) const
{
return {static_cast<Value>(r / c.r), static_cast<Value>(g / c.g), static_cast<Value>(b / c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator % (const Color3 & c) const
{
return {static_cast<Value>(r % c.r), static_cast<Value>(g % c.g), static_cast<Value>(b % c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator & (const Color3 & c) const
{
return {static_cast<Value>(r & c.r), static_cast<Value>(g & c.g), static_cast<Value>(b & c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator | (const Color3 & c) const
{
return {static_cast<Value>(r | c.r), static_cast<Value>(g | c.g), static_cast<Value>(b | c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator ^ (const Color3 & c) const
{
return {static_cast<Value>(r ^ c.r), static_cast<Value>(g ^ c.g), static_cast<Value>(b ^ c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator << (const Color3 & c) const
{
return {static_cast<Value>(r << c.r), static_cast<Value>(g << c.g), static_cast<Value>(b << c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator >> (const Color3 & c) const
{
return {static_cast<Value>(r >> c.r), static_cast<Value>(g >> c.g), static_cast<Value>(b >> c.b)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator + (Value s) const
{
return {static_cast<Value>(r + s), static_cast<Value>(g + s), static_cast<Value>(b + s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator - (Value s) const
{
return {static_cast<Value>(r - s), static_cast<Value>(g - s), static_cast<Value>(b - s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator * (Value s) const
{
return {static_cast<Value>(r * s), static_cast<Value>(g * s), static_cast<Value>(b * s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator / (Value s) const
{
return {static_cast<Value>(r / s), static_cast<Value>(g / s), static_cast<Value>(b / s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator % (Value s) const
{
return {static_cast<Value>(r % s), static_cast<Value>(g % s), static_cast<Value>(b % s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator & (Value s) const
{
return {static_cast<Value>(r & s), static_cast<Value>(g & s), static_cast<Value>(b & s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator | (Value s) const
{
return {static_cast<Value>(r | s), static_cast<Value>(g | s), static_cast<Value>(b | s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator ^ (Value s) const
{
return {static_cast<Value>(r ^ s), static_cast<Value>(g ^ s), static_cast<Value>(b ^ s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator << (Value s) const
{
return {static_cast<Value>(r << s), static_cast<Value>(g << s), static_cast<Value>(b << s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator >> (Value s) const
{
return {static_cast<Value>(r >> s), static_cast<Value>(g >> s), static_cast<Value>(b >> s)};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator + () const
{
return {r, g, b};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator - () const
{
return {0, 0, 0};
}
// ------------------------------------------------------------------------------------------------
Color3 Color3::operator ~ () const
{
return {static_cast<Value>(~r), static_cast<Value>(~g), static_cast<Value>(~b)};
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator == (const Color3 & c) const
{
return (r == c.r) && (g == c.g) && (b == c.b);
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator != (const Color3 & c) const
{
return (r != c.r) || (g != c.g) || (b != c.b);
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator < (const Color3 & c) const
{
return (r < c.r) && (g < c.g) && (b < c.b);
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator > (const Color3 & c) const
{
return (r > c.r) && (g > c.g) && (b > c.b);
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator <= (const Color3 & c) const
{
return (r <= c.r) && (g <= c.g) && (b <= c.b);
}
// ------------------------------------------------------------------------------------------------
bool Color3::operator >= (const Color3 & c) const
{
return (r >= c.r) && (g >= c.g) && (b >= c.b);
}
// ------------------------------------------------------------------------------------------------
Color3::operator Color4 () const
{
return {r, g, b};
}
// ------------------------------------------------------------------------------------------------
int32_t Color3::Cmp(const Color3 & o) const
{
if (*this == o)
{
return 0;
}
else if (*this > o)
{
return 1;
}
else
{
return -1;
}
}
// ------------------------------------------------------------------------------------------------
String Color3::ToString() const
{
return fmt::format("{},{},{}", r, g, b);
}
// ------------------------------------------------------------------------------------------------
void Color3::ToJSON(CtxJSON & ctx) const
{
if (ctx.mObjectOverArray)
{
fmt::format_to(std::back_inserter(ctx.mOutput), "{{r:{},g:{},b:{}}},", r, g, b);
}
else
{
fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{}],", r, g, b);
}
}
// ------------------------------------------------------------------------------------------------
void Color3::SetScalar(Value ns)
{
r = ns;
g = ns;
b = ns;
}
// ------------------------------------------------------------------------------------------------
void Color3::SetColor3(const Color3 & c)
{
r = c.r;
g = c.g;
b = c.b;
}
// ------------------------------------------------------------------------------------------------
void Color3::SetColor3Ex(Value nr, Value ng, Value nb)
{
r = nr;
g = ng;
b = nb;
}
// ------------------------------------------------------------------------------------------------
void Color3::SetColor4(const Color4 & c)
{
r = c.r;
g = c.g;
b = c.b;
}
// ------------------------------------------------------------------------------------------------
void Color3::SetColor4Ex(Value nr, Value ng, Value nb, Value /*na*/)
{
r = nr;
g = ng;
b = nb;
}
// ------------------------------------------------------------------------------------------------
void Color3::SetStr(SQChar delim, StackStrF & values)
{
SetColor3(Color3::GetEx(delim, values));
}
// ------------------------------------------------------------------------------------------------
void Color3::SetName(StackStrF & name)
{
SetColor3(GetColor(name));
}
// ------------------------------------------------------------------------------------------------
uint32_t Color3::GetRGB() const
{
return uint32_t(r << 16u | g << 8u | b); // NOLINT(hicpp-signed-bitwise)
}
// ------------------------------------------------------------------------------------------------
void Color3::SetRGB(uint32_t p)
{
r = static_cast< Value >((p >> 16u) & 0xFFu);
g = static_cast< Value >((p >> 8u) & 0xFFu);
b = static_cast< Value >((p) & 0xFFu);
}
// ------------------------------------------------------------------------------------------------
uint32_t Color3::GetRGBA() const
{
return (r << 24u | g << 16u | b << 8u | 0u); // NOLINT(hicpp-signed-bitwise)
}
// ------------------------------------------------------------------------------------------------
void Color3::SetRGBA(uint32_t p)
{
r = static_cast< Value >((p >> 24u) & 0xFFu);
g = static_cast< Value >((p >> 16u) & 0xFFu);
b = static_cast< Value >((p >> 8u) & 0xFFu);
}
// ------------------------------------------------------------------------------------------------
uint32_t Color3::GetARGB() const
{
return (0u << 24u | r << 16u | g << 8u | b); // NOLINT(hicpp-signed-bitwise)
}
// ------------------------------------------------------------------------------------------------
void Color3::SetARGB(uint32_t p)
{
r = static_cast< Value >((p >> 16u) & 0xFFu);
g = static_cast< Value >((p >> 8u) & 0xFFu);
b = static_cast< Value >((p) & 0xFFu);
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::Generate()
{
r = GetRandomUint8();
g = GetRandomUint8();
b = GetRandomUint8();
// Allow chaining
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::GenerateB(Value min, Value max)
{
if (max < min)
{
STHROWF("max value is lower than min value");
}
r = GetRandomUint8(min, max);
g = GetRandomUint8(min, max);
b = GetRandomUint8(min, max);
// Allow chaining
return *this;
}
// ------------------------------------------------------------------------------------------------
Color3 & Color3::GenerateR(Value rmin, Value rmax, Value gmin, Value gmax, Value bmin, Value bmax)
{
if (rmax < rmin || gmax < gmin || bmax < bmin)
{
STHROWF("max value is lower than min value");
}
r = GetRandomUint8(rmin, rmax);
g = GetRandomUint8(gmin, gmax);
b = GetRandomUint8(bmin, bmax);
// Allow chaining
return *this;
}
// ------------------------------------------------------------------------------------------------
void Color3::Random()
{
SetColor3(GetRandomColor());
}
// ------------------------------------------------------------------------------------------------
void Color3::Inverse()
{
r = static_cast< Value >(~r);
g = static_cast< Value >(~g);
b = static_cast< Value >(~b);
}
// ------------------------------------------------------------------------------------------------
LightObj Color3::ToHex() const
{
SQChar buff[16]; // 7 should be enough
// Attempt to perform the format in the local buffer
if (std::snprintf(buff, 16, UpperCaseHex ? "%02X%02X%02X" : "%02x%02x%02x", r, g, b) <= 0)
{
STHROWF("Format failed (somehow)");
}
// Return the resulted string
return LightObj{buff, -1};
}
// ------------------------------------------------------------------------------------------------
LightObj Color3::ToHex4() const
{
SQChar buff[16]; // 9 should be enough
// Attempt to perform the format in the local buffer
if (std::snprintf(buff, 16, UpperCaseHex ? "%02X%02X%02X%02X" : "%02x%02x%02x%02x", r, g, b, 0) <= 0)
{
STHROWF("Format failed (somehow)");
}
// Return the resulted string
return LightObj{buff, -1};
}
// ------------------------------------------------------------------------------------------------
String Color3::Format(StackStrF & str) const
{
return fmt::format(fmt::runtime(str.ToStr())
, fmt::arg("r", r)
, fmt::arg("g", g)
, fmt::arg("b", b)
);
}
// ------------------------------------------------------------------------------------------------
const Color3 & Color3::Get(StackStrF & str)
{
return Color3::GetEx(Color3::Delim, str);
}
// ------------------------------------------------------------------------------------------------
const Color3 & Color3::GetEx(SQChar delim, StackStrF & str)
{
static Color3 col;
// The minimum and maximum values supported by the Color3 type
static constexpr uint32_t min = std::numeric_limits< Color3::Value >::min();
static constexpr uint32_t max = std::numeric_limits< Color3::Value >::max();
// Clear previous values, if any
col.Clear();
// Is the specified string empty?
if (str.mLen <= 0)
{
return col; // Return the value as is!
}
// The format specifications that will be used to scan the string
SQChar fs[] = _SC(" %u , %u , %u ");
// Assign the specified delimiter
fs[4] = delim;
fs[9] = delim;
// The sscanf function requires at least 32 bit integers
uint32_t r = 0, g = 0, b = 0;
// Attempt to extract the component values from the specified string
std::sscanf(str.mPtr, fs, &r, &g, &b);
// Cast the extracted integers to the value used by the Color3 type
col.r = static_cast< Color3::Value >(Clamp(r, min, max));
col.g = static_cast< Color3::Value >(Clamp(g, min, max));
col.b = static_cast< Color3::Value >(Clamp(b, min, max));
// Return the resulted value
return col;
}
/* ------------------------------------------------------------------------------------------------
* Retrieve the hex case preference of the Color3 type.
*/
static bool SqGetColor3UpperCaseHex()
{
return Color3::UpperCaseHex;
}
/* ------------------------------------------------------------------------------------------------
* Modify the hex case preference of the Color3 type.
*/
static void SqSetColor3UpperCaseHex(bool t)
{
Color3::UpperCaseHex = t;
}
// ================================================================================================
void Register_Color3(HSQUIRRELVM vm)
{
typedef Color3::Value Val;
RootTable(vm).Bind(Typename::Str,
Class< Color3 >(vm, Typename::Str)
// Constructors
.Ctor()
.Ctor< Val >()
.Ctor< Val, Val, Val >()
.Ctor< Val, Val, Val, Val >()
// Member Variables
.Var(_SC("r"), &Color3::r)
.Var(_SC("g"), &Color3::g)
.Var(_SC("b"), &Color3::b)
.Var(_SC("R"), &Color3::r)
.Var(_SC("G"), &Color3::g)
.Var(_SC("B"), &Color3::b)
// Core Meta-methods
.SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.SquirrelFunc(_SC("_typename"), &Typename::Fn)
.Func(_SC("_tostring"), &Color3::ToString)
.Func(_SC("_tojson"), &Color3::ToJSON)
// Meta-methods
.SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.SquirrelFunc(_SC("_mul"), &SqDynArgFwd< SqDynArgMulFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.SquirrelFunc(_SC("_div"), &SqDynArgFwd< SqDynArgDivFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.SquirrelFunc(_SC("_modulo"), &SqDynArgFwd< SqDynArgModFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
.Func< Color3 (Color3::*)(void) const >(_SC("_unm"), &Color3::operator -)
// Properties
.Prop(_SC("RGB"), &Color3::GetRGB, &Color3::SetRGB)
.Prop(_SC("RGBA"), &Color3::GetRGBA, &Color3::SetRGBA)
.Prop(_SC("ARGB"), &Color3::GetARGB, &Color3::SetARGB)
.Prop(_SC("Hex"), &Color3::ToHex)
.Prop(_SC("Hex4"), &Color3::ToHex4)
// Member Methods
.Func(_SC("SetScalar"), &Color3::SetScalar)
.Func(_SC("SetColor3"), &Color3::SetColor3)
.Func(_SC("SetColor3Ex"), &Color3::SetColor3Ex)
.Func(_SC("SetColor4"), &Color3::SetColor4)
.Func(_SC("SetColor4Ex"), &Color3::SetColor4Ex)
.FmtFunc(_SC("SetStr"), &Color3::SetStr)
.FmtFunc(_SC("SetName"), &Color3::SetName)
.Func(_SC("Clear"), &Color3::Clear)
.FmtFunc(_SC("Format"), &Color3::Format)
.Func(_SC("Random"), &Color3::Random)
.Func(_SC("Inverse"), &Color3::Inverse)
// Member Overloads
.Overload(_SC("Generate"), &Color3::Generate)
.Overload(_SC("Generate"), &Color3::GenerateB)
.Overload(_SC("Generate"), &Color3::GenerateR)
// Static Functions
.StaticFunc(_SC("GetDelimiter"), &SqGetDelimiter< Color3 >)
.StaticFunc(_SC("SetDelimiter"), &SqSetDelimiter< Color3 >)
.StaticFunc(_SC("GetUpperCaseHex"), &SqGetColor3UpperCaseHex)
.StaticFunc(_SC("SetUpperCaseHex"), &SqSetColor3UpperCaseHex)
.StaticFmtFunc(_SC("FromStr"), &Color3::Get)
.StaticFmtFunc(_SC("FromStrEx"), &Color3::GetEx)
);
}
} // Namespace:: SqMod