From 779de2fcdca7943a4abf4426cb282a9ce9bc4621 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hugo=20H=C3=B6rnquist?= <hugo@hornquist.se>
Date: Thu, 6 Jun 2019 04:43:38 +0200
Subject: render: Add SDL_SetRenderTarget bindings.

* sdl2/bindings.scm (SDL_TEXTUREACCESS_STATIC,
  SDL_TEXTUREACCESS_STREAMING, SDL_TEXTUREACCESS_TARGET): New
  variables.
  (sdl-create-texture, sdl-set-render-target, sdl-get-render-target):
  New procedures.
* sdl2/render.scm (symbol->sdl-access-format, make-texture,
  set-render-target!, get-render-target): New procedures.
* doc/api.texi: Document new procedures.
---
 doc/api.texi | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

(limited to 'doc')

diff --git a/doc/api.texi b/doc/api.texi
index 44d6506..53a3e09 100644
--- a/doc/api.texi
+++ b/doc/api.texi
@@ -1098,6 +1098,29 @@ Fill @var{rectangle} onto @var{renderer}.
 Fill the list @var{rectangles} onto @var{renderer}.
 @end deffn
 
+@deffn {Procedure} set-render-target! renderer texture
+Sets the render target for @var{renderer} to @var{texture}, making all
+comming draw requests redirect to @var{texture}.
+
+Pass @code{#f} to reset it to the default target.
+@end deffn
+
+@deffn {Procedure} get-render-target renderer
+Returns the current render target of @var{renderer} or @code{#f} if
+it's a texture.
+@end deffn
+
+@deffn {Procedure} make-texture format access width height
+Returns a new texture for @var{renderer} with pixel @var{format}.
+@var{access} is one of the symbols:
+
+@itemize
+@item static, changes rarely, not lockable
+@item streaming, changes frequently, lockable
+@item target, can be used as a render target
+requires that renderer was created with the @code{texture} flag.
+@end itemize
+@end deffn
 
 @deffn {Procedure} surface->texture renderer surface
 Convert @var{surface} to a texture suitable for @var{renderer}.
-- 
cgit v1.2.3