source/core/frameformat.h

   1 #ifndef MSP_GL_FRAMEFORMAT_H_
   2 #define MSP_GL_FRAMEFORMAT_H_
   3
   4 #include <cstdint>
   5 #include "pixelformat.h"
   6
   7 namespace Msp {
   8 namespace GL {
   9
  10 /**
  11 Describes a single attachment of a framebuffer, including the type and index
  12 of the attachment point and the format of the attached texture.
  13
  14 The values are bitfields laid as follows:
  15
  16 nnnn nn_f _sss rccc
  17       │ │    │ │  └╴Number of components
  18       │ │    │ └───╴Reverse order flag
  19       │ │    └─────╴Size of one component
  20       │ └──────────╴Floating-point flag
  21       └────────────╴Attachment index
  22
  23 This information is presented for internal documentation purposes only; it is
  24 inadvisable for applications to rely on it.
  25 */
  26 enum FrameAttachment: std::uint16_t
  27 {
  28         COLOR_ATTACHMENT = 0x0014,
  29         DEPTH_ATTACHMENT = 0xF941,
  30         STENCIL_ATTACHMENT = 0xFC11
  31 };
  32
  33 /**
  34 Describes the complete format of a framebuffer.  It can hold multiple
  35 attachments (currently up to seven) as well as a sample count.
  36 */
  37 class FrameFormat
  38 {
  39 private:
  40         enum { MAX_ATTACHMENTS = 7 };
  41
  42         std::uint8_t count = 0;
  43         std::uint8_t samples = 0;
  44         FrameAttachment attachments[MAX_ATTACHMENTS];
  45
  46 public:
  47         FrameFormat() = default;
  48         FrameFormat(FrameAttachment);
  49
  50         FrameFormat operator,(FrameAttachment) const;
  51         FrameFormat operator,(PixelFormat) const;
  52         FrameFormat operator,(unsigned) const;
  53
  54         FrameFormat &set_samples(unsigned);
  55         unsigned get_samples() const { return samples; }
  56
  57         unsigned size() const { return count; }
  58         bool empty() const { return !count; }
  59         const FrameAttachment *begin() const { return attachments; }
  60         const FrameAttachment *end() const { return attachments+count; }
  61         int index(FrameAttachment) const;
  62 };
  63
  64 inline FrameFormat operator,(FrameAttachment fa1, FrameAttachment fa2)
  65 { return (FrameFormat(fa1), fa2); }
  66
  67 FrameAttachment make_typed_attachment(FrameAttachment, PixelFormat);
  68
  69 inline FrameAttachment operator,(FrameAttachment fa, PixelFormat pf)
  70 { return make_typed_attachment(fa, pf); }
  71
  72 FrameAttachment make_indexed_attachment(FrameAttachment, unsigned);
  73
  74 inline FrameAttachment operator,(FrameAttachment fa, unsigned i)
  75 { return make_indexed_attachment(fa, i); }
  76
  77 inline unsigned get_attach_point(FrameAttachment fa)
  78 { return fa>>10; }
  79
  80 PixelFormat get_attachment_pixelformat(FrameAttachment);
  81
  82 } // namespace GL
  83 } // namespace Msp
  84
  85 #include "frameformat_backend.h"
  86
  87 #endif