From c34bc3306c2ffbe62a47d746fd61ccd0cd114cbd Mon Sep 17 00:00:00 2001
From: Hannes Janetzek <hannes.janetzek@gmail.com>
Date: Thu, 4 Sep 2014 16:52:39 +0200
Subject: [PATCH] RenderElement: docs

---
 .../renderer/elements/RenderElement.java      | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/vtm/src/org/oscim/renderer/elements/RenderElement.java b/vtm/src/org/oscim/renderer/elements/RenderElement.java
index 651e5760..3f628ac1 100644
--- a/vtm/src/org/oscim/renderer/elements/RenderElement.java
+++ b/vtm/src/org/oscim/renderer/elements/RenderElement.java
@@ -35,20 +35,20 @@ public abstract class RenderElement extends Inlist<RenderElement> {
 
 	public final int type;
 
-	/** drawing order from bottom to top. */
+	/** Drawing order from bottom to top. */
 	int level;
 
-	/** number of vertices for this layer. */
+	/** Number of vertices for this layer. */
 	protected int numVertices;
 
-	/** temporary list of vertex data. */
+	/** Temporary list of vertex data. */
 	protected final VertexData vertexItems = new VertexData();
 
 	protected RenderElement(int type) {
 		this.type = type;
 	}
 
-	/** clear all resources. */
+	/** Clear all resources. */
 	protected void clear() {
 		vertexItems.dispose();
 		numVertices = 0;
@@ -67,6 +67,12 @@ public abstract class RenderElement extends Inlist<RenderElement> {
 		compileVertexItems(sbuf);
 	}
 
+	/**
+	 * For line- and polygon-layers this is the offset
+	 * of VERTICES in its layers.vbo.
+	 * For all other types it is the byte offset in vbo.
+	 * FIXME - always use byte offset?
+	 */
 	public int getOffset() {
 		return offset;
 	}
@@ -75,11 +81,6 @@ public abstract class RenderElement extends Inlist<RenderElement> {
 		this.offset = offset;
 	}
 
-	/**
-	 * For line- and polygon-layers this is the offset
-	 * of VERTICES in its layers.vbo.
-	 * For all other types it is the byte offset in vbo.
-	 */
 	protected int offset;
 
 	protected void compile(ShortBuffer vertexBuffer, ShortBuffer indexBuffer) {