X-Git-Url: http://git.tdb.fi/?p=libs%2Fgl.git;a=blobdiff_plain;f=source%2Fbufferable.h;h=a88f7b07a719535d426e262157fc8ef10879bd80;hp=fa81554dd0090be867ddfc6ca905c6c68ab5d790;hb=a4549c55a6d47129bd9e42c6a49a671b759ce6d9;hpb=f6e51c2f771726eec73b07824ebde2cf8bd522f0

diff --git a/source/bufferable.h b/source/bufferable.h
index fa81554d..a88f7b07 100644
--- a/source/bufferable.h
+++ b/source/bufferable.h
@@ -6,31 +6,88 @@ namespace GL {
 
 class Buffer;
 
+/**
+Base class for things that can store data in buffers.  Supports buffer sharing.
+A dirty flag is provided for derived classes.  It should be set when the data
+in the buffer is considered out of date, and is cleared by Bufferable after
+uploading fresh data to the buffer.
+*/
 class Bufferable
 {
-protected:
+public:
+	class AsyncUpdater
+	{
+	private:
+		const Bufferable &bufferable;
+		char *mapped_address;
+		bool buffer_resized;
+
+	public:
+		AsyncUpdater(const Bufferable &);
+		~AsyncUpdater();
+
+		void upload_data();
+	};
+
+private:
 	Buffer *buffer;
-	unsigned buffer_offset;
+	unsigned offset;
 	Bufferable *next_in_buffer;
 	Bufferable *prev_in_buffer;
+protected:
 	mutable bool dirty;
 
 	Bufferable();
 public:
 	virtual ~Bufferable();
 
-	void use_buffer(Buffer *, Bufferable * = 0);
+	/** Sets the buffer to use.  If prev is not null, it must use the same
+	buffer, and this object is inserted after it. */
+	void use_buffer(Buffer *buf, Bufferable *prev = 0);
+
+	/** Uploads new data into the buffer if necessary. */
+	void refresh() const { if(dirty) update_buffer(); }
+
+	AsyncUpdater *refresh_async() const;
+
 private:
 	void unlink_from_buffer();
 
 protected:
+	/** Returns the buffer in which the data is stored. */
+	Buffer *get_buffer() const { return buffer; }
+
+	/** Returns the amount of data to be stored in the buffer, in bytes. */
 	virtual unsigned get_data_size() const = 0;
 
-	void update_buffer_offset();
+	/** 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; }
+
+	/** Updates the offsets for the chain so that data from different objects
+	does not overlap.  Should be called if either data size or alignment
+	changes. */
+	void update_offset();
+
+	/** 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() { }
 
-	void update_buffer_data() const;
-	virtual void upload_data() const = 0;
+private:
+	bool resize_buffer() const;
+
+protected:
+	/** Resizes the buffer if necessary and calls upload_data(). */
+	void update_buffer() const;
+
+	/** Uploads data to the buffer.  Receives pointer to mapped buffer memory as
+	parameter.  If null, buffer interface should be used instead. */
+	virtual void upload_data(char *) const;
 };
 
 } // namespace GL