/** * @file llsettingsbase.cpp * @author optional * @brief A base class for asset based settings groups. * * $LicenseInfo:2011&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2017, 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$ */ #include "llsettingsbase.h" #include "llmath.h" #include #include "llsdserialize.h" //========================================================================= namespace { const F64 BREAK_POINT = 0.5; } //========================================================================= std::ostream &operator <<(std::ostream& os, LLSettingsBase &settings) { LLSDSerialize::serialize(settings.getSettings(), os, LLSDSerialize::LLSD_NOTATION); return os; } //========================================================================= const std::string LLSettingsBase::SETTING_ID("id"); const std::string LLSettingsBase::SETTING_NAME("name"); const std::string LLSettingsBase::SETTING_HASH("hash"); const std::string LLSettingsBase::SETTING_TYPE("type"); //========================================================================= LLSettingsBase::LLSettingsBase(): mSettings(LLSD::emptyMap()), mDirty(true), mAssetID(), mBlendedFactor(0.0) { } LLSettingsBase::LLSettingsBase(const LLSD setting) : mSettings(setting), mDirty(true), mAssetID(), mBlendedFactor(0.0) { } //========================================================================= void LLSettingsBase::lerpSettings(const LLSettingsBase &other, F64 mix) { mSettings = interpolateSDMap(mSettings, other.mSettings, mix); setDirtyFlag(true); } LLSD LLSettingsBase::combineSDMaps(const LLSD &settings, const LLSD &other) const { LLSD newSettings; for (LLSD::map_const_iterator it = settings.beginMap(); it != settings.endMap(); ++it) { std::string key_name = (*it).first; LLSD value = (*it).second; LLSD::Type setting_type = value.type(); switch (setting_type) { case LLSD::TypeMap: newSettings[key_name] = combineSDMaps(value, LLSD()); break; case LLSD::TypeArray: newSettings[key_name] = LLSD::emptyArray(); for (LLSD::array_const_iterator ita = value.beginArray(); ita != value.endArray(); ++ita) { newSettings[key_name].append(*ita); } break; //case LLSD::TypeInteger: //case LLSD::TypeReal: //case LLSD::TypeBoolean: //case LLSD::TypeString: //case LLSD::TypeUUID: //case LLSD::TypeURI: //case LLSD::TypeDate: //case LLSD::TypeBinary: default: newSettings[key_name] = value; break; } } if (!other.isUndefined()) { for (LLSD::map_const_iterator it = other.beginMap(); it != other.endMap(); ++it) { std::string key_name = (*it).first; LLSD value = (*it).second; LLSD::Type setting_type = value.type(); switch (setting_type) { case LLSD::TypeMap: newSettings[key_name] = combineSDMaps(value, LLSD()); break; case LLSD::TypeArray: newSettings[key_name] = LLSD::emptyArray(); for (LLSD::array_const_iterator ita = value.beginArray(); ita != value.endArray(); ++ita) { newSettings[key_name].append(*ita); } break; //case LLSD::TypeInteger: //case LLSD::TypeReal: //case LLSD::TypeBoolean: //case LLSD::TypeString: //case LLSD::TypeUUID: //case LLSD::TypeURI: //case LLSD::TypeDate: //case LLSD::TypeBinary: default: newSettings[key_name] = value; break; } } } return newSettings; } LLSD LLSettingsBase::interpolateSDMap(const LLSD &settings, const LLSD &other, F64 mix) const { LLSD newSettings; stringset_t skip = getSkipInterpolateKeys(); stringset_t slerps = getSlerpKeys(); for (LLSD::map_const_iterator it = settings.beginMap(); it != settings.endMap(); ++it) { std::string key_name = (*it).first; LLSD value = (*it).second; if (skip.find(key_name) != skip.end()) continue; if (!other.has(key_name)) { // The other does not contain this setting, keep the original value // TODO: Should I blend this out instead? newSettings[key_name] = value; continue; } LLSD::Type setting_type = value.type(); LLSD other_value = other[key_name]; if (other_value.type() != setting_type) { // The data type mismatched between this and other. Hard switch when we pass the break point // but issue a warning. LL_WARNS("SETTINGS") << "Setting lerp between mismatched types for '" << key_name << "'." << LL_ENDL; newSettings[key_name] = (mix > BREAK_POINT) ? other_value : value; continue; } switch (setting_type) { case LLSD::TypeInteger: // lerp between the two values rounding the result to the nearest integer. newSettings[key_name] = LLSD::Integer(llroundf(lerp(value.asReal(), other_value.asReal(), mix))); break; case LLSD::TypeReal: // lerp between the two values. newSettings[key_name] = LLSD::Real(lerp(value.asReal(), other_value.asReal(), mix)); break; case LLSD::TypeMap: // deep copy. newSettings[key_name] = interpolateSDMap(value, other_value, mix); break; case LLSD::TypeArray: { LLSD newvalue(LLSD::emptyArray()); if (slerps.find(key_name) != slerps.end()) { LLQuaternion q = slerp(mix, LLQuaternion(value), LLQuaternion(other_value)); newvalue = q.getValue(); } else { // TODO: We could expand this to inspect the type and do a deep lerp based on type. // for now assume a heterogeneous array of reals. size_t len = std::max(value.size(), other_value.size()); for (size_t i = 0; i < len; ++i) { newvalue[i] = lerp(value[i].asReal(), other_value[i].asReal(), mix); } } newSettings[key_name] = newvalue; } break; case LLSD::TypeUUID: newSettings[key_name] = value.asUUID(); break; // case LLSD::TypeBoolean: // case LLSD::TypeString: // case LLSD::TypeURI: // case LLSD::TypeBinary: // case LLSD::TypeDate: default: /* TODO: If the UUID points to an image ID, blend the images. */ // atomic or unknown data types. Lerping between them does not make sense so switch at the break. newSettings[key_name] = (mix > BREAK_POINT) ? other_value : value; break; } } // Now add anything that is in other but not in the settings for (LLSD::map_const_iterator it = other.beginMap(); it != other.endMap(); ++it) { // TODO: Should I blend this in instead? if (skip.find((*it).first) == skip.end()) continue; if (!settings.has((*it).first)) continue; newSettings[(*it).first] = (*it).second; } return newSettings; } LLSD LLSettingsBase::getSettings() const { return mSettings; } LLSD LLSettingsBase::cloneSettings() const { return combineSDMaps(getSettings(), LLSD()); } size_t LLSettingsBase::getHash() const { // get a shallow copy of the LLSD filtering out values to not include in the hash LLSD hash_settings = llsd_shallow(getSettings(), LLSDMap(SETTING_NAME, false)(SETTING_ID, false)(SETTING_HASH, false)("*", true)); return boost::hash{}(hash_settings); } bool LLSettingsBase::validate() { validation_list_t validations = getValidationList(); if (!mSettings.has(SETTING_TYPE)) { mSettings[SETTING_TYPE] = getSettingType(); } LLSD result = LLSettingsBase::settingValidation(mSettings, validations); if (result["errors"].size() > 0) { LL_WARNS("SETTINGS") << "Validation errors: " << result["errors"] << LL_ENDL; } if (result["warnings"].size() > 0) { LL_WARNS("SETTINGS") << "Validation warnings: " << result["errors"] << LL_ENDL; } return result["success"].asBoolean(); } LLSD LLSettingsBase::settingValidation(LLSD &settings, validation_list_t &validations) { static Validator validateName(SETTING_NAME, false, LLSD::TypeString); static Validator validateId(SETTING_ID, false, LLSD::TypeUUID); static Validator validateHash(SETTING_HASH, false, LLSD::TypeInteger); static Validator validateType(SETTING_TYPE, false, LLSD::TypeString); stringset_t validated; stringset_t strip; bool isValid(true); LLSD errors(LLSD::emptyArray()); LLSD warnings(LLSD::emptyArray()); // Fields common to all settings. if (!validateName.verify(settings)) { errors.append( LLSD::String("Unable to validate 'name'.") ); isValid = false; } validated.insert(validateName.getName()); if (!validateId.verify(settings)) { errors.append( LLSD::String("Unable to validate 'id'.") ); isValid = false; } validated.insert(validateId.getName()); if (!validateHash.verify(settings)) { errors.append( LLSD::String("Unable to validate 'hash'.") ); isValid = false; } validated.insert(validateHash.getName()); if (!validateType.verify(settings)) { errors.append( LLSD::String("Unable to validate 'type'.") ); isValid = false; } validated.insert(validateType.getName()); // Fields for specific settings. for (auto &test: validations) { if (!test.verify(settings)) { std::stringstream errtext; errtext << "Settings LLSD fails validation and could not be corrected for '" << test.getName() << "'!\n"; errors.append( errtext.str() ); isValid = false; } validated.insert(test.getName()); } // strip extra entries for (LLSD::map_const_iterator itm = settings.beginMap(); itm != settings.endMap(); ++itm) { if (validated.find((*itm).first) == validated.end()) { std::stringstream warntext; warntext << "Stripping setting '" << (*itm).first << "'"; warnings.append( warntext.str() ); strip.insert((*itm).first); } } for (const std::string &its: strip) { settings.erase(its); } return LLSDMap("success", LLSD::Boolean(isValid)) ("errors", errors) ("warnings", warnings); } //========================================================================= bool LLSettingsBase::Validator::verify(LLSD &data) { if (!data.has(mName) || (data.has(mName) && data[mName].isUndefined())) { if (!mDefault.isUndefined()) { LL_INFOS("SETTINGS") << "Inserting missing default for '" << mName << "'." << LL_ENDL; data[mName] = mDefault; return true; } if (mRequired) LL_WARNS("SETTINGS") << "Missing required setting '" << mName << "' with no default." << LL_ENDL; return !mRequired; } if (data[mName].type() != mType) { LL_WARNS("SETTINGS") << "Setting '" << mName << "' is incorrect type." << LL_ENDL; return false; } if (!mVerify.empty() && !mVerify(data[mName])) { LL_WARNS("SETTINGS") << "Setting '" << mName << "' fails validation." << LL_ENDL; return false; } return true; } bool LLSettingsBase::Validator::verifyColor(LLSD &value) { return (value.size() == 3 || value.size() == 4); } bool LLSettingsBase::Validator::verifyVector(LLSD &value, S32 length) { return (value.size() == length); } bool LLSettingsBase::Validator::verifyVectorNormalized(LLSD &value, S32 length) { if (value.size() != length) return false; LLSD newvector; switch (length) { case 2: { LLVector2 vect(value); if (is_approx_equal(vect.normalize(), 1.0f)) return true; newvector = vect.getValue(); break; } case 3: { LLVector3 vect(value); if (is_approx_equal(vect.normalize(), 1.0f)) return true; newvector = vect.getValue(); break; } case 4: { LLVector4 vect(value); if (is_approx_equal(vect.normalize(), 1.0f)) return true; newvector = vect.getValue(); break; } default: return false; } return true; } bool LLSettingsBase::Validator::verifyVectorMinMax(LLSD &value, LLSD minvals, LLSD maxvals) { for (S32 index = 0; index < value.size(); ++index) { if (minvals[index].asString() != "*") { if (minvals[index].asReal() > value[index].asReal()) { value[index] = minvals[index].asReal(); } } if (maxvals[index].asString() != "*") { if (maxvals[index].asReal() < value[index].asReal()) { value[index] = maxvals[index].asReal(); } } } return true; } bool LLSettingsBase::Validator::verifyQuaternion(LLSD &value) { return (value.size() == 4); } bool LLSettingsBase::Validator::verifyQuaternionNormal(LLSD &value) { if (value.size() != 4) return false; LLQuaternion quat(value); if (is_approx_equal(quat.normalize(), 1.0f)) return true; LLSD newquat = quat.getValue(); for (S32 index = 0; index < 4; ++index) { value[index] = newquat[index]; } return true; } bool LLSettingsBase::Validator::verifyFloatRange(LLSD &value, LLSD range) { F64 real = value.asReal(); F64 clampedval = llclamp(LLSD::Real(real), range[0].asReal(), range[1].asReal()); if (is_approx_equal(clampedval, real)) return true; value = LLSD::Real(clampedval); return true; } bool LLSettingsBase::Validator::verifyIntegerRange(LLSD &value, LLSD range) { S32 ival = value.asInteger(); S32 clampedval = llclamp(LLSD::Integer(ival), range[0].asInteger(), range[1].asInteger()); if (clampedval == ival) return true; value = LLSD::Integer(clampedval); return true; } //========================================================================= void LLSettingsBlender::update(F64 blendf) { setPosition(blendf); } F64 LLSettingsBlender::setPosition(F64 blendf) { if (blendf >= 1.0) { triggerComplete(); return 1.0; } blendf = llclamp(blendf, 0.0, 1.0); //_WARNS("LAPRAS") << "blending at " << (blendf * 100.0f) << "%" << LL_ENDL; mTarget->replaceSettings(mInitial->getSettings()); mTarget->blend(mFinal, blendf); return blendf; } void LLSettingsBlender::triggerComplete() { mTarget->replaceSettings(mFinal->getSettings()); LLSettingsBlender::ptr_t hold = shared_from_this(); // prevents this from deleting too soon mOnFinished(shared_from_this()); } //------------------------------------------------------------------------- void LLSettingsBlenderTimeDelta::update(F64 timedelta) { mTimeSpent += F64Seconds(timedelta); if (mTimeSpent > mBlendSpan) { triggerComplete(); return; } F64 blendf = fmod(mTimeSpent.value(), mBlendSpan.value()) / mBlendSpan.value(); // Note no clamp here. setPosition(blendf); }