1 /*
2  * Copyright 2003 VMware, Inc.
3  * Copyright © 2007 Intel Corporation
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice (including the next
13  * paragraph) shall be included in all copies or substantial portions of the
14  * Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
22  * IN THE SOFTWARE.
23  */
24 
25 /**
26  * @file intel_upload.c
27  *
28  * Batched upload via BOs.
29  */
30 
31 #include "main/imports.h"
32 #include "main/mtypes.h"
33 #include "main/macros.h"
34 #include "main/bufferobj.h"
35 
36 #include "brw_context.h"
37 #include "intel_blit.h"
38 #include "intel_buffer_objects.h"
39 #include "intel_batchbuffer.h"
40 #include "intel_fbo.h"
41 #include "intel_mipmap_tree.h"
42 
43 #include "brw_context.h"
44 
45 #define INTEL_UPLOAD_SIZE (64*1024)
46 
47 void
intel_upload_finish(struct brw_context * brw)48 intel_upload_finish(struct brw_context *brw)
49 {
50    assert((brw->upload.bo == NULL) == (brw->upload.map == NULL));
51    if (!brw->upload.bo)
52       return;
53 
54    brw_bo_unmap(brw->upload.bo);
55    brw_bo_unreference(brw->upload.bo);
56    brw->upload.bo = NULL;
57    brw->upload.map = NULL;
58    brw->upload.next_offset = 0;
59 }
60 
61 /**
62  * Interface for getting memory for uploading streamed data to the GPU
63  *
64  * In most cases, streamed data (for GPU state structures, for example) is
65  * uploaded through brw_state_batch(), since that interface allows relocations
66  * from the streamed space returned to other BOs.  However, that interface has
67  * the restriction that the amount of space allocated has to be "small" (see
68  * estimated_max_prim_size in brw_draw.c).
69  *
70  * This interface, on the other hand, is able to handle arbitrary sized
71  * allocation requests, though it will batch small allocations into the same
72  * BO for efficiency and reduced memory footprint.
73  *
74  * \note The returned pointer is valid only until intel_upload_finish(), which
75  * will happen at batch flush or the next
76  * intel_upload_space()/intel_upload_data().
77  *
78  * \param out_bo Pointer to a BO, which must point to a valid BO or NULL on
79  * entry, and will have a reference to the new BO containing the state on
80  * return.
81  *
82  * \param out_offset Offset within the buffer object that the data will land.
83  */
84 void *
intel_upload_space(struct brw_context * brw,uint32_t size,uint32_t alignment,struct brw_bo ** out_bo,uint32_t * out_offset)85 intel_upload_space(struct brw_context *brw,
86                    uint32_t size,
87                    uint32_t alignment,
88                    struct brw_bo **out_bo,
89                    uint32_t *out_offset)
90 {
91    uint32_t offset;
92 
93    offset = ALIGN_NPOT(brw->upload.next_offset, alignment);
94    if (brw->upload.bo && offset + size > brw->upload.bo->size) {
95       intel_upload_finish(brw);
96       offset = 0;
97    }
98 
99    assert((brw->upload.bo == NULL) == (brw->upload.map == NULL));
100    if (!brw->upload.bo) {
101       brw->upload.bo = brw_bo_alloc(brw->bufmgr, "streamed data",
102                                     MAX2(INTEL_UPLOAD_SIZE, size), 4096);
103       brw->upload.map = brw_bo_map(brw, brw->upload.bo, MAP_READ | MAP_WRITE);
104    }
105 
106    brw->upload.next_offset = offset + size;
107 
108    *out_offset = offset;
109    if (*out_bo != brw->upload.bo) {
110       brw_bo_unreference(*out_bo);
111       *out_bo = brw->upload.bo;
112       brw_bo_reference(brw->upload.bo);
113    }
114 
115    return brw->upload.map + offset;
116 }
117 
118 /**
119  * Handy interface to upload some data to temporary GPU memory quickly.
120  *
121  * References to this memory should not be retained across batch flushes.
122  */
123 void
intel_upload_data(struct brw_context * brw,const void * data,uint32_t size,uint32_t alignment,struct brw_bo ** out_bo,uint32_t * out_offset)124 intel_upload_data(struct brw_context *brw,
125                   const void *data,
126                   uint32_t size,
127                   uint32_t alignment,
128                   struct brw_bo **out_bo,
129                   uint32_t *out_offset)
130 {
131    void *dst = intel_upload_space(brw, size, alignment, out_bo, out_offset);
132    memcpy(dst, data, size);
133 }
134