CWE-ou-minkata/MOULOpenSourceClientPlugin/Plasma20/Sources/Tools/MaxComponent/plDistribComponent.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==*/

#ifndef plDistribComponent_inc
#define plDistribComponent_inc

const Class_ID DISTRIBUTOR_COMP_CID(0x78143984, 0x3e7c78ec);

#include "../MaxConvert/plDistributor.h"

class plMaxNode;
class plDistributor;
class plDistribInstTab;
class plExportProgressBar;
class plDistTree;

//Class that accesses the paramblock below.
class plDistribComponent : public plComponent
{
public:
	enum 
	{
		kRollTemplates,
		kRollSpacing,
		kRollScale,
		kRollOrient,
		kRollAngProb,
		kRollAltProb,
		kRollConform,
		kRollBitmap,
		kRollFade,
		kRollWind,
		kRollRandomize,
		kRollAction,

		kNumRollups
	};
	enum 
	{
		kTemplates = 0,

		// Spacing
		kSpacing,
		kSpaceRnd,
		kDensity,
		kSeparation,

		// Scale
		kScaleLoX,
		kScaleLoY,
		kScaleLoZ,

		kScaleHiX,
		kScaleHiY,
		kScaleHiZ,

		kLockScaleXY,
		kLockScaleXYZ,

		// Orient
		kAlignWgt,
		kPolarRange,
		kAzimuthRange,		
		
		kPolarBunch,
		
		// Angle prob
		kAngProbHi,
		kAngProbLo,
		kAngProbTrans,

		// Altitude prob
		kAltProbHi,
		kAltProbLo,
		kAltProbTrans,

		// Surface Conformity
		kConformType,
		kConformMax,
		kOffsetMin,
		kOffsetMax,

		// Bitmap
		kProbTexmap,
		kProbColorChan,

		kRemapFromLo,
		kRemapFromHi,
		kRemapToLo,
		kRemapToHi,

		// Fade
		kFadeInTran,
		kFadeInOpaq,
		kFadeOutTran,
		kFadeOutOpaq,
		kFadeInActive,

		// Wind
		kWindBone,
		kWindBoneActive,

		// Randomization
		kSeedLocked,
		kSeed,
		kNextSeed,

		// Etc.
		kReplicants,
		kRollupState,

		kFaceNormals,

		kNumParams

	};

	plMeshCacheTab		fDistCache;

	void		ISetProbTexmap(plDistributor& distrib);
	INode*		IMakeOne(plDistribInstTab& nodes);

	BOOL		IValidateFade(Box3& fade);

public:
	plDistribComponent();
	void DeleteThis() { delete this; }


	BOOL			Distribute(plDistribInstTab& reps, plErrorMsg* pErrMsg, plExportProgressBar& bar, plDistTree* dt=nil);
	void			Done();

	void			Clear();
	void			Preview();

	// See notes below
	Box3			GetFade();
	BOOL			IsFlexible() const;
	float			GetIsoPriority() const;

	plDistributor::IsoType GetIsolation() const;
	plDistributor::ColorChan GetProbabilityChan() const;
	plDistributor::ConformType GetConformity() const;

	// SetupProperties - Internal setup and write-only set properties on the MaxNode. No reading
	// of properties on the MaxNode, as it's still indeterminant.
	virtual hsBool SetupProperties(plMaxNode *node, plErrorMsg *pErrMsg);
	virtual hsBool PreConvert(plMaxNode *node, plErrorMsg *pErrMsg)		{ return true; }
	virtual hsBool Convert(plMaxNode *node, plErrorMsg *pErrMsg) { return true; }
};


	// GetFade() notes.
	// Fade returned as follows:
	// Box3.Min()[0] == fadeInTransparent
	// Box3.Min()[1] == fadeInOpaque
	// Box3.Max()[0] == fadeOutTransparent
	// Box3.Max()[1] == fadeOutOpaque
	//
	// Box3.Min()[2] == 0 turns off fadein.
	// Box3.Max()[2] == 0 turns off fadeout.
	// 
	// In all cases, max(Min()[0],Min()[1]) <= min(Max()[0], Max()[1])
	//
	// Also, either Min()[0] <= Min()[1] && Max()[0] >= Max()[1]
	//			or Min()[0] >= Min()[1] && Max()[0] <= Max()[1]
	// that is, we either start transparent, go to opaque and back to transparent,
	//				or we start opaque, go transparent, and back to opaque.
	// Makes sense if you think about it.
	//
	// If Min()[0] == Min()[1], there is no fade in, we start transparent or opaque
	//		as determined by Max()[0] and Max()[1].
	// Same for equal Maxs.
	// Naturally, Min()[0] == Min()[1] && Max()[0] == Max()[1] turns the whole thing off.
	//
	// Also, as a convenience, if the transparent distance is less than the opaque distance
	// (signifying a fade out), then the Z component will be -1, else if it's off, zero, else 1.
	// In Summario:
	//	if( box.Min()[0] < box.Min()[1] ) // Transparent less than Opaque
	//		box.Min()[2] = -1.f;
	//	else if( box.Min()[0] == box.Min()[1] ) // Tran same as Opaque, disabled
	//		box.Min()[2] = 0;
	//	else								// Leaves Opaque less than Transparent.
	//		box.Min()[2] = 1.f;

#endif // plDistribComponent_inc