From 42d42c9ba3b741d167eaa2196c686962559686f1 Mon Sep 17 00:00:00 2001
From: sanine-a <sanine.not@pm.me>
Date: Sat, 31 Oct 2020 22:43:41 -0500
Subject: add basic framebuffer operations

---
 src/texture/texture.h | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

(limited to 'src/texture/texture.h')

diff --git a/src/texture/texture.h b/src/texture/texture.h
index 785fef0..9dc0308 100644
--- a/src/texture/texture.h
+++ b/src/texture/texture.h
@@ -37,7 +37,7 @@ void honey_setup_texture(lua_State* L);
  * @param[in] height The height in pixels of the texture to create.
  * @param[in] data The data to populate the texture with, or NULL to leave it unpopulated.
  *
- * @returns HONEY_OK on success, and appropriate error on failure.
+ * @returns Nothing.
  */
 void honey_texture_new_greyscale(honey_texture* texture,
                                  int width, int height,
@@ -50,7 +50,7 @@ void honey_texture_new_greyscale(honey_texture* texture,
  * @param[in] height The height in pixels of the texture to create.
  * @param[in] data The data to populate the texture with, or NULL to leave it unpopulated.
  *
- * @returns HONEY_OK on success, and appropriate error on failure.
+ * @returns Nothing.
  */
 void honey_texture_new_rgb(honey_texture* texture,
                            int width, int height,
@@ -63,7 +63,7 @@ void honey_texture_new_rgb(honey_texture* texture,
  * @param[in] height The height in pixels of the texture to create.
  * @param[in] data The data to populate the texture with, or NULL to leave it unpopulated.
  *
- * @returns HONEY_OK on success, and appropriate error on failure.
+ * @returns Nothing.
  */
 void honey_texture_new_rgba(honey_texture* texture,
                             int width, int height,
@@ -76,7 +76,7 @@ void honey_texture_new_rgba(honey_texture* texture,
  * @param[in] height The height in pixels of the texture to create.
  * @param[in] data The data to populate the texture with, or NULL to leave it unpopulated.
  *
- * @returns HONEY_OK on success, and appropriate error on failure.
+ * @returns Nothing.
  */
 void honey_texture_new_depth(honey_texture* texture,
                              int width, int height,
@@ -101,14 +101,21 @@ enum honey_texture_result honey_texture_load(honey_texture* texture,
 void honey_texture_use(honey_texture texture, int texture_unit);
 
 /** @brief Create a framebuffer object.
+ *
+ * You must specify at least one of draw and depth; otherwise, the framebuffer will
+ * be incomplete and fail.
  *
  * @param[out] destination Pointer to store the resulting OpenGL handle in.
+ * @param[in] draw Pointer to a texture to draw to.
+ * @param[in] depth Pointer to a depth texture.
  * @param[in] width The width in pixels of the FBO.
  * @param[in] height The height in pixels of the FBO.
  *
- * @returns HONEY_OK on success; appropriate error otherwise.
+ * @returns Nothing.
  */
-honey_result honey_texture_framebuffer_object_new(unsigned int* destination,
-                                                  int width, int height);
+void honey_texture_framebuffer_object_new(unsigned int* destination,
+                                          honey_texture* draw,
+                                          honey_texture* depth,
+                                          int width, int height);
 
 #endif
-- 
cgit v1.2.1