package com.mbien.opencl; import java.nio.ByteBuffer; import java.nio.ByteOrder; import java.util.Collections; import java.util.HashMap; import java.util.Map; import static com.mbien.opencl.CLException.*; /** * * @author Michael Bien */ public class CLProgram { public final CLContext context; public final long ID; private final CL cl; private final Map kernels; public enum Status { BUILD_SUCCESS(CL.CL_BUILD_SUCCESS), BUILD_NONE(CL.CL_BUILD_NONE), BUILD_IN_PROGRESS(CL.CL_BUILD_IN_PROGRESS), BUILD_ERROR(CL.CL_BUILD_ERROR); /** * Value of wrapped OpenCL device type. */ public final int CL_BUILD_STATUS; private Status(int CL_BUILD_STATUS) { this.CL_BUILD_STATUS = CL_BUILD_STATUS; } public static Status valueOf(int clBuildStatus) { switch(clBuildStatus) { case(CL.CL_BUILD_SUCCESS): return BUILD_SUCCESS; case(CL.CL_BUILD_NONE): return BUILD_NONE; case(CL.CL_BUILD_IN_PROGRESS): return BUILD_IN_PROGRESS; case(CL.CL_BUILD_ERROR): return BUILD_ERROR; // is this a standard state? // case (CL.CL_BUILD_PROGRAM_FAILURE): // return BUILD_PROGRAM_FAILURE; } return null; } } CLProgram(CLContext context, String src, long contextID) { this.cl = context.cl; this.context = context; this.kernels = new HashMap(); int[] intArray = new int[1]; // Create the program ID = cl.clCreateProgramWithSource(contextID, 1, new String[] {src}, new long[]{src.length()}, 0, intArray, 0); checkForError(intArray[0], "can not create program with source"); } /** * Builds this program for all devices associated with the context and implementation specific build options. * @return this */ public CLProgram build() { build(null, null); return this; } /** * Builds this program for the given devices and with the specified build options. * @return this * @param devices A list of devices this program should be build on or null for all devices of its context. */ public CLProgram build(CLDevice[] devices, String options) { long[] deviceIDs = null; if(devices != null) { deviceIDs = new long[devices.length]; for (int i = 0; i < deviceIDs.length; i++) { deviceIDs[i] = devices[i].ID; } } // Build the program int ret = cl.clBuildProgram(ID, deviceIDs, options, null, null); checkForError(ret, "error building program"); return this; } /** * Returns all kernels of this program in a unmodifiable view of a map with the kernel function names as keys. */ public Map getCLKernels() { if(kernels.isEmpty()) { int[] intArray = new int[1]; int ret = cl.clCreateKernelsInProgram(ID, 0, null, 0, intArray, 0); checkForError(ret, "can not create kernels for program"); long[] kernelIDs = new long[intArray[0]]; ret = cl.clCreateKernelsInProgram(ID, kernelIDs.length, kernelIDs, 0, null, 0); checkForError(ret, "can not create kernels for program"); for (int i = 0; i < intArray[0]; i++) { CLKernel kernel = new CLKernel(this, kernelIDs[i]); kernels.put(kernel.name, kernel); } } return Collections.unmodifiableMap(kernels); } void kernelReleased(CLKernel kernel) { this.kernels.remove(kernel.name); } /** * Releases this program. */ public void release() { if(!kernels.isEmpty()) { String[] names = kernels.keySet().toArray(new String[kernels.size()]); for (String name : names) { kernels.get(name).release(); } } int ret = cl.clReleaseProgram(ID); checkForError(ret, "can not release program"); context.programReleased(this); } /** * Returns all devices associated with this program. */ public CLDevice[] getCLDevices() { long[] longArray = new long[1]; int ret = cl.clGetProgramInfo(ID, CL.CL_PROGRAM_DEVICES, 0, null, longArray, 0); checkForError(ret, "on clGetProgramInfo"); ByteBuffer bb = ByteBuffer.allocate((int) longArray[0]).order(ByteOrder.nativeOrder()); ret = cl.clGetProgramInfo(ID, CL.CL_PROGRAM_DEVICES, bb.capacity(), bb, null, 0); checkForError(ret, "on clGetProgramInfo"); int count = bb.capacity() / 8; // TODO sizeof cl_device CLDevice[] devices = new CLDevice[count]; for (int i = 0; i < count; i++) { devices[i] = context.getCLDevice(bb.getLong()); } return devices; } public String getBuildLog(CLDevice device) { return getBuildInfoString(device.ID, CL.CL_PROGRAM_BUILD_LOG); } public Status getBuildStatus(CLDevice device) { int clStatus = getBuildInfoInt(device.ID, CL.CL_PROGRAM_BUILD_STATUS); return Status.valueOf(clStatus); } /** * Returns the source code of this program. Note: sources are not cached, each call of this method calls into OpenCL. */ public String getSource() { return getProgramInfoString(CL.CL_PROGRAM_SOURCE); } // TODO binaries, serialization, program build options private final String getBuildInfoString(long device, int flag) { long[] longArray = new long[1]; int ret = cl.clGetProgramBuildInfo(ID, device, flag, 0, null, longArray, 0); checkForError(ret, "on clGetProgramBuildInfo"); ByteBuffer bb = ByteBuffer.allocate((int)longArray[0]).order(ByteOrder.nativeOrder()); ret = cl.clGetProgramBuildInfo(ID, device, flag, bb.capacity(), bb, null, 0); checkForError(ret, "on clGetProgramBuildInfo"); return new String(bb.array(), 0, (int)longArray[0]); } private final String getProgramInfoString(int flag) { long[] longArray = new long[1]; int ret = cl.clGetProgramInfo(ID, flag, 0, null, longArray, 0); checkForError(ret, "on clGetProgramInfo"); ByteBuffer bb = ByteBuffer.allocate((int)longArray[0]).order(ByteOrder.nativeOrder()); ret = cl.clGetProgramInfo(ID, flag, bb.capacity(), bb, null, 0); checkForError(ret, "on clGetProgramInfo"); return new String(bb.array(), 0, (int)longArray[0]); } // private int getProgramInfoInt(int flag) { // // ByteBuffer bb = ByteBuffer.allocate(4).order(ByteOrder.nativeOrder()); // // int ret = cl.clGetProgramInfo(programID, flag, bb.capacity(), bb, null, 0); // checkForError(ret, ""); // // return bb.getInt(); // } private int getBuildInfoInt(long device, int flag) { ByteBuffer bb = ByteBuffer.allocate(4).order(ByteOrder.nativeOrder()); int ret = cl.clGetProgramBuildInfo(ID, device, flag, bb.capacity(), bb, null, 0); checkForError(ret, "error on clGetProgramBuildInfo"); return bb.getInt(); } @Override public boolean equals(Object obj) { if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } final CLProgram other = (CLProgram) obj; if (this.ID != other.ID) { return false; } if (!this.context.equals(other.context)) { return false; } return true; } @Override public int hashCode() { int hash = 7; hash = 37 * hash + (this.context != null ? this.context.hashCode() : 0); hash = 37 * hash + (int) (this.ID ^ (this.ID >>> 32)); return hash; } }