summaryrefslogtreecommitdiff
path: root/sly/render/camera.scm
blob: f5921e35403538c6cf9bbebe5ad5bac7fe14cbc7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
;;; Sly
;;; Copyright (C) 2014 David Thompson <davet@gnu.org>
;;;
;;; Sly 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 3 of the License, or
;;; (at your option) any later version.
;;;
;;; Sly 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/>.

;;; Commentary:
;;
;; Cameras and viewports.
;;
;;; Code:

(define-module (sly render camera)
  #:use-module (ice-9 match)
  #:use-module (srfi srfi-9)
  #:use-module (gl)
  #:use-module (gl low-level)
  #:use-module (gl enums)
  #:use-module (sly wrappers gl)
  #:use-module (sly helpers)
  #:use-module (sly color)
  #:use-module (sly rect)
  #:use-module (sly transform)
  #:export (make-viewport viewport?
            viewport-area viewport-clear-color viewport-clear-flags
            %standard-clear-flags apply-viewport
            make-camera camera?
            camera-location camera-projection camera-viewport
            orthographic-camera))

;;;
;;; Viewport
;;;

(define-record-type <viewport>
  (%make-viewport area clear-color clear-flags)
  viewport?
  (area viewport-area)
  (clear-color viewport-clear-color)
  (clear-flags viewport-clear-flags))

(define %standard-clear-flags '(color-buffer depth-buffer))

(define* (make-viewport area #:optional #:key (clear-color black)
                        (clear-flags %standard-clear-flags))
  "Create a viewport that covers the rectangle AREA of the window.
Fill the viewport with CLEAR-COLOR when clearing the screen.  Clear
the buffers denoted by the list of symbols in CLEAR-FLAGS.  Possible
values for CLEAR-FLAGS are 'color-buffer', 'depth-buffer',
'accum-buffer', and 'stencil-buffer'."
  (%make-viewport area clear-color clear-flags))

(define clear-buffer-mask
  (memoize
   (lambda (flags)
     (apply logior
            ;; Map symbols to OpenGL constants.
            (map (match-lambda
                  ('depth-buffer 256)
                  ('accum-buffer 512)
                  ('stencil-buffer 1024)
                  ('color-buffer 16384))
                 flags)))))

(define (apply-viewport viewport)
  "Set the OpenGL state for VIEWPORT.  Clip rendering to the viewport
area, set the clear color, and clear necessary buffers."
  (gl-enable (enable-cap scissor-test))
  (match (viewport-area viewport)
    (($ <rect> x y width height)
     (gl-viewport x y width height)
     (gl-scissor x y width height)))
  (match (viewport-clear-color viewport)
    (($ <color> r g b a)
     (gl-clear-color r g b a)))
  (gl-clear (clear-buffer-mask (viewport-clear-flags viewport))))

;;;
;;; Camera
;;;

(define-record-type <camera>
  (make-camera location projection viewport)
  camera?
  (location camera-location)
  (projection camera-projection)
  (viewport camera-viewport))

(define* (orthographic-camera width height
                              #:optional #:key
                              (z-near 0) (z-far 1)
                              (viewport (make-viewport
                                         (make-rect 0 0 width height))))
  "Create a camera object that uses an orthographic (2D) projection of
size WIDTH x HEIGHT.  Optionally, z-axis clipping planes Z-NEAR and
Z-FAR can be specified, but default to 0 and 1, respectively.  By
default, the camera's VIEWPORT is WIDTH x HEIGHT, which is convenient if
the dimensions are measured in pixels."
  (let ((projection (orthographic-projection 0 width 0 height z-near z-far)))
    (make-camera identity-transform projection viewport)))