2 // Copyright 2012 Francisco Jerez
4 // Permission is hereby granted, free of charge, to any person obtaining a
5 // copy of this software and associated documentation files (the "Software"),
6 // to deal in the Software without restriction, including without limitation
7 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 // and/or sell copies of the Software, and to permit persons to whom the
9 // Software is furnished to do so, subject to the following conditions:
11 // The above copyright notice and this permission notice shall be included in
12 // all copies or substantial portions of the Software.
14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 // OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 // OTHER DEALINGS IN THE SOFTWARE.
23 #ifndef _CORE_RESOURCE_HPP_
24 #define _CORE_RESOURCE_HPP_
28 #include "core/base.hpp"
29 #include "core/memory.hpp"
30 #include "core/geometry.hpp"
31 #include "pipe/p_state.h"
37 /// Class that represents a device-specific instance of some memory
42 typedef clover::point<size_t, 3> point;
44 resource(const resource &r) = delete;
47 void copy(command_queue &q, const point &origin, const point ®ion,
48 resource &src_resource, const point &src_origin);
50 void *add_map(command_queue &q, cl_map_flags flags, bool blocking,
51 const point &origin, const point ®ion);
52 void del_map(void *p);
53 unsigned map_count() const;
56 clover::memory_obj &obj;
58 friend class sub_resource;
60 friend struct ::_cl_kernel;
63 resource(clover::device &dev, clover::memory_obj &obj);
65 pipe_sampler_view *bind_sampler_view(clover::command_queue &q);
66 void unbind_sampler_view(clover::command_queue &q,
67 pipe_sampler_view *st);
69 pipe_surface *bind_surface(clover::command_queue &q, bool rw);
70 void unbind_surface(clover::command_queue &q, pipe_surface *st);
76 std::list<mapping> maps;
80 /// Resource associated with its own top-level data storage
81 /// allocated in some device.
83 class root_resource : public resource {
85 root_resource(clover::device &dev, clover::memory_obj &obj,
86 clover::command_queue &q, const std::string &data);
87 root_resource(clover::device &dev, clover::memory_obj &obj,
89 virtual ~root_resource();
93 /// Resource that reuses a portion of some other resource as data
96 class sub_resource : public resource {
98 sub_resource(clover::resource &r, point offset);
102 /// Class that represents a mapping of some resource into the CPU
107 mapping(command_queue &q, resource &r, cl_map_flags flags,
108 bool blocking, const resource::point &origin,
109 const resource::point ®ion);
110 mapping(const mapping &m) = delete;
111 mapping(mapping &&m);
124 pipe_transfer *pxfer;