2 * © Copyright 2017-2018 Alyssa Rosenzweig
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 (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25 #ifndef __PAN_POOL_H__
26 #define __PAN_POOL_H__
29 #include <midgard_pack.h>
31 #include "util/u_dynarray.h"
33 /* Represents a pool of memory that can only grow, used to allocate objects
34 * with the same lifetime as the pool itself. In OpenGL, a pool is owned by the
35 * batch for transient structures. In Vulkan, it may be owned by e.g. the
39 /* Parent device for allocation */
40 struct panfrost_device
*dev
;
42 /* BOs allocated by this pool */
43 struct util_dynarray bos
;
45 /* Current transient BO */
46 struct panfrost_bo
*transient_bo
;
48 /* Within the topmost transient BO, how much has been used? */
49 unsigned transient_offset
;
51 /* BO flags to use in the pool */
52 unsigned create_flags
;
56 panfrost_pool_init(struct pan_pool
*pool
, void *memctx
,
57 struct panfrost_device
*dev
, unsigned create_flags
,
61 panfrost_pool_cleanup(struct pan_pool
*pool
);
63 static inline unsigned
64 panfrost_pool_num_bos(struct pan_pool
*pool
)
66 return util_dynarray_num_elements(&pool
->bos
, struct panfrost_bo
*);
70 panfrost_pool_get_bo_handles(struct pan_pool
*pool
, uint32_t *handles
);
72 /* Represents a fat pointer for GPU-mapped memory, returned from the transient
73 * allocator and not used for much else */
75 struct panfrost_transfer
{
80 struct panfrost_transfer
81 panfrost_pool_alloc_aligned(struct pan_pool
*pool
, size_t sz
, unsigned alignment
);
83 /* Default to self-alignment */
85 static inline struct panfrost_transfer
86 panfrost_pool_alloc(struct pan_pool
*pool
, size_t sz
)
88 assert(sz
== util_next_power_of_two(sz
));
89 return panfrost_pool_alloc_aligned(pool
, sz
, sz
);
92 struct panfrost_transfer
93 panfrost_pool_alloc(struct pan_pool
*pool
, size_t sz
);
96 panfrost_pool_upload(struct pan_pool
*pool
, const void *data
, size_t sz
);
99 panfrost_pool_upload_aligned(struct pan_pool
*pool
, const void *data
, size_t sz
, unsigned alignment
);