docs/sphinx: Add sphinx documentation

docs/sphinx/reference-libobs-graphics-image-file.rst

@@ -0,0 +1,71 @@
+.. _image_file_helper:
+
+Image File Helper
+=================
+
+Helper functions/type for easily loading/managing image files, including
+animated gif files.
+
+.. code:: cpp
+
+   #include <graphics/image-file.h>
+
+.. type:: struct gs_image_file
+
+   Image file structure
+
+.. type:: gs_texture_t *gs_image_file.texture
+
+   Texture
+
+.. type:: typedef struct gs_image_file gs_image_file_t
+
+   Image file type
+
+---------------------
+
+.. function:: void gs_image_file_init(gs_image_file_t *image, const char *file)
+
+   Loads an initializes an image file helper.  Does not initialize the
+   texture; call :c:func:`gs_image_file_init_texture()` to initialize
+   the texture.
+
+   :param image: Image file helper to initialize
+   :param file:  Path to the image file to load
+
+---------------------
+
+.. function:: void gs_image_file_free(gs_image_file_t *image)
+
+   Frees an image file helper
+
+   :param image: Image file helper
+
+---------------------
+
+.. function:: void gs_image_file_init_texture(gs_image_file_t *image)
+
+   Initializes the texture of an image file helper.  This is separate
+   from :c:func:`gs_image_file_init()` because it allows deferring the
+   graphics initialization if needed.
+
+   :param image: Image file helper
+
+---------------------
+
+.. function:: bool gs_image_file_tick(gs_image_file_t *image, uint64_t elapsed_time_ns)
+
+   Performs a tick operation on the image file helper (used primarily
+   for animated file).  Does not update the texture until
+   :c:func:`gs_image_file_update_texture()` is called.
+
+   :param image:           Image file helper
+   :param elapsed_time_ns: Elapsed time in nanoseconds
+
+---------------------
+
+.. function:: void gs_image_file_update_texture(gs_image_file_t *image)
+
+   Updates the texture (used primarily for animated files)
+
+   :param image: Image file helper