[ViewVC] Annotation of: cvs/OpenCL/Changes

Revision history for Perl extension OpenCL.

TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clCreateProgramWithBinary.html
TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clSetEventCallback.html, *pfn
TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clSetMemObjectDestructorCallback.html, *pfn
TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueUnmapMemObject.html
TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueMapBuffer.html
TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueMapImage.html
TODO: CL_IMAGE_FORMAT
TODO: ->build on multiple devices
TODO: some convenience methods maybe?
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCompileProgram.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clLinkProgram.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateProgramWithBuiltInKernels.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateSubDevices.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueFillBuffer.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueFillImage.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueMigrateMemObjects.html
TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetKernelArgInfo.html (also generic accessor)
TODO: ->id method that returns the underlying object id?
TODO: allow "prefer 1.2/1.1 api" or "ignore 1.2 api"

        - enqueue_acquire/release_gl_objects did not return an event object.
        - OpenCL::errno did not return the correct value.
        - allow undef values in event wait lists, for convenience.
        - implement $program->kernels_in_program.
        - add opencl 1.2 constants.
        - implement $ctx->image, $ctx->gl_texture, $platform->unload_compiler
          (opencl 1.2).
        - port image2d and image3d to the opencl 1.2 API.
        - port enqueue_marker/barrier to the opencl 1.2 API, and croak
          if the user requests something that 1.1 cannot do when compiled
          against 1.1. This slightly changes the API for enqueue_barrier,
          which now checks the context it is called in.

0.96 Fri Apr 20 22:23:58 CEST 2012
        - ->enqueue_write_buffer actually called enqueue_read_buffer. d'oh.
        - new $kernel->set_local function, to size local buffer arguments.
        - use finish, not flush, in examples.

0.95 Thu Apr 19 21:25:32 CEST 2012
        - add lengthy opengl sharing example.
        - support property lists in CreateContext* calls.
        - support some opengl sharing extensions
          (gl_buffer, gl_texture[23]d, gl_renderbuffer).
        - support some cl_khr_gl_sharing extensions.
        - add some extension constants (cl_gl.h cl_ext.h, cl_d3d10.h).
        - auto-generate error codes (and include gl+d3d extensions).

0.92 Mon Apr 16 08:39:21 CEST 2012
        - work around some bugs in amd's opencl implementation (INVALID_HOST_PTR
          when value deosn't matter).
        - minor documentation fix (patch by Maik Hentsche).

0.91 Sun Dec 11 00:05:02 CET 2011
        - introduce $buffer_obj->sub_buffer_region method and a new class, OpenCL::BufferObj
          for a subbuffer is a buffer without sub_buffer methods!
        - support apple using a different location for opencl headers - untested.
        - be more strict when passing event lists.

0.59 Tue Nov 22 11:44:32 CET 2011
        - provide $program->binaries method.
        - provide $queue->enqueue_read_buffer_rect method.
        - provide $queue->enqueue_write_buffer_rect method.
        - coalesce like-typed accessor methods into the same xs function and
          multiple ALIASes - this reduces the OpenCL codesize from 162kb to
          132kb on my system.
        - minor doc improvements.

0.55 Sun Nov 20 11:19:25 CET 2011
        - semi-automatically generate query methods for almost all clGet*Info names.
        - provide cl_ext.h constants.
        - provide OpenCL::Image->image_info method.
        - provide OpenCL::Event->profiling_info method.
        - provide OpenCL::Kernel->work_group_info method.

0.15 Thu Nov 17 07:22:11 CET 2011
        - include slice_pitch in enqueue_write_image (can be 0).
        - check length in enqueue_write_image.
        - properly calculate size in enqueue_read_image.
        - likewise, include row_pitch and slice_pitch in image2d and image3d,
          which must be nonzero right now, too, sorry.
        - allow undef or missing data scalar for image2d and image3d.
        - fix enqueue_copy_image prototype.
        - fix formatting.

0.14 Thu Nov 17 04:04:23 CET 2011
        - major incompatibilities due to API cleanup, the API should now be
          mostly stable, if incomplete.
        - fix prerequisites.
        - replaced all _simple functions by "full" implementations, with some
          parameters marked for future expansion - that means their API
          should be stable from now on:
             OpenCL::context_from_type_simple    => OpenCL::context_from_type
             $platform->context_from_type_simple => $platform->context_from_type
             $dev->context_simple                => $platform->context
             $ctx->command_queue_simple became   => $ctx->queue
        - add OpenCL::context function.
        - officially require C99.
        - errno value is unspecified after a successful call.

0.03  Wed Nov 16 01:44:26 CET 2011
        - add some reference documentation for all functions.
        - add user event support.
        - implement event wait lists.

0.02  Tue Nov 15 22:15:47 CET 2011
        - first opencl kernel executed, some example code.

0.01  Tue Nov 15 05:59:00 CET 2011
        - cloned from Convert::Scalar.

Revision:	1.42
Committed:	Tue Apr 24 13:30:49 2012 UTC (12 years ago) by root
Branch:	MAIN
Changes since 1.41:	+3 -3 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.1	Revision history for Perl extension OpenCL.
2
3	root	1.14	TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clCreateProgramWithBinary.html
4	root	1.20	TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clSetEventCallback.html, *pfn
5	root	1.41	TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clSetMemObjectDestructorCallback.html, *pfn
6			TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueUnmapMemObject.html
7			TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueMapBuffer.html
8			TODO: http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueMapImage.html
9	root	1.13	TODO: CL_IMAGE_FORMAT
10	root	1.22	TODO: ->build on multiple devices
11			TODO: some convenience methods maybe?
12	root	1.41	TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCompileProgram.html
13			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clLinkProgram.html
14			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateProgramWithBuiltInKernels.html
15			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateSubDevices.html
16			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueFillBuffer.html
17			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueFillImage.html
18			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueMigrateMemObjects.html
19			TODO: http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetKernelArgInfo.html (also generic accessor)
20			TODO: ->id method that returns the underlying object id?
21			TODO: allow "prefer 1.2/1.1 api" or "ignore 1.2 api"
22	root	1.25
23	root	1.35	- enqueue_acquire/release_gl_objects did not return an event object.
24	root	1.37	- OpenCL::errno did not return the correct value.
25	root	1.34	- allow undef values in event wait lists, for convenience.
26	root	1.42	- implement $program->kernels_in_program.
27	root	1.39	- add opencl 1.2 constants.
28	root	1.42	- implement $ctx->image, $ctx->gl_texture, $platform->unload_compiler
29			(opencl 1.2).
30	root	1.40	- port image2d and image3d to the opencl 1.2 API.
31	root	1.38	- port enqueue_marker/barrier to the opencl 1.2 API, and croak
32			if the user requests something that 1.1 cannot do when compiled
33			against 1.1. This slightly changes the API for enqueue_barrier,
34			which now checks the context it is called in.
35	root	1.34
36	root	1.33	0.96 Fri Apr 20 22:23:58 CEST 2012
37			- ->enqueue_write_buffer actually called enqueue_read_buffer. d'oh.
38	root	1.31	- new $kernel->set_local function, to size local buffer arguments.
39	root	1.30	- use finish, not flush, in examples.
40
41	root	1.29	0.95 Thu Apr 19 21:25:32 CEST 2012
42			- add lengthy opengl sharing example.
43	root	1.25	- support property lists in CreateContext* calls.
44	root	1.26	- support some opengl sharing extensions
45			(gl_buffer, gl_texture[23]d, gl_renderbuffer).
46	root	1.25	- support some cl_khr_gl_sharing extensions.
47	root	1.26	- add some extension constants (cl_gl.h cl_ext.h, cl_d3d10.h).
48			- auto-generate error codes (and include gl+d3d extensions).
49	root	1.14
50	root	1.24	0.92 Mon Apr 16 08:39:21 CEST 2012
51			- work around some bugs in amd's opencl implementation (INVALID_HOST_PTR
52			when value deosn't matter).
53			- minor documentation fix (patch by Maik Hentsche).
54	root	1.23
55	root	1.22	0.91 Sun Dec 11 00:05:02 CET 2011
56	root	1.20	- introduce $buffer_obj->sub_buffer_region method and a new class, OpenCL::BufferObj
57			for a subbuffer is a buffer without sub_buffer methods!
58	root	1.21	- support apple using a different location for opencl headers - untested.
59	root	1.22	- be more strict when passing event lists.
60	root	1.20
61	root	1.19	0.59 Tue Nov 22 11:44:32 CET 2011
62	root	1.18	- provide $program->binaries method.
63			- provide $queue->enqueue_read_buffer_rect method.
64			- provide $queue->enqueue_write_buffer_rect method.
65	root	1.16	- coalesce like-typed accessor methods into the same xs function and
66			multiple ALIASes - this reduces the OpenCL codesize from 162kb to
67			132kb on my system.
68	root	1.15	- minor doc improvements.
69	root	1.10
70	root	1.13	0.55 Sun Nov 20 11:19:25 CET 2011
71			- semi-automatically generate query methods for almost all clGet*Info names.
72	root	1.12	- provide cl_ext.h constants.
73			- provide OpenCL::Image->image_info method.
74			- provide OpenCL::Event->profiling_info method.
75			- provide OpenCL::Kernel->work_group_info method.
76
77	root	1.11	0.15 Thu Nov 17 07:22:11 CET 2011
78	root	1.10	- include slice_pitch in enqueue_write_image (can be 0).
79			- check length in enqueue_write_image.
80			- properly calculate size in enqueue_read_image.
81	root	1.11	- likewise, include row_pitch and slice_pitch in image2d and image3d,
82			which must be nonzero right now, too, sorry.
83			- allow undef or missing data scalar for image2d and image3d.
84	root	1.8	- fix enqueue_copy_image prototype.
85			- fix formatting.
86
87			0.14 Thu Nov 17 04:04:23 CET 2011
88	root	1.20	- major incompatibilities due to API cleanup, the API should now be
89	root	1.7	mostly stable, if incomplete.
90	root	1.6	- fix prerequisites.
91	root	1.7	- replaced all _simple functions by "full" implementations, with some
92	root	1.6	parameters marked for future expansion - that means their API
93			should be stable from now on:
94			OpenCL::context_from_type_simple => OpenCL::context_from_type
95			$platform->context_from_type_simple => $platform->context_from_type
96	root	1.7	$dev->context_simple => $platform->context
97	root	1.6	$ctx->command_queue_simple became => $ctx->queue
98	root	1.7	- add OpenCL::context function.
99			- officially require C99.
100			- errno value is unspecified after a successful call.
101	root	1.5
102	root	1.4	0.03 Wed Nov 16 01:44:26 CET 2011
103	root	1.3	- add some reference documentation for all functions.
104			- add user event support.
105			- implement event wait lists.
106
107	root	1.2	0.02 Tue Nov 15 22:15:47 CET 2011
108			- first opencl kernel executed, some example code.
109
110	root	1.1	0.01 Tue Nov 15 05:59:00 CET 2011
111			- cloned from Convert::Scalar.
112