boost/compute/image/image3d.hpp
//---------------------------------------------------------------------------// // Copyright (c) 2013-2015 Kyle Lutz <kyle.r.lutz@gmail.com> // // Distributed under the Boost Software License, Version 1.0 // See accompanying file LICENSE_1_0.txt or copy at // http://www.boost.org/LICENSE_1_0.txt // // See http://boostorg.github.com/compute for more information. //---------------------------------------------------------------------------// #ifndef BOOST_COMPUTE_IMAGE_IMAGE3D_HPP #define BOOST_COMPUTE_IMAGE_IMAGE3D_HPP #include <boost/throw_exception.hpp> #include <boost/compute/detail/get_object_info.hpp> #include <boost/compute/exception/opencl_error.hpp> #include <boost/compute/image/image_format.hpp> #include <boost/compute/image/image_object.hpp> #include <boost/compute/type_traits/type_name.hpp> #include <boost/compute/utility/extents.hpp> namespace boost { namespace compute { // forward declarations class command_queue; /// \class image3d /// \brief An OpenCL 3D image object /// /// \see image_format, image2d class image3d : public image_object { public: /// Creates a null image3d object. image3d() : image_object() { } /// Creates a new image3d object. /// /// \see_opencl_ref{clCreateImage} image3d(const context &context, size_t image_width, size_t image_height, size_t image_depth, const image_format &format, cl_mem_flags flags = read_write, void *host_ptr = 0, size_t image_row_pitch = 0, size_t image_slice_pitch = 0) { cl_int error = 0; #ifdef BOOST_COMPUTE_CL_VERSION_1_2 cl_image_desc desc; desc.image_type = CL_MEM_OBJECT_IMAGE3D; desc.image_width = image_width; desc.image_height = image_height; desc.image_depth = image_depth; desc.image_array_size = 0; desc.image_row_pitch = image_row_pitch; desc.image_slice_pitch = image_slice_pitch; desc.num_mip_levels = 0; desc.num_samples = 0; #ifdef BOOST_COMPUTE_CL_VERSION_2_0 desc.mem_object = 0; #else desc.buffer = 0; #endif m_mem = clCreateImage(context, flags, format.get_format_ptr(), &desc, host_ptr, &error); #else m_mem = clCreateImage3D(context, flags, format.get_format_ptr(), image_width, image_height, image_depth, image_row_pitch, image_slice_pitch, host_ptr, &error); #endif if(!m_mem){ BOOST_THROW_EXCEPTION(opencl_error(error)); } } /// \internal_ (deprecated) image3d(const context &context, cl_mem_flags flags, const image_format &format, size_t image_width, size_t image_height, size_t image_depth, size_t image_row_pitch, size_t image_slice_pitch = 0, void *host_ptr = 0) { cl_int error = 0; #ifdef BOOST_COMPUTE_CL_VERSION_1_2 cl_image_desc desc; desc.image_type = CL_MEM_OBJECT_IMAGE3D; desc.image_width = image_width; desc.image_height = image_height; desc.image_depth = image_depth; desc.image_array_size = 0; desc.image_row_pitch = image_row_pitch; desc.image_slice_pitch = image_slice_pitch; desc.num_mip_levels = 0; desc.num_samples = 0; #ifdef BOOST_COMPUTE_CL_VERSION_2_0 desc.mem_object = 0; #else desc.buffer = 0; #endif m_mem = clCreateImage(context, flags, format.get_format_ptr(), &desc, host_ptr, &error); #else m_mem = clCreateImage3D(context, flags, format.get_format_ptr(), image_width, image_height, image_depth, image_row_pitch, image_slice_pitch, host_ptr, &error); #endif if(!m_mem){ BOOST_THROW_EXCEPTION(opencl_error(error)); } } /// Creates a new image3d as a copy of \p other. image3d(const image3d &other) : image_object(other) { } /// Copies the image3d from \p other. image3d& operator=(const image3d &other) { image_object::operator=(other); return *this; } #ifndef BOOST_COMPUTE_NO_RVALUE_REFERENCES /// Move-constructs a new image object from \p other. image3d(image3d&& other) BOOST_NOEXCEPT : image_object(std::move(other)) { } /// Move-assigns the image from \p other to \c *this. image3d& operator=(image3d&& other) BOOST_NOEXCEPT { image_object::operator=(std::move(other)); return *this; } #endif // BOOST_COMPUTE_NO_RVALUE_REFERENCES /// Destroys the image3d object. ~image3d() { } /// Returns the size (width, height, depth) of the image. extents<3> size() const { extents<3> size; size[0] = get_info<size_t>(CL_IMAGE_WIDTH); size[1] = get_info<size_t>(CL_IMAGE_HEIGHT); size[2] = get_info<size_t>(CL_IMAGE_DEPTH); return size; } /// Returns the origin of the image (\c 0, \c 0, \c 0). extents<3> origin() const { return extents<3>(); } /// Returns information about the image. /// /// \see_opencl_ref{clGetImageInfo} template<class T> T get_info(cl_image_info info) const { return detail::get_object_info<T>(clGetImageInfo, m_mem, info); } /// \overload template<int Enum> typename detail::get_object_info_type<image3d, Enum>::type get_info() const; /// Returns the supported 3D image formats for the context. /// /// \see_opencl_ref{clGetSupportedImageFormats} static std::vector<image_format> get_supported_formats(const context &context, cl_mem_flags flags = read_write) { return image_object::get_supported_formats(context, CL_MEM_OBJECT_IMAGE3D, flags); } /// Returns \c true if \p format is a supported 3D image format for /// \p context. static bool is_supported_format(const image_format &format, const context &context, cl_mem_flags flags = read_write) { return image_object::is_supported_format( format, context, CL_MEM_OBJECT_IMAGE3D, flags ); } /// Creates a new image with a copy of the data in \c *this. Uses \p queue /// to perform the copy operation. image3d clone(command_queue &queue) const; }; /// \internal_ define get_info() specializations for image3d BOOST_COMPUTE_DETAIL_DEFINE_GET_INFO_SPECIALIZATIONS(image3d, ((cl_image_format, CL_IMAGE_FORMAT)) ((size_t, CL_IMAGE_ELEMENT_SIZE)) ((size_t, CL_IMAGE_ROW_PITCH)) ((size_t, CL_IMAGE_SLICE_PITCH)) ((size_t, CL_IMAGE_WIDTH)) ((size_t, CL_IMAGE_HEIGHT)) ((size_t, CL_IMAGE_DEPTH)) ) namespace detail { // set_kernel_arg() specialization for image3d template<> struct set_kernel_arg<image3d> : public set_kernel_arg<image_object> { }; } // end detail namespace } // end compute namespace } // end boost namespace BOOST_COMPUTE_TYPE_NAME(boost::compute::image3d, image3d_t) #endif // BOOST_COMPUTE_IMAGE_IMAGE3D_HPP