2017-04-17 06:17:10 -06:00

353 lines
9.8 KiB
C++
Executable File

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