3ds Max C++ API Reference
IPViewItem.h

Functions

 IPViewItem ()
 
virtual int NumPViewParamBlocks () const =0
 
virtual IParamBlock2GetPViewParamBlock (int i) const =0
 
More...
 
PFExport int NumPViewParamMaps () const
 
PFExport IParamMap2GetPViewParamMap (int i) const
 
PFExport void AddPViewParamMap (IParamMap2 *map)
 
PFExport void RemovePViewParamMap (IParamMap2 *map)
 
virtual bool HasCustomPViewIcons ()
 Implement if you want your operator/test to be shown with a custom icon in ParticleView. More...
 
virtual bool HasTransparentPViewIcons () const
 Defines whether the custom icons in Particle View have alpha channels. More...
 
virtual HBITMAP GetActivePViewIcon ()
 Implement if you want your operator/test to be shown with a custom icon in ParticleView. More...
 
virtual HBITMAP GetInactivePViewIcon ()
 Implement if you want your operator/test to be shown with a custom icon in ParticleView. More...
 
virtual HBITMAP GetTruePViewIcon ()
 Implement if you want your operator/test to be shown with a custom icon in ParticleView. More...
 
virtual HBITMAP GetFalsePViewIcon ()
 Implement if you want your operator/test to be shown with a custom icon in ParticleView. More...
 
virtual bool ShowColorSwatch () const
 An operator may have a color swatch UI (color circle on the right side) if it can be used to display particles in viewport. More...
 
PFExport int GetNumInstances () const
 Used to track instanced actions. More...
 
PFExport void SetNumInstances (int num)
 Used to track instanced actions. More...
 
PFExport void IncNumInstances ()
 Used to track instanced actions. More...
 
PFExport bool HasComments (INode *itemNode) const
 A PView item can have comments. More...
 
PFExport const MCHARGetComments (INode *itemNode) const
 See HasComments(). More...
 
PFExport void SetComments (INode *itemNode, const MCHAR *comments)
 See HasComments(). More...
 
PFExport void EditComments (INode *itemNode, HWND parentWnd, long x, long y)
 See HasComments(). More...
 
PFExport LRESULT CALLBACK commentsProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
 For internal use. More...
 
virtual bool HasDynamicName (MSTR &nameSuffix)
 For dynamic names support; if the action has a dynamic name then it supplies the name suffix. More...
 
static PFExport int GetWireExtension (INode *node, int &wireHeight)
 To read/modify the length/height of the wire nub extended from an emitter, or an action list, or a test. More...
 
static PFExport void SetWireExtension (INode *node, int wireLen, int wireHight)
 Sets wire length. More...
 
FPInterfaceDescGetDesc ()
 

Variables

Tab< IParamMap2 * > m_paramMaps
 
int m_numInstances
 
Tab< INode * > m_nodes
 
Tab< HWND > m_hWnds
 

Detailed Description

Function Documentation

◆ IPViewItem()

IPViewItem ( )
inline
58 { m_numInstances = 1; }
int m_numInstances
Definition: IPViewItem.h:207

◆ NumPViewParamBlocks()

int NumPViewParamBlocks ( ) const
pure virtual

Implemented in PFSimpleAction.

◆ GetPViewParamBlock()

IParamBlock2 * GetPViewParamBlock ( int  i) const
pure virtual


Implemented in PFSimpleAction.

◆ NumPViewParamMaps()

PFExport int NumPViewParamMaps ( ) const

◆ GetPViewParamMap()

PFExport IParamMap2 * GetPViewParamMap ( int  i) const

◆ AddPViewParamMap()

PFExport void AddPViewParamMap ( IParamMap2 map)

◆ RemovePViewParamMap()

PFExport void RemovePViewParamMap ( IParamMap2 map)

◆ HasCustomPViewIcons()

bool HasCustomPViewIcons ( )
inlinevirtual

Implement if you want your operator/test to be shown with a custom icon in ParticleView.

93 { return false; }

◆ HasTransparentPViewIcons()

bool HasTransparentPViewIcons ( ) const
inlinevirtual

Defines whether the custom icons in Particle View have alpha channels.

It is not possible for any specific PFlow action/operator/test to have some icons with alpha, and some without. If the method returns true, then the PFlow action/operator/test has to implement all PViewIcon related methods below and return a 32-bit HBITMAP with alpha channel.

101 { return false; }

◆ GetActivePViewIcon()

HBITMAP GetActivePViewIcon ( )
inlinevirtual

Implement if you want your operator/test to be shown with a custom icon in ParticleView.

For operator/test when in active state.

106 { return NULL; }
#define NULL
Definition: autoptr.h:18

◆ GetInactivePViewIcon()

HBITMAP GetInactivePViewIcon ( )
inlinevirtual

Implement if you want your operator/test to be shown with a custom icon in ParticleView.

For operator when in disabled state.

111 { return NULL; }

◆ GetTruePViewIcon()

HBITMAP GetTruePViewIcon ( )
inlinevirtual

Implement if you want your operator/test to be shown with a custom icon in ParticleView.

For test when in "always true" state.

116 { return NULL; }

◆ GetFalsePViewIcon()

HBITMAP GetFalsePViewIcon ( )
inlinevirtual

Implement if you want your operator/test to be shown with a custom icon in ParticleView.

For test when in "always false" state.

121 { return NULL; }

◆ ShowColorSwatch()

bool ShowColorSwatch ( ) const
inlinevirtual

An operator may have a color swatch UI (color circle on the right side) if it can be used to display particles in viewport.

The method is used for the case when the color swatch is variable: visibility of the swatch depends on the parameters of the operator. The typical case is 'mP Shape' operator where the particle collision shape is used for debugging purposes only. The operators Display, Display Script, Display Data don't implement this method since they always show their color swatch.

129 { return false; }

◆ GetNumInstances()

PFExport int GetNumInstances ( ) const

Used to track instanced actions.

An action may have several instances, which PView shows in italic font.

◆ SetNumInstances()

PFExport void SetNumInstances ( int  num)

Used to track instanced actions.

An action may have several instances, which PView shows in italic font.

◆ IncNumInstances()

PFExport void IncNumInstances ( )

Used to track instanced actions.

An action may have several instances, which PView shows in italic font.

◆ HasComments()

PFExport bool HasComments ( INode itemNode) const

A PView item can have comments.

Comments are also shown and edited via right-click above the PView item.

◆ GetComments()

PFExport MSTR GetComments ( INode itemNode) const

◆ SetComments()

PFExport void SetComments ( INode itemNode,
const MCHAR comments 
)

◆ EditComments()

PFExport void EditComments ( INode itemNode,
HWND  parentWnd,
long  x,
long  y 
)

◆ commentsProc()

PFExport LRESULT CALLBACK commentsProc ( HWND  hwnd,
UINT  message,
WPARAM  wParam,
LPARAM  lParam 
)

For internal use.

◆ HasDynamicName()

bool HasDynamicName ( MSTR nameSuffix)
inlinevirtual

For dynamic names support; if the action has a dynamic name then it supplies the name suffix.

175 { UNUSED_PARAM(nameSuffix); return false; }
#define UNUSED_PARAM(x)
Definition: BuildWarnings.h:18

◆ GetWireExtension()

PFExport static int GetWireExtension ( INode node,
int wireHeight 
)
static

To read/modify the length/height of the wire nub extended from an emitter, or an action list, or a test.

You must supply the node of the item. This method returns wire length.

◆ SetWireExtension()

PFExport static void SetWireExtension ( INode node,
int  wireLen,
int  wireHight 
)
static

Sets wire length.

See GetWireExtension().

◆ GetDesc()

FPInterfaceDesc * GetDesc ( )
inlinevirtual
Remarks
Returns a pointer to the class which contains the interface metadata.

Implements FPInterface.

191 { return GetDescByID(PVIEWITEM_INTERFACE); }
#define PVIEWITEM_INTERFACE
Definition: IPViewItem.h:21
virtual FPInterfaceDesc * GetDescByID(Interface_ID id)
Definition: ifnpub.h:613

Variable Documentation

◆ m_paramMaps

Tab<IParamMap2*> m_paramMaps
protected

◆ m_numInstances

int m_numInstances
protected

◆ m_nodes

Tab<INode*> m_nodes
protected

◆ m_hWnds

Tab<HWND> m_hWnds
protected