CWE-ou-minkata/Sources/Tools/MaxPlasmaMtls/Layers/plPlasmaMAXLayer.h

/*==LICENSE==*

CyanWorlds.com Engine - MMOG client, server and tools
Copyright (C) 2011  Cyan Worlds, Inc.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program 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 General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Additional permissions under GNU GPL version 3 section 7

If you modify this Program, or any covered work, by linking or
combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK,
NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent
JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK
(or a modified version of those libraries),
containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA,
PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG
JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the
licensors of this Program grant you additional
permission to convey the resulting work. Corresponding Source for a
non-source form of such a combination shall include the source code for
the parts of OpenSSL and IJG JPEG Library used as well as that of the covered
work.

You can contact Cyan Worlds, Inc. by email legal@cyan.com
 or by snail mail at:
      Cyan Worlds, Inc.
      14617 N Newport Hwy
      Mead, WA   99021

*==LICENSE==*/
///////////////////////////////////////////////////////////////////////////////
//                                                                           //
//  plPlasmaMAXLayer - MAX Layer type that is the basis for all Plasma layer //
//                     types                                                 //
//  Cyan, Inc.                                                               //
//                                                                           //
//// Version History //////////////////////////////////////////////////////////
//                                                                           //
//  1.13.2002 mcn - Created.                                                 //
//                                                                           //
//// Notes from the Author ////////////////////////////////////////////////////
//                                                                           //
//  This base class is actually a quite-recent addition. As a result, most   //
//  of the old, non-base-class-structured code is still lying around. This   //
//  code will be slowly converted over as time goes on; the theory was that  //
//  this conversion would be far more likely to occur if the base class      //
//  actually already existed.                                                //
//                                                                           //
///////////////////////////////////////////////////////////////////////////////

#ifndef _plPlasmaMAXLayer_h
#define _plPlasmaMAXLayer_h

#include "Max.h"
#include "iparamm2.h"
#include "hsTypes.h"

//// Derived Type Class IDs ///////////////////////////////////////////////////
//  If you create a new Plasma layer type, add a define for the class ID here 
//  and also add the ID to the list in plPlasmaMAXLayer.cpp.

const Class_ID LAYER_TEX_CLASS_ID( 0x4223c620, 0x183c4868 );
const Class_ID STATIC_ENV_LAYER_CLASS_ID( 0x379a0a20, 0x3d0b1244 );
const Class_ID DYNAMIC_ENV_LAYER_CLASS_ID( 0x18205c0f, 0x57ea0e10 );
const Class_ID DYN_TEXT_LAYER_CLASS_ID( 0x36e3480f, 0x120120bd );
const Class_ID ANGLE_ATTEN_LAYER_CLASS_ID( 0x6d90918, 0x6160114 );
const Class_ID MAX_CAMERA_LAYER_CLASS_ID( 0xfaf5ec7, 0x13d90d3f );

//// Class Definition /////////////////////////////////////////////////////////

class plLayerInterface;
class plMaxNode;
class plErrorMsg;
class plLayer;
class plDynamicTextMap;
class plBitmapData;
class plLocation;
class plLayerConverter;
class plLayerInterface;
class plBMSamplerData;
class jvUniqueId;
class plLayerTargetContainer;
class plPlasmaMAXLayer : public Texmap
{
    friend class plLayerConverter;

    protected:

        static const Class_ID   fDerivedTypes[];

        plLayerTargetContainer  *fConversionTargets;


        void    IAddConversionTarget( plLayerInterface *target );
        void    IClearConversionTargets( void );

    public:

        plPlasmaMAXLayer();
        virtual ~plPlasmaMAXLayer();

        void    DeleteThis() { delete this; }       


        // Static that checks the classID of the given texMap and, if it's a valid Plasma MAX Layer, returns a pointer to such
        static plPlasmaMAXLayer     *GetPlasmaMAXLayer( Texmap *map );

        // Some layers must be unique for each node they're applied to (i.e. can't be shared among nodes).
        // This returns true if the layer must be unique.
        virtual bool MustBeUnique( void ) { return false; }

        // These let the material make an informed decision on what to do with
        // the color and alpha values coming out of an EvalColor call. Something
        // like an InvertColor can be handled within EvalColor, but there needs
        // to be a way to tell the caller that the color returned should be completely
        // ignored.
        virtual BOOL    DiscardColor() { return false; }
        virtual BOOL    DiscardAlpha() { return false; }


        // Return the number of conversion targets (only valid after the MakeMesh pass)
        int     GetNumConversionTargets( void );

        // Get an indexed conversion target
        plLayerInterface    *GetConversionTarget( int index );
        
        virtual BOOL HandleBitmapSelection(int index = 0);
        virtual void SetBitmap(BitmapInfo *bi, int index = 0);
#ifdef MAXASS_AVAILABLE
        virtual void SetBitmapAssetId(jvUniqueId& assetId, int index = 0);
        virtual void GetBitmapAssetId(jvUniqueId& assetId, int index = 0);
#endif

        // Pure virtual accessors for the various bitmap related elements
        virtual Bitmap *GetMaxBitmap(int index = 0) = 0;
        virtual PBBitmap *GetPBBitmap( int index = 0 ) = 0;
        virtual int     GetNumBitmaps( void ) = 0;

        // Makes sure the textures are the latest versions (including getting
        // the latest version from AssetMan)
        void RefreshBitmaps();

        hsBool  GetBitmapFileName( char *destFilename, int maxLength, int index = 0 );

        // Virtual function called by plBMSampler to get various things while sampling the layer's image
        virtual bool    GetSamplerInfo( plBMSamplerData *samplerData ) { return false; }

        // Backdoor for the texture find and replace util.  Assumes input has the correct aspect ratio and is power of 2.
        virtual void SetExportSize(int x, int y) {}
        
    protected:
        virtual void ISetMaxBitmap(Bitmap *bitmap, int index = 0) = 0;
        virtual void ISetPBBitmap( PBBitmap *pbbm, int index = 0 ) = 0;

};

#endif // _plPlasmaMAXLayer_h