]> git.tdb.fi Git - libs/gl.git/blobdiff - source/bufferable.h
Remove the deprecated ProgramBuilder class
[libs/gl.git] / source / bufferable.h
index 0a30e80e817e8343b374094651008a7d03935714..cbbde4e1b93f1e07266c097c150774f2b5621d3c 100644 (file)
@@ -14,15 +14,29 @@ uploading fresh data to the buffer.
 */
 class Bufferable
 {
+public:
+       class AsyncUpdater
+       {
+       private:
+               const Bufferable &bufferable;
+               char *mapped_address;
+
+       public:
+               AsyncUpdater(const Bufferable &);
+               ~AsyncUpdater();
+
+               void upload_data();
+       };
+
 private:
        Buffer *buffer;
        unsigned offset;
        Bufferable *next_in_buffer;
        Bufferable *prev_in_buffer;
+       mutable bool location_dirty;
 protected:
        mutable bool dirty;
 
-protected:
        Bufferable();
 public:
        virtual ~Bufferable();
@@ -31,16 +45,34 @@ public:
        buffer, and this object is inserted after it. */
        void use_buffer(Buffer *buf, Bufferable *prev = 0);
 
+       /** Sets the buffer for the entire chain of objects. */
+       void change_buffer(Buffer *);
+
+       /** Returns the total amount of storage required by this object and others
+       in the same chain, including any alignment between objects. */
+       unsigned get_required_buffer_size() const;
+
+       /** Uploads new data into the buffer if necessary. */
+       void refresh() const { if(buffer && dirty) upload_data(0); }
+
+       /** Returns an object which can be used to upload data to the buffer using
+       mapped memory. */
+       AsyncUpdater *refresh_async() const;
+
 private:
        void unlink_from_buffer();
 
-protected:
+public:
        /** Returns the buffer in which the data is stored. */
-       Buffer *get_buffer() const { return buffer; }
+       const Buffer *get_buffer() const { return buffer; }
 
+protected:
        /** Returns the amount of data to be stored in the buffer, in bytes. */
        virtual unsigned get_data_size() const = 0;
 
+       /** Returns a pointer to the start of data in client memory. */
+       virtual const void *get_data_pointer() const = 0;
+
        /** Returns the alignment required for the data, in bytes.  The offset is
        guaranteed to be a multiple of this. */
        virtual unsigned get_alignment() const { return 1; }
@@ -53,14 +85,13 @@ protected:
        /** Returns the offset where the data should be uploaded. */
        unsigned get_offset() const { return offset; }
 
-       /** Called when the offset for the data has changed. */
-       virtual void offset_changed() { }
-
-       /** Resizes the buffer if necessary and calls upload_data(). */
-       void update_buffer() const;
+       /** Called when the target buffer or offset within it has changed. */
+       virtual void location_changed(Buffer *, unsigned, unsigned) const { }
 
-       /** Uploads data to the buffer. */
-       virtual void upload_data() const = 0;
+private:
+       /** Uploads data to the buffer.  Receives pointer to mapped buffer memory as
+       parameter, or null to use the buffer upload interface. */
+       void upload_data(char *) const;
 };
 
 } // namespace GL