diff options
Diffstat (limited to 'boost/compute/image/image3d.hpp')
| -rw-r--r-- | boost/compute/image/image3d.hpp | 265 |
1 files changed, 265 insertions, 0 deletions
diff --git a/boost/compute/image/image3d.hpp b/boost/compute/image/image3d.hpp new file mode 100644 index 0000000000..9463cfaa16 --- /dev/null +++ b/boost/compute/image/image3d.hpp @@ -0,0 +1,265 @@ +//---------------------------------------------------------------------------// +// 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 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 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 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 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 |