mirror of
https://github.com/love2d/love.git
synced 2026-08-16 00:02:12 +02:00
Alex Szpakowski
3e80ec2257
- Removed love.graphics.set/getCanvas, Canvas:renderTo, Canvas:newImageData, love.graphics.clear, love.graphics.discard, and love.graphics.newScreenshot.
- Added love.graphics.beginPass and love.graphics.endPass. All rendering must happen within a pass. love.draw is now called while a render pass to the main screen is active.
- Added love.graphics.renderPass, which is a wrapper for begin/endPass which calls the supplied function argument in between a begin/end. This is similar to the old Canvas:renderTo.
- Added love.graphics.isPassActive, getPassCanvases, getPassWidth, getPassHeight, and getPassDimensions.
- Added love.graphics.captureScreenshot.
- Added a new love.run callback love.drawpasses, which is called after love.update and before love.draw. It is the place to render to Canvases using beginPass or renderPass, since love.draw now always draws to the main screen.
- Renamed the ‘canvasswitches’ field in the table returned by love.graphics.getStats to ‘renderpasses’.
love.graphics.beginPass has the following variants (and renderPass mirrors them with an additional function argument at the end):
- love.graphics.beginPass(), begins rendering to the main screen without clearing it.
- love.graphics.beginPass(r, g, b [, a]), begins rendering to the main screen and clears the screen to the specified color.
- love.graphics.beginPass(canvas [, willstencil]), begins rendering to the specified Canvas without clearing it. love.graphics.stencil can only be used within the Canvas if ‘willstencil’ is true.
- love.graphics.beginPass(canvas, r, g, b [, a] [, willstencil]), beings rendering to the specified Canvas and clears it to the specified color. love.graphics.stencil can only be used within the Canvas if ‘willstencil’ is true.
- love.graphics.beginPass(info), where ‘info’ is a table in the following form:
{
{canvas [, r, g, b, a]}, — A canvas and an optional color to clear the Canvas to when the pass begins.
{canvas2, [r, g, b, a]}, — Additional Canvases and optional clear colors for multi-canvas rendering.
…,
stencil = false, — Optional boolean field to specify whether love.graphics.stencil is allowed within this pass. False by default.
}
The pass info table can be created once up-front and used for multiple beginPass/renderPass calls.
love.graphics.endPass can take an optional callback function argument, which causes endPass to capture the contents of the Canvas drawn to in the render pass to a new ImageData and passes it to the supplied function (this replaces Canvas:newImageData). This does not work on the main screen.
love.graphics.captureScreenshot replaces love.graphics.newScreenshot. It takes a callback function argument which causes love.graphics.present to capture the contents of the screen to a new ImageData and passes it to the supplied function. captureScreenshot can only be called before drawing to the main screen begins in the current frame (e.g. in love.keypressed, love.update, etc.)
--HG--
branch : minor
163 lines
4.1 KiB
C++
163 lines
4.1 KiB
C++
/**
|
|
* Copyright (c) 2006-2016 LOVE Development Team
|
|
*
|
|
* This software is provided 'as-is', without any express or implied
|
|
* warranty. In no event will the authors be held liable for any damages
|
|
* arising from the use of this software.
|
|
*
|
|
* Permission is granted to anyone to use this software for any purpose,
|
|
* including commercial applications, and to alter it and redistribute it
|
|
* freely, subject to the following restrictions:
|
|
*
|
|
* 1. The origin of this software must not be misrepresented; you must not
|
|
* claim that you wrote the original software. If you use this software
|
|
* in a product, an acknowledgment in the product documentation would be
|
|
* appreciated but is not required.
|
|
* 2. Altered source versions must be plainly marked as such, and must not be
|
|
* misrepresented as being the original software.
|
|
* 3. This notice may not be removed or altered from any source distribution.
|
|
**/
|
|
|
|
#ifndef LOVE_WINDOW_SDL_WINDOW_H
|
|
#define LOVE_WINDOW_SDL_WINDOW_H
|
|
|
|
// LOVE
|
|
#include "window/Window.h"
|
|
|
|
// SDL
|
|
#include <SDL.h>
|
|
|
|
namespace love
|
|
{
|
|
namespace window
|
|
{
|
|
namespace sdl
|
|
{
|
|
|
|
class Window : public love::window::Window
|
|
{
|
|
public:
|
|
|
|
Window();
|
|
~Window();
|
|
|
|
void setGraphics(graphics::Graphics *graphics);
|
|
|
|
bool setWindow(int width = 800, int height = 600, WindowSettings *settings = nullptr);
|
|
void getWindow(int &width, int &height, WindowSettings &settings);
|
|
|
|
void close();
|
|
|
|
bool setFullscreen(bool fullscreen, FullscreenType fstype);
|
|
bool setFullscreen(bool fullscreen);
|
|
|
|
bool onSizeChanged(int width, int height);
|
|
|
|
int getDisplayCount() const;
|
|
|
|
const char *getDisplayName(int displayindex) const;
|
|
|
|
std::vector<WindowSize> getFullscreenSizes(int displayindex) const;
|
|
|
|
void getDesktopDimensions(int displayindex, int &width, int &height) const;
|
|
|
|
void setPosition(int x, int y, int displayindex);
|
|
void getPosition(int &x, int &y, int &displayindex);
|
|
|
|
bool isOpen() const;
|
|
|
|
void setWindowTitle(const std::string &title);
|
|
const std::string &getWindowTitle() const;
|
|
|
|
bool setIcon(love::image::ImageData *imgd);
|
|
love::image::ImageData *getIcon();
|
|
|
|
void setDisplaySleepEnabled(bool enable);
|
|
bool isDisplaySleepEnabled() const;
|
|
|
|
void minimize();
|
|
void maximize();
|
|
|
|
bool isMaximized() const;
|
|
|
|
void swapBuffers();
|
|
|
|
bool hasFocus() const;
|
|
bool hasMouseFocus() const;
|
|
|
|
bool isVisible() const;
|
|
|
|
void setMouseGrab(bool grab);
|
|
bool isMouseGrabbed() const;
|
|
|
|
void getPixelDimensions(int &w, int &h) const;
|
|
void windowToPixelCoords(double *x, double *y) const;
|
|
void pixelToWindowCoords(double *x, double *y) const;
|
|
|
|
double getPixelScale() const;
|
|
|
|
double toPixels(double x) const;
|
|
void toPixels(double wx, double wy, double &px, double &py) const;
|
|
double fromPixels(double x) const;
|
|
void fromPixels(double px, double py, double &wx, double &wy) const;
|
|
|
|
const void *getHandle() const;
|
|
|
|
bool showMessageBox(const std::string &title, const std::string &message, MessageBoxType type, bool attachtowindow);
|
|
int showMessageBox(const MessageBoxData &data);
|
|
|
|
void requestAttention(bool continuous);
|
|
|
|
const char *getName() const;
|
|
|
|
private:
|
|
|
|
struct ContextAttribs
|
|
{
|
|
int versionMajor;
|
|
int versionMinor;
|
|
bool gles;
|
|
bool debug;
|
|
};
|
|
|
|
void setGLFramebufferAttributes(int msaa, bool sRGB);
|
|
void setGLContextAttributes(const ContextAttribs &attribs);
|
|
bool checkGLVersion(const ContextAttribs &attribs, std::string &outversion);
|
|
std::vector<ContextAttribs> getContextAttribsList() const;
|
|
bool createWindowAndContext(int x, int y, int w, int h, Uint32 windowflags, int msaa);
|
|
|
|
// Update the saved window settings based on the window's actual state.
|
|
void updateSettings(const WindowSettings &newsettings, bool updateGraphicsViewport);
|
|
|
|
SDL_MessageBoxFlags convertMessageBoxType(MessageBoxType type) const;
|
|
|
|
std::string title;
|
|
|
|
int windowWidth = 800;
|
|
int windowHeight = 600;
|
|
int pixelWidth = 800;
|
|
int pixelHeight = 600;
|
|
WindowSettings settings;
|
|
StrongRef<love::image::ImageData> icon;
|
|
|
|
bool open;
|
|
|
|
bool mouseGrabbed;
|
|
|
|
SDL_Window *window;
|
|
SDL_GLContext context;
|
|
|
|
bool displayedWindowError;
|
|
bool hasSDL203orEarlier;
|
|
ContextAttribs contextAttribs;
|
|
|
|
StrongRef<graphics::Graphics> graphics;
|
|
|
|
}; // Window
|
|
|
|
} // sdl
|
|
} // window
|
|
} // love
|
|
|
|
#endif // LOVE_WINDOW_WINDOW_H
|