--- OpenCL/OpenCL.pm 2011/11/20 01:09:48 1.20 +++ OpenCL/OpenCL.pm 2011/11/22 10:39:47 1.25 @@ -103,10 +103,10 @@ system. for my $platform (OpenCL::platforms) { - printf "platform: %s\n", $platform->info (OpenCL::PLATFORM_NAME); - printf "extensions: %s\n", $platform->info (OpenCL::PLATFORM_EXTENSIONS); + printf "platform: %s\n", $platform->name; + printf "extensions: %s\n", $platform->extensions; for my $device ($platform->devices) { - printf "+ device: %s\n", $device->info (OpenCL::DEVICE_NAME); + printf "+ device: %s\n", $device->name; my $ctx = $device->context; # do stuff } @@ -163,7 +163,7 @@ # build croaks on compile errors, so catch it and print the compile errors eval { $prog->build ($dev); 1 } - or die $prog->build_info ($dev, OpenCL::PROGRAM_BUILD_LOG); + or die $prog->build_log; my $kernel = $prog->kernel ("squareit"); @@ -324,7 +324,7 @@ =item $ctx = $platform->context_from_type ($properties, $type = OpenCL::DEVICE_TYPE_DEFAULT, $notify = undef) -Tries to create a context. Never worked for me, and you need devices explitly anyway. +Tries to create a context. Never worked for me, and you need devices explicitly anyway. L @@ -338,36 +338,36 @@ =item $packed_value = $platform->info ($name) Calls C and returns the packed, raw value - for -strings, this will be the string, for other values you probably need to -use the correct C. +strings, this will be the string (possibly including terminating \0), for +other values you probably need to use the correct C. -It's best to avoid this method and use one of the predefined C -methods. +It's best to avoid this method and use one of the following convenience +wrappers. L =for gengetinfo begin platform - =item $string = $platform->profile -Calls C with C and returns the result(s). +Calls C with C and returns the result. =item $string = $platform->version -Calls C with C and returns the result(s). +Calls C with C and returns the result. =item $string = $platform->name -Calls C with C and returns the result(s). +Calls C with C and returns the result. =item $string = $platform->vendor -Calls C with C and returns the result(s). +Calls C with C and returns the result. =item $string = $platform->extensions -Calls C with C and returns the result(s). +Calls C with C and returns the result. + =for gengetinfo end platform =back @@ -382,6 +382,274 @@ L +=for gengetinfo begin device + +=item $device_type = $device->type + +Calls C with C and returns the result. + +=item $uint = $device->vendor_id + +Calls C with C and returns the result. + +=item $uint = $device->max_compute_units + +Calls C with C and returns the result. + +=item $uint = $device->max_work_item_dimensions + +Calls C with C and returns the result. + +=item $int = $device->max_work_group_size + +Calls C with C and returns the result. + +=item @ints = $device->max_work_item_sizes + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_char + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_short + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_int + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_long + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_float + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_double + +Calls C with C and returns the result. + +=item $uint = $device->max_clock_frequency + +Calls C with C and returns the result. + +=item $bitfield = $device->address_bits + +Calls C with C and returns the result. + +=item $uint = $device->max_read_image_args + +Calls C with C and returns the result. + +=item $uint = $device->max_write_image_args + +Calls C with C and returns the result. + +=item $ulong = $device->max_mem_alloc_size + +Calls C with C and returns the result. + +=item $int = $device->image2d_max_width + +Calls C with C and returns the result. + +=item $int = $device->image2d_max_height + +Calls C with C and returns the result. + +=item $int = $device->image3d_max_width + +Calls C with C and returns the result. + +=item $int = $device->image3d_max_height + +Calls C with C and returns the result. + +=item $int = $device->image3d_max_depth + +Calls C with C and returns the result. + +=item $uint = $device->image_support + +Calls C with C and returns the result. + +=item $int = $device->max_parameter_size + +Calls C with C and returns the result. + +=item $uint = $device->max_samplers + +Calls C with C and returns the result. + +=item $uint = $device->mem_base_addr_align + +Calls C with C and returns the result. + +=item $uint = $device->min_data_type_align_size + +Calls C with C and returns the result. + +=item $device_fp_config = $device->single_fp_config + +Calls C with C and returns the result. + +=item $device_mem_cache_type = $device->global_mem_cache_type + +Calls C with C and returns the result. + +=item $uint = $device->global_mem_cacheline_size + +Calls C with C and returns the result. + +=item $ulong = $device->global_mem_cache_size + +Calls C with C and returns the result. + +=item $ulong = $device->global_mem_size + +Calls C with C and returns the result. + +=item $ulong = $device->max_constant_buffer_size + +Calls C with C and returns the result. + +=item $uint = $device->max_constant_args + +Calls C with C and returns the result. + +=item $device_local_mem_type = $device->local_mem_type + +Calls C with C and returns the result. + +=item $ulong = $device->local_mem_size + +Calls C with C and returns the result. + +=item $boolean = $device->error_correction_support + +Calls C with C and returns the result. + +=item $int = $device->profiling_timer_resolution + +Calls C with C and returns the result. + +=item $boolean = $device->endian_little + +Calls C with C and returns the result. + +=item $boolean = $device->available + +Calls C with C and returns the result. + +=item $boolean = $device->compiler_available + +Calls C with C and returns the result. + +=item $device_exec_capabilities = $device->execution_capabilities + +Calls C with C and returns the result. + +=item $command_queue_properties = $device->properties + +Calls C with C and returns the result. + +=item $ = $device->platform + +Calls C with C and returns the result. + +=item $string = $device->name + +Calls C with C and returns the result. + +=item $string = $device->vendor + +Calls C with C and returns the result. + +=item $string = $device->driver_version + +Calls C with C and returns the result. + +=item $string = $device->profile + +Calls C with C and returns the result. + +=item $string = $device->version + +Calls C with C and returns the result. + +=item $string = $device->extensions + +Calls C with C and returns the result. + +=item $uint = $device->preferred_vector_width_half + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_char + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_short + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_int + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_long + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_float + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_double + +Calls C with C and returns the result. + +=item $uint = $device->native_vector_width_half + +Calls C with C and returns the result. + +=item $device_fp_config = $device->double_fp_config + +Calls C with C and returns the result. + +=item $device_fp_config = $device->half_fp_config + +Calls C with C and returns the result. + +=item $boolean = $device->host_unified_memory + +Calls C with C and returns the result. + +=item $device = $device->parent_device_ext + +Calls C with C and returns the result. + +=item @device_partition_property_exts = $device->partition_types_ext + +Calls C with C and returns the result. + +=item @device_partition_property_exts = $device->affinity_domains_ext + +Calls C with C and returns the result. + +=item $uint = $device->reference_count_ext + +Calls C with C and returns the result. + +=item @device_partition_property_exts = $device->partition_style_ext + +Calls C with C and returns the result. + +=for gengetinfo end device + =back =head2 THE OpenCL::Context CLASS @@ -449,6 +717,22 @@ =for gengetinfo begin context +=item $uint = $context->reference_count + +Calls C with C and returns the result. + +=item @devices = $context->devices + +Calls C with C and returns the result. + +=item @property_ints = $context->properties + +Calls C with C and returns the result. + +=item $uint = $context->num_devices + +Calls C with C and returns the result. + =for gengetinfo end context =back @@ -473,12 +757,6 @@ =over 4 -=item $packed_value = $ctx->info ($name) - -See C<< $platform->info >> for details. - -L - =item $ev = $queue->enqueue_read_buffer ($buffer, $blocking, $offset, $len, $data, $wait_events...) Reads data from buffer into the given string. @@ -495,6 +773,14 @@ L +=item $ev = $queue->enqueue_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...) + +http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueReadBufferRect.html + +=item $ev = $queue->enqueue_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...) + +http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clEnqueueWriteBufferRect.html + =item $ev = $queue->enqueue_read_image ($src, $blocking, $x, $y, $z, $width, $height, $depth, $row_pitch, $slice_pitch, $data, $wait_events...) L @@ -563,13 +849,38 @@ L +=item $packed_value = $queue->info ($name) + +See C<< $platform->info >> for details. + +L + +=for gengetinfo begin command_queue + +=item $ctx = $command_queue->context + +Calls C with C and returns the result. + +=item $device = $command_queue->device + +Calls C with C and returns the result. + +=item $uint = $command_queue->reference_count + +Calls C with C and returns the result. + +=item $command_queue_properties = $command_queue->properties + +Calls C with C and returns the result. + +=for gengetinfo end command_queue + =back =head2 THE OpenCL::Memory CLASS This the superclass of all memory objects - OpenCL::Buffer, OpenCL::Image, -OpenCL::Image2D and OpenCL::Image3D. The subclasses of this class -currently only exist to allow type-checking. +OpenCL::Image2D and OpenCL::Image3D. =over 4 @@ -579,6 +890,46 @@ L +=for gengetinfo begin mem + +=item $mem_object_type = $mem->type + +Calls C with C and returns the result. + +=item $mem_flags = $mem->flags + +Calls C with C and returns the result. + +=item $int = $mem->size + +Calls C with C and returns the result. + +=item $ptr_value = $mem->host_ptr + +Calls C with C and returns the result. + +=item $uint = $mem->map_count + +Calls C with C and returns the result. + +=item $uint = $mem->reference_count + +Calls C with C and returns the result. + +=item $ctx = $mem->context + +Calls C with C and returns the result. + +=item $mem = $mem->associated_memobject + +Calls C with C and returns the result. + +=item $int = $mem->offset + +Calls C with C and returns the result. + +=for gengetinfo end mem + =back =head2 THE OpenCL::Image CLASS @@ -596,6 +947,34 @@ L +=for gengetinfo begin image + +=item $int = $image->element_size + +Calls C with C and returns the result. + +=item $int = $image->row_pitch + +Calls C with C and returns the result. + +=item $int = $image->slice_pitch + +Calls C with C and returns the result. + +=item $int = $image->width + +Calls C with C and returns the result. + +=item $int = $image->height + +Calls C with C and returns the result. + +=item $int = $image->depth + +Calls C with C and returns the result. + +=for gengetinfo end image + =back =head2 THE OpenCL::Sampler CLASS @@ -608,17 +987,35 @@ L -=back +=for gengetinfo begin sampler -=head2 THE OpenCL::Program CLASS +=item $uint = $sampler->reference_count -=over 4 +Calls C with C and returns the result. -=item $packed_value = $program->info ($name) +=item $ctx = $sampler->context -See C<< $platform->info >> for details. +Calls C with C and returns the result. -L +=item $addressing_mode = $sampler->normalized_coords + +Calls C with C and returns the result. + +=item $filter_mode = $sampler->addressing_mode + +Calls C with C and returns the result. + +=item $boolean = $sampler->filter_mode + +Calls C with C and returns the result. + +=for gengetinfo end sampler + +=back + +=head2 THE OpenCL::Program CLASS + +=over 4 =item $program->build ($device, $options = "") @@ -640,6 +1037,67 @@ L +=for gengetinfo begin program_build + +=item $build_status = $program->build_status ($device) + +Calls C with C and returns the result. + +=item $string = $program->build_options ($device) + +Calls C with C and returns the result. + +=item $string = $program->build_log ($device) + +Calls C with C and returns the result. + +=for gengetinfo end program_build + +=item $packed_value = $program->info ($name) + +See C<< $platform->info >> for details. + +L + +=for gengetinfo begin program + +=item $uint = $program->reference_count + +Calls C with C and returns the result. + +=item $ctx = $program->context + +Calls C with C and returns the result. + +=item $uint = $program->num_devices + +Calls C with C and returns the result. + +=item @devices = $program->devices + +Calls C with C and returns the result. + +=item $string = $program->source + +Calls C with C and returns the result. + +=item @ints = $program->binary_sizes + +Calls C with C and returns the result. + +=for gengetinfo end program + +=item @blobs = $program->binaries + +Returns a string for the compiled binary for every device associated with +the program, empty strings indicate missing programs, and an empty result +means no program binaries are available. + +These "binaries" are often, in fact, informative low-level assembly +sources. + +L + =back =head2 THE OpenCL::Kernel CLASS @@ -652,6 +1110,30 @@ L +=for gengetinfo begin kernel + +=item $string = $kernel->function_name + +Calls C with C and returns the result. + +=item $uint = $kernel->num_args + +Calls C with C and returns the result. + +=item $uint = $kernel->reference_count + +Calls C with C and returns the result. + +=item $ctx = $kernel->context + +Calls C with C and returns the result. + +=item $program = $kernel->program + +Calls C with C and returns the result. + +=for gengetinfo end kernel + =item $packed_value = $kernel->work_group_info ($device, $name) See C<< $platform->info >> for details. @@ -661,6 +1143,30 @@ L +=for gengetinfo begin kernel_work_group + +=item $int = $kernel->work_group_size ($device) + +Calls C with C and returns the result. + +=item @ints = $kernel->compile_work_group_size ($device) + +Calls C with C and returns the result. + +=item $ulong = $kernel->local_mem_size ($device) + +Calls C with C and returns the result. + +=item $int = $kernel->preferred_work_group_size_multiple ($device) + +Calls C with C and returns the result. + +=item $ulong = $kernel->private_mem_size ($device) + +Calls C with C and returns the result. + +=for gengetinfo end kernel_work_group + =item $kernel->set_TYPE ($index, $value) This is a family of methods to set the kernel argument with the number C<$index> to the give C<$value>. @@ -685,12 +1191,42 @@ =over 4 +=item $ev->wait + +Waits for the event to complete. + +L + =item $packed_value = $ev->info ($name) See C<< $platform->info >> for details. L +=for gengetinfo begin event + +=item $queue = $event->command_queue + +Calls C with C and returns the result. + +=item $command_type = $event->command_type + +Calls C with C and returns the result. + +=item $uint = $event->reference_count + +Calls C with C and returns the result. + +=item $uint = $event->command_execution_status + +Calls C with C and returns the result. + +=item $ctx = $event->context + +Calls C with C and returns the result. + +=for gengetinfo end event + =item $packed_value = $ev->profiling_info ($name) See C<< $platform->info >> for details. @@ -700,11 +1236,25 @@ L -=item $ev->wait +=for gengetinfo begin profiling -Waits for the event to complete. +=item $ulong = $event->profiling_command_queued -L +Calls C with C and returns the result. + +=item $ulong = $event->profiling_command_submit + +Calls C with C and returns the result. + +=item $ulong = $event->profiling_command_start + +Calls C with C and returns the result. + +=item $ulong = $event->profiling_command_end + +Calls C with C and returns the result. + +=for gengetinfo end profiling =back @@ -727,7 +1277,7 @@ use common::sense; BEGIN { - our $VERSION = '0.15'; + our $VERSION = '0.55'; require XSLoader; XSLoader::load (__PACKAGE__, $VERSION);