CWE-ou-minkata/MOULOpenSourceClientPlugin/Plasma20/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/>.

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 "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);
		virtual void SetBitmapAssetId(jvUniqueId& assetId, int index = 0);
		virtual void GetBitmapAssetId(jvUniqueId& assetId, int index = 0);

		// 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