ViewExp22 Class Reference

Extends ViewExp18. More...

#include <C:/adskgit/3dsmax/3dsmax/3dswin/src/maxsdk/include/maxapi.h>

Inheritance diagram for ViewExp22:

Public Member Functions
virtual float	GetPickingSelectionRadiusScale () const =0
	Returns the picking selection radius scaling factor.
virtual void	SetPickingSelectionRadiusScale (float selectionRadiusScale)=0
	Sets the picking selection radius scaling factor.
virtual int	GetPickingSelectionRadius () const =0
	Returns the picking selection radius in pixels.
virtual void	SetPickingSelectionRadius (int selectionRadius)=0
	Sets the picking selection pixel radius.
virtual void	SetInPresentationMode (bool onoff)=0
	Set this ViewExp in presentation mode on or off The presentation mode works only on viewport in floating view panels.
virtual bool	IsInPresentationMode () const =0
	Is this ViewExp in presentation mode ?
Public Member Functions inherited from ViewExp18
virtual MaxSDK::Graphics::IRenderView2 *	GetRenderView ()=0
	Get access to a nitrous render view instance.
virtual void	AppendTooltip (const MSTR &content)=0
	Append string on current viewport's popup tooltip This function only available during NOTIFY_PRE_VIEWPORT_TOOLTIP.
Public Member Functions inherited from ViewExp13
virtual	~ViewExp13 ()
	Destructor.
virtual bool	IsUsingDefaultLights () const =0
	Is this viewport using default lights ?
virtual BOOL	GetSingleDefaultLight () const =0
	Get whether the viewport uses one default light, or two.
virtual size_t	GetDefaultLightsData (DefaultLight *pDefaultLights, size_t sizeOfDefaultLights, bool bApplyGlobalLevel) const =0
	Get the default lights data and their number at the same time.
virtual void	UpdateLabel ()=0
	Updates the viewport label, if the display mode has changed.
virtual float	GetZoom ()=0
	Get the zoom value of the viewport.
virtual float	GetHither ()=0
	Get the hither clipping value of the viewport.
virtual float	GetYon ()=0
	Get the yon clipping value of the viewport.
virtual DeviceRect	GetRegionDeviceRect ()=0
	Returns the viewport region rectangle as a DeviceRect.
virtual void	SetRegionDeviceRect (DeviceRect r)=0
	Sets the viewport region rectangle as a DeviceRect.
virtual DeviceRect	GetBlowupDeviceRect ()=0
	Returns the viewport blow-up rectangle as a DeviceRect.
virtual void	SetBlowupDeviceRect (DeviceRect r)=0
	Sets the viewport blow-up rectangle as a DeviceRect.
virtual DeviceRect	GetSelDeviceRect (TimeValue t)=0
	Returns the viewport bounding box of the current node selection, as a DeviceRect.
virtual void	SetEdgedFaces (int md)=0
	Sets if drawing edges faces should be turned on in the viewport.
virtual int	GetEdgedFaces (void)=0
	Gets if drawing edges faces is turned on in the viewport.
virtual bool	QueryCursorSceneIntersection (float x, float y, Point3 &intersection)=0
	Query the world space intersection point under the specified cursor position.
Public Member Functions inherited from ViewExp11
virtual	~ViewExp11 ()
	Destructor.
virtual BOOL	IsDegrading ()=0
	Gets whether or not we are in the process of drawing the viewports in an degraded state.
Public Member Functions inherited from ViewExp10
virtual	~ViewExp10 ()
	Destructor.
virtual BOOL	SetFOV (float fov)=0
	Sets the Field of View for the viewport.
virtual float	GetViewportFPS ()=0
	Gets the state of the active viewport current fps.
virtual float	GetViewportClipScale ()=0
	Gets the state of the active viewport clip scale value.
virtual void	SetViewportClipScale (float fScale)=0
	Sets the state of the active viewport clip scale value.
virtual void	Pan (const Point2 &screenDelta)=0
	Pans the viewport.
virtual void	Zoom (float zoomFactor)=0
	Zooms the viewport.
virtual void	Rotate (const Quat &rotData, const Point3 &center=Point3::Origin)=0
	Rotates the viewport.
virtual void	SetFocalDistance (float dist)=0
	Sets the focal distance of the viewport.
virtual bool	UndoBegin ()=0
	Call this method before any change to the viewpoint or viewport parameters.
virtual bool	UndoAccept ()=0
	Marks the end of recording viewport changes for undo.
virtual void	Invalidate (bool bForegroundOnly=false)=0
	A call to Interface::RedrawViews will cause the viewport to be redrawn.
virtual bool	IsValid () const =0
	Retrieves the validity state of the viewport foreground.
virtual float	GetAdaptiveDegGoalFPS ()=0
	Gets Adaptive Deg. goal FPS.
virtual void	SetAdaptiveDegGoalFPS (float fFPS)=0
	Sets Adaptive Deg. goal FPS.
virtual BOOL	GetAdaptiveDegDisplayModeCurrent ()=0
	Gets the state of the display mode current display option.
virtual void	SetAdaptiveDegDisplayModeCurrent (BOOL bMode)=0
	Sets the display mode to the current display.
virtual BOOL	GetAdaptiveDegDisplayModeFastShaded ()=0
	Gets the state of the display mode Fast Shaded display option.
virtual void	SetAdaptiveDegDisplayModeFastShaded (BOOL bMode)=0
	Sets the state of the display mode Fast Shaded display option.
virtual BOOL	GetAdaptiveDegDisplayModeWire ()=0
	Gets the state of the display mode Wireframe display option.
virtual void	SetAdaptiveDegDisplayModeWire (BOOL bMode)=0
	Sets the state of the display mode Wireframe display option.
virtual BOOL	GetAdaptiveDegDisplayModeBox ()=0
	Gets the state of the display mode BoundingBox display option.
virtual void	SetAdaptiveDegDisplayModeBox (BOOL bMode)=0
	Sets the state of the display mode BoundingBox display option.
virtual BOOL	GetAdaptiveDegDisplayModePoint ()=0
	Gets the state of the display mode Point display option.
virtual void	SetAdaptiveDegDisplayModePoint (BOOL bMode)=0
	Sets the state of the display mode Point display option.
virtual BOOL	GetAdaptiveDegDisplayModeHide ()=0
	Gets the state of the display mode Hide display option.
virtual void	SetAdaptiveDegDisplayModeHide (BOOL bMode)=0
	Sets the state of the display mode Hide display option.
virtual BOOL	GetAdaptiveDegDrawBackface ()=0
	Gets the state of the Draw Backface option.
virtual void	SetAdaptiveDegDrawBackface (BOOL bDraw)=0
	Sets the state of the Draw Backface option.
virtual BOOL	GetAdaptiveDegNeverDegradeSelected ()=0
	Gets the state of the Never Degrade Selected option.
virtual void	SetAdaptiveDegNeverDegradeSelected (BOOL bNeverDegrade)=0
	Sets the state of the Never Degrade Selected option.
virtual BOOL	GetAdaptiveDegDegradeLight ()=0
	Gets the state of the Degrade to Default Light option.
virtual void	SetAdaptiveDegDegradeLight (BOOL bDegradeLight)=0
	Sets the state of the Degrade to Default Light option.
virtual BOOL	GetAdaptiveDegNeverRedrawAfterDegrade ()=0
	Gets the state of the Never Redraw After Degrade option.
virtual void	SetAdaptiveDegNeverRedrawAfterDegrade (BOOL bNeverRedraw)=0
	Sets the state of the Never Redraw After Degrade option.
virtual float	GetAdaptiveDegCameraDistancePriority ()=0
	Gets the state of the Distance From Camera Priority option.
virtual void	SetAdaptiveDegCameraDistancePriority (float fPriority)=0
	Sets the state of the Distance From Camera Priority option.
virtual float	GetAdaptiveDegScreenSizePriority ()=0
	Gets the state of the Screen Size Priority option.
virtual void	SetAdaptiveDegScreenSizePriority (float fPriority)=0
	Sets the state of the Screen Size Priority option.
virtual int	GetAdaptiveDegMinSize ()=0
	Gets the state of the Minimum Draw Size option.
virtual void	SetAdaptiveDegMinSize (int iMinSize)=0
	Sets the state of the Minimum Draw Size option.
Public Member Functions inherited from ViewExp
virtual int	GetViewID ()=0
	Return the unique ID of the viewport represented by the ViewExp.
virtual ViewExp *	ToPointer ()=0
virtual bool	IsAlive ()=0
virtual Point2	MapViewToScreen (const Point3 &p)=0
virtual float	GetFPS ()=0
	Get the FPS from the active viewport.
virtual void	SetSolidBackgroundColorMode (bool bSolidColor)=0
	Set the viewport background color mode as solid color mode or gradient color mode.
virtual bool	IsSolidBackgroundColorMode ()=0
	Get the current viewport background color mode.
virtual void	ResetBackgroundColorMode ()=0
	Reset viewport background color mode.
virtual void	InvalidateRect (const Rect &rect)=0
virtual INT_PTR	Execute (int cmd, ULONG_PTR arg1=0, ULONG_PTR arg2=0, ULONG_PTR arg3=0)
virtual Point3	GetPointOnCP (const IPoint2 &ps)=0
virtual float	GetCPDisp (const Point3 base, const Point3 &dir, const IPoint2 &sp1, const IPoint2 &sp2, BOOL snap=FALSE)=0
virtual Point3	MapScreenToView (const IPoint2 &sp, float depth)=0
virtual void	MapScreenToWorldRay (float sx, float sy, Ray &ray)=0
virtual BOOL	SetAffineTM (const Matrix3 &m)=0
virtual void	GetAffineTM (Matrix3 &tm)=0
virtual float	GetScreenScaleFactor (const Point3 worldPoint)=0
virtual float	GetVPWorldWidth (const Point3 wPoint)=0
virtual Point3	MapCPToWorld (const Point3 cpPoint)=0
virtual float	NonScalingObjectSize ()=0
virtual Point3	SnapPoint (const IPoint2 &in, IPoint2 &out, Matrix3 *plane2d=NULL, DWORD flags=0)=0
virtual void	SnapPreview (const IPoint2 &in, IPoint2 &out, Matrix3 *plane2d=NULL, DWORD flags=0)=0
virtual void	GetGridDims (float *MinX, float *MaxX, float *MinY, float *MaxY)=0
virtual float	SnapLength (float in)=0
virtual GraphicsWindow *	getGW ()=0
virtual int	IsWire ()=0
virtual Rect	GetDammageRect ()=0
virtual void	GetConstructionTM (Matrix3 &tm)=0
virtual void	SetGridSize (float size)=0
virtual float	GetGridSize ()=0
virtual BOOL	IsGridVisible ()=0
virtual void	SetGridVisibility (BOOL bVisible)=0
virtual int	GetGridType ()=0
virtual BOOL	setBkgImageDsp (BOOL onOff)=0
virtual int	getBkgImageDsp (void)=0
virtual void	setSFDisplay (int onOff)=0
virtual int	getSFDisplay (void)=0
virtual HWND	GetHWnd ()=0
virtual BOOL	IsActive ()=0
virtual BOOL	IsEnabled ()=0
virtual int	GetViewType ()=0
virtual BOOL	IsPerspView ()=0
virtual BOOL	IsCanvasNavigationMode ()=0
virtual float	GetFOV ()=0
virtual float	GetFocalDist ()=0
virtual void	SetFocalDist (float fd)=0
virtual INode *	GetViewCamera ()=0
virtual void	SetViewCamera (INode *camNode)=0
virtual void	SetViewUser (BOOL persp)=0
virtual INode *	GetViewSpot ()=0
virtual void	SetViewSpot (INode *spotNode)=0
virtual void	ClearHitList ()=0
virtual INode *	GetClosestHit ()=0
virtual INode *	GetHit (int i)=0
virtual int	HitCount ()=0
virtual void	LogHit (INode *nr, ModContext *mc, DWORD dist, ulong info, HitData *hitdata=NULL)=0
	This method records a sub-object level hit record with the system using the specified parameters.
virtual HitLog &	GetSubObjHitList ()=0
virtual void	ClearSubObjHitList ()=0
virtual int	NumSubObjHits ()=0
virtual void	CtrlLogHit (INode *nr, DWORD dist, ulong info, DWORD infoExtra)=0
virtual CtrlHitLog &	GetCtrlHitList ()=0
virtual void	ClearCtrlHitList ()=0
virtual void	TrackImplicitGrid (IPoint2 m, Matrix3 *mat=NULL, ULONG hitTestFlags=0)=0
virtual void	CommitImplicitGrid (IPoint2 m, int mouseflags, Matrix3 *mat=NULL)=0
virtual void	ReleaseImplicitGrid ()=0
Public Member Functions inherited from InterfaceServer
virtual UtilExport	~InterfaceServer ()
	Destructor.
virtual UtilExport BaseInterface *	GetInterface (Interface_ID id)
template<class InterfaceType>
InterfaceType *	GetTypedInterface ()

Additional Inherited Members
Public Types inherited from ViewExp
enum	{ kEXECUTE_GET_VIEWEXP_10 = 0 , kEXECUTE_GET_VIEWPORT_ID = 1 , kEXECUTE_GET_VIEWEXP_11 = 2 , kEXECUTE_GET_VIEWEXP_13 = 3 }
Static Public Member Functions inherited from MaxHeapOperators
static UtilExport void *	operator new (size_t size)
	Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e)
	Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new (size_t size, const char *filename, int line)
	New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e, const char *filename, int line)
	New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new (size_t size, unsigned long flags)
	New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e, unsigned long flags)
	New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size, const char *filename, int line)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate arrays of objects.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size, unsigned long flags)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e, unsigned long flags)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void	operator delete (void *ptr)
	Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e)
	Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete (void *ptr, const char *filename, int line)
	Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, int block_type, const char *filename, int line)
	Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line)
	Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete (void *ptr, unsigned long flags)
	Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags)
	Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr)
	Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e)
	Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, int block_type, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr, unsigned long flags)
	Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags)
	Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void *	operator new (size_t size, void *placement_ptr)
	Placement new operator.
static UtilExport void	operator delete (void *ptr, void *placement_ptr)
	Placement delete operator.
static UtilExport void *	aligned_malloc (size_t size, size_t alignment)
	Allocates memory on a specified alignment boundary.
static UtilExport void *	aligned_realloc (void *ptr, size_t size, size_t alignment)
	Reallocates memory on a specified alignment boundary.
static UtilExport void	aligned_free (void *ptr)
	Frees a block of memory that was allocated with aligned_malloc/aligned_realloc.

Detailed Description

Extends ViewExp18.

The following code example shows how to get access to this interface:

ViewExp22& viewExp22 = static_cast<ViewExp22&>(GetCOREInterface7()->getViewExp(0));

Member Function Documentation

GetPickingSelectionRadiusScale()

virtual float GetPickingSelectionRadiusScale ( ) const

pure virtual

Returns the picking selection radius scaling factor.

This is used with the mouse cursor size to calculate the selection radius. The selection radius scale is a global property.

Returns

Returns the selection radius scaling factor.

SetPickingSelectionRadiusScale()

virtual void SetPickingSelectionRadiusScale ( float selectionRadiusScale )

pure virtual

Sets the picking selection radius scaling factor.

This is used with the mouse cursor size to calculate the selection radius. The selection radius scale is a global property.

Parameters

selectionRadiusScale

- The new selection radius scale value. Clamped between [0.0001, 1000.0].

GetPickingSelectionRadius()

virtual int GetPickingSelectionRadius ( ) const

pure virtual

Returns the picking selection radius in pixels.

The selection radius is a function of the cursor size (which scales with the screen DPI) and the selection radius scale factor. The selection radius scale is a global property.

Returns

Returns the selection radius in pixels.

SetPickingSelectionRadius()

virtual void SetPickingSelectionRadius ( int selectionRadius )

pure virtual

Sets the picking selection pixel radius.

The selection radius scale is a global property.

Parameters

selectionRadius

- The new selection radius value in pixels.

SetInPresentationMode()

virtual void SetInPresentationMode ( bool onoff )

pure virtual

Set this ViewExp in presentation mode on or off The presentation mode works only on viewport in floating view panels.

It is a mode where there are no title bar, no grid, no view cube, no gizmos... The view in presentation mode is always updated even if it is not the active view

IsInPresentationMode()

virtual bool IsInPresentationMode ( ) const

pure virtual

Is this ViewExp in presentation mode ?

The presentation mode works only on viewport in floating view panels. It is a mode where there are no title bar, no grid, no view cube, no gizmos... The view in presentation mode is always updated even if it is not the active view

Returns

Return true if it is in presentation mode.