Added docs for texture component

2024-12-31 18:00:17 +05:30 · 2018-04-25 03:58:33 -07:00 · 2018-04-25 03:58:33 -07:00 · 4bed12289b
commit 4bed12289b
parent d6ef6e3dc5
1 changed files with 99 additions and 0 deletions
--- a/docs/doc-tex.txt
+++ b/docs/doc-tex.txt
@ -0,0 +1,99 @@
+
+devil1tex.h / devil1tex.c
+    Handles texture packages.
+
+Functions
+    All functions are static but exposed by a function pointer in a constant
+    struct called DEVIL1TEX. For example, clients call functions using
+    DEVIL1TEX.printheader(...);
+
+    
+    void printheader(struct TexturePack*);
+        Prints the attributes and values of a header to standard output.
+
+        input: pointer to a TexturePack struct.
+
+    void printbatchdesc(struct TextureBatchDescriptor*);
+        Prints the attributes and values if a TextureBatchDescriptor to
+        standard output.
+
+    bool getbatchdesc(struct TextureBatchDescriptor**, 
+                      unsigned int, 
+                      const char *, 
+                      unsigned int);
+        Retrieves the i-th TextureBatchDescriptor from a buffer.
+
+        input:
+            Pointer to a pointer of TextureBatchDescriptor. 
+            This is pass by reference of a pointer to the function. 
+            The pointer to TextureBatchDescriptor can be NULL and will be 
+            set to point to a region in the const char*.
+
+            unsigned int, the i-th instance of a TextureBatchDescriptor in
+            the const char*.
+
+            const char*, the buffer containing the whole texture pack file.
+
+            unsigned int, the size of the buffer.
+
+        output:
+            true when successfully retrieving a pointer to 
+            TextureBatchDescriptor.
+
+            false when unsuccesful in retrieving a pointer to 
+            TextureBatchDescriptor; failed checks against segmentation 
+            faults.
+                When const char* (buffer) is NULL.
+
+                When the location of the TextureBatchDescriptor will exceed
+                the size of a buffer.
+
+    bool getbatch(struct TextureBatch**,
+                  unsigned int,
+                  const char*
+                  unsigned int);
+        Retrieves i-th instance of a TextureBatch from a buffer.
+
+        input:
+            Pointer to a pointer of TextureBatch.
+            This is pass by reference of a pointer to the function.
+            The pointer to a TextureBatch can be NULL and will be set to
+            point to a region in the const char*.
+
+            unsigned int, the i-th instance of a TextureBatch in the 
+            const char*.
+
+            const char*, the buffer containing the whole texture pack file.
+
+            unsigned int, the size of the buffer.
+
+        output:
+            true on success.
+
+            false when failing checks against segmentation faults.
+                When const char* is NULL.
+
+                When the location of the Texture Batch will exceed the size
+                of the buffer.
+
+    bool gettextures(struct Texture*,
+                     unsigned int,
+                     const char*,
+                     unsigned int);
+        Retrieves textures of the i-th batch from a buffer.
+
+        input:
+            Pointer to Texture. This can be an array of Textures.
+            This parameter can not be NULL.
+
+            unsigned int, the i-th instance the TextureBatch containing
+            the files.
+
+            const char*, the buffer containing the whole texture pack file.
+
+            unsigned int, size of the buffer.
+
+        output:
+            true on success.
+
+            false when failing checks against segmentation faults.