GlueGen Struct [8]: Revised setter (resolved shrinking array, using 'subset' flag), added (detailed) JavaDoc in generated code

Revised setter:

A) int32_t val[10] -> setter for a subset change only, as-is with args[src, srcPos, destPos, length]
                     - no new memory, reuse only
                     - no special action to be performed

B) int32_t* val -> setter with toggle 'subset' with args[subset, src, srcPos, destPos, length],
                - replace memory w/ 'subset==false' where it also may copy 'destPos' gap from old -> new
                - reuse memory w/ 'subset==true', where destPos+length <= elementCount

C) const int32_t* val -> setter to replace referenced memory only args[src, srcPos, length]
                     - always replaces memory, no copy of a gap (no destPos)

Hence:
- case (A) stays as is
- case (B) will be revised and argument 'boolean subset' added
- case (C) will be revised (simplified) and argument 'destPos' removed

3 files changed, 506 insertions, 115 deletions

diff --git a/src/java/com/jogamp/gluegen/JavaEmitter.java b/src/java/com/jogamp/gluegen/JavaEmitter.java
index 63c7d73..f4edbee 100644
--- a/src/java/com/jogamp/gluegen/JavaEmitter.java
+++ b/src/java/com/jogamp/gluegen/JavaEmitter.java
@@ -1089,7 +1089,7 @@ public class JavaEmitter implements GlueEmitter {
                                        field + "\" in type \"" + structCTypeName + "\")",
                                        fieldType.getASTLocusTag());
           }
-          generateGetterSignature(javaUnit, fieldType, false, false, fieldType.getName(), fieldName, capitalizeString(fieldName), null, false, null);
+          generateGetterSignature(javaUnit, fieldType, false, false, fieldType.getName(), fieldName, capitalizeString(fieldName), null, false, false, null, null);
           javaUnit.emitln(" {");
           javaUnit.emitln("    return " + fieldType.getName() + ".create( accessor.slice( " +
                            fieldName+"_offset[mdIdx], "+fieldName+"_size[mdIdx] ) );");
@@ -1128,7 +1128,7 @@ public class JavaEmitter implements GlueEmitter {
 
             if( !immutableField && !fieldType.isConst() ) {
                 // Setter
-                generateSetterSignature(javaUnit, fieldType, MethodAccess.PUBLIC, false, false, containingJTypeName, fieldName, capFieldName, null, javaTypeName, null, false, null);
+                generateSetterSignature(javaUnit, fieldType, MethodAccess.PUBLIC, false, false, containingJTypeName, fieldName, capFieldName, null, javaTypeName, null, false, false, null, null, null);
                 javaUnit.emitln(" {");
                 if( fieldTypeNativeSizeFixed ) {
                     javaUnit.emitln("    accessor.set" + capJavaTypeName + "At(" + fieldName+"_offset[mdIdx], src);");
@@ -1141,7 +1141,7 @@ public class JavaEmitter implements GlueEmitter {
             }
 
             // Getter
-            generateGetterSignature(javaUnit, fieldType, false, false, javaTypeName, fieldName, capFieldName, null, false, null);
+            generateGetterSignature(javaUnit, fieldType, false, false, javaTypeName, fieldName, capFieldName, null, false, false, null, null);
             javaUnit.emitln(" {");
             javaUnit.emit  ("    return ");
             if( fieldTypeNativeSizeFixed ) {
@@ -1200,59 +1200,86 @@ public class JavaEmitter implements GlueEmitter {
   //----------------------------------------------------------------------
   // Internals only below this point
   //
-
-  private void generateIsNullSignature(final CodeUnit unit, final Type origFieldType,
-                                       final boolean abstractMethod, final String fieldName,
-                                       final String capitalizedFieldName, final boolean constElemCount,
-                                       final String elemCountExpr) {
-      unit.emit("  /** Is 'null' for native field <code>"+fieldName+"</code>: "+origFieldType.getDebugString());
+  private void generateArrayFieldNote(final CodeUnit unit, final String leadIn, final String leadOut,
+                                      final Type origFieldType, final String fieldName,
+                                      final boolean constElemCount, final boolean maxOneElem, final String elemCountExpr) {
+      if( null != leadIn ) {
+          unit.emit(leadIn+" ");
+      }
+      unit.emit("native field <code>"+fieldName+"</code>, referencing ");
       if( null != elemCountExpr ) {
-          unit.emit(", with "+(constElemCount?"fixed":"initial")+" array length of <code>"+elemCountExpr+"</code>");
+          unit.emit((constElemCount?"a natively owned array with fixed":"an array with initial")+" element count of <code>"+elemCountExpr+"</code>.");
+      } else {
+          unit.emit((constElemCount?"a natively owned":"an")+" array.");
       }
-      unit.emitln(" */");
+      if( maxOneElem ) {
+          unit.emit(" Maximum element count is <code>1</code>.");
+      }
+      if( null == leadOut ) {
+          unit.emitln();
+          unit.emitln("   * <p>");
+          unit.emitln("   * NativeSig <code>"+origFieldType.getSignature(null).toString()+"</code>");
+          unit.emitln("   * </p>");
+      } else {
+          unit.emit(" NativeSig <code>"+origFieldType.getSignature(null).toString()+"</code>");
+          unit.emit(" "+leadOut);
+          unit.emitln();
+      }
+  }
+  private void generateIsNullSignature(final CodeUnit unit, final Type origFieldType,
+                                       final boolean abstractMethod, final String fieldName,
+                                       final String capitalizedFieldName,
+                                       final boolean constElemCount, final boolean maxOneElem, final String elemCountExpr) {
+      unit.emitln("  /**");
+      unit.emitln("   * Returns `true` if native pointer <code>"+fieldName+"</code> is `null`, otherwise `false`.");
+      unit.emitln("   * <p>");
+      generateArrayFieldNote(unit, "   * Corresponds to", null, origFieldType, fieldName, constElemCount, maxOneElem, elemCountExpr);
+      unit.emitln("   * </p>");
+      unit.emitln("   */");
       unit.emit("  public " + (abstractMethod ? "abstract " : "final ") + "boolean is" + capitalizedFieldName + "Null()");
   }
   private void generateReleaseSignature(final CodeUnit unit, final Type origFieldType,
                                         final boolean abstractMethod,
                                         final String returnTypeName, final String fieldName, final String capitalizedFieldName,
-                                        final boolean constElemCount, final String elemCountExpr) {
-      unit.emit("  /** Release for native field <code>"+fieldName+"</code>: "+origFieldType.getDebugString());
-      if( null != elemCountExpr ) {
-          unit.emit(", with "+(constElemCount?"fixed":"initial")+" array length of <code>"+elemCountExpr+"</code>");
-      }
-      unit.emitln(" */");
+                                        final boolean constElemCount, final boolean maxOneElement, final String elemCountExpr) {
+      unit.emitln("  /**");
+      generateArrayFieldNote(unit, "   * Releases memory referenced by", null, origFieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
+      unit.emitln("   */");
       unit.emit("  public " + (abstractMethod ? "abstract " : "final ") + returnTypeName + " release" + capitalizedFieldName + "()");
   }
   private void generateGetterSignature(final CodeUnit unit, final Type origFieldType,
                                        final boolean staticMethod, final boolean abstractMethod,
-                                       final String returnTypeName, final String fieldName, final String capitalizedFieldName,
-                                       final String customArgs, final boolean constElemCount, final String elemCountExpr) {
-      unit.emit("  /** Getter for native field <code>"+fieldName+"</code>: "+origFieldType.getDebugString());
-      if( null != elemCountExpr ) {
-          unit.emit(", with "+(constElemCount?"fixed":"initial")+" array length of <code>"+elemCountExpr+"</code>");
+                                       final String returnTypeName, final String fieldName, final String capitalizedFieldName, final String customArgs,
+                                       final boolean constElemCount, final boolean maxOneElem, final String elemCountExpr, final String apiDocTail) {
+      unit.emitln("  /**");
+      generateArrayFieldNote(unit, "   * Getter for", null, origFieldType, fieldName, constElemCount, maxOneElem, elemCountExpr);
+      if( null != apiDocTail ) {
+          unit.emitln("   * "+apiDocTail);
       }
-      unit.emitln(" */");
+      unit.emitln("   */");
       unit.emit("  public " + (staticMethod ? "static " : "final ") + (abstractMethod ? "abstract " : "") + returnTypeName + " get" + capitalizedFieldName + "(");
       if( null != customArgs ) {
           unit.emit(customArgs);
       }
       unit.emit(")");
   }
-
-  private void generateSetterAPIDoc(final CodeUnit unit, final String action,
-                                    final Type origFieldType, final String fieldName,
-                                    final boolean constElemCount, final String elemCountExpr) {
-      unit.emit("  /** "+action+" native field <code>"+fieldName+"</code>: "+origFieldType.getDebugString());
-      if( null != elemCountExpr ) {
-          unit.emit(", with "+(constElemCount?"fixed native-ownership":"initial")+" array length of <code>"+elemCountExpr+"</code>");
-      }
-      unit.emitln(" */");
-  }
   private void generateSetterSignature(final CodeUnit unit, final Type origFieldType, final MethodAccess accessMod,
                                        final boolean staticMethod, final boolean abstractMethod,
                                        final String returnTypeName, final String fieldName, final String capitalizedFieldName,
-                                       final String customArgsPre, final String paramTypeName, final String customArgsPost, final boolean constElemCount, final String elemCountExpr) {
-      generateSetterAPIDoc(unit, "Setter for", origFieldType, fieldName, constElemCount, elemCountExpr);
+                                       final String customArgsPre, final String paramTypeName, final String customArgsPost,
+                                       final boolean constElemCount, final boolean maxOneElem,
+                                       final String elemCountExpr, final String apiDocDetail, final String apiDocArgs) {
+      unit.emitln("  /**");
+      generateArrayFieldNote(unit, "   * Setter for", null, origFieldType, fieldName, constElemCount, maxOneElem, elemCountExpr);
+      if( null != apiDocDetail ) {
+          unit.emitln("   * <p>");
+          unit.emitln("   * "+apiDocDetail);
+          unit.emitln("   * </p>");
+      }
+      if( null != apiDocArgs ) {
+          unit.emitln(apiDocArgs);
+      }
+      unit.emitln("   */");
       unit.emit("  "+accessMod.getJavaName() + " " + (staticMethod ? "static " : "final ") + (abstractMethod ? "abstract " : "") + returnTypeName + " set" + capitalizedFieldName + "(");
       if( null != customArgsPre ) {
           unit.emit(customArgsPre+", ");
@@ -1427,8 +1454,40 @@ public class JavaEmitter implements GlueEmitter {
       return false;
   }
 
-  private static final String SetArrayArgs = "final int srcPos, final int destPos, final int length";
-  private static final String SetArrayArgsCheck = "    if( 0 > srcPos || 0 > destPos || 0 > length || srcPos + length > src.length ) { throw new IndexOutOfBoundsException(\"src[pos \"+srcPos+\", length \"+src.length+\"], destPos \"+destPos+\", length \"+length); }";
+  private static final String GetElemValueApiDocTail = "@return element value of the corresponding field-array";
+  private static final String GetElemCountApiDocTail = "@return element count of the corresponding field-array";
+
+  private static final String SetSubArrayArgsPost = "final int srcPos, final int destPos, final int length";
+  private static final String SetSubArrayArgsCheck = "    if( 0 > srcPos || 0 > destPos || 0 > length || srcPos + length > src.length ) { throw new IndexOutOfBoundsException(\"src[pos \"+srcPos+\", length \"+src.length+\"], destPos \"+destPos+\", length \"+length); }";
+  private static final String SetSubArrayApiDocDetail = "Copies the given source elements into the respective field's existing memory.";
+  private static final String SetSubArrayApiDocArgs =
+          "   * @param src the source array of elements\n"+
+          "   * @param srcPos starting element position within the source array with 'srcPos >= 0` &&  `srcPos + length <= src.length`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @param destPos starting element position within the destination with 'destPos >= 0` && `destPos + length <= elemCount`, otherwise an exception is thrown\n"+
+          "   * @param length the element count to be copied with 'length >= 0` &&  `srcPos + length <= src.length` && `destPos + length <= elemCount`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @return this instance of chaining";
+
+  private static final String SetArrayArgsPre = "final boolean subset";
+  private static final String SetArrayArgsPost = "final int srcPos, final int destPos, final int length";
+  private static final String SetArrayArgsCheck = "    if( 0 > srcPos || 0 > destPos || 0 > length || srcPos + length > src.length ) { throw new IndexOutOfBoundsException(\"subset \"+subset+\", src[pos \"+srcPos+\", length \"+src.length+\"], destPos \"+destPos+\", length \"+length); }";
+  private static final String SetArrayApiDocDetail = "Copies the given source elements into the respective field, either writing into the existing memory or creating a new memory and referencing it.";
+  private static final String SetArrayApiDocArgs =
+          "   * @param subset if `true` keeps the underlying memory and only allows to set up to `elemCount` elements. Otherwise may replace the underlying memory if `destPos + length != elemCount`.\n"+
+          "   * @param src the source array of elements\n"+
+          "   * @param srcPos starting element position within the source array with 'srcPos >= 0` &&  `srcPos + length <= src.length`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @param destPos starting element position within the destination with 'destPos >= 0`. If `subset == true`, `destPos + length <= elemCount` also must be be `true`. Otherwise an exception is thrown\n"+
+          "   * @param length the element count to be copied with 'length >= 0` &&  `srcPos + length <= src.length`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @return this instance of chaining";
+
+  private static final String SetReplaceArrayArgsPost = "final int srcPos, final int length";
+  private static final String SetReplaceArrayArgsCheck = "    if( 0 > srcPos || 0 > length || srcPos + length > src.length ) { throw new IndexOutOfBoundsException(\"src[pos \"+srcPos+\", length \"+src.length+\"], length \"+length); }";
+  private static final String SetReplaceArrayApiDocDetail = "Replaces the respective field's memory with a new memory segment containing given source elements and referencing it.";
+  private static final String SetReplaceArrayApiDocArgs =
+          "   * @param src the source array of elements\n"+
+          "   * @param srcPos starting element position within the source array with 'srcPos >= 0` &&  `srcPos + length <= src.length`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @param length the element count to be copied with 'length >= 0` &&  `srcPos + length <= src.length`, otherwise an {@link IndexOutOfBoundsException} is thrown\n"+
+          "   * @return this instance of chaining";
+
   private static final String GetArrayArgs = "final int destPos, final int length";
   private static final String GetArrayArgsCheck = "    if( 0 > srcPos || 0 > destPos || 0 > length || destPos + length > dest.length ) { throw new IndexOutOfBoundsException(\"dest[pos \"+destPos+\", length \"+dest.length+\"], srcPos \"+srcPos+\", length \"+length); }";
 
@@ -1665,20 +1724,21 @@ public class JavaEmitter implements GlueEmitter {
       //
       if( ownElemCountHandling ) {
           if( constElemCount ) {
-              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, maxOneElement, elemCountExpr, GetElemCountApiDocTail);
               unit.emitln(" { return "+elemCountExpr+"; }");
           } else if( useGetCStringLength ) {
-              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, maxOneElement, elemCountExpr, GetElemCountApiDocTail);
               unit.emitln(" {");
               unit.emitln("    final long pString = PointerBuffer.wrap( accessor.slice(" + fieldName+"_offset[mdIdx],  PointerBuffer.POINTER_SIZE) ).get(0);");
               unit.emitln("    return 0 != pString ? "+elemCountExpr+" : 0;");
               unit.emitln("  }");
           } else {
               unit.emitln("  private int _"+fieldName+"ArrayLen = "+elemCountExpr+"; // "+(constElemCount ? "const" : "initial")+" array length");
-              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, staticElemCount, false, "int", fieldName, capitalFieldName+"ElemCount", null, constElemCount, maxOneElement, elemCountExpr, GetElemCountApiDocTail);
               unit.emitln("  { return _"+fieldName+"ArrayLen; }");
               if( !immutableAccess ) {
-                  generateSetterSignature(unit, fieldType, MethodAccess.PRIVATE, staticElemCount, false, "void", fieldName, capitalFieldName+"ElemCount", null, "int", null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, MethodAccess.PRIVATE, staticElemCount, false, "void", fieldName, capitalFieldName+"ElemCount", null, "int", null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   unit.emitln("  { _"+fieldName+"ArrayLen = src; }");
               }
           }
@@ -1687,13 +1747,13 @@ public class JavaEmitter implements GlueEmitter {
 
       // Null query for pointer
       if( isPointer ) {
-          generateIsNullSignature(unit, fieldType, false, fieldName, capitalFieldName, constElemCount, elemCountExpr);
+          generateIsNullSignature(unit, fieldType, false, fieldName, capitalFieldName, constElemCount, maxOneElement, elemCountExpr);
           unit.emitln(" {");
           unit.emitln("    return 0 == PointerBuffer.wrap(getBuffer(), "+fieldName+"_offset[mdIdx], 1).get(0);");
           unit.emitln("  }");
           unit.emitln();
           if( !constElemCount && !immutableAccess ) {
-              generateReleaseSignature(unit, fieldType, false, containingJTypeName, fieldName, capitalFieldName, constElemCount, elemCountExpr);
+              generateReleaseSignature(unit, fieldType, false, containingJTypeName, fieldName, capitalFieldName, constElemCount, maxOneElement, elemCountExpr);
               unit.emitln(" {");
               unit.emitln("    accessor.setLongAt("+fieldName+"_offset[mdIdx], 0, md.pointerSizeInBytes()); // write nullptr");
               unit.emitln("    _eb"+capitalFieldName+" = null;");
@@ -1708,20 +1768,21 @@ public class JavaEmitter implements GlueEmitter {
 
       // Setter
       if( immutableAccess ) {
-          generateSetterAPIDoc(unit, "SKIP setter for immutable", fieldType, fieldName, constElemCount, elemCountExpr);
+          generateArrayFieldNote(unit, "  /** SKIP setter for immutable", " */", fieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
           unit.emitln();
       } else if( isPointer && isConstValue && constElemCount ) {
-          generateSetterAPIDoc(unit, "SKIP setter for constValue constElemCount Pointer w/ native ownership", fieldType, fieldName, constElemCount, elemCountExpr);
+          generateArrayFieldNote(unit, "  /** SKIP setter for constValue constElemCount Pointer w/ native ownership", " */", fieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
           unit.emitln();
       } else if( !isPointer && isConstValue ) {
-          generateSetterAPIDoc(unit, "SKIP setter for constValue Array", fieldType, fieldName, constElemCount, elemCountExpr);
+          generateArrayFieldNote(unit, "  /** SKIP setter for constValue Array", " */", fieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
           unit.emitln();
       } else if( isPrimitive ) {
           // Setter Primitive
           if( maxOneElement ) {
               // Setter Primitive Single Pointer + Array
               if( isPointer ) {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   if( isConstValue ) {
                       // constElemCount excluded: SKIP setter for constValue constElemCount Pointer w/ native ownership
                       unit.emitln(" {");
@@ -1768,7 +1829,8 @@ public class JavaEmitter implements GlueEmitter {
                       }
                   }
               } else { // array && !isConstValue
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   unit.emitln(" {");
                   unit.emitln("    ElementBuffer.wrap("+primElemSizeExpr+", 1, getBuffer(), "+fieldName+"_offset[mdIdx])");
                   unit.emit  ("      .getByteBuffer()");
@@ -1786,7 +1848,8 @@ public class JavaEmitter implements GlueEmitter {
 
               if( isString && isByteBuffer && isPointer ) { // isConst is OK
                   // isConst && constElemCount excluded: SKIP setter for constValue constElemCount Pointer w/ native ownership
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, "String", null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, "String", null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   unit.emitln(" {");
                   unit.emitln("    final byte[] srcBytes = src.getBytes(_charset);");
                   if( constElemCount ) {
@@ -1808,30 +1871,31 @@ public class JavaEmitter implements GlueEmitter {
                   doneString = true;
               }
               if( doneString && isStringOnly ) {
-                  generateSetterAPIDoc(unit, "SKIP setter for String alternative (ByteBuffer)", fieldType, fieldName, constElemCount, elemCountExpr);
+                  generateArrayFieldNote(unit, "  /** SKIP setter for String alternative (ByteBuffer)", " */", fieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
               } else if( isConstValue ) {
                   if( isPointer ) {
                       // constElemCount excluded: SKIP setter for constValue constElemCount Pointer w/ native ownership
-                      generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                      generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]",
+                                              SetReplaceArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetReplaceArrayApiDocDetail, SetReplaceArrayApiDocArgs);
                       unit.emitln(" {");
-                      unit.emitln(SetArrayArgsCheck);
-                      unit.emitln("    final int newElemCount = destPos + length;");
-                      unit.emitln("    final ElementBuffer eb = ElementBuffer.allocateDirect("+primElemSizeExpr+", newElemCount);");
-                      unit.emit  ("    ( ( "+primJElemTypeBufferName+")(eb.getByteBuffer()");
+                      unit.emitln(SetReplaceArrayArgsCheck);
+                      unit.emitln("    final ElementBuffer eb = ElementBuffer.allocateDirect("+primElemSizeExpr+", length);");
+                      unit.emit  ("    eb.getByteBuffer()");
                       if( !isByteBuffer ) {
                           unit.emit(".as"+primJElemTypeBufferName+"()");
                       }
-                      unit.emitln(".position(destPos) ) ).put(src, srcPos, length).rewind();");
+                      unit.emitln(".put(src, srcPos, length).rewind();");
                       unit.emitln("    eb.storeDirectAddress(getBuffer(), "+fieldName+"_offset[mdIdx]);");
                       unit.emitln("    _eb"+capitalFieldName+" = eb;");
-                      emitSetElemCount(unit, setElemCountLengthFunc, "newElemCount", !useGetCStringLength, capitalFieldName, structCType, "    ");
+                      emitSetElemCount(unit, setElemCountLengthFunc, "length", !useGetCStringLength, capitalFieldName, structCType, "    ");
                       unit.emitln("    return this;");
                       unit.emitln("  }");
                   } // else SKIP setter for constValue Array
               } else if( constElemCount || !isPointer ) {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]",
+                                          SetSubArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetSubArrayApiDocDetail, SetSubArrayApiDocArgs);
                   unit.emitln(" {");
-                  unit.emitln(SetArrayArgsCheck);
+                  unit.emitln(SetSubArrayArgsCheck);
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
                   unit.emitln("    if( destPos + length > elemCount ) { throw new IndexOutOfBoundsException(\"destPos \"+destPos+\" + length \"+length+\" > elemCount \"+elemCount); };");
                   if( isPointer ) {
@@ -1839,33 +1903,45 @@ public class JavaEmitter implements GlueEmitter {
                   } else {
                       unit.emitln("    final ElementBuffer eb = ElementBuffer.wrap("+primElemSizeExpr+", elemCount, getBuffer(), "+fieldName+"_offset[mdIdx]);");
                   }
-                  unit.emit  ("    ( ( "+primJElemTypeBufferName+")(eb.getByteBuffer()");
+                  unit.emit  ("    ( ("+primJElemTypeBufferName+") eb.getByteBuffer()");
                   if( !isByteBuffer ) {
                       unit.emit(".as"+primJElemTypeBufferName+"()");
                   }
-                  unit.emitln(".position(destPos) ) ).put(src, srcPos, length).rewind();");
+                  unit.emitln(".position(destPos) ).put(src, srcPos, length).rewind();");
                   unit.emitln("    return this;");
                   unit.emitln("  }");
               } else /* if( !constElemCount && isPointer ) */ {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, SetArrayArgsPre, baseJElemTypeName+"[]",
+                                          SetArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetArrayApiDocDetail, SetArrayApiDocArgs);
                   unit.emitln(" {");
                   unit.emitln(SetArrayArgsCheck);
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
-                  unit.emitln("    if( destPos + length <= elemCount ) {");
+                  unit.emitln("    if( subset || destPos + length == elemCount ) {");
+                  unit.emitln("      if( destPos + length > elemCount ) { throw new IndexOutOfBoundsException(\"subset \"+subset+\", destPos \"+destPos+\" + length \"+length+\" > elemCount \"+elemCount); };");
                   unit.emitln("      final ElementBuffer eb = ElementBuffer.derefPointer("+primElemSizeExpr+", elemCount, getBuffer(), "+fieldName+"_offset[mdIdx]);");
-                  unit.emit  ("      ( ( "+primJElemTypeBufferName+")(eb.getByteBuffer()");
+                  unit.emit  ("      ( ("+primJElemTypeBufferName+") eb.getByteBuffer()");
                   if( !isByteBuffer ) {
                       unit.emit(".as"+primJElemTypeBufferName+"()");
                   }
-                  unit.emitln(".position(destPos) ) ).put(src, srcPos, length).rewind();");
+                  unit.emitln(".position(destPos) ).put(src, srcPos, length).rewind();");
                   unit.emitln("    } else {");
                   unit.emitln("      final int newElemCount = destPos + length;");
                   unit.emitln("      final ElementBuffer eb = ElementBuffer.allocateDirect("+primElemSizeExpr+", newElemCount);");
-                  unit.emit  ("      ( ( "+primJElemTypeBufferName+")(eb.getByteBuffer()");
+                  unit.emit  ("      final "+primJElemTypeBufferName+" ebBB = eb.getByteBuffer()");
                   if( !isByteBuffer ) {
                       unit.emit(".as"+primJElemTypeBufferName+"()");
                   }
-                  unit.emitln(".position(destPos) ) ).put(src, srcPos, length).rewind();");
+                  unit.emitln(";");
+                  unit.emitln("      if( 0 < destPos ) {");
+                  unit.emitln("        final ElementBuffer pre_eb = ElementBuffer.derefPointer("+primElemSizeExpr+", elemCount, getBuffer(), "+fieldName+"_offset[mdIdx]);");
+                  unit.emit  ("        final "+primJElemTypeBufferName+" pre_ebBB = ("+primJElemTypeBufferName+") pre_eb.getByteBuffer()");
+                  if( !isByteBuffer ) {
+                      unit.emit(".as"+primJElemTypeBufferName+"()");
+                  }
+                  unit.emitln(".position(0).limit(destPos);");
+                  unit.emitln("        ebBB.put(pre_ebBB);");
+                  unit.emitln("      }");
+                  unit.emitln("      ebBB.put(src, srcPos, length).rewind();");
                   unit.emitln("      eb.storeDirectAddress(getBuffer(), "+fieldName+"_offset[mdIdx]);");
                   unit.emitln("      _eb"+capitalFieldName+" = eb;");
                   emitSetElemCount(unit, setElemCountLengthFunc, "newElemCount", !useGetCStringLength, capitalFieldName, structCType, "      ");
@@ -1880,7 +1956,8 @@ public class JavaEmitter implements GlueEmitter {
           if( maxOneElement ) {
               // Setter Struct Single Pointer + Array
               if( isPointer ) {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   if( isConstValue ) {
                       // constElemCount excluded: SKIP setter for constValue constElemCount Pointer w/ native ownership
                       unit.emitln(" {");
@@ -1915,7 +1992,8 @@ public class JavaEmitter implements GlueEmitter {
                       }
                   }
               } else if( !isConstValue ) { // array && !isConstValue
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   unit.emitln(" {");
                   unit.emitln("    ElementBuffer.wrap("+baseJElemTypeName+".size(), 1, getBuffer(), "+fieldName+"_offset[mdIdx])");
                   unit.emitln("      .put(0, src.getBuffer());");
@@ -1928,24 +2006,25 @@ public class JavaEmitter implements GlueEmitter {
               if( isConstValue ) {
                   if( isPointer ) {
                       // constElemCount excluded: SKIP setter for constValue constElemCount Pointer w/ native ownership
-                      generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                      generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]",
+                                              SetReplaceArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetReplaceArrayApiDocDetail, SetReplaceArrayApiDocArgs);
                       unit.emitln(" {");
-                      unit.emitln(SetArrayArgsCheck);
-                      unit.emitln("    final int newElemCount = destPos + length;");
-                      unit.emitln("    final ElementBuffer eb = ElementBuffer.allocateDirect("+baseJElemTypeName+".size(), newElemCount);");
+                      unit.emitln(SetReplaceArrayArgsCheck);
+                      unit.emitln("    final ElementBuffer eb = ElementBuffer.allocateDirect("+baseJElemTypeName+".size(), length);");
                       unit.emitln("    for(int i=0; i<length; ++i) {");
-                      unit.emitln("      eb.put(destPos+i, src[srcPos+i].getBuffer());");
+                      unit.emitln("      eb.put(i, src[srcPos+i].getBuffer());");
                       unit.emitln("    }");
                       unit.emitln("    eb.storeDirectAddress(getBuffer(), "+fieldName+"_offset[mdIdx]);");
                       unit.emitln("    _eb"+capitalFieldName+" = eb;");
-                      emitSetElemCount(unit, setElemCountLengthFunc, "newElemCount", !useGetCStringLength, capitalFieldName, structCType, "    ");
+                      emitSetElemCount(unit, setElemCountLengthFunc, "length", !useGetCStringLength, capitalFieldName, structCType, "    ");
                       unit.emitln("    return this;");
                       unit.emitln("  }");
                   } // else SKIP setter for constValue Array
               } else if( constElemCount || !isPointer ) {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]",
+                                          SetSubArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetSubArrayApiDocDetail, SetSubArrayApiDocArgs);
                   unit.emitln(" {");
-                  unit.emitln(SetArrayArgsCheck);
+                  unit.emitln(SetSubArrayArgsCheck);
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
                   unit.emitln("    if( destPos + length > elemCount ) { throw new IndexOutOfBoundsException(\"destPos \"+destPos+\" + length \"+length+\" > elemCount \"+elemCount); };");
                   if( isPointer ) {
@@ -1959,11 +2038,13 @@ public class JavaEmitter implements GlueEmitter {
                   unit.emitln("    return this;");
                   unit.emitln("  }");
               } else /* if( !constElemCount && isPointer ) */ {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, null, baseJElemTypeName+"[]", SetArrayArgs, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, SetArrayArgsPre, baseJElemTypeName+"[]",
+                                          SetArrayArgsPost, constElemCount, maxOneElement, elemCountExpr, SetArrayApiDocDetail, SetArrayApiDocArgs);
                   unit.emitln(" {");
                   unit.emitln(SetArrayArgsCheck);
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
-                  unit.emitln("    if( destPos + length <= elemCount ) {");
+                  unit.emitln("    if( subset || destPos + length == elemCount ) {");
+                  unit.emitln("      if( destPos + length > elemCount ) { throw new IndexOutOfBoundsException(\"subset \"+subset+\", destPos \"+destPos+\" + length \"+length+\" > elemCount \"+elemCount); };");
                   unit.emitln("      final ElementBuffer eb = ElementBuffer.derefPointer("+baseJElemTypeName+".size(), elemCount, getBuffer(), "+fieldName+"_offset[mdIdx]);");
                   unit.emitln("      for(int i=0; i<length; ++i) {");
                   unit.emitln("        eb.put(destPos+i, src[srcPos+i].getBuffer());");
@@ -1971,6 +2052,11 @@ public class JavaEmitter implements GlueEmitter {
                   unit.emitln("    } else {");
                   unit.emitln("      final int newElemCount = destPos + length;");
                   unit.emitln("      final ElementBuffer eb = ElementBuffer.allocateDirect("+baseJElemTypeName+".size(), newElemCount);");
+
+                  unit.emitln("      if( 0 < destPos ) {");
+                  unit.emitln("        final ElementBuffer pre_eb = ElementBuffer.derefPointer("+baseJElemTypeName+".size(), elemCount, getBuffer(), "+fieldName+"_offset[mdIdx]);");
+                  unit.emitln("        eb.put(pre_eb.getByteBuffer(), 0, 0, destPos);");
+                  unit.emitln("      }");
                   unit.emitln("      for(int i=0; i<length; ++i) {");
                   unit.emitln("        eb.put(destPos+i, src[srcPos+i].getBuffer());");
                   unit.emitln("      }");
@@ -1983,7 +2069,8 @@ public class JavaEmitter implements GlueEmitter {
               }
               unit.emitln();
               if( !isConstValue ) {
-                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, "final int destPos", baseJElemTypeName, null, constElemCount, elemCountExpr);
+                  generateSetterSignature(unit, fieldType, accessMod, false, false, containingJTypeName, fieldName, capitalFieldName, "final int destPos", baseJElemTypeName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, null, null);
                   unit.emitln(" {");
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
                   unit.emitln("    if( destPos + 1 > elemCount ) { throw new IndexOutOfBoundsException(\"destPos \"+destPos+\" + 1 > elemCount \"+elemCount); };");
@@ -2004,7 +2091,8 @@ public class JavaEmitter implements GlueEmitter {
       if( isPrimitive ) {
           // Getter Primitive Pointer + Array
           if( maxOneElement ) {
-              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName, fieldName, capitalFieldName, null, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName, fieldName, capitalFieldName, null,
+                                      constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
               unit.emitln(" {");
               if( isPointer ) {
                   unit.emitln("    return ElementBuffer.derefPointer("+primElemSizeExpr+", 1, getBuffer(), "+fieldName+"_offset[mdIdx])");
@@ -2021,7 +2109,8 @@ public class JavaEmitter implements GlueEmitter {
           } else {
               boolean doneString = false;
               if( isString && isByteBuffer ) {
-                  generateGetterSignature(unit, fieldType, false, false, "String", fieldName, capitalFieldName+(isStringOnly?"":"AsString"), null, constElemCount, elemCountExpr);
+                  generateGetterSignature(unit, fieldType, false, false, "String", fieldName, capitalFieldName+(isStringOnly?"":"AsString"), null,
+                                          constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
                   unit.emitln(" {");
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
                   if( isPointer ) {
@@ -2041,10 +2130,11 @@ public class JavaEmitter implements GlueEmitter {
                   doneString = true;
               }
               if( doneString && isStringOnly ) {
-                  generateSetterAPIDoc(unit, "SKIP getter for String alternative (ByteBuffer)", fieldType, fieldName, constElemCount, elemCountExpr);
+                  generateArrayFieldNote(unit, "  /** SKIP getter for String alternative (ByteBuffer)", " */", fieldType, fieldName, constElemCount, maxOneElement, elemCountExpr);
                   unit.emitln();
               } else {
-                  generateGetterSignature(unit, fieldType, false, false, primJElemTypeBufferName, fieldName, capitalFieldName, null, constElemCount, elemCountExpr);
+                  generateGetterSignature(unit, fieldType, false, false, primJElemTypeBufferName, fieldName, capitalFieldName, null,
+                                          constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
                   unit.emitln(" {");
                   if( isPointer ) {
                       unit.emitln("    return ElementBuffer.derefPointer("+primElemSizeExpr+", "+getElemCountFuncExpr+", getBuffer(), "+fieldName+"_offset[mdIdx])");
@@ -2060,7 +2150,8 @@ public class JavaEmitter implements GlueEmitter {
                   unit.emitln();
               }
               if( !doneString ) {
-                  generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName+"[]", fieldName, capitalFieldName, "final int srcPos, "+baseJElemTypeName+" dest[], "+GetArrayArgs, constElemCount, elemCountExpr);
+                  generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName+"[]", fieldName, capitalFieldName, "final int srcPos, "+baseJElemTypeName+" dest[], "+GetArrayArgs,
+                                          constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
                   unit.emitln(" {");
                   unit.emitln(GetArrayArgsCheck);
                   unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
@@ -2084,7 +2175,8 @@ public class JavaEmitter implements GlueEmitter {
       } else {
           // Getter Struct Pointer + Array
           if( maxOneElement ) {
-              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName, fieldName, capitalFieldName, null, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName, fieldName, capitalFieldName, null,
+                                      constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
               unit.emitln(" {");
               unit.emitln("    return "+baseJElemTypeName+".create(");
               if( isPointer ) {
@@ -2095,7 +2187,8 @@ public class JavaEmitter implements GlueEmitter {
               unit.emitln("  }");
               unit.emitln();
           } else {
-              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName+"[]", fieldName, capitalFieldName, "final int srcPos, "+baseJElemTypeName+" dest[], "+GetArrayArgs, constElemCount, elemCountExpr);
+              generateGetterSignature(unit, fieldType, false, false, baseJElemTypeName+"[]", fieldName, capitalFieldName, "final int srcPos, "+baseJElemTypeName+" dest[], "+GetArrayArgs,
+                                      constElemCount, maxOneElement, elemCountExpr, GetElemValueApiDocTail);
               unit.emitln(" {");
               unit.emitln(GetArrayArgsCheck);
               unit.emitln("    final int elemCount = "+getElemCountFuncExpr+";");
diff --git a/src/java/com/jogamp/gluegen/cgram/types/Type.java b/src/java/com/jogamp/gluegen/cgram/types/Type.java
index 04c46af..2c32235 100644
--- a/src/java/com/jogamp/gluegen/cgram/types/Type.java
+++ b/src/java/com/jogamp/gluegen/cgram/types/Type.java
@@ -170,11 +170,11 @@ public abstract class Type implements SemanticEqualityOp, ASTLocusTagProvider {
       sb.append(val);
       return sb;
   }
-  // For debugging
-  public final String getDebugString() {
-    final StringBuilder sb = new StringBuilder();
+  public final StringBuilder getSignature(StringBuilder sb) {
+    if( null == sb ) {
+        sb = new StringBuilder();
+    }
     boolean prepComma = false;
-    sb.append("CType[");
     sb.append("(").append(getClass().getSimpleName()).append(") ");
     if( isTypedef() ) {
         sb.append("typedef ");
@@ -211,7 +211,6 @@ public abstract class Type implements SemanticEqualityOp, ASTLocusTagProvider {
     } else {
         sb.append(" ZERO");
     }
-    append(sb, "[", prepComma); prepComma=false;
     {
         append(sb, "const[", prepComma); prepComma=false;
         {
@@ -268,8 +267,15 @@ public abstract class Type implements SemanticEqualityOp, ASTLocusTagProvider {
         if( isVoid() ) {
             append(sb, "void", prepComma); prepComma=true;
         }
-        sb.append("]");
     }
+    return sb;
+  }
+
+  // For debugging
+  public final String getDebugString() {
+    final StringBuilder sb = new StringBuilder();
+    sb.append("CType[");
+    getSignature(sb);
     sb.append("]");
     return sb.toString();
   }
diff --git a/src/junit/com/jogamp/gluegen/test/junit/generation/BaseClass.java b/src/junit/com/jogamp/gluegen/test/junit/generation/BaseClass.java
index ed23f54..071d2d7 100644
--- a/src/junit/com/jogamp/gluegen/test/junit/generation/BaseClass.java
+++ b/src/junit/com/jogamp/gluegen/test/junit/generation/BaseClass.java
@@ -1481,7 +1481,6 @@ public class BaseClass extends SingletonJunitCase {
     }
 
     /** Primitive.ConstValue.int32.Pointer - write access */
-    @SuppressWarnings("unused")
     private void chapter12_03bTestTKFieldConstValueInt32WriteAccess(final TK_Field model) {
         Assert.assertEquals(0, model.getConstInt32PointerMaxOneElemElemCount());
         Assert.assertEquals(true, model.isConstInt32PointerMaxOneElemNull());
@@ -1545,7 +1544,7 @@ public class BaseClass extends SingletonJunitCase {
             // write 1 via int[] set, also actually allocating initial memory
             {
                 final int[] ia = { 220, 221, 222, 223, 224 };
-                model.setConstInt32PointerVariaLen(ia, 0, 0, ia.length);
+                model.setConstInt32PointerVariaLen(ia, 0, ia.length);
             }
             // verify 1
             {
@@ -1620,7 +1619,7 @@ public class BaseClass extends SingletonJunitCase {
             // write 2 via int[] set
             {
                 final int[] ia = { 0, 220, 221, 222, 223, 224, 0 };
-                model.setConstInt32PointerCustomLen(ia, 1 /* srcPos */, 0 /* destPos */, ia.length-2);
+                model.setConstInt32PointerCustomLen(ia, 1 /* srcPos */, ia.length-2);
             }
             // verify 2
             {
@@ -1735,7 +1734,6 @@ public class BaseClass extends SingletonJunitCase {
     }
 
     /** Primitive.VariaValue.int32.Pointer - write access */
-    @SuppressWarnings("unused")
     private void chapter12_04bTestTKFieldVariaValueInt32WriteAccess(final TK_Field model) {
         Assert.assertEquals(1, TK_Field.getVariaInt32PointerConstOneElemElemCount());
         Assert.assertEquals(false, model.isVariaInt32PointerConstOneElemNull());
@@ -1801,18 +1799,10 @@ public class BaseClass extends SingletonJunitCase {
                     Assert.assertEquals(220 + i, s[0]);
                 }
             }
-            {
-            }
             // write 3 via int[] single set @ offset
-            if( false ) {
             {
-                final int[] ia = { 0, 320, 321, 322 };
-                for(int i=0; i<3; i++) {
-                    model.setVariaInt32PointerConstLen(ia, i+1, i, 3-i);
-                }
-                model.setVariaInt32PointerConstLen(new int[]{ 0, 320,   0,   0 }, 0+1 /* srcPos */, 0 /* destPos */, 3);
-                model.setVariaInt32PointerConstLen(new int[]{ 0,   0, 321,   0 }, 1+1 /* srcPos */, 1 /* destPos */, 2);
-                model.setVariaInt32PointerConstLen(new int[]{ 0,   0,   0, 322 }, 2+1 /* srcPos */, 2 /* destPos */, 1);
+                final int[] ia = { 0, 321, 322 };
+                model.setVariaInt32PointerConstLen(ia, 1, 1, 2);
             }
             // verify 3
             {
@@ -1822,14 +1812,19 @@ public class BaseClass extends SingletonJunitCase {
                 final IntBuffer allB = model.getVariaInt32PointerConstLen();
                 Assert.assertEquals(size, all.length);
                 Assert.assertEquals(size, allB.limit());
-                for(int i=0; i<size; i++) {
+                for(int i=0; i<1; i++) {
+                    Assert.assertEquals(220 + i, all[i]);
+                    Assert.assertEquals(220 + i, allB.get(i));
+                    final int[] s = model.getVariaInt32PointerConstLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(220 + i, s[0]);
+                }
+                for(int i=1; i<size; i++) {
                     Assert.assertEquals(320 + i, all[i]);
                     Assert.assertEquals(320 + i, allB.get(i));
                     final int[] s = model.getVariaInt32PointerConstLen(i, new int[1], 0, 1);
                     Assert.assertEquals(320 + i, s[0]);
                 }
             }
-            }
         }
 
         Assert.assertEquals(0, model.getVariaInt32PointerVariaLenElemCount());
@@ -1855,7 +1850,7 @@ public class BaseClass extends SingletonJunitCase {
             // write 1 via int[] set, also actually allocating initial memory
             {
                 final int[] ia = { 220, 221, 222, 223, 224 };
-                model.setVariaInt32PointerVariaLen(ia, 0, 0, ia.length);
+                model.setVariaInt32PointerVariaLen(false /* subset */, ia, 0, 0, ia.length);
             }
             // verify 1
             {
@@ -1927,10 +1922,10 @@ public class BaseClass extends SingletonJunitCase {
                     Assert.assertEquals(120 + i, s[0]);
                 }
             }
-            // write 2 via int[] set
+            // write 2 via int[] set all, keep 1st element by writing to destPos 1, 5 elements total, 4 written
             {
                 final int[] ia = { 0, 220, 221, 222, 223, 224, 0 };
-                model.setVariaInt32PointerCustomLen(ia, 1 /* srcPos */, 0 /* destPos */, ia.length-2);
+                model.setVariaInt32PointerCustomLen(false /* subset */, ia, 2 /* srcPos */, 1 /* destPos */, ia.length-1-2);
             }
             // verify 2
             {
@@ -1940,13 +1935,54 @@ public class BaseClass extends SingletonJunitCase {
                 final IntBuffer allB = model.getVariaInt32PointerCustomLen();
                 Assert.assertEquals(size, all.length);
                 Assert.assertEquals(size, allB.limit());
-                for(int i=0; i<size; i++) {
+                for(int i=0; i<1; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaInt32PointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+                for(int i=1; i<size; i++) {
                     Assert.assertEquals(220 + i, all[i]);
                     Assert.assertEquals(220 + i, allB.get(i));
                     final int[] s = model.getVariaInt32PointerCustomLen(i, new int[1], 0, 1);
                     Assert.assertEquals(220 + i, s[0]);
                 }
             }
+            // write 3 via int[] set a subset only
+            {
+                final int[] ia = { 0, 0, 322, 323, 324, 0, 0 };
+                model.setVariaInt32PointerCustomLen(true /* subset */, ia, 2 /* srcPos */, 2 /* destPos */, 3);
+            }
+            // verify 2
+            {
+                final int size = model.getVariaInt32PointerCustomLenElemCount();
+                Assert.assertEquals(5, size);
+                final int[] all = model.getVariaInt32PointerCustomLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaInt32PointerCustomLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<size; i++) {
+                    System.err.printf("%d/%d: A %d, B %d%n", i, size, all[i], allB.get(i));
+                }
+                for(int i=0; i<1; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaInt32PointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+                for(int i=1; i<2; i++) {
+                    Assert.assertEquals(220 + i, all[i]);
+                    Assert.assertEquals(220 + i, allB.get(i));
+                    final int[] s = model.getVariaInt32PointerCustomLen(i, new int[3], 1, 1);
+                    Assert.assertEquals(220 + i, s[1]);
+                }
+                for(int i=2; i<size; i++) {
+                    Assert.assertEquals(320 + i, all[i]);
+                    Assert.assertEquals(320 + i, allB.get(i));
+                    final int[] s = model.getVariaInt32PointerCustomLen(i, new int[3], 2, 1);
+                    Assert.assertEquals(320 + i, s[2]);
+                }
+            }
             model.releaseVariaInt32PointerCustomLen(); // FIXME: Ownership is ambiguous, may leak native allocated memory, not free'ed!
             Assert.assertEquals(0, model.getVariaInt32PointerCustomLenElemCount());
             Assert.assertEquals(true, model.isVariaInt32PointerCustomLenNull());
@@ -1955,7 +1991,7 @@ public class BaseClass extends SingletonJunitCase {
 
 
     /** Struct */
-    private void chapter12_05aTestTKFieldStruct(final TK_Field model) {
+    private void chapter12_05aTestTKFieldConstValueStructReadAccess(final TK_Field model) {
         // field: structArrayOneElem
         //        CType['TK_Dimension *', size [fixed false, lnx64 16], [array*1]], with array length of 1
         {
@@ -1992,6 +2028,261 @@ public class BaseClass extends SingletonJunitCase {
         }
     }
 
+    private static TK_Dimension createTKDim(final int x, final int y, final int w, final int h) {
+        return TK_Dimension.create().setX(x).setY(y).setWidth(w).setHeight(h);
+    }
+    private static boolean equals(final TK_Dimension a, final TK_Dimension b) {
+        if( a == b ) {
+            return true;
+        }
+        return a.getX() == b.getX() &&
+               a.getY() == b.getY() &&
+               a.getWidth() == b.getWidth() &&
+               a.getHeight() == b.getHeight();
+    }
+
+    /** Primitive.VariaValue.Struct.Pointer - write access */
+    private void chapter12_06bTestTKFieldVariaValueStructWriteAccess(final TK_Field model) {
+        Assert.assertEquals(1, TK_Field.getVariaStructPointerConstOneElemElemCount());
+        Assert.assertEquals(false, model.isVariaStructPointerConstOneElemNull());
+        {
+            final TK_Dimension val = createTKDim(10, 11, 100, 111);
+            model.setVariaStructPointerConstOneElem(val);
+            Assert.assertTrue( equals(val, model.getVariaStructPointerConstOneElem()) );
+        }
+
+        Assert.assertEquals(0, model.getVariaStructPointerMaxOneElemElemCount());
+        Assert.assertEquals(true, model.isVariaStructPointerMaxOneElemNull());
+        {
+            final TK_Dimension val = createTKDim(20, 21, 200, 211);
+            model.setVariaStructPointerMaxOneElem(val);
+            Assert.assertEquals(1, model.getVariaStructPointerMaxOneElemElemCount());
+            Assert.assertEquals(false, model.isVariaStructPointerMaxOneElemNull());
+            Assert.assertTrue( equals(val, model.getVariaStructPointerMaxOneElem()) );
+            model.releaseVariaStructPointerMaxOneElem();
+            Assert.assertEquals(0, model.getVariaStructPointerMaxOneElemElemCount());
+            Assert.assertEquals(true, model.isVariaStructPointerMaxOneElemNull());
+        }
+
+        Assert.assertEquals(3, TK_Field.getVariaStructPointerConstLenElemCount());
+        Assert.assertEquals(false, model.isVariaStructPointerConstLenNull());
+        {
+            // No write/verify 1 via ByteBuffer reference
+
+            // write 2 via TK_Dimension[] set
+            {
+                final TK_Dimension[] all = new TK_Dimension[3];
+                for(int i=0; i<3; ++i) {
+                    all[i] = createTKDim(i*10, i*10+1, 100+i*10, 100+i*10+1);
+                }
+                model.setVariaStructPointerConstLen(all, 0, 0, 3);
+            }
+            // verify 2
+            {
+                final int size = TK_Field.getVariaStructPointerConstLenElemCount();
+                Assert.assertEquals(3, size);
+                final TK_Dimension[] all = model.getVariaStructPointerConstLen(0, new TK_Dimension[3], 0, 3);
+                Assert.assertEquals(size, all.length);
+                for(int i=0; i<size; i++) {
+                    final TK_Dimension val = createTKDim(i*10, i*10+1, 100+i*10, 100+i*10+1);
+                    Assert.assertTrue( equals(val, all[i]) );
+                    final TK_Dimension[] s = model.getVariaStructPointerConstLen(i, new TK_Dimension[1], 0, 1);
+                    Assert.assertTrue( equals(val, s[0]) );
+                }
+            }
+            // write 3 via int[] single set @ offset
+            {
+                final TK_Dimension[] all = new TK_Dimension[3];
+                for(int i=1; i<3; ++i) {
+                    all[i] = createTKDim(i*20, i*20+1, 100+i*20, 100+i*20+1);
+                }
+                model.setVariaStructPointerConstLen(all, 1, 1, 2);
+            }
+            // verify 3
+            {
+                final int size = TK_Field.getVariaStructPointerConstLenElemCount();
+                Assert.assertEquals(3, size);
+                final TK_Dimension[] all = model.getVariaStructPointerConstLen(0, new TK_Dimension[3], 0, 3);
+                Assert.assertEquals(size, all.length);
+                for(int i=0; i<1; i++) {
+                    final TK_Dimension val = createTKDim(i*10, i*10+1, 100+i*10, 100+i*10+1);
+                    Assert.assertTrue( equals(val, all[i]) );
+                    final TK_Dimension[] s = model.getVariaStructPointerConstLen(i, new TK_Dimension[1], 0, 1);
+                    Assert.assertTrue( equals(val, s[0]) );
+                }
+                for(int i=1; i<size; i++) {
+                    final TK_Dimension val = createTKDim(i*20, i*20+1, 100+i*20, 100+i*20+1);
+                    Assert.assertTrue( equals(val, all[i]) );
+                    final TK_Dimension[] s = model.getVariaStructPointerConstLen(i, new TK_Dimension[1], 0, 1);
+                    Assert.assertTrue( equals(val, s[0]) );
+                }
+            }
+        }
+
+        Assert.assertEquals(0, model.getVariaStructPointerVariaLenElemCount());
+        Assert.assertEquals(true, model.isVariaStructPointerVariaLenNull());
+        /**
+        {
+            Exception e1 = null;
+            try {
+                @SuppressWarnings("unused")
+                final IntBuffer ib = model.getVariaStructPointerVariaLen(); // NULL -> exception
+            } catch(final Exception _e) { e1 = _e; }
+            Assert.assertNotNull(e1);
+            System.err.println("Expected exception-1: "+e1);
+
+            Exception e2 = null;
+            try {
+                @SuppressWarnings("unused")
+                final int[] ia = model.getVariaStructPointerVariaLen(0, new int[0], 0, 0); // NULL -> exception
+            } catch(final Exception _e) { e2 = _e; }
+            Assert.assertNotNull(e2);
+            System.err.println("Expected exception-2: "+e2);
+        }
+        {
+            // write 1 via int[] set, also actually allocating initial memory
+            {
+                final int[] ia = { 220, 221, 222, 223, 224 };
+                model.setVariaStructPointerVariaLen(false, ia, 0, 0, ia.length);
+            }
+            // verify 1
+            {
+                final int size = model.getVariaStructPointerVariaLenElemCount();
+                Assert.assertEquals(5, size);
+                final int[] all = model.getVariaStructPointerVariaLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaStructPointerVariaLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<size; i++) {
+                    Assert.assertEquals(220 + i, all[i]);
+                    Assert.assertEquals(220 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerVariaLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(220 + i, s[0]);
+                }
+            }
+            // write 2 via IntBuffer reference get
+            {
+                final IntBuffer ib = model.getVariaStructPointerVariaLen();
+                Assert.assertEquals(5, ib.limit());
+                for(int i=0; i<5; ++i) {
+                    ib.put(i, 120+i);
+                }
+            }
+            // verify 2
+            {
+                final int size = model.getVariaStructPointerVariaLenElemCount();
+                Assert.assertEquals(5, size);
+                final int[] all = model.getVariaStructPointerVariaLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaStructPointerVariaLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<size; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerVariaLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+            }
+            model.releaseVariaStructPointerVariaLen();
+            Assert.assertEquals(0, model.getVariaStructPointerVariaLenElemCount());
+            Assert.assertEquals(true, model.isVariaStructPointerVariaLenNull());
+        }
+
+        {
+            // write 1 via IntBuffer reference get
+            {
+                final int size = model.getVariaStructPointerCustomLenElemCount();
+                Assert.assertEquals(4, size);
+                Assert.assertEquals(false, model.isVariaStructPointerCustomLenNull());
+                final IntBuffer ib = model.getVariaStructPointerCustomLen();
+                Assert.assertEquals(size, ib.limit());
+                for(int i=0; i<size; ++i) {
+                    ib.put(i, 120+i);
+                }
+            }
+            // verify 1
+            {
+                final int size = model.getVariaStructPointerCustomLenElemCount();
+                Assert.assertEquals(4, size);
+                final int[] all = model.getVariaStructPointerCustomLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaStructPointerCustomLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<size; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+            }
+            // write 2 via int[] set all, keep 1st element by writing to destPos 1, 5 elements total, 4 written
+            {
+                final int[] ia = { 0, 220, 221, 222, 223, 224, 0 };
+                model.setVariaStructPointerCustomLen(false, ia, 2, 1, ia.length-1-2);
+            }
+            // verify 2
+            {
+                final int size = model.getVariaStructPointerCustomLenElemCount();
+                Assert.assertEquals(5, size);
+                final int[] all = model.getVariaStructPointerCustomLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaStructPointerCustomLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<1; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+                for(int i=1; i<size; i++) {
+                    Assert.assertEquals(220 + i, all[i]);
+                    Assert.assertEquals(220 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(220 + i, s[0]);
+                }
+            }
+            // write 3 via int[] set a subset only
+            {
+                final int[] ia = { 0, 0, 322, 323, 324, 0, 0 };
+                model.setVariaStructPointerCustomLen(true, ia, 2, 2, 3);
+            }
+            // verify 2
+            {
+                final int size = model.getVariaStructPointerCustomLenElemCount();
+                Assert.assertEquals(5, size);
+                final int[] all = model.getVariaStructPointerCustomLen(0, new int[size], 0, size);
+                final IntBuffer allB = model.getVariaStructPointerCustomLen();
+                Assert.assertEquals(size, all.length);
+                Assert.assertEquals(size, allB.limit());
+                for(int i=0; i<size; i++) {
+                    System.err.printf("%d/%d: A %d, B %d%n", i, size, all[i], allB.get(i));
+                }
+                for(int i=0; i<1; i++) {
+                    Assert.assertEquals(120 + i, all[i]);
+                    Assert.assertEquals(120 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[1], 0, 1);
+                    Assert.assertEquals(120 + i, s[0]);
+                }
+                for(int i=1; i<2; i++) {
+                    Assert.assertEquals(220 + i, all[i]);
+                    Assert.assertEquals(220 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[3], 1, 1);
+                    Assert.assertEquals(220 + i, s[1]);
+                }
+                for(int i=2; i<size; i++) {
+                    Assert.assertEquals(320 + i, all[i]);
+                    Assert.assertEquals(320 + i, allB.get(i));
+                    final int[] s = model.getVariaStructPointerCustomLen(i, new int[3], 2, 1);
+                    Assert.assertEquals(320 + i, s[2]);
+                }
+            }
+            model.releaseVariaStructPointerCustomLen(); // FIXME: Ownership is ambiguous, may leak native allocated memory, not free'ed!
+            Assert.assertEquals(0, model.getVariaStructPointerCustomLenElemCount());
+            Assert.assertEquals(true, model.isVariaStructPointerCustomLenNull());
+        }
+        */
+    }
+
     private static ByteBuffer toEOSByteBuffer(final String val, final Charset cs) {
         final byte[] ba = val.getBytes( cs );
         final ByteBuffer bb = Buffers.newDirectByteBuffer( ba.length + 1 );
@@ -2188,7 +2479,8 @@ public class BaseClass extends SingletonJunitCase {
         chapter12_03bTestTKFieldConstValueInt32WriteAccess(model0);
         chapter12_04aTestTKFieldVariaValueInt32ReadAccess(model0);
         chapter12_04bTestTKFieldVariaValueInt32WriteAccess(model0);
-        chapter12_05aTestTKFieldStruct(model0);
+        chapter12_05aTestTKFieldConstValueStructReadAccess(model0);
+        chapter12_06bTestTKFieldVariaValueStructWriteAccess(model0);
         chapter12_10aTestTKFieldConstStringReadAccess(model0);
         chapter12_11aTestTKFieldConstStringOnlyReadAccess(model0);
         chapter12_11bTestTKFieldConstStringOnlyWriteAccess(model0);