/** * @file llunit.h * @brief Unit conversion classes * * $LicenseInfo:firstyear=2001&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2012, Linden Research, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; * version 2.1 of the License only. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * * Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA * $/LicenseInfo$ */ #ifndef LL_LLUNIT_H #define LL_LLUNIT_H #include "stdtypes.h" #include "llpreprocessor.h" #include "llerrorlegacy.h" template struct LLUnit { typedef LLUnit self_t; typedef STORAGE_TYPE storage_t; // value initialization LLUnit(storage_t value = storage_t()) : mValue(value) {} // unit initialization and conversion template LLUnit(LLUnit other) : mValue(convert(other).mValue) {} bool operator == (const self_t& other) { return mValue = other.mValue; } // value assignment self_t& operator = (storage_t value) { mValue = value; return *this; } // unit assignment template self_t& operator = (LLUnit other) { mValue = convert(other).mValue; return *this; } storage_t value() const { return mValue; } template STORAGE_TYPE valueAs() { return LLUnit(*this).value(); } void operator += (storage_t value) { mValue += value; } template void operator += (LLUnit other) { mValue += convert(other).mValue; } void operator -= (storage_t value) { mValue -= value; } template void operator -= (LLUnit other) { mValue -= convert(other).mValue; } void operator *= (storage_t multiplicand) { mValue *= multiplicand; } template void operator *= (LLUnit multiplicand) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template LL_BAD_TEMPLATE_INSTANTIATION(OTHER_UNIT, "Multiplication of unit types not supported."); } void operator /= (storage_t divisor) { mValue /= divisor; } template void operator /= (LLUnit divisor) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template LL_BAD_TEMPLATE_INSTANTIATION(OTHER_UNIT, "Illegal in-place division of unit types."); } template static self_t convert(LLUnit v) { self_t result; ll_convert_units(v, result); return result; } protected: storage_t mValue; }; template std::ostream& operator <<(std::ostream& s, const LLUnit& unit) { s << unit.value() << UNIT_TYPE::getUnitLabel(); return s; } template std::istream& operator >>(std::istream& s, LLUnit& unit) { STORAGE_TYPE val; s >> val; unit = val; return s; } template struct LLUnitImplicit : public LLUnit { typedef LLUnitImplicit self_t; typedef typename LLUnit::storage_t storage_t; typedef LLUnit base_t; LLUnitImplicit(storage_t value = storage_t()) : base_t(value) {} template LLUnitImplicit(LLUnit other) : base_t(convert(other)) {} // unlike LLUnit, LLUnitImplicit is *implicitly* convertable to a POD scalar (F32, S32, etc) // this allows for interoperability with legacy code operator storage_t() const { return base_t::value(); } }; template std::ostream& operator <<(std::ostream& s, const LLUnitImplicit& unit) { s << unit.value() << UNIT_TYPE::getUnitLabel(); return s; } template std::istream& operator >>(std::istream& s, LLUnitImplicit& unit) { STORAGE_TYPE val; s >> val; unit = val; return s; } template struct LLIsSameType { static const bool value = false; }; template struct LLIsSameType { static const bool value = true; }; template LL_FORCE_INLINE void ll_convert_units(LLUnit in, LLUnit& out, ...) { LL_STATIC_ASSERT((LLIsSameType::value || !LLIsSameType::value || !LLIsSameType::value), "invalid conversion"); if (LLIsSameType::value) { if (LLIsSameType::value) { // T1 and T2 fully reduced and equal...just copy out = LLUnit((S2)in.value()); } else { // reduce T2 LLUnit new_out; ll_convert_units(in, new_out); ll_convert_units(new_out, out); } } else { // reduce T1 LLUnit new_in; ll_convert_units(in, new_in); ll_convert_units(new_in, out); } } // // operator + // template LLUnit operator + (LLUnit first, LLUnit second) { LLUnit result(first); result += second; return result; } template LLUnit operator + (LLUnit first, SCALAR_TYPE second) { LLUnit result(first); result += second; return result; } template LLUnit operator + (SCALAR_TYPE first, LLUnit second) { LLUnit result(first); result += second; return result; } template LLUnitImplicit operator + (LLUnitImplicit first, LLUnit second) { LLUnitImplicit result(first); result += second; return result; } template LLUnitImplicit operator + (LLUnitImplicit first, SCALAR_TYPE second) { LLUnitImplicit result(first); result += second; return result; } template LLUnitImplicit operator + (LLUnitImplicit first, LLUnitImplicit second) { LLUnitImplicit result(first); result += second; return result; } // // operator - // template LLUnit operator - (LLUnit first, LLUnit second) { LLUnit result(first); result -= second; return result; } template LLUnit operator - (LLUnit first, SCALAR_TYPE second) { LLUnit result(first); result -= second; return result; } template LLUnit operator - (SCALAR_TYPE first, LLUnit second) { LLUnit result(first); result -= second; return result; } template LLUnitImplicit operator - (LLUnitImplicit first, LLUnitImplicit second) { LLUnitImplicit result(first); result -= second; return result; } template LLUnitImplicit operator - (LLUnitImplicit first, SCALAR_TYPE second) { LLUnitImplicit result(first); result -= second; return result; } template LLUnitImplicit operator - (SCALAR_TYPE first, LLUnitImplicit second) { LLUnitImplicit result(first); result -= second; return result; } // // operator * // template LLUnit operator * (SCALAR_TYPE first, LLUnit second) { return LLUnit((STORAGE_TYPE)(first * second.value())); } template LLUnit operator * (LLUnit first, SCALAR_TYPE second) { return LLUnit((STORAGE_TYPE)(first.value() * second)); } template LLUnit operator * (LLUnit, LLUnit) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template LL_BAD_TEMPLATE_INSTANTIATION(STORAGE_TYPE1, "Multiplication of unit types results in new unit type - not supported."); return LLUnit(); } template LLUnitImplicit operator * (SCALAR_TYPE first, LLUnitImplicit second) { return LLUnitImplicit(first * second.value()); } template LLUnitImplicit operator * (LLUnitImplicit first, SCALAR_TYPE second) { return LLUnitImplicit(first.value() * second); } template LLUnitImplicit operator * (LLUnitImplicit, LLUnitImplicit) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template LL_BAD_TEMPLATE_INSTANTIATION(STORAGE_TYPE1, "Multiplication of unit types results in new unit type - not supported."); return LLUnitImplicit(); } // // operator / // template SCALAR_TYPE operator / (SCALAR_TYPE first, LLUnit second) { return SCALAR_TYPE(first / second.value()); } template LLUnit operator / (LLUnit first, SCALAR_TYPE second) { return LLUnit((STORAGE_TYPE)(first.value() / second)); } template STORAGE_TYPE1 operator / (LLUnit first, LLUnit second) { return STORAGE_TYPE1(first.value() / first.convert(second)); } template LLUnitImplicit operator / (LLUnitImplicit first, SCALAR_TYPE second) { return LLUnitImplicit((STORAGE_TYPE)(first.value() / second)); } template STORAGE_TYPE1 operator / (LLUnitImplicit first, LLUnitImplicit second) { return STORAGE_TYPE1(first.value() / first.convert(second)); } #define COMPARISON_OPERATORS(op) \ template \ bool operator op (SCALAR_TYPE first, LLUnit second) \ { \ return first op second.value(); \ } \ \ template \ bool operator op (LLUnit first, SCALAR_TYPE second) \ { \ return first.value() op second; \ } \ \ template \ bool operator op (LLUnitImplicit first, LLUnitImplicit second) \ { \ return first.value() op first.convert(second); \ } \ \ template \ bool operator op (LLUnit first, LLUnit second) \ { \ return first.value() op first.convert(second); \ } COMPARISON_OPERATORS(<) COMPARISON_OPERATORS(<=) COMPARISON_OPERATORS(>) COMPARISON_OPERATORS(>=) COMPARISON_OPERATORS(==) COMPARISON_OPERATORS(!=) template struct LLGetUnitLabel { static const char* getUnitLabel() { return ""; } }; template struct LLGetUnitLabel > { static const char* getUnitLabel() { return T::getUnitLabel(); } }; template struct LLUnitLinearOps { typedef LLUnitLinearOps self_t; LLUnitLinearOps(VALUE_TYPE val) : mResult (val) {} operator VALUE_TYPE() const { return mResult; } VALUE_TYPE mResult; template self_t operator * (T other) { return mResult * other; } template self_t operator / (T other) { return mResult / other; } template self_t operator + (T other) { return mResult + other; } template self_t operator - (T other) { return mResult - other; } }; template struct LLUnitInverseLinearOps { typedef LLUnitInverseLinearOps self_t; LLUnitInverseLinearOps(VALUE_TYPE val) : mResult (val) {} operator VALUE_TYPE() const { return mResult; } VALUE_TYPE mResult; template self_t operator * (T other) { return mResult / other; } template self_t operator / (T other) { return mResult * other; } template self_t operator + (T other) { return mResult - other; } template self_t operator - (T other) { return mResult + other; } }; #define LL_DECLARE_BASE_UNIT(base_unit_name, unit_label) \ struct base_unit_name \ { \ typedef base_unit_name base_unit_t; \ static const char* getUnitLabel() { return unit_label; } \ template \ static LLUnit fromValue(T value) { return LLUnit(value); } \ template \ static LLUnit fromValue(LLUnit value) \ { return LLUnit(value); } \ } #define LL_DECLARE_DERIVED_UNIT(base_unit_name, conversion_operation, unit_name, unit_label) \ struct unit_name \ { \ typedef base_unit_name base_unit_t; \ static const char* getUnitLabel() { return unit_label; } \ template \ static LLUnit fromValue(T value) { return LLUnit(value); } \ template \ static LLUnit fromValue(LLUnit value) \ { return LLUnit(value); } \ }; \ \ template \ void ll_convert_units(LLUnit in, LLUnit& out) \ { \ out = LLUnit((S2)(LLUnitLinearOps(in.value()) conversion_operation)); \ } \ \ template \ void ll_convert_units(LLUnit in, LLUnit& out) \ { \ out = LLUnit((S2)(LLUnitInverseLinearOps(in.value()) conversion_operation)); \ } // // Unit declarations // namespace LLUnits { LL_DECLARE_BASE_UNIT(Bytes, "B"); LL_DECLARE_DERIVED_UNIT(Bytes, * 1000, Kilobytes, "KB"); LL_DECLARE_DERIVED_UNIT(Kilobytes, * 1000, Megabytes, "MB"); LL_DECLARE_DERIVED_UNIT(Megabytes, * 1000, Gigabytes, "GB"); LL_DECLARE_DERIVED_UNIT(Bytes, * 1024, Kibibytes, "KiB"); LL_DECLARE_DERIVED_UNIT(Kibibytes, * 1024, Mibibytes, "MiB"); LL_DECLARE_DERIVED_UNIT(Mibibytes, * 1024, Gibibytes, "GiB"); LL_DECLARE_DERIVED_UNIT(Bytes, / 8, Bits, "b"); LL_DECLARE_DERIVED_UNIT(Bits, * 1000, Kilobits, "Kb"); LL_DECLARE_DERIVED_UNIT(Kilobits, * 1000, Megabits, "Mb"); LL_DECLARE_DERIVED_UNIT(Megabits, * 1000, Gigabits, "Gb"); LL_DECLARE_DERIVED_UNIT(Bits, * 1024, Kibibits, "Kib"); LL_DECLARE_DERIVED_UNIT(Kibibits, * 1024, Mibibits, "Mib"); LL_DECLARE_DERIVED_UNIT(Mibibits, * 1024, Gibibits, "Gib"); LL_DECLARE_BASE_UNIT(Seconds, "s"); LL_DECLARE_DERIVED_UNIT(Seconds, * 60, Minutes, "min"); LL_DECLARE_DERIVED_UNIT(Minutes, * 60, Hours, "h"); LL_DECLARE_DERIVED_UNIT(Seconds, / 1000, Milliseconds, "ms"); LL_DECLARE_DERIVED_UNIT(Milliseconds, / 1000, Microseconds, "\x09\x3cs"); LL_DECLARE_DERIVED_UNIT(Microseconds, / 1000, Nanoseconds, "ns"); LL_DECLARE_BASE_UNIT(Meters, "m"); LL_DECLARE_DERIVED_UNIT(Meters, * 1000, Kilometers, "km"); LL_DECLARE_DERIVED_UNIT(Meters, / 100, Centimeters, "cm"); LL_DECLARE_DERIVED_UNIT(Meters, / 1000, Millimeters, "mm"); LL_DECLARE_BASE_UNIT(Hertz, "Hz"); LL_DECLARE_DERIVED_UNIT(Hertz, * 1000, Kilohertz, "KHz"); LL_DECLARE_DERIVED_UNIT(Kilohertz, * 1000, Megahertz, "MHz"); LL_DECLARE_DERIVED_UNIT(Megahertz, * 1000, Gigahertz, "GHz"); LL_DECLARE_BASE_UNIT(Radians, "rad"); LL_DECLARE_DERIVED_UNIT(Radians, / 57.29578f, Degrees, "deg"); LL_DECLARE_BASE_UNIT(Percent, "%"); LL_DECLARE_DERIVED_UNIT(Percent, * 100, Ratio, "x"); LL_DECLARE_BASE_UNIT(Triangles, "tris"); LL_DECLARE_DERIVED_UNIT(Triangles, * 1000, Kilotriangles, "ktris"); } // namespace LLUnits #endif // LL_LLUNIT_H