/** * @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 "llerror.h" template struct LLUnit { typedef LLUnit self_t; typedef STORAGE_TYPE storage_t; // value initialization explicit 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; } void value(storage_t value) { mValue = value; } template storage_t valueInUnits() { return LLUnit(*this).value(); } template void valueInUnits(storage_t value) { *this = LLUnit(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, LLUnitImplicit second) { LLUnitImplicit result(first); result += second; return result; } template LLUnitImplicit operator + (LLUnit first, LLUnitImplicit second) { LLUnitImplicit result(first); result += second; return result; } template LLUnitImplicit operator + (LLUnitImplicit first, LLUnit second) { LLUnitImplicit result(first); result += LLUnitImplicit(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 - (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 - (LLUnit first, LLUnitImplicit second) { LLUnitImplicit result(first); result -= second; return result; } template LLUnitImplicit operator - (LLUnitImplicit first, LLUnit second) { LLUnitImplicit result(first); result -= LLUnitImplicit(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 * (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 LLUnit operator * (LLUnit first, SCALAR_TYPE second) { return LLUnit((STORAGE_TYPE)(first.value() * second)); } template LLUnit operator * (SCALAR_TYPE first, LLUnit second) { return LLUnit((STORAGE_TYPE)(first * second.value())); } 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(); } template LLUnitImplicit operator * (LLUnitImplicit first, SCALAR_TYPE second) { return LLUnitImplicit(first.value() * second); } template LLUnitImplicit operator * (SCALAR_TYPE first, LLUnitImplicit second) { return LLUnitImplicit(first * second.value()); } // // 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)); } template STORAGE_TYPE1 operator / (LLUnit first, LLUnitImplicit second) { return STORAGE_TYPE1(first.value() / first.convert(second)); } template STORAGE_TYPE1 operator / (LLUnitImplicit first, LLUnit 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(); } }; #define LL_UNIT_PROMOTE_VALUE(output_type, value) ((true ? (output_type)(1) : (value/value)) * value) template struct LLUnitLinearOps { typedef LLUnitLinearOps output_t; LLUnitLinearOps(INPUT_TYPE val) : mInput (val) {} operator OUTPUT_TYPE() const { return (OUTPUT_TYPE)mInput; } INPUT_TYPE mInput; template output_t operator * (T other) { return mInput * other; } template output_t operator / (T other) { return LL_UNIT_PROMOTE_VALUE(OUTPUT_TYPE, mInput) / other; } template output_t operator + (T other) { return mInput + other; } template output_t operator - (T other) { return mInput - other; } }; template struct LLUnitInverseLinearOps { typedef LLUnitInverseLinearOps output_t; LLUnitInverseLinearOps(INPUT_TYPE val) : mInput(val) {} operator OUTPUT_TYPE() const { return (OUTPUT_TYPE)mInput; } INPUT_TYPE mInput; template output_t operator * (T other) { return LL_UNIT_PROMOTE_VALUE(OUTPUT_TYPE, mInput) / other; } template output_t operator / (T other) { return mInput * other; } template output_t operator + (T other) { return mInput - other; } template output_t operator - (T other) { return mInput + 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"); typedef LLUnit F32Bytes; typedef LLUnit F32KiloBytes; typedef LLUnit F32MegaBytes; typedef LLUnit F32GigaBytes; typedef LLUnit F32KibiBytes; typedef LLUnit F32MibiBytes; typedef LLUnit F32GibiBytes; typedef LLUnit F64Bytes; typedef LLUnit F64KiloBytes; typedef LLUnit F64MegaBytes; typedef LLUnit F64GigaBytes; typedef LLUnit F64KibiBytes; typedef LLUnit F64MibiBytes; typedef LLUnit F64GibiBytes; typedef LLUnit S32Bytes; typedef LLUnit S32KiloBytes; typedef LLUnit S32MegaBytes; typedef LLUnit S32GigaBytes; typedef LLUnit S32KibiBytes; typedef LLUnit S32MibiBytes; typedef LLUnit S32GibiBytes; typedef LLUnit U32Bytes; typedef LLUnit U32KiloBytes; typedef LLUnit U32MegaBytes; typedef LLUnit U32GigaBytes; typedef LLUnit U32KibiBytes; typedef LLUnit U32MibiBytes; typedef LLUnit U32GibiBytes; typedef LLUnit S64Bytes; typedef LLUnit S64KiloBytes; typedef LLUnit S64MegaBytes; typedef LLUnit S64GigaBytes; typedef LLUnit S64KibiBytes; typedef LLUnit S64MibiBytes; typedef LLUnit S64GibiBytes; typedef LLUnit U64Bytes; typedef LLUnit U64KiloBytes; typedef LLUnit U64MegaBytes; typedef LLUnit U64GigaBytes; typedef LLUnit U64KibiBytes; typedef LLUnit U64MibiBytes; typedef LLUnit U64GibiBytes; 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"); typedef LLUnit F32Bits; typedef LLUnit F32KiloBits; typedef LLUnit F32MegaBits; typedef LLUnit F32GigaBits; typedef LLUnit F32KibiBits; typedef LLUnit F32MibiBits; typedef LLUnit F32GibiBits; typedef LLUnit F64Bits; typedef LLUnit F64KiloBits; typedef LLUnit F64MegaBits; typedef LLUnit F64GigaBits; typedef LLUnit F64KibiBits; typedef LLUnit F64MibiBits; typedef LLUnit F64GibiBits; typedef LLUnit S32Bits; typedef LLUnit S32KiloBits; typedef LLUnit S32MegaBits; typedef LLUnit S32GigaBits; typedef LLUnit S32KibiBits; typedef LLUnit S32MibiBits; typedef LLUnit S32GibiBits; typedef LLUnit U32Bits; typedef LLUnit U32KiloBits; typedef LLUnit U32MegaBits; typedef LLUnit U32GigaBits; typedef LLUnit U32KibiBits; typedef LLUnit U32MibiBits; typedef LLUnit U32GibiBits; typedef LLUnit S64Bits; typedef LLUnit S64KiloBits; typedef LLUnit S64MegaBits; typedef LLUnit S64GigaBits; typedef LLUnit S64KibiBits; typedef LLUnit S64MibiBits; typedef LLUnit S64GibiBits; typedef LLUnit U64Bits; typedef LLUnit U64KiloBits; typedef LLUnit U64MegaBits; typedef LLUnit U64GigaBits; typedef LLUnit U64KibiBits; typedef LLUnit U64MibiBits; typedef LLUnit U64GibiBits; 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(Hours, * 24, Days, "d"); 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"); typedef LLUnit F32Seconds; typedef LLUnit F32Minutes; typedef LLUnit F32Hours; typedef LLUnit F32Days; typedef LLUnit F32Milliseconds; typedef LLUnit F32Microseconds; typedef LLUnit F32Nanoseconds; typedef LLUnit F64Seconds; typedef LLUnit F64Minutes; typedef LLUnit F64Hours; typedef LLUnit F64Days; typedef LLUnit F64Milliseconds; typedef LLUnit F64Microseconds; typedef LLUnit F64Nanoseconds; typedef LLUnit S32Seconds; typedef LLUnit S32Minutes; typedef LLUnit S32Hours; typedef LLUnit S32Days; typedef LLUnit S32Milliseconds; typedef LLUnit S32Microseconds; typedef LLUnit S32Nanoseconds; typedef LLUnit U32Seconds; typedef LLUnit U32Minutes; typedef LLUnit U32Hours; typedef LLUnit U32Days; typedef LLUnit U32Milliseconds; typedef LLUnit U32Microseconds; typedef LLUnit U32Nanoseconds; typedef LLUnit S64Seconds; typedef LLUnit S64Minutes; typedef LLUnit S64Hours; typedef LLUnit S64Days; typedef LLUnit S64Milliseconds; typedef LLUnit S64Microseconds; typedef LLUnit S64Nanoseconds; typedef LLUnit U64Seconds; typedef LLUnit U64Minutes; typedef LLUnit U64Hours; typedef LLUnit U64Days; typedef LLUnit U64Milliseconds; typedef LLUnit U64Microseconds; typedef LLUnit U64Nanoseconds; 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"); typedef LLUnit F32Meters; typedef LLUnit F32Kilometers; typedef LLUnit F32Centimeters; typedef LLUnit F32Millimeters; typedef LLUnit F64Meters; typedef LLUnit F64Kilometers; typedef LLUnit F64Centimeters; typedef LLUnit F64Millimeters; typedef LLUnit S32Meters; typedef LLUnit S32Kilometers; typedef LLUnit S32Centimeters; typedef LLUnit S32Millimeters; typedef LLUnit U32Meters; typedef LLUnit U32Kilometers; typedef LLUnit U32Centimeters; typedef LLUnit U32Millimeters; typedef LLUnit S64Meters; typedef LLUnit S64Kilometers; typedef LLUnit S64Centimeters; typedef LLUnit S64Millimeters; typedef LLUnit U64Meters; typedef LLUnit U64Kilometers; typedef LLUnit U64Centimeters; typedef LLUnit U64Millimeters; // rare units 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