several small refactorings, api and javadoc improvements.

added automatically generated specialized CLExceptions for each known OpenCL error.
added get/set Properties to CLCommandQueue.

1 files changed, 619 insertions, 108 deletions

diff --git a/src/com/mbien/opencl/CLException.java b/src/com/mbien/opencl/CLException.java
index 81e96789..2f6a02a4 100644
--- a/src/com/mbien/opencl/CLException.java
+++ b/src/com/mbien/opencl/CLException.java
@@ -3,191 +3,702 @@ package com.mbien.opencl;
 import static com.mbien.opencl.CL.*;
 
 /**
- * Main Exception type for runtime OpenCL errors and unsuccessful function calls (e.g. returning not CL_SUCCESS).
+ * Main Exception type for runtime OpenCL errors and failed function calls (e.g. returning not CL_SUCCESS).
  * @author Michael Bien
  */
 public class CLException extends RuntimeException {
 
+    // must be positive
+    private static final long serialVersionUID = 6573520735486076436L;
+
     public final int errorcode;
+    public final String error;
 
-    private final static String ERROR_CODE_DOC = "http://www.khronos.org/opencl/sdk/1.0/docs/man/xhtml/errors.html";
+    private final static String ERROR_CODE_DOC =
+            "http://www.khronos.org/opencl/sdk/1.0/docs/man/xhtml/errors.html";
 
     public CLException(String message) {
         super(message);
         errorcode = 0;
+        error = "none";
     }
 
-    public CLException(int error, String message) {
-        super(message + "\nerror: " + identifyError(error) + " (man page: "+ERROR_CODE_DOC+")");
-        errorcode = error;
+    private CLException(int errorcode, String errorStr, String message) {
+        super(message + "\nerror: " + errorStr + " (man page: "+ERROR_CODE_DOC+")");
+        this.error = errorStr;
+        this.errorcode = errorcode;
     }
 
     /**
      * Throws a CLException when <code>status != CL_SUCCESS</code>.
      */
     public static final void checkForError(int status, String message) {
-        if(status != CL_SUCCESS)
-            throw new CLException(status, message);
+        if(status != CL_SUCCESS) {
+            CLException ex = newException(status, message);
+            ex.fillInStackTrace();
+            throw ex;
+        }
+    }
+
+    /**
+     * Returns a CLException specific to the error code.
+     */
+    public static final CLException newException(int status, String message) {
+        CLException specificEx = createSpecificException(status, message);
+        if(specificEx != null) {
+            specificEx.fillInStackTrace();
+            return specificEx;
+        }
+        return new CLException(status, "unknown", "unknown cause: code" + status);
     }
 
     /**
      * Returns a human readable String for the OpenCL error code.
      */
     public String getCLErrorString() {
-        return identifyError(errorcode);
+        return error;
     }
 
-    private static final String identifyError(int error) {
 
-        switch (error) {
-            case CL_DEVICE_NOT_FOUND:
-                return "CL_DEVICE_NOT_FOUND";
+     // - - - generated code do not edit - - -
 
-            case CL_DEVICE_NOT_AVAILABLE:
-                return "CL_DEVICE_NOT_AVAILABLE";
+    /**
+     * Returns a human readable String for the OpenCL error code or null if not known.
+     */
+    public static String resolveErrorCode(int error) {
+        switch(error) {
+            case CL_DEVICE_NOT_FOUND:                       return "CL_DEVICE_NOT_FOUND";
+            case CL_DEVICE_NOT_AVAILABLE:                   return "CL_DEVICE_NOT_AVAILABLE";
+            case CL_COMPILER_NOT_AVAILABLE:                 return "CL_COMPILER_NOT_AVAILABLE";
+            case CL_MEM_OBJECT_ALLOCATION_FAILURE:          return "CL_MEM_OBJECT_ALLOCATION_FAILURE";
+            case CL_OUT_OF_RESOURCES:                       return "CL_OUT_OF_RESOURCES";
+            case CL_OUT_OF_HOST_MEMORY:                     return "CL_OUT_OF_HOST_MEMORY";
+            case CL_PROFILING_INFO_NOT_AVAILABLE:           return "CL_PROFILING_INFO_NOT_AVAILABLE";
+            case CL_MEM_COPY_OVERLAP:                       return "CL_MEM_COPY_OVERLAP";
+            case CL_IMAGE_FORMAT_MISMATCH:                  return "CL_IMAGE_FORMAT_MISMATCH";
+            case CL_IMAGE_FORMAT_NOT_SUPPORTED:             return "CL_IMAGE_FORMAT_NOT_SUPPORTED";
+            case CL_BUILD_PROGRAM_FAILURE:                  return "CL_BUILD_PROGRAM_FAILURE";
+            case CL_MAP_FAILURE:                            return "CL_MAP_FAILURE";
+            case CL_INVALID_VALUE:                          return "CL_INVALID_VALUE";
+            case CL_INVALID_DEVICE_TYPE:                    return "CL_INVALID_DEVICE_TYPE";
+            case CL_INVALID_PLATFORM:                       return "CL_INVALID_PLATFORM";
+            case CL_INVALID_DEVICE:                         return "CL_INVALID_DEVICE";
+            case CL_INVALID_CONTEXT:                        return "CL_INVALID_CONTEXT";
+            case CL_INVALID_QUEUE_PROPERTIES:               return "CL_INVALID_QUEUE_PROPERTIES";
+            case CL_INVALID_COMMAND_QUEUE:                  return "CL_INVALID_COMMAND_QUEUE";
+            case CL_INVALID_HOST_PTR:                       return "CL_INVALID_HOST_PTR";
+            case CL_INVALID_MEM_OBJECT:                     return "CL_INVALID_MEM_OBJECT";
+            case CL_INVALID_IMAGE_FORMAT_DESCRIPTOR:        return "CL_INVALID_IMAGE_FORMAT_DESCRIPTOR";
+            case CL_INVALID_IMAGE_SIZE:                     return "CL_INVALID_IMAGE_SIZE";
+            case CL_INVALID_SAMPLER:                        return "CL_INVALID_SAMPLER";
+            case CL_INVALID_BINARY:                         return "CL_INVALID_BINARY";
+            case CL_INVALID_BUILD_OPTIONS:                  return "CL_INVALID_BUILD_OPTIONS";
+            case CL_INVALID_PROGRAM:                        return "CL_INVALID_PROGRAM";
+            case CL_INVALID_PROGRAM_EXECUTABLE:             return "CL_INVALID_PROGRAM_EXECUTABLE";
+            case CL_INVALID_KERNEL_NAME:                    return "CL_INVALID_KERNEL_NAME";
+            case CL_INVALID_KERNEL_DEFINITION:              return "CL_INVALID_KERNEL_DEFINITION";
+            case CL_INVALID_KERNEL:                         return "CL_INVALID_KERNEL";
+            case CL_INVALID_ARG_INDEX:                      return "CL_INVALID_ARG_INDEX";
+            case CL_INVALID_ARG_VALUE:                      return "CL_INVALID_ARG_VALUE";
+            case CL_INVALID_ARG_SIZE:                       return "CL_INVALID_ARG_SIZE";
+            case CL_INVALID_KERNEL_ARGS:                    return "CL_INVALID_KERNEL_ARGS";
+            case CL_INVALID_WORK_DIMENSION:                 return "CL_INVALID_WORK_DIMENSION";
+            case CL_INVALID_WORK_GROUP_SIZE:                return "CL_INVALID_WORK_GROUP_SIZE";
+            case CL_INVALID_WORK_ITEM_SIZE:                 return "CL_INVALID_WORK_ITEM_SIZE";
+            case CL_INVALID_GLOBAL_OFFSET:                  return "CL_INVALID_GLOBAL_OFFSET";
+            case CL_INVALID_EVENT_WAIT_LIST:                return "CL_INVALID_EVENT_WAIT_LIST";
+            case CL_INVALID_EVENT:                          return "CL_INVALID_EVENT";
+            case CL_INVALID_OPERATION:                      return "CL_INVALID_OPERATION";
+            case CL_INVALID_GL_OBJECT:                      return "CL_INVALID_GL_OBJECT";
+            case CL_INVALID_BUFFER_SIZE:                    return "CL_INVALID_BUFFER_SIZE";
+            case CL_INVALID_MIP_LEVEL:                      return "CL_INVALID_MIP_LEVEL";
+            case CL_INVALID_GLOBAL_WORK_SIZE:               return "CL_INVALID_GLOBAL_WORK_SIZE";
+            case CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR:    return "CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR";
+            case CL_PLATFORM_NOT_FOUND_KHR:                 return "CL_PLATFORM_NOT_FOUND_KHR";
+            default: return null;
+        }
+    }
 
-            case CL_COMPILER_NOT_AVAILABLE:
-                return "CL_COMPILER_NOT_AVAILABLE";
+    private static CLException createSpecificException(int error, String message) {
+        switch(error) {
+            case CL_DEVICE_NOT_FOUND:                       return new CLDeviceNotFoundException(message);
+            case CL_DEVICE_NOT_AVAILABLE:                   return new CLDeviceNotAvailableException(message);
+            case CL_COMPILER_NOT_AVAILABLE:                 return new CLCompilerNotAvailableException(message);
+            case CL_MEM_OBJECT_ALLOCATION_FAILURE:          return new CLMemObjectAllocationFailureException(message);
+            case CL_OUT_OF_RESOURCES:                       return new CLOutOfResourcesException(message);
+            case CL_OUT_OF_HOST_MEMORY:                     return new CLOutOfHostMemoryException(message);
+            case CL_PROFILING_INFO_NOT_AVAILABLE:           return new CLProfilingInfoNotAvailableException(message);
+            case CL_MEM_COPY_OVERLAP:                       return new CLMemCopyOverlapException(message);
+            case CL_IMAGE_FORMAT_MISMATCH:                  return new CLImageFormatMismatchException(message);
+            case CL_IMAGE_FORMAT_NOT_SUPPORTED:             return new CLImageFormatNotSupportedException(message);
+            case CL_BUILD_PROGRAM_FAILURE:                  return new CLBuildProgramFailureException(message);
+            case CL_MAP_FAILURE:                            return new CLMapFailureException(message);
+            case CL_INVALID_VALUE:                          return new CLInvalidValueException(message);
+            case CL_INVALID_DEVICE_TYPE:                    return new CLInvalidDeviceTypeException(message);
+            case CL_INVALID_PLATFORM:                       return new CLInvalidPlatformException(message);
+            case CL_INVALID_DEVICE:                         return new CLInvalidDeviceException(message);
+            case CL_INVALID_CONTEXT:                        return new CLInvalidContextException(message);
+            case CL_INVALID_QUEUE_PROPERTIES:               return new CLInvalidQueuePropertiesException(message);
+            case CL_INVALID_COMMAND_QUEUE:                  return new CLInvalidCommandQueueException(message);
+            case CL_INVALID_HOST_PTR:                       return new CLInvalidHostPtrException(message);
+            case CL_INVALID_MEM_OBJECT:                     return new CLInvalidMemObjectException(message);
+            case CL_INVALID_IMAGE_FORMAT_DESCRIPTOR:        return new CLInvalidImageFormatDescriptorException(message);
+            case CL_INVALID_IMAGE_SIZE:                     return new CLInvalidImageSizeException(message);
+            case CL_INVALID_SAMPLER:                        return new CLInvalidSamplerException(message);
+            case CL_INVALID_BINARY:                         return new CLInvalidBinaryException(message);
+            case CL_INVALID_BUILD_OPTIONS:                  return new CLInvalidBuildOptionsException(message);
+            case CL_INVALID_PROGRAM:                        return new CLInvalidProgramException(message);
+            case CL_INVALID_PROGRAM_EXECUTABLE:             return new CLInvalidProgramExecutableException(message);
+            case CL_INVALID_KERNEL_NAME:                    return new CLInvalidKernelNameException(message);
+            case CL_INVALID_KERNEL_DEFINITION:              return new CLInvalidKernelDefinitionException(message);
+            case CL_INVALID_KERNEL:                         return new CLInvalidKernelException(message);
+            case CL_INVALID_ARG_INDEX:                      return new CLInvalidArgIndexException(message);
+            case CL_INVALID_ARG_VALUE:                      return new CLInvalidArgValueException(message);
+            case CL_INVALID_ARG_SIZE:                       return new CLInvalidArgSizeException(message);
+            case CL_INVALID_KERNEL_ARGS:                    return new CLInvalidKernelArgsException(message);
+            case CL_INVALID_WORK_DIMENSION:                 return new CLInvalidWorkDimensionException(message);
+            case CL_INVALID_WORK_GROUP_SIZE:                return new CLInvalidWorkGroupSizeException(message);
+            case CL_INVALID_WORK_ITEM_SIZE:                 return new CLInvalidWorkItemSizeException(message);
+            case CL_INVALID_GLOBAL_OFFSET:                  return new CLInvalidGlobalOffsetException(message);
+            case CL_INVALID_EVENT_WAIT_LIST:                return new CLInvalidEventWaitListException(message);
+            case CL_INVALID_EVENT:                          return new CLInvalidEventException(message);
+            case CL_INVALID_OPERATION:                      return new CLInvalidOperationException(message);
+            case CL_INVALID_GL_OBJECT:                      return new CLInvalidGLObjectException(message);
+            case CL_INVALID_BUFFER_SIZE:                    return new CLInvalidBufferSizeException(message);
+            case CL_INVALID_MIP_LEVEL:                      return new CLInvalidMipLevelException(message);
+            case CL_INVALID_GLOBAL_WORK_SIZE:               return new CLInvalidGlobalWorkSizeException(message);
+            case CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR:    return new CLInvalidGLSharegroupReferenceKhrException(message);
+            case CL_PLATFORM_NOT_FOUND_KHR:                 return new CLPlatformNotFoundKhrException(message);
+            default: return null;
+        }
+    }
 
-            case CL_MEM_OBJECT_ALLOCATION_FAILURE:
-                return "CL_MEM_OBJECT_ALLOCATION_FAILURE";
+    /**
+     * {@link CLException} thrown on CL.CL_DEVICE_NOT_FOUND errors.
+     * @author Michael Bien
+     */
+    public final static class CLDeviceNotFoundException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_DEVICE_NOT_FOUND;
+        public CLDeviceNotFoundException(String message) {
+            super(CL_DEVICE_NOT_FOUND, "CL_DEVICE_NOT_FOUND", message);
+        }
+    }
 
-            case CL_OUT_OF_RESOURCES:
-                return "CL_OUT_OF_RESOURCES";
+    /**
+     * {@link CLException} thrown on CL.CL_DEVICE_NOT_AVAILABLE errors.
+     * @author Michael Bien
+     */
+    public final static class CLDeviceNotAvailableException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_DEVICE_NOT_AVAILABLE;
+        public CLDeviceNotAvailableException(String message) {
+            super(CL_DEVICE_NOT_AVAILABLE, "CL_DEVICE_NOT_AVAILABLE", message);
+        }
+    }
 
-            case CL_OUT_OF_HOST_MEMORY:
-                return "CL_OUT_OF_HOST_MEMORY";
+    /**
+     * {@link CLException} thrown on CL.CL_COMPILER_NOT_AVAILABLE errors.
+     * @author Michael Bien
+     */
+    public final static class CLCompilerNotAvailableException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_COMPILER_NOT_AVAILABLE;
+        public CLCompilerNotAvailableException(String message) {
+            super(CL_COMPILER_NOT_AVAILABLE, "CL_COMPILER_NOT_AVAILABLE", message);
+        }
+    }
 
-            case CL_PROFILING_INFO_NOT_AVAILABLE:
-                return "CL_PROFILING_INFO_NOT_AVAILABLE";
+    /**
+     * {@link CLException} thrown on CL.CL_MEM_OBJECT_ALLOCATION_FAILURE errors.
+     * @author Michael Bien
+     */
+    public final static class CLMemObjectAllocationFailureException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_MEM_OBJECT_ALLOCATION_FAILURE;
+        public CLMemObjectAllocationFailureException(String message) {
+            super(CL_MEM_OBJECT_ALLOCATION_FAILURE, "CL_MEM_OBJECT_ALLOCATION_FAILURE", message);
+        }
+    }
 
-            case CL_MEM_COPY_OVERLAP:
-                return "CL_MEM_COPY_OVERLAP";
+    /**
+     * {@link CLException} thrown on CL.CL_OUT_OF_RESOURCES errors.
+     * @author Michael Bien
+     */
+    public final static class CLOutOfResourcesException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_OUT_OF_RESOURCES;
+        public CLOutOfResourcesException(String message) {
+            super(CL_OUT_OF_RESOURCES, "CL_OUT_OF_RESOURCES", message);
+        }
+    }
 
-            case CL_IMAGE_FORMAT_MISMATCH:
-                return "CL_IMAGE_FORMAT_MISMATCH";
+    /**
+     * {@link CLException} thrown on CL.CL_OUT_OF_HOST_MEMORY errors.
+     * @author Michael Bien
+     */
+    public final static class CLOutOfHostMemoryException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_OUT_OF_HOST_MEMORY;
+        public CLOutOfHostMemoryException(String message) {
+            super(CL_OUT_OF_HOST_MEMORY, "CL_OUT_OF_HOST_MEMORY", message);
+        }
+    }
 
-            case CL_IMAGE_FORMAT_NOT_SUPPORTED:
-                return "CL_IMAGE_FORMAT_NOT_SUPPORTED";
+    /**
+     * {@link CLException} thrown on CL.CL_PROFILING_INFO_NOT_AVAILABLE errors.
+     * @author Michael Bien
+     */
+    public final static class CLProfilingInfoNotAvailableException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_PROFILING_INFO_NOT_AVAILABLE;
+        public CLProfilingInfoNotAvailableException(String message) {
+            super(CL_PROFILING_INFO_NOT_AVAILABLE, "CL_PROFILING_INFO_NOT_AVAILABLE", message);
+        }
+    }
+
+    /**
+     * {@link CLException} thrown on CL.CL_MEM_COPY_OVERLAP errors.
+     * @author Michael Bien
+     */
+    public final static class CLMemCopyOverlapException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_MEM_COPY_OVERLAP;
+        public CLMemCopyOverlapException(String message) {
+            super(CL_MEM_COPY_OVERLAP, "CL_MEM_COPY_OVERLAP", message);
+        }
+    }
 
-            case CL_BUILD_PROGRAM_FAILURE:
-                return "CL_BUILD_PROGRAM_FAILURE";
+    /**
+     * {@link CLException} thrown on CL.CL_IMAGE_FORMAT_MISMATCH errors.
+     * @author Michael Bien
+     */
+    public final static class CLImageFormatMismatchException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_IMAGE_FORMAT_MISMATCH;
+        public CLImageFormatMismatchException(String message) {
+            super(CL_IMAGE_FORMAT_MISMATCH, "CL_IMAGE_FORMAT_MISMATCH", message);
+        }
+    }
 
-            case CL_MAP_FAILURE:
-                return "CL_MAP_FAILURE";
+    /**
+     * {@link CLException} thrown on CL.CL_IMAGE_FORMAT_NOT_SUPPORTED errors.
+     * @author Michael Bien
+     */
+    public final static class CLImageFormatNotSupportedException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_IMAGE_FORMAT_NOT_SUPPORTED;
+        public CLImageFormatNotSupportedException(String message) {
+            super(CL_IMAGE_FORMAT_NOT_SUPPORTED, "CL_IMAGE_FORMAT_NOT_SUPPORTED", message);
+        }
+    }
 
-            case CL_INVALID_VALUE:
-                return "CL_INVALID_VALUE";
+    /**
+     * {@link CLException} thrown on CL.CL_BUILD_PROGRAM_FAILURE errors.
+     * @author Michael Bien
+     */
+    public final static class CLBuildProgramFailureException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_BUILD_PROGRAM_FAILURE;
+        public CLBuildProgramFailureException(String message) {
+            super(CL_BUILD_PROGRAM_FAILURE, "CL_BUILD_PROGRAM_FAILURE", message);
+        }
+    }
 
-            case CL_INVALID_DEVICE_TYPE:
-                return "CL_INVALID_DEVICE_TYPE";
+    /**
+     * {@link CLException} thrown on CL.CL_MAP_FAILURE errors.
+     * @author Michael Bien
+     */
+    public final static class CLMapFailureException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_MAP_FAILURE;
+        public CLMapFailureException(String message) {
+            super(CL_MAP_FAILURE, "CL_MAP_FAILURE", message);
+        }
+    }
 
-            case CL_INVALID_PLATFORM:
-                return "CL_INVALID_PLATFORM";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_VALUE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidValueException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_VALUE;
+        public CLInvalidValueException(String message) {
+            super(CL_INVALID_VALUE, "CL_INVALID_VALUE", message);
+        }
+    }
 
-            case CL_INVALID_DEVICE:
-                return "CL_INVALID_DEVICE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_DEVICE_TYPE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidDeviceTypeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_DEVICE_TYPE;
+        public CLInvalidDeviceTypeException(String message) {
+            super(CL_INVALID_DEVICE_TYPE, "CL_INVALID_DEVICE_TYPE", message);
+        }
+    }
 
-            case CL_INVALID_CONTEXT:
-                return "CL_INVALID_CONTEXT";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_PLATFORM errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidPlatformException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_PLATFORM;
+        public CLInvalidPlatformException(String message) {
+            super(CL_INVALID_PLATFORM, "CL_INVALID_PLATFORM", message);
+        }
+    }
 
-            case CL_INVALID_QUEUE_PROPERTIES:
-                return "CL_INVALID_QUEUE_PROPERTIES";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_DEVICE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidDeviceException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_DEVICE;
+        public CLInvalidDeviceException(String message) {
+            super(CL_INVALID_DEVICE, "CL_INVALID_DEVICE", message);
+        }
+    }
 
-            case CL_INVALID_COMMAND_QUEUE:
-                return "CL_INVALID_COMMAND_QUEUE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_CONTEXT errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidContextException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_CONTEXT;
+        public CLInvalidContextException(String message) {
+            super(CL_INVALID_CONTEXT, "CL_INVALID_CONTEXT", message);
+        }
+    }
 
-            case CL_INVALID_HOST_PTR:
-                return "CL_INVALID_HOST_PTR";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_QUEUE_PROPERTIES errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidQueuePropertiesException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_QUEUE_PROPERTIES;
+        public CLInvalidQueuePropertiesException(String message) {
+            super(CL_INVALID_QUEUE_PROPERTIES, "CL_INVALID_QUEUE_PROPERTIES", message);
+        }
+    }
 
-            case CL_INVALID_MEM_OBJECT:
-                return "CL_INVALID_MEM_OBJECT";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_COMMAND_QUEUE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidCommandQueueException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_COMMAND_QUEUE;
+        public CLInvalidCommandQueueException(String message) {
+            super(CL_INVALID_COMMAND_QUEUE, "CL_INVALID_COMMAND_QUEUE", message);
+        }
+    }
 
-            case CL_INVALID_IMAGE_FORMAT_DESCRIPTOR:
-                return "CL_INVALID_IMAGE_FORMAT_DESCRIPTOR";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_HOST_PTR errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidHostPtrException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_HOST_PTR;
+        public CLInvalidHostPtrException(String message) {
+            super(CL_INVALID_HOST_PTR, "CL_INVALID_HOST_PTR", message);
+        }
+    }
 
-            case CL_INVALID_IMAGE_SIZE:
-                return "CL_INVALID_IMAGE_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_MEM_OBJECT errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidMemObjectException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_MEM_OBJECT;
+        public CLInvalidMemObjectException(String message) {
+            super(CL_INVALID_MEM_OBJECT, "CL_INVALID_MEM_OBJECT", message);
+        }
+    }
 
-            case CL_INVALID_SAMPLER:
-                return "CL_INVALID_SAMPLER";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_IMAGE_FORMAT_DESCRIPTOR errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidImageFormatDescriptorException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_IMAGE_FORMAT_DESCRIPTOR;
+        public CLInvalidImageFormatDescriptorException(String message) {
+            super(CL_INVALID_IMAGE_FORMAT_DESCRIPTOR, "CL_INVALID_IMAGE_FORMAT_DESCRIPTOR", message);
+        }
+    }
 
-            case CL_INVALID_BINARY:
-                return "CL_INVALID_BINARY";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_IMAGE_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidImageSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_IMAGE_SIZE;
+        public CLInvalidImageSizeException(String message) {
+            super(CL_INVALID_IMAGE_SIZE, "CL_INVALID_IMAGE_SIZE", message);
+        }
+    }
 
-            case CL_INVALID_BUILD_OPTIONS:
-                return "CL_INVALID_BUILD_OPTIONS";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_SAMPLER errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidSamplerException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_SAMPLER;
+        public CLInvalidSamplerException(String message) {
+            super(CL_INVALID_SAMPLER, "CL_INVALID_SAMPLER", message);
+        }
+    }
 
-            case CL_INVALID_PROGRAM:
-                return "CL_INVALID_PROGRAM";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_BINARY errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidBinaryException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_BINARY;
+        public CLInvalidBinaryException(String message) {
+            super(CL_INVALID_BINARY, "CL_INVALID_BINARY", message);
+        }
+    }
 
-            case CL_INVALID_PROGRAM_EXECUTABLE:
-                return "CL_INVALID_PROGRAM_EXECUTABLE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_BUILD_OPTIONS errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidBuildOptionsException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_BUILD_OPTIONS;
+        public CLInvalidBuildOptionsException(String message) {
+            super(CL_INVALID_BUILD_OPTIONS, "CL_INVALID_BUILD_OPTIONS", message);
+        }
+    }
 
-            case CL_INVALID_KERNEL_NAME:
-                return "CL_INVALID_KERNEL_NAME";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_PROGRAM errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidProgramException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_PROGRAM;
+        public CLInvalidProgramException(String message) {
+            super(CL_INVALID_PROGRAM, "CL_INVALID_PROGRAM", message);
+        }
+    }
 
-            case CL_INVALID_KERNEL_DEFINITION:
-                return "CL_INVALID_KERNEL_DEFINITION";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_PROGRAM_EXECUTABLE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidProgramExecutableException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_PROGRAM_EXECUTABLE;
+        public CLInvalidProgramExecutableException(String message) {
+            super(CL_INVALID_PROGRAM_EXECUTABLE, "CL_INVALID_PROGRAM_EXECUTABLE", message);
+        }
+    }
 
-            case CL_INVALID_KERNEL:
-                return "CL_INVALID_KERNEL";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_KERNEL_NAME errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidKernelNameException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_KERNEL_NAME;
+        public CLInvalidKernelNameException(String message) {
+            super(CL_INVALID_KERNEL_NAME, "CL_INVALID_KERNEL_NAME", message);
+        }
+    }
 
-            case CL_INVALID_ARG_INDEX:
-                return "CL_INVALID_ARG_INDEX";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_KERNEL_DEFINITION errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidKernelDefinitionException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_KERNEL_DEFINITION;
+        public CLInvalidKernelDefinitionException(String message) {
+            super(CL_INVALID_KERNEL_DEFINITION, "CL_INVALID_KERNEL_DEFINITION", message);
+        }
+    }
 
-            case CL_INVALID_ARG_VALUE:
-                return "CL_INVALID_ARG_VALUE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_KERNEL errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidKernelException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_KERNEL;
+        public CLInvalidKernelException(String message) {
+            super(CL_INVALID_KERNEL, "CL_INVALID_KERNEL", message);
+        }
+    }
 
-            case CL_INVALID_ARG_SIZE:
-                return "CL_INVALID_ARG_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_ARG_INDEX errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidArgIndexException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_ARG_INDEX;
+        public CLInvalidArgIndexException(String message) {
+            super(CL_INVALID_ARG_INDEX, "CL_INVALID_ARG_INDEX", message);
+        }
+    }
 
-            case CL_INVALID_KERNEL_ARGS:
-                return "CL_INVALID_KERNEL_ARGS";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_ARG_VALUE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidArgValueException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_ARG_VALUE;
+        public CLInvalidArgValueException(String message) {
+            super(CL_INVALID_ARG_VALUE, "CL_INVALID_ARG_VALUE", message);
+        }
+    }
 
-            case CL_INVALID_WORK_DIMENSION:
-                return "CL_INVALID_WORK_DIMENSION";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_ARG_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidArgSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_ARG_SIZE;
+        public CLInvalidArgSizeException(String message) {
+            super(CL_INVALID_ARG_SIZE, "CL_INVALID_ARG_SIZE", message);
+        }
+    }
 
-            case CL_INVALID_WORK_GROUP_SIZE:
-                return "CL_INVALID_WORK_GROUP_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_KERNEL_ARGS errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidKernelArgsException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_KERNEL_ARGS;
+        public CLInvalidKernelArgsException(String message) {
+            super(CL_INVALID_KERNEL_ARGS, "CL_INVALID_KERNEL_ARGS", message);
+        }
+    }
 
-            case CL_INVALID_WORK_ITEM_SIZE:
-                return "CL_INVALID_WORK_ITEM_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_WORK_DIMENSION errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidWorkDimensionException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_WORK_DIMENSION;
+        public CLInvalidWorkDimensionException(String message) {
+            super(CL_INVALID_WORK_DIMENSION, "CL_INVALID_WORK_DIMENSION", message);
+        }
+    }
 
-            case CL_INVALID_GLOBAL_OFFSET:
-                return "CL_INVALID_GLOBAL_OFFSET";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_WORK_GROUP_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidWorkGroupSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_WORK_GROUP_SIZE;
+        public CLInvalidWorkGroupSizeException(String message) {
+            super(CL_INVALID_WORK_GROUP_SIZE, "CL_INVALID_WORK_GROUP_SIZE", message);
+        }
+    }
 
-            case CL_INVALID_EVENT_WAIT_LIST:
-                return "CL_INVALID_EVENT_WAIT_LIST";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_WORK_ITEM_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidWorkItemSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_WORK_ITEM_SIZE;
+        public CLInvalidWorkItemSizeException(String message) {
+            super(CL_INVALID_WORK_ITEM_SIZE, "CL_INVALID_WORK_ITEM_SIZE", message);
+        }
+    }
 
-            case CL_INVALID_EVENT:
-                return "CL_INVALID_EVENT";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_GLOBAL_OFFSET errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidGlobalOffsetException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_GLOBAL_OFFSET;
+        public CLInvalidGlobalOffsetException(String message) {
+            super(CL_INVALID_GLOBAL_OFFSET, "CL_INVALID_GLOBAL_OFFSET", message);
+        }
+    }
 
-            case CL_INVALID_OPERATION:
-                return "CL_INVALID_OPERATION";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_EVENT_WAIT_LIST errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidEventWaitListException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_EVENT_WAIT_LIST;
+        public CLInvalidEventWaitListException(String message) {
+            super(CL_INVALID_EVENT_WAIT_LIST, "CL_INVALID_EVENT_WAIT_LIST", message);
+        }
+    }
 
-            case CL_INVALID_GL_OBJECT:
-                return "CL_INVALID_GL_OBJECT";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_EVENT errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidEventException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_EVENT;
+        public CLInvalidEventException(String message) {
+            super(CL_INVALID_EVENT, "CL_INVALID_EVENT", message);
+        }
+    }
 
-            case CL_INVALID_BUFFER_SIZE:
-                return "CL_INVALID_BUFFER_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_OPERATION errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidOperationException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_OPERATION;
+        public CLInvalidOperationException(String message) {
+            super(CL_INVALID_OPERATION, "CL_INVALID_OPERATION", message);
+        }
+    }
 
-            case CL_INVALID_MIP_LEVEL:
-                return "CL_INVALID_MIP_LEVEL";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_GL_OBJECT errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidGLObjectException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_GL_OBJECT;
+        public CLInvalidGLObjectException(String message) {
+            super(CL_INVALID_GL_OBJECT, "CL_INVALID_GL_OBJECT", message);
+        }
+    }
 
-            case CL_INVALID_GLOBAL_WORK_SIZE:
-                return "CL_INVALID_GLOBAL_WORK_SIZE";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_BUFFER_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidBufferSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_BUFFER_SIZE;
+        public CLInvalidBufferSizeException(String message) {
+            super(CL_INVALID_BUFFER_SIZE, "CL_INVALID_BUFFER_SIZE", message);
+        }
+    }
 
-            case CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR:
-                return "CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_MIP_LEVEL errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidMipLevelException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_MIP_LEVEL;
+        public CLInvalidMipLevelException(String message) {
+            super(CL_INVALID_MIP_LEVEL, "CL_INVALID_MIP_LEVEL", message);
+        }
+    }
 
-            case CL_PLATFORM_NOT_FOUND_KHR:
-                return "CL_PLATFORM_NOT_FOUND_KHR";
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_GLOBAL_WORK_SIZE errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidGlobalWorkSizeException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_GLOBAL_WORK_SIZE;
+        public CLInvalidGlobalWorkSizeException(String message) {
+            super(CL_INVALID_GLOBAL_WORK_SIZE, "CL_INVALID_GLOBAL_WORK_SIZE", message);
+        }
+    }
 
-            default:
-                return "unknown cause: code" + error;
+    /**
+     * {@link CLException} thrown on CL.CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR errors.
+     * @author Michael Bien
+     */
+    public final static class CLInvalidGLSharegroupReferenceKhrException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR;
+        public CLInvalidGLSharegroupReferenceKhrException(String message) {
+            super(CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR, "CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR", message);
         }
     }
 
+    /**
+     * {@link CLException} thrown on CL.CL_PLATFORM_NOT_FOUND_KHR errors.
+     * @author Michael Bien
+     */
+    public final static class CLPlatformNotFoundKhrException extends CLException {
+        private static final long serialVersionUID = CLException.serialVersionUID+CL_PLATFORM_NOT_FOUND_KHR;
+        public CLPlatformNotFoundKhrException(String message) {
+            super(CL_PLATFORM_NOT_FOUND_KHR, "CL_PLATFORM_NOT_FOUND_KHR", message);
+        }
+    }
 
 }
\ No newline at end of file