aboutsummaryrefslogtreecommitdiffstats
path: root/src/com/jogamp/opencl/util/CLBuildConfiguration.java
diff options
context:
space:
mode:
authorMichael Bien <[email protected]>2011-04-19 04:12:54 +0200
committerMichael Bien <[email protected]>2011-04-19 04:12:54 +0200
commit03ce3ff819e342b95552c1438ea1269fd30e7176 (patch)
tree426d9782e7340862615131a971df5fe2dd7311ac /src/com/jogamp/opencl/util/CLBuildConfiguration.java
parenta3654a0b8a4e0c9e246aa04019bf1d5a09e7a28d (diff)
CLBuildConfiguration.save(..) should store device index and not the device id.
updated javadoc.
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)