266 lines
8.1 KiB
C++
266 lines
8.1 KiB
C++
//---------------------------------------------------------------------------//
|
|
// 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
|