[ViewVC] Diff of: cvs/OpenCL/OpenCL.pm

Comparing OpenCL/OpenCL.pm (file contents):
Revision 1.80 by root, Sat May 5 13:55:59 2012 UTC vs.
Revision 1.84 by root, Sat May 5 16:44:02 2012 UTC

    $ev->wait;
 =head2 Use the OpenGL module to share a texture between OpenCL and OpenGL and draw some julia
 set flight effect.
-This is quite a long example to get you going - you can download it from
+This is quite a long example to get you going - you can also download it
-L<http://cvs.schmorp.de/OpenCL/examples/juliaflight>.
+from L<http://cvs.schmorp.de/OpenCL/examples/juliaflight>.
    use OpenGL ":all";
    use OpenCL;
    my $S = $ARGV[0] || 256; # window/texture size, smaller is faster
 =head2 CONSTANTS
 All C<CL_xxx> constants that this module supports are always available
 in the C<OpenCL> namespace as C<OpenCL::xxx> (i.e. without the C<CL_>
-prefix). Constants which are not defined in the heaer files used during
+prefix). Constants which are not defined in the header files used during
 compilation, or otherwise are not available, will have the value C<-1>.
+The latest version of this module knows and exports the constants
+listed in L<http://cvs.schmorp.de/OpenCL/constiv.h>.
 =head2 OPENCL 1.1 VS. OPENCL 1.2
 This module supports both OpenCL version 1.1 and 1.2, although the OpenCL
 1.2 interface hasn't been tested much for lack of availability of an
 particular OpenCL function has a link to the its C manual page.
 If the link contains a F<1.1>, then this function is an OpenCL 1.1
 function. Most but not all also exist in OpenCL 1.2, and this module
 tries to emulate the missing ones for you, when told to do so at
-compiletime. You cna check whether a function was removed in OpenCL 1.2 by
+compiletime. You can check whether a function was removed in OpenCL 1.2 by
 replacing the F<1.1> component in the URL by F<1.2>.
 If the link contains a F<1.2>, then this is a OpenCL 1.2-only
 function. Even if the module was compiled with OpenCL 1.2 header files
 and has an 1.2 OpenCL library, calling such a function on a platform that
 The last error returned by a function - it's only valid after an error occured
 and before calling another OpenCL function.
 =item $str = OpenCL::err2str [$errval]
-Converts an error value into a human readable string. IF no error value is
+Converts an error value into a human readable string. If no error value is
 given, then the last error will be used (as returned by OpenCL::errno).
+The latest version of this module knows the error constants
+listed in L<http://cvs.schmorp.de/OpenCL/errstr.h>.
 =item $str = OpenCL::enum2str $enum
 Converts most enum values (of parameter names, image format constants,
 object types, addressing and filter modes, command types etc.) into a
 human readable string. When confronted with some random integer it can be
 very helpful to pass it through this function to maybe get some readable
 string out of it.
+The latest version of this module knows the enumaration constants
+listed in L<http://cvs.schmorp.de/OpenCL/enumstr.h>.
 =item @platforms = OpenCL::platforms
 Returns all available OpenCL::Platform objects.
 =item $ev = $queue->copy_buffer ($src, $dst, $src_offset, $dst_offset, $len, $wait_events...)
 L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueCopyBuffer.html>
-=item $ev = $queue->read_buffer_rect (OpenCL::Memory buf, cl_bool blocking, $buf_x, $buf_y, $buf_z, $host_x, $host_y, $host_z, $width, $height, $depth, $buf_row_pitch, $buf_slice_pitch, $host_row_pitch, $host_slice_pitch, $data, $wait_events...)
+$eue->read_buffer_rect ($buf, cl_bool blocking, $buf_x, $buf_y, $buf_z, $host_x, $host_y, $host_z, $width, $height, $depth, $buf_row_pitch, $buf_slice_pitch, $host_row_pitch, $host_slice_pitch, $data, $wait_events...)
 http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueReadBufferRect.html
-=item $ev = $queue->write_buffer_rect (OpenCL::Memory buf, cl_bool blocking, $buf_x, $buf_y, $buf_z, $host_x, $host_y, $host_z, $width, $height, $depth, $buf_row_pitch, $buf_slice_pitch, $host_row_pitch, $host_slice_pitch, $data, $wait_events...)
+=item $ev = $queue->write_buffer_rect ($buf, $blocking, $buf_y, $host_x, $host_z, $height, $buf_row_pitch, $host_row_pitch, $data, $wait_events...)
 http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueWriteBufferRect.html
 =item $ev = $queue->copy_buffer_to_image ($src_buffer, $dst_image, $src_offset, $dst_x, $dst_y, $dst_z, $width, $height, $depth, $wait_events...)
 it. You are not necessarily meant to do it this way, this example just
 shows you the accessors to use :)
    my $mapped = $queue->map_image ($image, 1, OpenCL::MAP_WRITE);
-   $mapped->set ($_ * $mapped->row_pitch, pack "C", 5)
+   $mapped->write ($_ * $mapped->row_pitch, pack "C", 5)
-      for 0..$image->height;
+      for 0 .. $mapped->height - 1;
    $mapped->unmap;.
    $mapped->wait; # only needed for out of order queues normally
 =item $ev = $queue->unmap ($mapped, $wait_events...)
 =item $packed_value = $memory->info ($name)
 See C<< $platform->info >> for details.
 L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clGetMemObjectInfo.html>
+=item $memory->destructor_callback ($cb->())
+Sets a callback that will be invoked after the memory object is destructed.
+L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clSetMemObjectDestructorCallback.html>
 =for gengetinfo begin mem
 =item $mem_object_type = $mem->type
 This is a subclass of OpenCL::Mapped, representing mapped images.
 =over 4
+=item $pixels = $mapped->width
+=item $pixels = $mapped->height
+=item $pixels = $mapped->depth
+Return the width/height/depth of the mapped image region, in pixels.
 =item $bytes = $mapped->row_pitch
 =item $bytes = $mapped->slice_pitch
 Return the row or slice pitch of the image that has been mapped.
+=item $bytes = $mapped->element_size
+Return the size of a single pixel.
+=item $data = $mapped->get_row ($count, $x=0, $y=0, $z=0)
+Return C<$count> pixels from the given coordinates. The pixel data must
+be completely contained within a single row.
+If C<$count> is C<undef>, then all the remaining pixels in that row are
+returned.
+=item $mapped->set_row ($data, $x=0, $y=0, $z=0)
+Write the given pixel data at the given coordinate. The pixel data must
+be completely contained within a single row.
 =back
 =cut
 1;

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing OpenCL/OpenCL.pm (file contents): Revision 1.80 by root, Sat May 5 13:55:59 2012 UTC vs. Revision 1.84 by root, Sat May 5 16:44:02 2012 UTC

Diff Legend

Comparing OpenCL/OpenCL.pm (file contents):
Revision 1.80 by root, Sat May 5 13:55:59 2012 UTC vs.
Revision 1.84 by root, Sat May 5 16:44:02 2012 UTC