aboutsummaryrefslogtreecommitdiffstats
path: root/src/com/jogamp/opencl/util/CLBuildConfiguration.java
diff options
context:
space:
mode:
authorSven Gothel <[email protected]>2011-05-01 07:06:45 +0200
committerSven Gothel <[email protected]>2011-05-01 07:06:45 +0200
commitdab2ffd696b5f9ccb192834c3e50132fad96a30a (patch)
treea174ad04342f32002197171eb895b2435fc42f49 /src/com/jogamp/opencl/util/CLBuildConfiguration.java
parent454f81a14da543faebae4c8e6adebb3256a2e646 (diff)
parentabcef28580df7ba0176390fe6d0a0eb1d969183d (diff)
Merge remote-tracking branch 'mbien/master'
Diffstat (limited to 'src/com/jogamp/opencl/util/CLBuildConfiguration.java')
-rw-r--r--src/com/jogamp/opencl/util/CLBuildConfiguration.java8
1 files changed, 8 insertions, 0 deletions
diff --git a/src/com/jogamp/opencl/util/CLBuildConfiguration.java b/src/com/jogamp/opencl/util/CLBuildConfiguration.java
index f70f088e..89f59110 100644
--- a/src/com/jogamp/opencl/util/CLBuildConfiguration.java
+++ b/src/com/jogamp/opencl/util/CLBuildConfiguration.java
@@ -36,6 +36,14 @@ import java.util.Map;
/**
* Configuration representing everything needed to build an OpenCL program.
+ * <p>
+ * If you use {@link #save(java.io.ObjectOutputStream)} to persist build configurations between
+ * JVM sessions it is highly recommended to call {@link #forDevice(com.jogamp.opencl.CLDevice) }
+ * or {@link #forDevices(com.jogamp.opencl.CLDevice[]) } before building the program.
+ * Driver updates or HW changes can make exact device-to-binary mapping hard, the
+ * builder will drop all unmappable binaries silently. Setting the devices explicitly will
+ * force automatic rebuilds from source in this situation.
+ * </p>
* @author Michael Bien
* @see com.jogamp.opencl.CLProgramBuilder#createConfiguration()
* @see com.jogamp.opencl.CLProgramBuilder#loadConfiguration(java.io.ObjectInputStream)