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

Comparing OpenCL/OpenCL.pm (file contents):
Revision 1.66 by root, Tue May 1 16:37:23 2012 UTC vs.
Revision 1.67 by root, Tue May 1 22:04:56 2012 UTC

    @OpenCL::Image1DArray::ISA  =
    @OpenCL::Image1DBuffer::ISA = OpenCL::Image::;
    @OpenCL::UserEvent::ISA     = OpenCL::Event::;
-   @OpenCL::MappedBuffer       =
+   @OpenCL::MappedBuffer::ISA  =
-   @OpenCL::MappedImage        = OpenCL::Mapped::;
+   @OpenCL::MappedImage::ISA   = OpenCL::Mapped::;
 }
 =head2 THE OpenCL PACKAGE
 =over 4
 copied.
 When the object is destroyed it will enqueue an implicit unmap operation
 on the queue that was used to create it.
+Keep in mind that you I<need> to unmap (or destroy) mapped objects before
+OpenCL sees the changes, even if some implementations don't need this
+sometimes.
 Example, replace the first two floats in the mapped buffer by 1 and 2.
    my $mapped = $queue->map_buffer ($buf, ...
    $mapped->event->wait; # make sure it's there
    # (and of course, we assume iee 754 single precision floats :)
    substr $$mapped, 0, 8, pack "f*", 1, 2;
 =over 4
+=item $ev = $mapped->unmap ($wait_events...)
+Unmaps the mapped memory object, using the queue originally used to create
+it, quite similarly to C<< $queue->unmap ($mapped, ...) >>.
 =item $bool = $mapped->mapped
 Returns whether the object is still mapped - true before an C<unmap> is
 enqueued, false afterwards.
 =item $ptr = $mapped->ptr
 Returns the raw memory address of the mapped area - same as C<$mapped+0>.
+=item $mapped->set ($offset, $data)
+Replaces the data at the given C<$offset> in the memory area by the new
+C<$data>. This method is safer but slower than direct manipulation of
+C<$$mapped> with substr.
+=item $data = $mapped->get ($offset, $length)
+Returns (without copying) a scalar representing the data at the given
+C<$offset> and C<$length> in the mapped memory area. This is the same as
+the following substr, except much slower:
+   $data = substr $$mapped, $offset, $length
+#TODO: really?
+=cut
+sub get {
+   substr ${$_[0]}, $_[1], $_[2]
+}
 =back
 =head2 THE OpenCL::MappedBuffer CLASS
 This is a subclass of OpenCL::Mapped, representing mapped buffers.
+=head2 THE OpenCL::MappedImage CLASS
+This is a subclass of OpenCL::Mapped, representing mapped images.
 =over 4
-=back
+=item $bytes = $mapped->row_pitch
-=head2 THE OpenCL::MappedImage CLASS
+=item $bytes = $mapped->slice_pitch
-This is a subclass of OpenCL::Mapped, representing mapped images.
+Return the row or slice pitch of the image that has been mapped.
-=over 4
 =back
 =cut

Diff Legend

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

Comparing OpenCL/OpenCL.pm (file contents): Revision 1.66 by root, Tue May 1 16:37:23 2012 UTC vs. Revision 1.67 by root, Tue May 1 22:04:56 2012 UTC

Diff Legend

Comparing OpenCL/OpenCL.pm (file contents):
Revision 1.66 by root, Tue May 1 16:37:23 2012 UTC vs.
Revision 1.67 by root, Tue May 1 22:04:56 2012 UTC