Initial commit
This commit is contained in:
Eagle517
352
Torque/SDK/lib/mayasdk4/include/maya/M3dView.h
Normal file
352
Torque/SDK/lib/mayasdk4/include/maya/M3dView.h
Normal file
@@ -0,0 +1,352 @@
|
||||
#ifndef LINUX
|
||||
#pragma once
|
||||
#endif
|
||||
#ifndef _M3dView
|
||||
#define _M3dView
|
||||
//
|
||||
// *****************************************************************************
|
||||
//
|
||||
// Copyright (C) 1997-2001 Alias|Wavefront Inc.
|
||||
//
|
||||
// These coded instructions, statements and computer programs contain
|
||||
// unpublished information proprietary to Alias|Wavefront Inc. and are
|
||||
// protected by Canadian and US federal copyright laws. They may not be
|
||||
// disclosed to third parties or copied or duplicated, in whole or in part,
|
||||
// without prior written consent of Alias|Wavefront Inc.
|
||||
//
|
||||
// Unpublished-rights reserved under the Copyright Laws of the United States.
|
||||
//
|
||||
// *****************************************************************************
|
||||
//
|
||||
// CLASS: M3dView
|
||||
//
|
||||
// *****************************************************************************
|
||||
//
|
||||
// CLASS DESCRIPTION (M3dView)
|
||||
//
|
||||
// M3dView provides methods for working with 3D model views. 3D views are
|
||||
// based on OpenGL drawing areas.
|
||||
//
|
||||
// Maya can operate in two different color modes, RGBA and color index. Color
|
||||
// index mode is used to increase performance when shading is not required.
|
||||
// Drawing in color index mode is more complicated, but this class provides
|
||||
// methods to simplify color selection.
|
||||
//
|
||||
// Maya has four color tables that can be used in RGBA, and that must be used
|
||||
// in color index mode. These four color tables represent four sets of bit
|
||||
// planes that are independent of each other. So, for example, it is possible
|
||||
// to clear all active objects from the display and redraw them without
|
||||
// redrawing the dormant and templated objects.
|
||||
//
|
||||
// The extra performance of color index mode comes at the cost of a
|
||||
// limited number of colors. If this restriction causes difficulty, then
|
||||
// it is possible for the user to force all displays into RGBA mode
|
||||
// where any color may be used.
|
||||
//
|
||||
// When an object is affected by another in the scene, it is drawn in a
|
||||
// magenta colour by default. This is denoted in the DisplayStatus enum by
|
||||
// kActiveAffected. These objects are drawn in the active planes even though
|
||||
// they are dormant for performance reasons.
|
||||
//
|
||||
// *****************************************************************************
|
||||
|
||||
#if defined __cplusplus
|
||||
|
||||
// *****************************************************************************
|
||||
// INCLUDED HEADER FILES
|
||||
|
||||
#include <maya/MStatus.h>
|
||||
#include <maya/MObject.h>
|
||||
|
||||
#ifndef _WIN32
|
||||
#include <GL/glx.h>
|
||||
#include <X11/Intrinsic.h>
|
||||
typedef Widget MWindow;
|
||||
#else
|
||||
#include "windows.h"
|
||||
#include <gl/Gl.h>
|
||||
typedef HWND MWindow;
|
||||
#endif // _WIN32
|
||||
|
||||
// *****************************************************************************
|
||||
|
||||
// DECLARATIONS
|
||||
|
||||
class MString;
|
||||
class MDagPath;
|
||||
class MPoint;
|
||||
class MVector;
|
||||
class MMatrix;
|
||||
class MColor;
|
||||
class MPxGlBuffer;
|
||||
|
||||
// *****************************************************************************
|
||||
|
||||
// CLASS DECLARATION (M3dView)
|
||||
|
||||
/// A 3-D view (OpenMayaUI)
|
||||
/**
|
||||
|
||||
3-D view class.
|
||||
|
||||
*/
|
||||
|
||||
#ifndef _WIN32
|
||||
typedef Window M3dWindow;
|
||||
#else
|
||||
typedef HWND M3dWindow;
|
||||
#endif // _WIN32
|
||||
|
||||
#ifdef _WIN32
|
||||
#pragma warning(disable: 4522)
|
||||
#endif // _WIN32
|
||||
|
||||
class OPENMAYAUI_EXPORT M3dView {
|
||||
|
||||
public:
|
||||
|
||||
///
|
||||
enum DisplayStyle {
|
||||
/// bounding box display
|
||||
kBoundingBox,
|
||||
/// flat shaded display
|
||||
kFlatShaded,
|
||||
/// gouraud shaded display
|
||||
kGouraudShaded,
|
||||
/// wire frame display
|
||||
kWireFrame,
|
||||
/// points only display
|
||||
kPoints
|
||||
};
|
||||
|
||||
|
||||
///
|
||||
enum DisplayStatus {
|
||||
/// object is active (selected)
|
||||
kActive,
|
||||
/// object is live (construction surface)
|
||||
kLive,
|
||||
/// object is domant
|
||||
kDormant,
|
||||
/// object is invisible (not drawn)
|
||||
kInvisible,
|
||||
/// object is hilited (has selectable components)
|
||||
kHilite,
|
||||
/// object is templated (Not renderable)
|
||||
kTemplate,
|
||||
/// object is active and templated
|
||||
kActiveTemplate,
|
||||
/// object has active components
|
||||
kActiveComponent,
|
||||
/// Last selected object
|
||||
kLead,
|
||||
/// Construction object (not drawn)
|
||||
kIntermediateObject,
|
||||
/// Affected by active object(s)
|
||||
kActiveAffected,
|
||||
/// object does not have a valid display status
|
||||
kNoStatus
|
||||
};
|
||||
|
||||
///
|
||||
enum ColorTable {
|
||||
/// colors for active objects
|
||||
kActiveColors = kActive,
|
||||
/// colors for dormant objects
|
||||
kDormantColors = kDormant,
|
||||
/// colors for templated objects
|
||||
kTemplateColor = kTemplate,
|
||||
/// colors for background color
|
||||
kBackgroundColor
|
||||
};
|
||||
|
||||
///
|
||||
enum TextPosition {
|
||||
/// draw text to the left of the point
|
||||
kLeft,
|
||||
/// draw text centered around the point
|
||||
kCenter,
|
||||
/// draw text to the right of the point
|
||||
kRight
|
||||
};
|
||||
|
||||
enum LightingMode {
|
||||
kLightAll, // All lights ON mode
|
||||
kLightSelected, // Selected lights ON mode
|
||||
kLightActive, // Active lights ON mode
|
||||
kLightDefault // Default light ON mode
|
||||
};
|
||||
|
||||
///
|
||||
M3dView();
|
||||
///
|
||||
virtual ~M3dView();
|
||||
|
||||
// global methods
|
||||
///
|
||||
static M3dView active3dView( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
static unsigned numberOf3dViews();
|
||||
///
|
||||
static MStatus get3dView( const unsigned index,
|
||||
M3dView & view );
|
||||
|
||||
///
|
||||
#ifndef _WIN32
|
||||
Display * display( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
GLXContext glxContext( MStatus * ReturnStatus = NULL );
|
||||
#else
|
||||
HGLRC display( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
HDC deviceContext( MStatus * ReturnStatus = NULL );
|
||||
#endif
|
||||
|
||||
///
|
||||
static MWindow applicationShell( MStatus * ReturnStatus = NULL );
|
||||
|
||||
///
|
||||
M3dWindow window( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
int portWidth( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
int portHeight( MStatus * ReturnStatus = NULL );
|
||||
|
||||
|
||||
// OpenGL wrapper methods
|
||||
///
|
||||
MStatus beginGL();
|
||||
///
|
||||
MStatus endGL();
|
||||
|
||||
// OpenGL Selection
|
||||
//
|
||||
///
|
||||
void beginSelect (GLuint *buffer = NULL, GLsizei size = 0);
|
||||
///
|
||||
GLint endSelect ();
|
||||
///
|
||||
bool selectMode () const;
|
||||
///
|
||||
void loadName (GLuint name);
|
||||
///
|
||||
void pushName (GLuint name);
|
||||
///
|
||||
void popName ();
|
||||
///
|
||||
void initNames ();
|
||||
|
||||
|
||||
// Overlay plane methods
|
||||
|
||||
///
|
||||
MStatus beginOverlayDrawing();
|
||||
///
|
||||
MStatus endOverlayDrawing();
|
||||
///
|
||||
MStatus clearOverlayPlane();
|
||||
|
||||
// Color methods
|
||||
|
||||
///
|
||||
MStatus setDrawColor( unsigned index,
|
||||
ColorTable table = kActiveColors );
|
||||
///
|
||||
MStatus setDrawColor( const MColor & color );
|
||||
|
||||
///
|
||||
bool isColorIndexMode( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
unsigned numDormantColors( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
unsigned numActiveColors( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
unsigned numUserDefinedColors( MStatus * ReturnStatus = NULL );
|
||||
|
||||
///
|
||||
MStatus setUserDefinedColor( unsigned index, const MColor & color );
|
||||
///
|
||||
unsigned userDefinedColorIndex( unsigned index,
|
||||
MStatus * ReturnStatus = NULL );
|
||||
|
||||
///
|
||||
MColor templateColor( MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
MColor backgroundColor( MStatus * ReturnStatus = NULL );
|
||||
|
||||
///
|
||||
MColor colorAtIndex( unsigned index, ColorTable table = kActiveColors,
|
||||
MStatus * ReturnStatus = NULL );
|
||||
///
|
||||
MStatus getColorIndexAndTable( unsigned glindex, unsigned &index,
|
||||
ColorTable &table ) const;
|
||||
|
||||
// Text drawing methods
|
||||
|
||||
///
|
||||
MStatus drawText( const MString & text, const MPoint position,
|
||||
TextPosition textPosition = kLeft );
|
||||
|
||||
// Camera methods
|
||||
|
||||
///
|
||||
MStatus getCamera( MDagPath & camera );
|
||||
///
|
||||
MStatus setCamera( MDagPath & camera );
|
||||
|
||||
///
|
||||
MStatus refresh( bool all = false, bool force = false );
|
||||
///
|
||||
MStatus refresh( MPxGlBuffer &buffer );
|
||||
|
||||
// Light methods
|
||||
MStatus getLightCount( unsigned int &count, bool visible = TRUE );
|
||||
MStatus getLightingMode(LightingMode &mode );
|
||||
MStatus getLightPath( unsigned int lightNumber, MDagPath &light );
|
||||
MStatus isLightVisible( unsigned int lightNumber, bool &visible );
|
||||
MStatus getLightIndex( unsigned int lightNumber, unsigned int &lightIndex );
|
||||
|
||||
// Transformation methods
|
||||
|
||||
///
|
||||
MStatus viewToWorld( short x_pos, short y_pos,
|
||||
MPoint & worldPt, MVector & worldVector ) const;
|
||||
///
|
||||
MStatus viewToWorld( short x_pos, short y_pos,
|
||||
MPoint & nearClipPt, MPoint & farClipPt ) const;
|
||||
///
|
||||
MStatus viewToObjectSpace( short x_pos, short y_pos,
|
||||
const MMatrix & localMatrixInverse,
|
||||
MPoint & oPt, MVector & oVector ) const;
|
||||
///
|
||||
bool worldToView( const MPoint& worldPt,
|
||||
short& x_pos, short& y_pos,
|
||||
MStatus * ReturnStatus = NULL ) const;
|
||||
|
||||
// Display style methods
|
||||
|
||||
///
|
||||
DisplayStyle displayStyle( MStatus * ReturnStatus = NULL ) const;
|
||||
///
|
||||
bool isShadeActiveOnly( MStatus * ReturnStatus = NULL ) const;
|
||||
///
|
||||
MStatus setDisplayStyle ( DisplayStyle style, bool activeOnly = false);
|
||||
|
||||
protected:
|
||||
// No protected members
|
||||
|
||||
private:
|
||||
|
||||
|
||||
static const char* className();
|
||||
M3dView( const void * );
|
||||
const void * fPtr;
|
||||
};
|
||||
|
||||
|
||||
#ifdef _WIN32
|
||||
#pragma warning(default: 4522)
|
||||
#endif // _WIN32
|
||||
|
||||
#endif /* __cplusplus */
|
||||
#endif /* _M3dView */
|
||||
Reference in New Issue
Block a user