2010-11-20 10:37:14 +00:00
|
|
|
/* (c) Magnus Auvinen. See licence.txt in the root of the distribution for more information. */
|
|
|
|
/* If you are missing that file, acquire a complete release at teeworlds.com. */
|
2010-05-29 07:25:38 +00:00
|
|
|
#ifndef ENGINE_GRAPHICS_H
|
|
|
|
#define ENGINE_GRAPHICS_H
|
|
|
|
|
|
|
|
#include "kernel.h"
|
|
|
|
|
2018-03-13 20:47:07 +00:00
|
|
|
#include <vector>
|
|
|
|
#define GRAPHICS_TYPE_UNSIGNED_BYTE 0x1401
|
|
|
|
#define GRAPHICS_TYPE_UNSIGNED_SHORT 0x1403
|
|
|
|
#define GRAPHICS_TYPE_INT 0x1404
|
|
|
|
#define GRAPHICS_TYPE_UNSIGNED_INT 0x1405
|
|
|
|
#define GRAPHICS_TYPE_FLOAT 0x1406
|
|
|
|
struct SBufferContainerInfo
|
|
|
|
{
|
|
|
|
int m_Stride;
|
|
|
|
|
|
|
|
// the attributes of the container
|
|
|
|
struct SAttribute
|
|
|
|
{
|
|
|
|
int m_DataTypeCount;
|
|
|
|
unsigned int m_Type;
|
|
|
|
bool m_Normalized;
|
|
|
|
void* m_pOffset;
|
|
|
|
|
|
|
|
//0: float, 1:integer
|
|
|
|
unsigned int m_FuncType;
|
|
|
|
|
|
|
|
int m_VertBufferBindingIndex;
|
|
|
|
};
|
|
|
|
std::vector<SAttribute> m_Attributes;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct SQuadRenderInfo
|
|
|
|
{
|
|
|
|
float m_aColor[4];
|
|
|
|
float m_aOffsets[2];
|
|
|
|
float m_Rotation;
|
|
|
|
};
|
2011-12-31 09:04:46 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
class CImageInfo
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
enum
|
|
|
|
{
|
|
|
|
FORMAT_AUTO=-1,
|
|
|
|
FORMAT_RGB=0,
|
|
|
|
FORMAT_RGBA=1,
|
|
|
|
FORMAT_ALPHA=2,
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Variable: width
|
|
|
|
Contains the width of the image */
|
|
|
|
int m_Width;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
/* Variable: height
|
|
|
|
Contains the height of the image */
|
|
|
|
int m_Height;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
/* Variable: format
|
|
|
|
Contains the format of the image. See <Image Formats> for more information. */
|
|
|
|
int m_Format;
|
|
|
|
|
|
|
|
/* Variable: data
|
|
|
|
Pointer to the image data. */
|
|
|
|
void *m_pData;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
Structure: CVideoMode
|
|
|
|
*/
|
|
|
|
class CVideoMode
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
int m_Width, m_Height;
|
|
|
|
int m_Red, m_Green, m_Blue;
|
|
|
|
};
|
|
|
|
|
|
|
|
class IGraphics : public IInterface
|
|
|
|
{
|
|
|
|
MACRO_INTERFACE("graphics", 0)
|
|
|
|
protected:
|
|
|
|
int m_ScreenWidth;
|
|
|
|
int m_ScreenHeight;
|
2015-08-24 20:46:28 +00:00
|
|
|
int m_DesktopScreenWidth;
|
|
|
|
int m_DesktopScreenHeight;
|
2010-05-29 07:25:38 +00:00
|
|
|
public:
|
|
|
|
/* Constants: Texture Loading Flags
|
|
|
|
TEXLOAD_NORESAMPLE - Prevents the texture from any resampling
|
|
|
|
*/
|
|
|
|
enum
|
|
|
|
{
|
2011-12-31 10:18:55 +00:00
|
|
|
TEXLOAD_NORESAMPLE = 1,
|
|
|
|
TEXLOAD_NOMIPMAPS = 2,
|
2010-05-29 07:25:38 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
int ScreenWidth() const { return m_ScreenWidth; }
|
|
|
|
int ScreenHeight() const { return m_ScreenHeight; }
|
|
|
|
float ScreenAspect() const { return (float)ScreenWidth()/(float)ScreenHeight(); }
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2016-04-29 19:07:10 +00:00
|
|
|
virtual bool Fullscreen(bool State) = 0;
|
2016-04-29 22:34:12 +00:00
|
|
|
virtual void SetWindowBordered(bool State) = 0;
|
|
|
|
virtual bool SetWindowScreen(int Index) = 0;
|
|
|
|
virtual bool SetVSync(bool State) = 0;
|
|
|
|
virtual int GetWindowScreen() = 0;
|
2016-04-30 15:59:58 +00:00
|
|
|
virtual void Resize(int w, int h) = 0;
|
2016-04-29 19:07:10 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void Clear(float r, float g, float b) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void ClipEnable(int x, int y, int w, int h) = 0;
|
|
|
|
virtual void ClipDisable() = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void MapScreen(float TopLeftX, float TopLeftY, float BottomRightX, float BottomRightY) = 0;
|
|
|
|
virtual void GetScreen(float *pTopLeftX, float *pTopLeftY, float *pBottomRightX, float *pBottomRightY) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
// TODO: These should perhaps not be virtuals
|
|
|
|
virtual void BlendNone() = 0;
|
|
|
|
virtual void BlendNormal() = 0;
|
|
|
|
virtual void BlendAdditive() = 0;
|
2012-01-08 00:47:53 +00:00
|
|
|
virtual void WrapNormal() = 0;
|
|
|
|
virtual void WrapClamp() = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual int MemoryUsage() const = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2011-07-25 16:28:02 +00:00
|
|
|
virtual int LoadPNG(CImageInfo *pImg, const char *pFilename, int StorageType) = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual int UnloadTexture(int Index) = 0;
|
|
|
|
virtual int LoadTextureRaw(int Width, int Height, int Format, const void *pData, int StoreFormat, int Flags) = 0;
|
2010-10-06 21:07:35 +00:00
|
|
|
virtual int LoadTexture(const char *pFilename, int StorageType, int StoreFormat, int Flags) = 0;
|
2011-12-31 08:40:11 +00:00
|
|
|
virtual int LoadTextureRawSub(int TextureID, int x, int y, int Width, int Height, int Format, const void *pData) = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void TextureSet(int TextureID) = 0;
|
2018-03-13 20:47:07 +00:00
|
|
|
|
|
|
|
virtual void FlushVertices(bool KeepVertices = false) = 0;
|
|
|
|
virtual void FlushTextVertices(int TextureSize, int TextTextureIndex, int TextOutlineTextureIndex, float* pOutlineTextColor) = 0;
|
|
|
|
|
|
|
|
// specific render functions
|
|
|
|
virtual void RenderTileLayer(int BufferContainerIndex, float* pColor, char** pOffsets, unsigned int* IndicedVertexDrawNum, size_t NumIndicesOffet) = 0;
|
|
|
|
virtual void RenderBorderTiles(int BufferContainerIndex, float* pColor, char* pOffset, float* Offset, float* Dir, int JumpIndex, unsigned int DrawNum) = 0;
|
|
|
|
virtual void RenderBorderTileLines(int BufferContainerIndex, float* pColor, char* pOffset, float* Dir, unsigned int IndexDrawNum, unsigned int RedrawNum) = 0;
|
|
|
|
virtual void RenderQuadLayer(int BufferContainerIndex, SQuadRenderInfo* pQuadInfo, int QuadNum) = 0;
|
|
|
|
virtual void RenderText(int BufferContainerIndex, int TextQuadNum, int TextureSize, int TextureTextIndex, int TextureTextOutlineIndex, float* pTextColor, float* pTextoutlineColor) = 0;
|
2017-09-12 18:11:47 +00:00
|
|
|
|
2018-03-13 20:47:07 +00:00
|
|
|
// opengl 3.3 functions
|
|
|
|
virtual int CreateBufferObject(size_t UploadDataSize, void* pUploadData) = 0;
|
|
|
|
virtual void RecreateBufferObject(int BufferIndex, size_t UploadDataSize, void* pUploadData) = 0;
|
|
|
|
virtual void UpdateBufferObject(int BufferIndex, size_t UploadDataSize, void* pUploadData, void* pOffset) = 0;
|
|
|
|
virtual void CopyBufferObject(int WriteBufferIndex, int ReadBufferIndex, size_t WriteOffset, size_t ReadOffset, size_t CopyDataSize) = 0;
|
|
|
|
virtual void DeleteBufferObject(int BufferIndex) = 0;
|
|
|
|
|
|
|
|
virtual int CreateBufferContainer(struct SBufferContainerInfo *pContainerInfo) = 0;
|
|
|
|
// destroying all buffer objects means, that all referenced VBOs are destroyed automatically, so the user does not need to save references to them
|
|
|
|
virtual void DeleteBufferContainer(int ContainerIndex, bool DestroyAllBO = true) = 0;
|
|
|
|
virtual void UpdateBufferContainer(int ContainerIndex, struct SBufferContainerInfo *pContainerInfo) = 0;
|
|
|
|
virtual void IndicesNumRequiredNotify(unsigned int RequiredIndicesCount) = 0;
|
|
|
|
|
2017-09-12 18:11:47 +00:00
|
|
|
virtual bool IsBufferingEnabled() = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
struct CLineItem
|
|
|
|
{
|
|
|
|
float m_X0, m_Y0, m_X1, m_Y1;
|
|
|
|
CLineItem() {}
|
|
|
|
CLineItem(float x0, float y0, float x1, float y1) : m_X0(x0), m_Y0(y0), m_X1(x1), m_Y1(y1) {}
|
|
|
|
};
|
|
|
|
virtual void LinesBegin() = 0;
|
|
|
|
virtual void LinesEnd() = 0;
|
|
|
|
virtual void LinesDraw(const CLineItem *pArray, int Num) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void QuadsBegin() = 0;
|
|
|
|
virtual void QuadsEnd() = 0;
|
2018-03-13 20:47:07 +00:00
|
|
|
virtual void TextQuadsBegin() = 0;
|
|
|
|
virtual void TextQuadsEnd(int TextureSize, int TextTextureIndex, int TextOutlineTextureIndex, float* pOutlineTextColor) = 0;
|
|
|
|
virtual void QuadsEndKeepVertices() = 0;
|
|
|
|
virtual void QuadsDrawCurrentVertices(bool KeepVertices = true) = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void QuadsSetRotation(float Angle) = 0;
|
2014-08-16 14:50:01 +00:00
|
|
|
virtual void QuadsSetSubset(float TopLeftU, float TopLeftV, float BottomRightU, float BottomRightV) = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void QuadsSetSubsetFree(float x0, float y0, float x1, float y1, float x2, float y2, float x3, float y3) = 0;
|
2018-03-13 20:47:07 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
struct CQuadItem
|
|
|
|
{
|
|
|
|
float m_X, m_Y, m_Width, m_Height;
|
|
|
|
CQuadItem() {}
|
|
|
|
CQuadItem(float x, float y, float w, float h) : m_X(x), m_Y(y), m_Width(w), m_Height(h) {}
|
2018-03-13 20:47:07 +00:00
|
|
|
void Set(float x, float y, float w, float h) { m_X = x; m_Y = y; m_Width = w; m_Height = h; }
|
2010-05-29 07:25:38 +00:00
|
|
|
};
|
|
|
|
virtual void QuadsDraw(CQuadItem *pArray, int Num) = 0;
|
|
|
|
virtual void QuadsDrawTL(const CQuadItem *pArray, int Num) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
struct CFreeformItem
|
|
|
|
{
|
|
|
|
float m_X0, m_Y0, m_X1, m_Y1, m_X2, m_Y2, m_X3, m_Y3;
|
|
|
|
CFreeformItem() {}
|
|
|
|
CFreeformItem(float x0, float y0, float x1, float y1, float x2, float y2, float x3, float y3)
|
|
|
|
: m_X0(x0), m_Y0(y0), m_X1(x1), m_Y1(y1), m_X2(x2), m_Y2(y2), m_X3(x3), m_Y3(y3) {}
|
|
|
|
};
|
2018-03-13 20:47:07 +00:00
|
|
|
|
|
|
|
virtual int CreateQuadContainer() = 0;
|
|
|
|
virtual void QuadContainerAddQuads(int ContainerIndex, CQuadItem *pArray, int Num) = 0;
|
|
|
|
virtual void QuadContainerAddQuads(int ContainerIndex, CFreeformItem *pArray, int Num) = 0;
|
|
|
|
virtual void QuadContainerReset(int ContainerIndex) = 0;
|
|
|
|
virtual void DeleteQuadContainer(int ContainerIndex) = 0;
|
|
|
|
virtual void RenderQuadContainer(int ContainerIndex, int QuadDrawNum) = 0;
|
|
|
|
virtual void RenderQuadContainer(int ContainerIndex, int QuadOffset, int QuadDrawNum) = 0;
|
|
|
|
virtual void RenderQuadContainerAsSprite(int ContainerIndex, int QuadOffset, float X, float Y, float ScaleX = 1.f, float ScaleY = 1.f) = 0;
|
|
|
|
|
|
|
|
struct SRenderSpriteInfo
|
|
|
|
{
|
|
|
|
float m_Pos[2];
|
|
|
|
float m_Scale;
|
|
|
|
float m_Rotation;
|
|
|
|
};
|
|
|
|
|
|
|
|
virtual void RenderQuadContainerAsSpriteMultiple(int ContainerIndex, int QuadOffset, int DrawCount, SRenderSpriteInfo *pRenderInfo) = 0;
|
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void QuadsDrawFreeform(const CFreeformItem *pArray, int Num) = 0;
|
2012-10-14 12:04:48 +00:00
|
|
|
virtual void QuadsText(float x, float y, float Size, const char *pText) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
struct CColorVertex
|
|
|
|
{
|
|
|
|
int m_Index;
|
|
|
|
float m_R, m_G, m_B, m_A;
|
|
|
|
CColorVertex() {}
|
|
|
|
CColorVertex(int i, float r, float g, float b, float a) : m_Index(i), m_R(r), m_G(g), m_B(b), m_A(a) {}
|
|
|
|
};
|
|
|
|
virtual void SetColorVertex(const CColorVertex *pArray, int Num) = 0;
|
|
|
|
virtual void SetColor(float r, float g, float b, float a) = 0;
|
2018-03-13 20:47:07 +00:00
|
|
|
virtual void ChangeColorOfCurrentQuadVertices(float r, float g, float b, float a) = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-12-12 15:48:13 +00:00
|
|
|
virtual void TakeScreenshot(const char *pFilename) = 0;
|
2014-01-19 03:02:01 +00:00
|
|
|
virtual void TakeCustomScreenshot(const char *pFilename) = 0;
|
2015-08-24 20:46:28 +00:00
|
|
|
virtual int GetVideoModes(CVideoMode *pModes, int MaxModes, int Screen) = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
|
|
|
|
virtual void Swap() = 0;
|
2016-04-29 22:34:12 +00:00
|
|
|
virtual int GetNumScreens() const = 0;
|
2011-12-31 09:04:46 +00:00
|
|
|
|
2018-02-04 15:00:47 +00:00
|
|
|
// synchronization
|
2012-02-05 12:22:39 +00:00
|
|
|
virtual void InsertSignal(class semaphore *pSemaphore) = 0;
|
2011-12-31 09:04:46 +00:00
|
|
|
virtual bool IsIdle() = 0;
|
|
|
|
virtual void WaitForIdle() = 0;
|
2014-10-18 14:17:36 +00:00
|
|
|
|
2015-08-24 23:01:38 +00:00
|
|
|
virtual void SetWindowGrab(bool Grab) = 0;
|
2014-10-18 14:17:36 +00:00
|
|
|
virtual void NotifyWindow() = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class IEngineGraphics : public IGraphics
|
|
|
|
{
|
|
|
|
MACRO_INTERFACE("enginegraphics", 0)
|
|
|
|
public:
|
2012-01-03 20:39:10 +00:00
|
|
|
virtual int Init() = 0;
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void Shutdown() = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual void Minimize() = 0;
|
|
|
|
virtual void Maximize() = 0;
|
2011-04-13 18:37:12 +00:00
|
|
|
|
2010-05-29 07:25:38 +00:00
|
|
|
virtual int WindowActive() = 0;
|
|
|
|
virtual int WindowOpen() = 0;
|
|
|
|
};
|
|
|
|
|
|
|
|
extern IEngineGraphics *CreateEngineGraphics();
|
2011-12-31 09:29:25 +00:00
|
|
|
extern IEngineGraphics *CreateEngineGraphicsThreaded();
|
2010-05-29 07:25:38 +00:00
|
|
|
|
|
|
|
#endif
|