graphics.h

Go to the documentation of this file.

/*
 *  The ManaPlus Client
 *  Copyright (C) 2004-2009  The Mana World Development Team
 *  Copyright (C) 2009-2010  The Mana Developers
 *  Copyright (C) 2011-2019  The ManaPlus Developers
 *  Copyright (C) 2019-2021  Andrei Karas
 *
 *  This file is part of The ManaPlus Client.
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
/*      _______   __   __   __   ______   __   __   _______   __   __
 *     / _____/\ / /\ / /\ / /\ / ____/\ / /\ / /\ / ___  /\ /  |\/ /\
 *    / /\____\// / // / // / // /\___\// /_// / // /\_/ / // , |/ / /
 *   / / /__   / / // / // / // / /    / ___  / // ___  / // /| ' / /
 *  / /_// /\ / /_// / // / // /_/_   / / // / // /\_/ / // / |  / /
 * /______/ //______/ //_/ //_____/\ /_/ //_/ //_/ //_/ //_/ /|_/ /
 * \______\/ \______\/ \_\/ \_____\/ \_\/ \_\/ \_\/ \_\/ \_\/ \_\/
 *
 * Copyright (c) 2004 - 2008 Olof Naessén and Per Larsson
 *
 *
 * Per Larsson a.k.a finalman
 * Olof Naessén a.k.a jansem/yakslem
 *
 * Visit: http://guichan.sourceforge.net
 *
 * License: (BSD)
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 * 3. Neither the name of Guichan nor the names of its contributors may
 *    be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef RENDER_GRAPHICS_H
#define RENDER_GRAPHICS_H
 
#include "sdlshared.h"
 
#include "enums/render/rendertype.h"
 
#include "gui/color.h"
#include "gui/cliprect.h"
 
#include "resources/mstack.h"
 
PRAGMA48(GCC diagnostic push)
PRAGMA48(GCC diagnostic ignored "-Wshadow")
#ifdef USE_SDL2
#include <SDL_render.h>
#else  // USE_SDL2
#include <SDL_video.h>
#endif  // USE_SDL2
PRAGMA48(GCC diagnostic pop)
 
#include "localconsts.h"
 
#ifdef USE_SDL2
#define RectPos int32_t
#define RectSize int32_t
#else  // USE_SDL2
#define RectPos int16_t
#define RectSize uint16_t
#endif  // USE_SDL2
 
class Image;
class ImageCollection;
class ImageRect;
class ImageVertexes;
 
struct SDL_Window;
 
class Graphics notfinal
{
    public:
#ifdef USE_OPENGL
        friend class OpenGLScreenshotHelper;
#endif  // USE_SDL2
 
        friend class SdlScreenshotHelper;
 
        A_DELETE_COPY(Graphics)
 
        
        virtual ~Graphics();
 
        static void cleanUp();
 
        enum Alignment
        {
            LEFT = 0,
            CENTER,
            RIGHT
        };
 
        void setWindow(SDL_Window *restrict const window,
                       const int width, const int height) restrict2 noexcept2
        {
            mWindow = window;
            mRect.w = static_cast<RectSize>(width);
            mRect.h = static_cast<RectSize>(height);
        }
 
        SDL_Window *getWindow() const restrict2 noexcept2
        { return mWindow; }
 
        void setSync(const bool sync) restrict2;
 
        bool getSync() const restrict2 noexcept2 A_WARN_UNUSED
        { return mSync; }
 
        virtual bool setVideoMode(const int w, const int h,
                                  const int scale,
                                  const int bpp,
                                  const bool fs,
                                  const bool hwaccel,
                                  const bool resize,
                                  const bool noFrame,
                                  const bool allowHighDPI) restrict2 = 0;
 
        bool setFullscreen(const bool fs) restrict2;
 
        virtual bool resizeScreen(const int width,
                                  const int height) restrict2;
 
        virtual void restoreContext() restrict2
        { }
 
        virtual void drawRescaledImage(const Image *restrict const image,
                                       int dstX, int dstY,
                                       const int desiredWidth,
                                       const int desiredHeight) restrict2 = 0;
 
        virtual void drawPattern(const Image *restrict const image,
                                 const int x, const int y,
                                 const int w, const int h) restrict2 = 0;
 
        virtual void drawRescaledPattern(const Image *restrict const image,
                                         const int x, const int y,
                                         const int w, const int h,
                                         const int scaledWidth,
                                         const int scaledHeight) restrict2 = 0;
 
        virtual void drawImageRect(const int x, const int y,
                                   const int w, const int h,
                                   const ImageRect &restrict imgRect)
                                   restrict2 = 0;
 
        virtual void calcPattern(ImageVertexes *restrict const vert,
                                 const Image *restrict const image,
                                 const int x, const int y,
                                 const int w, const int h) const restrict2 = 0;
 
        virtual void calcPattern(ImageCollection *restrict const vert,
                                 const Image *restrict const image,
                                 const int x, const int y,
                                 const int w, const int h) const restrict2 = 0;
 
        virtual void calcTileVertexes(ImageVertexes *restrict const vert,
                                      const Image *restrict const image,
                                      int x,
                                      int y) const restrict2 A_NONNULL(2, 3)
                                      = 0;
 
        virtual void calcTileSDL(ImageVertexes *restrict const vert A_UNUSED,
                                 int x A_UNUSED,
                                 int y A_UNUSED) const restrict2
        {
        }
 
        virtual void drawTileVertexes(const ImageVertexes *restrict const vert)
                                      restrict2 = 0;
 
        virtual void drawTileCollection(const ImageCollection
                                        *restrict const vertCol) restrict2
                                        A_NONNULL(2) = 0;
 
        virtual void calcTileCollection(ImageCollection *restrict const
                                        vertCol,
                                        const Image *restrict const image,
                                        int x,
                                        int y) restrict2 = 0;
 
        virtual void calcWindow(ImageCollection *restrict const vertCol,
                                const int x, const int y,
                                const int w, const int h,
                                const ImageRect &restrict imgRect)
                                restrict2 A_NONNULL(2) = 0;
 
        virtual void fillRectangle(const Rect &restrict rectangle)
                                   restrict2 = 0;
 
        virtual void updateScreen() restrict2 = 0;
 
        void setWindowSize(const int width,
#ifdef USE_SDL2
            const int height) restrict2;
#else  // USE_SDL2
            const int height) restrict2;
#endif  // USE_SDL2
 
        int getWidth() const restrict2 A_WARN_UNUSED;
 
        int getHeight() const restrict2 A_WARN_UNUSED;
 
        int getMemoryUsage() const restrict2 A_WARN_UNUSED;
 
        virtual void drawNet(const int x1, const int y1,
                             const int x2, const int y2,
                             const int width, const int height) restrict2;
 
        ClipRect &getTopClip() const restrict2 A_WARN_UNUSED
        { return mClipStack.top(); }
 
        void setRedraw(const bool n) restrict2 noexcept2
        { mRedraw = n; }
 
        bool getRedraw() const restrict2 noexcept2 A_WARN_UNUSED
        { return mRedraw; }
 
        void setSecure(const bool n) restrict2 noexcept2
        { mSecure = n; }
 
        bool getSecure() const restrict2 noexcept2 A_WARN_UNUSED
        { return mSecure; }
 
        int getBpp() const restrict2 noexcept2 A_WARN_UNUSED
        { return mBpp; }
 
        bool getFullScreen() const restrict2 noexcept2 A_WARN_UNUSED
        { return mFullscreen; }
 
        bool getHWAccel() const restrict2 noexcept2 A_WARN_UNUSED
        { return mHWAccel; }
 
        bool getDoubleBuffer() const restrict2 noexcept2 A_WARN_UNUSED
        { return mDoubleBuffer; }
 
        RenderType getOpenGL() const restrict2 noexcept2 A_WARN_UNUSED
        { return mOpenGL; }
 
        void setNoFrame(const bool n) restrict2 noexcept2
        { mNoFrame = n; }
 
        const std::string &getName() const restrict2 noexcept2 A_WARN_UNUSED
        { return mName; }
 
        virtual void initArrays(const int vertCount A_UNUSED) restrict2
        { }
 
        virtual void setColor(const Color &restrict color) restrict2
        {
            mColor = color;
            mAlpha = (color.a != 255);
        }
 
        const Color &getColor() const restrict2 noexcept2
        { return mColor; }
 
#ifdef DEBUG_DRAW_CALLS
        virtual unsigned int getDrawCalls() const restrict2
        { return 0; }
#endif  // DEBUG_DRAW_CALLS
#ifdef DEBUG_BIND_TEXTURE
        virtual unsigned int getBinds() const restrict2
        { return 0; }
#endif  // DEBUG_BIND_TEXTURE
#ifdef USE_SDL2
        void dumpRendererInfo(const char *restrict const str,
                              const SDL_RendererInfo &restrict info) restrict2;
 
        virtual void setRendererFlags(const uint32_t flags A_UNUSED) restrict2
        { }
#endif  // USE_SDL2
 
        virtual void drawImage(const Image *restrict const image,
                               int dstX, int dstY) restrict2 = 0;
 
        virtual void copyImage(const Image *restrict const image,
                               int dstX, int dstY) restrict2 = 0;
 
        virtual void drawImageCached(const Image *restrict const image,
                                     int srcX, int srcY) restrict2 = 0;
 
        virtual void drawPatternCached(const Image *restrict const image,
                                       const int x, const int y,
                                       const int w, const int h) restrict2 = 0;
 
        virtual void completeCache() restrict2 = 0;
 
        int getScale() const restrict2 noexcept2
        { return mScale; }
 
        virtual bool isAllowScale() const restrict2 noexcept2
        { return false; }
 
        void setScale(int scale) restrict2;
 
        virtual void pushClipArea(const Rect &restrict area) restrict2;
 
        virtual void popClipArea() restrict2;
 
        virtual void drawLine(int x1, int y1,
                              int x2, int y2) restrict2 = 0;
 
        virtual void drawRectangle(const Rect &restrict rectangle)
                                   restrict2 = 0;
 
#ifdef USE_OPENGL
#ifdef USE_SDL2
        virtual void createGLContext(const bool custom) restrict2;
#else  // USE_SDL2
 
        virtual void createGLContext(const bool custom) restrict2;
#endif  // USE_SDL2
#endif  // USE_OPENGL
 
        virtual void drawPoint(int x, int y) restrict2 = 0;
 
        virtual void beginDraw() restrict2
        { }
 
        virtual void endDraw() restrict2
        { }
 
        virtual void clearScreen() const restrict2
        { }
 
        virtual void deleteArrays() restrict2
        { }
 
        virtual void postInit() restrict2
        { }
 
        virtual void finalize(ImageCollection *restrict const col A_UNUSED)
                              restrict2
        { }
 
        virtual void finalize(ImageVertexes *restrict const vert A_UNUSED)
                              restrict2
        { }
 
        virtual void testDraw() restrict2
        { }
 
        virtual void removeArray(const uint32_t sz A_UNUSED,
                                 uint32_t *restrict const arr A_UNUSED)
                                 restrict2
        { }
 
        virtual void screenResized() restrict2
        { }
 
        int mWidth;
        int mHeight;
        int mActualWidth;
        int mActualHeight;
 
    protected:
        Graphics();
 
        void setMainFlags(const int w, const int h,
                          const int scale,
                          const int bpp,
                          const bool fs,
                          const bool hwaccel,
                          const bool resize,
                          const bool noFrame,
                          const bool allowHighDPI) restrict2;
 
        int getOpenGLFlags() const restrict2 A_WARN_UNUSED;
 
        int getSoftwareFlags() const restrict2 A_WARN_UNUSED;
 
        bool setOpenGLMode() restrict2;
 
        void updateMemoryInfo() restrict2;
 
        bool videoInfo() restrict2;
 
#ifdef USE_OPENGL
        void setOpenGLFlags() restrict2;
#endif  // USE_OPENGL
 
        MStack<ClipRect> mClipStack;
 
        SDL_Window *restrict mWindow;
 
#ifdef USE_SDL2
        static SDL_Renderer *restrict mRenderer;
#endif  // USE_SDL2
#ifdef USE_OPENGL
#ifdef USE_SDL2
        static SDL_GLContext mGLContext;
#else  // USE_SDL2
 
        static void *restrict mGLContext;
#endif  // USE_SDL2
#endif  // USE_OPENGL
 
        int mBpp;
        bool mAlpha;
        bool mFullscreen;
        bool mHWAccel;
        bool mRedraw;
        bool mDoubleBuffer;
        SDL_Rect mRect;
        bool mSecure;
        RenderType mOpenGL;
        bool mEnableResize;
        bool mNoFrame;
        bool mAllowHighDPI;
        std::string mName;
        int mStartFreeMem;
        bool mSync;
        int mScale;
        Color mColor;
};
 
extern Graphics *mainGraphics A_NONNULLPOINTER;
 
#endif  // RENDER_GRAPHICS_H