Main Page Modules C++ Classes Compound List File List Index Related Pages What is the Nebula Device? Features Downloads License Contact Us Documentation FAQ Getting Started Script Docs Links forums Bugs Nebula2 on Sourceforge Radon Labs Categories News Images changes Search Archives July 2008 May 2008 April 2007 March 2007 August 2006 June 2006 March 2006 October 2005 August 2005 July 2005 Meta Login RSS Comments RSS ngfxserver2.h Go to the documentation of this file. #ifndef N_GFXSERVER2_H #define N_GFXSERVER2_H //------------------------------------------------------------------------------ #include "kernel/nroot.h" #include "gfx2/ncamera2.h" #include "kernel/nautoref.h" #include "mathlib/matrix.h" #include "gfx2/ntexture2.h" #include "mathlib/rectangle.h" #include "gfx2/nmousecursor.h" #include "gfx2/ndisplaymode2.h" #include "gfx2/nfont2.h" #include "gfx2/ninstancestream.h" #include "gfx2/nlight.h" #include "util/nfixedarray.h" #include "mathlib/rectangle.h" #include "mathlib/plane.h" #if __NEBULA_STATS__ #include "kernel/nprofiler.h" #endif //------------------------------------------------------------------------------ class nMesh2; class nShader2; class nResourceServer; class nFontDesc; class nMeshArray; class nOcclusionQuery; class nViewport { public: float x; float y; float width; float height; float nearz; float farz; }; class nGfxServer2 : public nRoot { public: enum TransformType { Model = 0, View, Projection, InvModel, InvView, ModelView, InvModelView, ModelViewProjection, ViewProjection, Texture0, Texture1, Texture2, Texture3, Light, ModelLight, InvModelLight, ShadowProjection, NumTransformTypes }; enum LightingType { Off = 0, FFP, Shader, }; enum BufferType { NoBuffer = 0, ColorBuffer = (1<<0), DepthBuffer = (1<<1), StencilBuffer = (1<<2), AllBuffers = (ColorBuffer | DepthBuffer | StencilBuffer), }; enum PrimitiveType { PointList, LineList, LineStrip, TriangleList, TriangleStrip, TriangleFan, }; enum IndexType { Index16, Index32, }; enum ShapeType { Box = 0, Cylinder, Sphere, Torus, Teapot, NumShapeTypes, }; enum FeatureSet { DX7 = 0, DX8, DX8SB, DX9, DX9FLT, NumFeatureSets, InvalidFeatureSet, }; enum CursorVisibility { None, System, Custom, Gui, }; enum { MaxVertexStreams = 16, MaxTextureStages = 4, MaxTransformStackDepth = 4, MaxRenderTargets = 4, MaxLights = 8, }; enum DeviceIdentifier // list of devices that are know to cause bugs { GenericDevice, Intel_82865G, // shadow bugs SiS_630, // crap SiS_741, // crap }; enum Hint { MvpOnly = (1<<0), // only update the ModelViewProjection matrix in shaders CountStats = (1<<1), // statistics counting currently active? }; nGfxServer2(); virtual ~nGfxServer2(); static nGfxServer2* Instance(); virtual nMesh2* NewMesh(const nString& rsrcName); virtual nMeshArray* NewMeshArray(const nString& rsrcName); virtual nTexture2* NewTexture(const nString& rsrcName); virtual nShader2* NewShader(const nString& rsrcName); virtual nFont2* NewFont(const nString& rsrcName, const nFontDesc& fontDesc); virtual nTexture2* NewRenderTarget(const nString& rsrcName, int width, int height, nTexture2::Format format, int usageFlags); virtual nInstanceStream* NewInstanceStream(const nString& rsrcName); virtual nOcclusionQuery* NewOcclusionQuery(); virtual void SetDisplayMode(const nDisplayMode2& mode); virtual const nDisplayMode2& GetDisplayMode() const; virtual void SetWindowTitle(const char* title); void SetFontScale(float s); float GetFontScale() const; void SetMinFontHeight(int s); int GetMinFontHeight() const; virtual void SetCamera(nCamera2& cam); void SetFeatureSetOverride(FeatureSet f); virtual FeatureSet GetFeatureSet(); virtual bool AreVertexShadersEmulated(); nCamera2& GetCamera(); virtual void SetViewport(nViewport& vp); virtual nViewport& GetViewport(); virtual bool OpenDisplay(); virtual void CloseDisplay(); virtual bool Trigger(); virtual int GetNumStencilBits() const; virtual int GetNumDepthBits() const; virtual void SetScissorRect(const rectangle& rect); const rectangle& GetScissorRect() const; virtual void SetClipPlanes(const nArray<plane>& planes); const nArray<plane>& GetClipPlanes() const; void SetHint(Hint hint, bool enable); bool GetHint(Hint hint) const; virtual void SetRenderTarget(int index, nTexture2* tex); nTexture2* GetRenderTarget(int index) const; virtual bool BeginFrame(); virtual bool BeginScene(); virtual void EndScene(); virtual void PresentScene(); virtual void EndFrame(); bool InBeginScene() const; virtual void Clear(int bufferTypes, float red, float green, float blue, float alpha, float z, int stencil); void SetLightingType(LightingType t); LightingType GetLightingType() const; virtual void ClearLights(); virtual void ClearPointLights(); virtual void ClearLight(int index); virtual int AddLight(const nLight& light); const nArray<nLight>& GetLightArray() const; virtual void SetMesh(nMesh2* vbMesh, nMesh2* ibMesh); nMesh2* GetMesh() const; virtual void SetMeshArray(nMeshArray* meshArray); nMeshArray* GetMeshArray() const; virtual void SetShader(nShader2* shader); nShader2* GetShader() const; virtual void SetFont(nFont2* font); nFont2* GetFont() const; void SetInstanceStream(nInstanceStream* stream); nInstanceStream* GetInstanceStream() const; virtual void SetTransform(TransformType type, const matrix44& matrix); const matrix44& GetTransform(TransformType type) const; void PushTransform(TransformType type, const matrix44& matrix); const matrix44& PopTransform(TransformType type); void SetVertexRange(int firstVertex, int numVertices); void SetIndexRange(int firstIndex, int numIndices); virtual void DrawIndexed(PrimitiveType primType); virtual void Draw(PrimitiveType primType); virtual void DrawIndexedNS(PrimitiveType primType); virtual void DrawNS(PrimitiveType primType); virtual void DrawText(const nString& text, const vector4& color, const rectangle& rect, uint flags, bool immediate=true); virtual vector2 GetTextExtent(const nString& text); void BreakLines(const nString& text, const rectangle& rect, nString& outString); virtual void Text(const nString& text, const vector4& color, float xPos, float yPos); virtual void DrawTextBuffer(); virtual void SetMouseCursor(const nMouseCursor& cursor); virtual const nMouseCursor& GetMouseCursor() const; virtual void SetCursorVisibility(CursorVisibility type); virtual CursorVisibility GetCursorVisibility() const; virtual void EnterDialogBoxMode(); virtual void LeaveDialogBoxMode(); bool InDialogBoxMode() const; virtual bool SaveScreenshot(const char* filename, nTexture2::FileFormat fileFormat); static FeatureSet StringToFeatureSet(const char* str); static const char* FeatureSetToString(FeatureSet f); static const vector4 GetShadowLightIndexVector(int shadowLightIndex, float value); DeviceIdentifier GetDeviceIdentifier() const; line3 ComputeWorldMouseRay(const vector2& mousePos, float length); void SetGamma(float g); void SetBrightness(float b); void SetContrast(float c); float GetGamma() const; float GetBrightness() const; float GetContrast() const; virtual void AdjustGamma(); virtual void RestoreGamma(); virtual void SetSkipMsgLoop(bool skip); virtual void BeginShapes(); virtual void DrawShape(ShapeType type, const matrix44& model, const vector4& color); virtual void DrawShapeNS(ShapeType type, const matrix44& model); virtual void DrawShapePrimitives(PrimitiveType type, int numPrimitives, const vector3* vertexList, int vertexWidth, const matrix44& model, const vector4& color); virtual void DrawShapeIndexedPrimitives(PrimitiveType type, int numPrimitives, const vector3* vertexList, int numVertices, int vertexWidth, void* indices, IndexType indexType, const matrix44& model, const vector4& color); virtual void EndShapes(); virtual void BeginLines(); virtual void DrawLines3d(const vector3* vertexList, int numVertices, const vector4& color); virtual void DrawLines2d(const vector2* vertexList, int numVertices, const vector4& color); virtual void EndLines(); private: static nGfxServer2* Singleton; protected: bool displayOpen; bool inBeginFrame; bool inBeginScene; bool inBeginLines; bool inBeginShapes; nAutoRef<nResourceServer> refResource; nCamera2 camera; nViewport viewport; nFixedArray<nRef<nTexture2> > refRenderTargets; nRef<nMesh2> refVbMesh; nRef<nMesh2> refIbMesh; nRef<nMeshArray> refMeshArray; nRef<nFont2> refFont; nRef<nShader2> refShader; nRef<nInstanceStream> refInstanceStream; nMouseCursor curMouseCursor; int vertexRangeFirst; int vertexRangeNum; int indexRangeFirst; int indexRangeNum; FeatureSet featureSetOverride; matrix44 transform[NumTransformTypes]; int transformTopOfStack[NumTransformTypes]; matrix44 transformStack[NumTransformTypes][MaxTransformStackDepth]; bool cursorDirty; bool inDialogBoxMode; nArray<nLight> lightArray; float gamma; float brightness; float contrast; float fontScale; int fontMinHeight; DeviceIdentifier deviceIdentifier; LightingType lightingType; rectangle scissorRect; uint hints; // currently set hints nArray<plane> clipPlanes; #if __NEBULA_STATS__ nProfiler profGUIBreakLines; nProfiler profGUIGetTextExtent; nProfiler profGUIDrawText; #endif public: CursorVisibility cursorVisibility; }; //------------------------------------------------------------------------------ inline nGfxServer2* nGfxServer2::Instance() { n_assert(Singleton); return Singleton; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetHint(Hint hint, bool enable) { if (enable) this->hints |= hint; else this->hints &= ~hint; } //------------------------------------------------------------------------------ inline bool nGfxServer2::GetHint(Hint hint) const { return (this->hints & hint) != 0; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetMinFontHeight(int s) { this->fontMinHeight = s; } //------------------------------------------------------------------------------ inline int nGfxServer2::GetMinFontHeight() const { return this->fontMinHeight; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetFontScale(float s) { this->fontScale = s; } //------------------------------------------------------------------------------ inline float nGfxServer2::GetFontScale() const { return this->fontScale; } //------------------------------------------------------------------------------ inline const nArray<nLight>& nGfxServer2::GetLightArray() const { return this->lightArray; } //------------------------------------------------------------------------------ inline nGfxServer2::FeatureSet nGfxServer2::StringToFeatureSet(const char* str) { n_assert(str); if (0 == strcmp(str, "dx7")) return DX7; if (0 == strcmp(str, "dx8")) return DX8; if (0 == strcmp(str, "dx8sb")) return DX8SB; if (0 == strcmp(str, "dx9")) return DX9; if (0 == strcmp(str, "dx9flt")) return DX9FLT; return InvalidFeatureSet; } //------------------------------------------------------------------------------ inline const char* nGfxServer2::FeatureSetToString(FeatureSet f) { switch (f) { case nGfxServer2::DX7: return "dx7"; case nGfxServer2::DX8: return "dx8"; case nGfxServer2::DX8SB: return "dx8sb"; case nGfxServer2::DX9: return "dx9"; case nGfxServer2::DX9FLT: return "dx9flt"; default: return "invalid"; } } //------------------------------------------------------------------------------ inline nViewport& nGfxServer2::GetViewport() { return this->viewport; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetFeatureSetOverride(FeatureSet f) { this->featureSetOverride = f; n_printf("nGfxServer2: set feature set override to '%s'\n", FeatureSetToString(f)); } //------------------------------------------------------------------------------ inline nCamera2& nGfxServer2::GetCamera() { return this->camera; } //------------------------------------------------------------------------------ inline nTexture2* nGfxServer2::GetRenderTarget(int index) const { return this->refRenderTargets[index].get_unsafe(); } //------------------------------------------------------------------------------ inline nInstanceStream* nGfxServer2::GetInstanceStream() const { return this->refInstanceStream.isvalid() ? this->refInstanceStream.get() : 0; } //------------------------------------------------------------------------------ inline nMeshArray* nGfxServer2::GetMeshArray() const { return this->refMeshArray.isvalid() ? this->refMeshArray.get() : 0; } //------------------------------------------------------------------------------ inline nShader2* nGfxServer2::GetShader() const { return this->refShader.isvalid() ? this->refShader.get() : 0; } //------------------------------------------------------------------------------ inline nFont2* nGfxServer2::GetFont() const { return this->refFont.isvalid() ? this->refFont.get() : 0; } //------------------------------------------------------------------------------ inline const matrix44& nGfxServer2::GetTransform(TransformType type) const { n_assert(type < NumTransformTypes); return this->transform[type]; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetVertexRange(int firstVertex, int numVertices) { this->vertexRangeFirst = firstVertex; this->vertexRangeNum = numVertices; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetIndexRange(int firstIndex, int numIndices) { this->indexRangeFirst = firstIndex; this->indexRangeNum = numIndices; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetGamma(float g) { this->gamma = g; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetBrightness(float b) { this->brightness = b; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetContrast(float c) { this->contrast = c; } //------------------------------------------------------------------------------ inline float nGfxServer2::GetGamma() const { return this->gamma; } //------------------------------------------------------------------------------ inline float nGfxServer2::GetBrightness() const { return this->brightness; } //------------------------------------------------------------------------------ inline float nGfxServer2::GetContrast() const { return this->contrast; } //------------------------------------------------------------------------------ inline nGfxServer2::DeviceIdentifier nGfxServer2::GetDeviceIdentifier() const { return this->deviceIdentifier; } //------------------------------------------------------------------------------ inline void nGfxServer2::SetLightingType(LightingType t) { this->lightingType = t; } //------------------------------------------------------------------------------ inline nGfxServer2::LightingType nGfxServer2::GetLightingType() const { return this->lightingType; } //------------------------------------------------------------------------------ inline bool nGfxServer2::InBeginScene() const { return this->inBeginScene; } //------------------------------------------------------------------------------ inline const rectangle& nGfxServer2::GetScissorRect() const { return this->scissorRect; } //------------------------------------------------------------------------------ inline const vector4 nGfxServer2::GetShadowLightIndexVector(int shadowLightIndex, float value) { // FIXME: lightIndex should be a bit field (shader must support this?), // so there can be 32 shadow casting lights at once, // or 8 shadow casting lights in a one channel map (e.g. only alpha write) vector4 indexColor; indexColor.x = (shadowLightIndex == 0) ? value : 0.0f; indexColor.y = (shadowLightIndex == 1) ? value : 0.0f; indexColor.z = (shadowLightIndex == 2) ? value : 0.0f; indexColor.w = (shadowLightIndex == 3) ? value : 0.0f; return indexColor; } //------------------------------------------------------------------------------ inline const nArray<plane>& nGfxServer2::GetClipPlanes() const { return this->clipPlanes; } //------------------------------------------------------------------------------ #endif Nebula Device 2 documentation generated by doxygen at Sun Apr 8 20:04:46 2007