New iteration of check 'imageSizeInBytes':

Premises:
    See http://www.glprogramming.com/red/chapter08.html

    "If the rectangle in memory is larger than the subrectangle that's being drawn or read,
    you need to specify the actual length (measured in pixels) of the larger rectangle with *ROW_LENGTH. "

    This equals ROW_LENGTH == SubPicture-Width + 'Dirt', ie the offset to go from one line to the next.

    "You also need to specify the number of rows and pixels to skip before starting to copy the data for the subrectangle.
    These numbers are set using the parameters *SKIP_ROWS and *SKIP_PIXELS, as shown in Figure 8-9.
    By default, both parameters are 0, so you start at the lower-left corner."

    This equals to a one time offset _before_ you start copy the data, ie with your DMA engine,
    using ROW_LENGTH and HEIGHT only.

Compared to Mesa3D's implementation (proof):

    http://cgit.freedesktop.org/mesa/mesa/tree/src/glx/x11/pixelstore.c
    Line 78 - 200
      PixelStore State Tracker: Store the values in the PixelStore structure.

    http://cgit.freedesktop.org/mesa/mesa/tree/src/glx/x11/pixel.c
    Line 82 - 155
      Line 210: Start position is set one time using SKIP_* values the same way we do.
      Line 228: Jump to the first pixel in the newxt row, just using ROW_LENGTH
      Line 230: Jump to the first pixel in the next 'image' just using imageSize,

            rowsPerImage = IMAGE_HEIGHT>0?IMAGE_HEIGHT:height;

            groupsPerRow = ROW_LENGTH>0?ROW_LENGTH:width;
            groupSize = elementSize * components;
            rowSize = groupsPerRow * groupSize;

            imageSize = rowSize * rowsPerImage;

changes:
    Removed redundand 'dimension' parameted, which is derived from depth and height,
        1D == depth:1 height:1
        2D == depth:1 height>1
        nD == depth>1 height>1

    Safe fail depth to >= 1
    Safe fail height to >= 1D

    Take either the ROW_LENGTH / IMAGE_HEIGHT PixelStore value if > 0,
    or the given width / height.

1 files changed, 15 insertions, 14 deletions

diff --git a/make/config/jogl/gl-impl-CustomJavaCode-embedded.java b/make/config/jogl/gl-impl-CustomJavaCode-embedded.java
index c803a06a4..ae90a42a0 100644
--- a/make/config/jogl/gl-impl-CustomJavaCode-embedded.java
+++ b/make/config/jogl/gl-impl-CustomJavaCode-embedded.java
@@ -3,10 +3,7 @@ private int[] imageSizeTemp = new int[1];
 /** Helper for more precise computation of number of bytes that will
     be touched by a pixel pack or unpack operation. */
 private int imageSizeInBytes(int bytesPerElement,
-                             int width, int height, int depth,
-                             int dimensions,
-                             boolean pack) {
-    int rowLength;
+                             int rowLength, int imageHeight, int depth, boolean pack) {
     int alignment = 1;
 
     if (pack) {
@@ -17,23 +14,27 @@ private int imageSizeInBytes(int bytesPerElement,
         alignment = imageSizeTemp[0];
     }
     // Try to deal somewhat correctly with potentially invalid values
-    height      = Math.max(0, height);
+    rowLength   = Math.max(0, rowLength );
+    imageHeight = Math.max(1, imageHeight); // min 1D
+    depth       = Math.max(1, depth );      // min 1 * imageSize
     alignment   = Math.max(1, alignment);
 
-    rowLength   = Math.max(0, width); // > 0 && >= width
     int rowLengthInBytes = rowLength * bytesPerElement;
 
     if (alignment > 1) {
-        int modulus = rowLengthInBytes % alignment;
-        if (modulus > 0) {
-            rowLengthInBytes += alignment - modulus;
+        int padding = rowLengthInBytes % alignment;
+        if (padding > 0) {
+            rowLengthInBytes += alignment - padding;
         }
     }
 
-    int size = height * rowLengthInBytes; // height == 1 for 1D
-    if(dimensions==3) {
-       size *= depth;
-    }
+    /**
+     * depth is in multiples of image size.
+     *
+     * rowlenght is the actual repeating offset 
+     * to go from line n to line n+1 at the same x-axis position.
+     */
+    int imageSize = imageHeight * rowLengthInBytes;
 
-    return size;
+    return imageSize * depth;
 }