/**
 * @file lldriverparam.h
 * @brief A visual parameter that drives (controls) other visual parameters.
 *
 * $LicenseInfo:firstyear=2002&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2010, 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_LLDRIVERPARAM_H
#define LL_LLDRIVERPARAM_H

#include "llviewervisualparam.h"
#include "llwearabletype.h"
#include <deque>

class LLAvatarAppearance;
class LLDriverParam;
class LLWearable;

//-----------------------------------------------------------------------------

struct LLDrivenEntryInfo
{
    LLDrivenEntryInfo( S32 id, F32 min1, F32 max1, F32 max2, F32 min2 )
        : mDrivenID( id ), mMin1( min1 ), mMax1( max1 ), mMax2( max2 ), mMin2( min2 ) {}
    S32                 mDrivenID;
    F32                 mMin1;
    F32                 mMax1;
    F32                 mMax2;
    F32                 mMin2;
};

struct LLDrivenEntry
{
    LLDrivenEntry( LLViewerVisualParam* param, LLDrivenEntryInfo *info )
        : mParam( param ), mInfo( info ) {}
    LLViewerVisualParam* mParam;
    LLDrivenEntryInfo*   mInfo;
};

//-----------------------------------------------------------------------------

class LLDriverParamInfo : public LLViewerVisualParamInfo
{
    friend class LLDriverParam;
public:
    LLDriverParamInfo();
    /*virtual*/ ~LLDriverParamInfo() {};

    /*virtual*/ BOOL parseXml(LLXmlTreeNode* node);

    /*virtual*/ void toStream(std::ostream &out);

protected:
    typedef std::deque<LLDrivenEntryInfo> entry_info_list_t;
    entry_info_list_t mDrivenInfoList;
    LLDriverParam* mDriverParam; // backpointer
};

//-----------------------------------------------------------------------------

class alignas(16) LLDriverParam : public LLViewerVisualParam
{
    LL_ALIGN_NEW
private:
    // Hide the default constructor.  Force construction with LLAvatarAppearance.
    LLDriverParam() {}
public:
    LLDriverParam(LLAvatarAppearance* appearance, LLWearable* wearable = NULL);
    ~LLDriverParam();

    // Special: These functions are overridden by child classes
    LLDriverParamInfo* getInfo() const { return (LLDriverParamInfo*)mInfo; }
    //   This sets mInfo and calls initialization functions
    BOOL                    setInfo(LLDriverParamInfo* info);

    LLAvatarAppearance* getAvatarAppearance() { return mAvatarAppearance; }
    const LLAvatarAppearance* getAvatarAppearance() const { return mAvatarAppearance; }

    void                    updateCrossDrivenParams(LLWearableType::EType driven_type);

    /*virtual*/ LLViewerVisualParam* cloneParam(LLWearable* wearable) const;

    // LLVisualParam Virtual functions
    /*virtual*/ void                apply(ESex sex) {} // apply is called separately for each driven param.
    /*virtual*/ void                setWeight(F32 weight);
    /*virtual*/ void                setAnimationTarget(F32 target_value);
    /*virtual*/ void                stopAnimating();
    /*virtual*/ BOOL                linkDrivenParams(visual_param_mapper mapper, BOOL only_cross_params);
    /*virtual*/ void                resetDrivenParams();

    // LLViewerVisualParam Virtual functions
    /*virtual*/ F32                 getTotalDistortion();
    /*virtual*/ const LLVector4a& getAvgDistortion();
    /*virtual*/ F32                 getMaxDistortion();
    /*virtual*/ LLVector4a          getVertexDistortion(S32 index, LLPolyMesh* poly_mesh);
    /*virtual*/ const LLVector4a* getFirstDistortion(U32* index, LLPolyMesh** poly_mesh);
    /*virtual*/ const LLVector4a* getNextDistortion(U32* index, LLPolyMesh** poly_mesh);

    S32                             getDrivenParamsCount() const;
    const LLViewerVisualParam* getDrivenParam(S32 index) const;

    typedef std::vector<LLDrivenEntry> entry_list_t;
    entry_list_t& getDrivenList() { return mDriven; }
    void                            setDrivenList(entry_list_t& driven_list) { mDriven = driven_list; }

protected:
    LLDriverParam(const LLDriverParam& pOther);
    F32 getDrivenWeight(const LLDrivenEntry* driven, F32 input_weight);
    void setDrivenWeight(LLDrivenEntry* driven, F32 driven_weight);


    LL_ALIGN_16(LLVector4a  mDefaultVec); // temp holder
    entry_list_t mDriven;
    LLViewerVisualParam* mCurrentDistortionParam;
    // Backlink only; don't make this an LLPointer.
    LLAvatarAppearance* mAvatarAppearance;
    LLWearable* mWearablep;
};

#endif  // LL_LLDRIVERPARAM_H