adds toggling of rendering into each cubemap face.

Author: diroru

src/codeanticode/planetarium/Dome.java

@@ -69,6 +69,8 @@ public class Dome extends PGraphics3D {
 
 	protected boolean requestedRenderDomeChange = false;
 	protected boolean requestedRenderDome;
+	
+	private boolean[] faceDraw = {true, true, true, true, true, false};
 
 	protected float domeLeft, domeRight, domeTop, domeBottom;
 	protected float domeDX, domeDY, domeDZ;
@@ -210,7 +212,9 @@ public void beginDraw() {
 			pgl.viewport(0, 0, cubeMapSize, cubeMapSize);
 			super.perspective(90.0f * DEG_TO_RAD, 1.0f, 1.0f, cameraFar);
 
-			beginFaceDraw(PGL.TEXTURE_CUBE_MAP_POSITIVE_X);
+			if (getFaceDraw(DomeCamera.POSITIVE_X)) {
+				beginFaceDraw(PGL.TEXTURE_CUBE_MAP_POSITIVE_X);
+			}
 		}
 	}
 
@@ -220,10 +224,12 @@ public void endDraw() {
 			endFaceDraw();
 
 			// Draw the rest of the cubemap faces
-			for (int face = PGL.TEXTURE_CUBE_MAP_NEGATIVE_X; face <= PGL.TEXTURE_CUBE_MAP_POSITIVE_Z; face++) {
-				beginFaceDraw(face);
-				parent.draw();
-				endFaceDraw();
+			for (int face = PGL.TEXTURE_CUBE_MAP_NEGATIVE_X; face <= PGL.TEXTURE_CUBE_MAP_NEGATIVE_Z; face++) {
+				if (getFaceDraw(face - PGL.TEXTURE_CUBE_MAP_POSITIVE_X)) {
+					beginFaceDraw(face);
+					parent.draw();
+					endFaceDraw();
+				}
 			}
 
 			endPGL();
@@ -457,6 +463,20 @@ protected void setDomeAperture(float theAperture) {
 		}
 	}
 
+	protected boolean getFaceDraw(int theFace) {
+		if (theFace >= 0 && theFace <= faceDraw.length) {
+			return faceDraw[theFace];
+		}
+		return false;
+	}
+	
+	protected void setFaceDraw(int theFace, boolean doDraw) {
+		if (theFace >= 0 && theFace <= faceDraw.length) {
+			faceDraw[theFace] = doDraw;
+			System.out.println("face no. " + theFace + " rendering " + doDraw);
+		}	
+	}
+
 	private void welcome() {
 		System.out.println("##library.name## ##library.prettyVersion## by ##author##");
 	}

src/codeanticode/planetarium/DomeCamera.java

@@ -92,11 +92,68 @@ public void imageToForeground(PImage theImage, int x0, int y0, int w, int h) {
 	  renderer.imageToForeground(theImage, x0, y0, w, h);
   }
 
+  /* TODO: figure out a way for this to work
   public void imageToBackground(PImage theImage, int x0, int y0, int w, int h) {
 	  renderer.imageToBackground(theImage, x0, y0, w, h);
   }
+  */
 
+  
+  /**
+   * Returns the currently rendered face index.
+   * 
+   * @return		0 == DomeCamera.POSITIVE_X
+   * 			1 == DomeCamera.NEGATIVE_X
+   *   			2 == DomeCamera.POSITIVE_Y
+   * 			3 == DomeCamera.NEGATIVE_Y
+   *       		4 == DomeCamera.POSITIVE_Z
+   * 			5 == DomeCamera.NEGATIVE_Z
+   */  
   public int getFace() {
     return renderer.getCurrentFace() - PGL.TEXTURE_CUBE_MAP_POSITIVE_X;
   }
+  
+  /**
+   * Toggles the rendering into a cubemap face by index.
+   * 
+   * @param	theFace	0 == DomeCamera.POSITIVE_X
+   * 				1 == DomeCamera.NEGATIVE_X
+   *   				2 == DomeCamera.POSITIVE_Y
+   * 				3 == DomeCamera.NEGATIVE_Y
+   *       			4 == DomeCamera.POSITIVE_Z
+   * 				5 == DomeCamera.NEGATIVE_Z
+   */  
+  public void toggleFaceDraw(int theFace) {
+	  renderer.setFaceDraw(theFace, !renderer.getFaceDraw(theFace));
+  }
+  
+  /**
+   * Sets the rendering into a cubemap face by index.
+   * 
+   * @param	theFace	0 == DomeCamera.POSITIVE_X
+   * 				1 == DomeCamera.NEGATIVE_X
+   *   				2 == DomeCamera.POSITIVE_Y
+   * 				3 == DomeCamera.NEGATIVE_Y
+   *       			4 == DomeCamera.POSITIVE_Z
+   * 				5 == DomeCamera.NEGATIVE_Z
+   * @param doDraw	true or false
+   */  
+  public void setFaceDraw(int theFace, boolean doDraw) {
+	  renderer.setFaceDraw(theFace, doDraw);
+  }
+  
+  /**
+   * Informs if a given face is being rendered into.
+   * 
+   * @param	theFace	0 == DomeCamera.POSITIVE_X
+   * 				1 == DomeCamera.NEGATIVE_X
+   *   				2 == DomeCamera.POSITIVE_Y
+   * 				3 == DomeCamera.NEGATIVE_Y
+   *       			4 == DomeCamera.POSITIVE_Z
+   * 				5 == DomeCamera.NEGATIVE_Z
+   * @return 		true if the given camera is being updated.
+   */   
+  public boolean getFaceDraw(int theFace) {
+	return renderer.getFaceDraw(theFace); 
+  }
 }