1 /**************************************************************************
3 * Copyright 2007 VMware, Inc.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
30 #include "st_context.h"
31 #include "st_format.h"
32 #include "st_texture.h"
33 #include "st_cb_fbo.h"
34 #include "main/enums.h"
36 #include "pipe/p_state.h"
37 #include "pipe/p_context.h"
38 #include "pipe/p_defines.h"
39 #include "util/u_inlines.h"
40 #include "util/u_format.h"
41 #include "util/u_rect.h"
42 #include "util/u_math.h"
43 #include "util/u_memory.h"
44 #include "tgsi/tgsi_from_mesa.h"
47 #define DBG if(0) printf
51 * Allocate a new pipe_resource object
52 * width0, height0, depth0 are the dimensions of the level 0 image
53 * (the highest resolution). last_level indicates how many mipmap levels
54 * to allocate storage for. For non-mipmapped textures, this will be zero.
56 struct pipe_resource
*
57 st_texture_create(struct st_context
*st
,
58 enum pipe_texture_target target
,
59 enum pipe_format format
,
68 struct pipe_resource pt
, *newtex
;
69 struct pipe_screen
*screen
= st
->pipe
->screen
;
71 assert(target
< PIPE_MAX_TEXTURE_TYPES
);
75 if (target
== PIPE_TEXTURE_CUBE
)
78 DBG("%s target %d format %s last_level %d\n", __func__
,
79 (int) target
, util_format_name(format
), last_level
);
82 assert(screen
->is_format_supported(screen
, format
, target
, 0,
83 PIPE_BIND_SAMPLER_VIEW
));
85 memset(&pt
, 0, sizeof(pt
));
88 pt
.last_level
= last_level
;
92 pt
.array_size
= layers
;
93 pt
.usage
= PIPE_USAGE_DEFAULT
;
95 /* only set this for OpenGL textures, not renderbuffers */
96 pt
.flags
= PIPE_RESOURCE_FLAG_TEXTURING_MORE_LIKELY
;
97 pt
.nr_samples
= nr_samples
;
99 newtex
= screen
->resource_create(screen
, &pt
);
101 assert(!newtex
|| pipe_is_referenced(&newtex
->reference
));
108 * In OpenGL the number of 1D array texture layers is the "height" and
109 * the number of 2D array texture layers is the "depth". In Gallium the
110 * number of layers in an array texture is a separate 'array_size' field.
111 * This function converts dimensions from the former to the later.
114 st_gl_texture_dims_to_pipe_dims(GLenum texture
,
125 case GL_PROXY_TEXTURE_1D
:
126 assert(heightIn
== 1);
127 assert(depthIn
== 1);
133 case GL_TEXTURE_1D_ARRAY
:
134 case GL_PROXY_TEXTURE_1D_ARRAY
:
135 assert(depthIn
== 1);
139 *layersOut
= heightIn
;
142 case GL_PROXY_TEXTURE_2D
:
143 case GL_TEXTURE_RECTANGLE
:
144 case GL_PROXY_TEXTURE_RECTANGLE
:
145 case GL_TEXTURE_EXTERNAL_OES
:
146 case GL_PROXY_TEXTURE_2D_MULTISAMPLE
:
147 case GL_TEXTURE_2D_MULTISAMPLE
:
148 assert(depthIn
== 1);
150 *heightOut
= heightIn
;
154 case GL_TEXTURE_CUBE_MAP
:
155 case GL_PROXY_TEXTURE_CUBE_MAP
:
156 case GL_TEXTURE_CUBE_MAP_POSITIVE_X
:
157 case GL_TEXTURE_CUBE_MAP_NEGATIVE_X
:
158 case GL_TEXTURE_CUBE_MAP_POSITIVE_Y
:
159 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
:
160 case GL_TEXTURE_CUBE_MAP_POSITIVE_Z
:
161 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z
:
162 assert(depthIn
== 1);
164 *heightOut
= heightIn
;
168 case GL_TEXTURE_2D_ARRAY
:
169 case GL_TEXTURE_2D_MULTISAMPLE_ARRAY
:
170 case GL_PROXY_TEXTURE_2D_ARRAY
:
171 case GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
:
173 *heightOut
= heightIn
;
175 *layersOut
= depthIn
;
177 case GL_TEXTURE_CUBE_MAP_ARRAY
:
178 case GL_PROXY_TEXTURE_CUBE_MAP_ARRAY
:
180 *heightOut
= heightIn
;
182 *layersOut
= util_align_npot(depthIn
, 6);
185 assert(0 && "Unexpected texture in st_gl_texture_dims_to_pipe_dims()");
188 case GL_PROXY_TEXTURE_3D
:
190 *heightOut
= heightIn
;
199 * Check if a texture image can be pulled into a unified mipmap texture.
202 st_texture_match_image(struct st_context
*st
,
203 const struct pipe_resource
*pt
,
204 const struct gl_texture_image
*image
)
207 uint16_t ptHeight
, ptDepth
, ptLayers
;
209 /* Images with borders are never pulled into mipmap textures.
214 /* Check if this image's format matches the established texture's format.
216 if (st_mesa_format_to_pipe_format(st
, image
->TexFormat
) != pt
->format
)
219 st_gl_texture_dims_to_pipe_dims(image
->TexObject
->Target
,
220 image
->Width
, image
->Height
, image
->Depth
,
221 &ptWidth
, &ptHeight
, &ptDepth
, &ptLayers
);
223 /* Test if this image's size matches what's expected in the
224 * established texture.
226 if (ptWidth
!= u_minify(pt
->width0
, image
->Level
) ||
227 ptHeight
!= u_minify(pt
->height0
, image
->Level
) ||
228 ptDepth
!= u_minify(pt
->depth0
, image
->Level
) ||
229 ptLayers
!= pt
->array_size
)
232 if (image
->Level
> pt
->last_level
)
240 * Map a texture image and return the address for a particular 2D face/slice/
241 * layer. The stImage indicates the cube face and mipmap level. The slice
242 * of the 3D texture is passed in 'zoffset'.
243 * \param usage one of the PIPE_TRANSFER_x values
244 * \param x, y, w, h the region of interest of the 2D image.
245 * \return address of mapping or NULL if any error
248 st_texture_image_map(struct st_context
*st
, struct st_texture_image
*stImage
,
249 enum pipe_transfer_usage usage
,
250 GLuint x
, GLuint y
, GLuint z
,
251 GLuint w
, GLuint h
, GLuint d
,
252 struct pipe_transfer
**transfer
)
254 struct st_texture_object
*stObj
=
255 st_texture_object(stImage
->base
.TexObject
);
259 DBG("%s \n", __func__
);
264 if (stObj
->pt
!= stImage
->pt
)
267 level
= stImage
->base
.Level
;
269 if (stObj
->base
.Immutable
) {
270 level
+= stObj
->base
.MinLevel
;
271 z
+= stObj
->base
.MinLayer
;
272 if (stObj
->pt
->array_size
> 1)
273 d
= MIN2(d
, stObj
->base
.NumLayers
);
276 z
+= stImage
->base
.Face
;
278 map
= pipe_transfer_map_3d(st
->pipe
, stImage
->pt
, level
, usage
,
279 x
, y
, z
, w
, h
, d
, transfer
);
281 /* Enlarge the transfer array if it's not large enough. */
282 if (z
>= stImage
->num_transfers
) {
283 unsigned new_size
= z
+ 1;
285 stImage
->transfer
= realloc(stImage
->transfer
,
286 new_size
* sizeof(struct st_texture_image_transfer
));
287 memset(&stImage
->transfer
[stImage
->num_transfers
], 0,
288 (new_size
- stImage
->num_transfers
) *
289 sizeof(struct st_texture_image_transfer
));
290 stImage
->num_transfers
= new_size
;
293 assert(!stImage
->transfer
[z
].transfer
);
294 stImage
->transfer
[z
].transfer
= *transfer
;
301 st_texture_image_unmap(struct st_context
*st
,
302 struct st_texture_image
*stImage
, unsigned slice
)
304 struct pipe_context
*pipe
= st
->pipe
;
305 struct st_texture_object
*stObj
=
306 st_texture_object(stImage
->base
.TexObject
);
307 struct pipe_transfer
**transfer
;
309 if (stObj
->base
.Immutable
)
310 slice
+= stObj
->base
.MinLayer
;
311 transfer
= &stImage
->transfer
[slice
+ stImage
->base
.Face
].transfer
;
313 DBG("%s\n", __func__
);
315 pipe_transfer_unmap(pipe
, *transfer
);
321 * For debug only: get/print center pixel in the src resource.
324 print_center_pixel(struct pipe_context
*pipe
, struct pipe_resource
*src
)
326 struct pipe_transfer
*xfer
;
327 struct pipe_box region
;
330 region
.x
= src
->width0
/ 2;
331 region
.y
= src
->height0
/ 2;
337 map
= pipe
->transfer_map(pipe
, src
, 0, PIPE_TRANSFER_READ
, ®ion
, &xfer
);
339 printf("center pixel: %d %d %d %d\n", map
[0], map
[1], map
[2], map
[3]);
341 pipe
->transfer_unmap(pipe
, xfer
);
346 * Copy the image at level=0 in 'src' to the 'dst' resource at 'dstLevel'.
347 * This is used to copy mipmap images from one texture buffer to another.
348 * This typically happens when our initial guess at the total texture size
349 * is incorrect (see the guess_and_alloc_texture() function).
352 st_texture_image_copy(struct pipe_context
*pipe
,
353 struct pipe_resource
*dst
, GLuint dstLevel
,
354 struct pipe_resource
*src
, GLuint srcLevel
,
357 GLuint width
= u_minify(dst
->width0
, dstLevel
);
358 GLuint height
= u_minify(dst
->height0
, dstLevel
);
359 GLuint depth
= u_minify(dst
->depth0
, dstLevel
);
360 struct pipe_box src_box
;
363 if (u_minify(src
->width0
, srcLevel
) != width
||
364 u_minify(src
->height0
, srcLevel
) != height
||
365 u_minify(src
->depth0
, srcLevel
) != depth
) {
366 /* The source image size doesn't match the destination image size.
367 * This can happen in some degenerate situations such as rendering to a
368 * cube map face which was set up with mismatched texture sizes.
375 src_box
.width
= width
;
376 src_box
.height
= height
;
379 if (src
->target
== PIPE_TEXTURE_1D_ARRAY
||
380 src
->target
== PIPE_TEXTURE_2D_ARRAY
||
381 src
->target
== PIPE_TEXTURE_CUBE_ARRAY
) {
383 depth
= src
->array_size
;
386 /* Loop over 3D image slices */
387 /* could (and probably should) use "true" 3d box here -
388 but drivers can't quite handle it yet */
389 for (i
= face
; i
< face
+ depth
; i
++) {
393 print_center_pixel(pipe
, src
);
396 pipe
->resource_copy_region(pipe
,
399 0, 0, i
,/* destX, Y, Z */
407 struct pipe_resource
*
408 st_create_color_map_texture(struct gl_context
*ctx
)
410 struct st_context
*st
= st_context(ctx
);
411 struct pipe_resource
*pt
;
412 enum pipe_format format
;
413 const uint texSize
= 256; /* simple, and usually perfect */
415 /* find an RGBA texture format */
416 format
= st_choose_format(st
, GL_RGBA
, GL_NONE
, GL_NONE
,
417 PIPE_TEXTURE_2D
, 0, PIPE_BIND_SAMPLER_VIEW
,
420 /* create texture for color map/table */
421 pt
= st_texture_create(st
, PIPE_TEXTURE_2D
, format
, 0,
422 texSize
, texSize
, 1, 1, 0, PIPE_BIND_SAMPLER_VIEW
);
428 * Destroy bound texture handles for the given stage.
431 st_destroy_bound_texture_handles_per_stage(struct st_context
*st
,
432 enum pipe_shader_type shader
)
434 struct st_bound_handles
*bound_handles
= &st
->bound_texture_handles
[shader
];
435 struct pipe_context
*pipe
= st
->pipe
;
438 if (likely(!bound_handles
->num_handles
))
441 for (i
= 0; i
< bound_handles
->num_handles
; i
++) {
442 uint64_t handle
= bound_handles
->handles
[i
];
444 pipe
->make_texture_handle_resident(pipe
, handle
, false);
445 pipe
->delete_texture_handle(pipe
, handle
);
447 free(bound_handles
->handles
);
448 bound_handles
->handles
= NULL
;
449 bound_handles
->num_handles
= 0;
454 * Destroy all bound texture handles in the context.
457 st_destroy_bound_texture_handles(struct st_context
*st
)
461 for (i
= 0; i
< PIPE_SHADER_TYPES
; i
++) {
462 st_destroy_bound_texture_handles_per_stage(st
, i
);
468 * Destroy bound image handles for the given stage.
471 st_destroy_bound_image_handles_per_stage(struct st_context
*st
,
472 enum pipe_shader_type shader
)
474 struct st_bound_handles
*bound_handles
= &st
->bound_image_handles
[shader
];
475 struct pipe_context
*pipe
= st
->pipe
;
478 if (likely(!bound_handles
->num_handles
))
481 for (i
= 0; i
< bound_handles
->num_handles
; i
++) {
482 uint64_t handle
= bound_handles
->handles
[i
];
484 pipe
->make_image_handle_resident(pipe
, handle
, GL_READ_WRITE
, false);
485 pipe
->delete_image_handle(pipe
, handle
);
487 free(bound_handles
->handles
);
488 bound_handles
->handles
= NULL
;
489 bound_handles
->num_handles
= 0;
494 * Destroy all bound image handles in the context.
497 st_destroy_bound_image_handles(struct st_context
*st
)
501 for (i
= 0; i
< PIPE_SHADER_TYPES
; i
++) {
502 st_destroy_bound_image_handles_per_stage(st
, i
);
508 * Create a texture handle from a texture unit.
511 st_create_texture_handle_from_unit(struct st_context
*st
,
512 struct gl_program
*prog
, GLuint texUnit
)
514 struct pipe_context
*pipe
= st
->pipe
;
515 struct pipe_sampler_view
*view
;
516 struct pipe_sampler_state sampler
= {0};
518 st_update_single_texture(st
, &view
, texUnit
, prog
->sh
.data
->Version
>= 130);
522 if (view
->target
!= PIPE_BUFFER
)
523 st_convert_sampler_from_unit(st
, &sampler
, texUnit
);
525 assert(st
->ctx
->Texture
.Unit
[texUnit
]._Current
);
527 return pipe
->create_texture_handle(pipe
, view
, &sampler
);
532 * Create an image handle from an image unit.
535 st_create_image_handle_from_unit(struct st_context
*st
,
536 struct gl_program
*prog
, GLuint imgUnit
)
538 struct pipe_context
*pipe
= st
->pipe
;
539 struct pipe_image_view img
;
541 st_convert_image_from_unit(st
, &img
, imgUnit
);
543 return pipe
->create_image_handle(pipe
, &img
);
548 * Make all bindless samplers bound to texture units resident in the context.
551 st_make_bound_samplers_resident(struct st_context
*st
,
552 struct gl_program
*prog
)
554 enum pipe_shader_type shader
= pipe_shader_type_from_mesa(prog
->info
.stage
);
555 struct st_bound_handles
*bound_handles
= &st
->bound_texture_handles
[shader
];
556 struct pipe_context
*pipe
= st
->pipe
;
560 /* Remove previous bound texture handles for this stage. */
561 st_destroy_bound_texture_handles_per_stage(st
, shader
);
563 if (likely(!prog
->sh
.HasBoundBindlessSampler
))
566 for (i
= 0; i
< prog
->sh
.NumBindlessSamplers
; i
++) {
567 struct gl_bindless_sampler
*sampler
= &prog
->sh
.BindlessSamplers
[i
];
572 /* Request a new texture handle from the driver and make it resident. */
573 handle
= st_create_texture_handle_from_unit(st
, prog
, sampler
->unit
);
577 pipe
->make_texture_handle_resident(st
->pipe
, handle
, true);
579 /* Overwrite the texture unit value by the resident handle before
580 * uploading the constant buffer.
582 *(uint64_t *)sampler
->data
= handle
;
584 /* Store the handle in the context. */
585 bound_handles
->handles
= (uint64_t *)
586 realloc(bound_handles
->handles
,
587 (bound_handles
->num_handles
+ 1) * sizeof(uint64_t));
588 bound_handles
->handles
[bound_handles
->num_handles
] = handle
;
589 bound_handles
->num_handles
++;
595 * Make all bindless images bound to image units resident in the context.
598 st_make_bound_images_resident(struct st_context
*st
,
599 struct gl_program
*prog
)
601 enum pipe_shader_type shader
= pipe_shader_type_from_mesa(prog
->info
.stage
);
602 struct st_bound_handles
*bound_handles
= &st
->bound_image_handles
[shader
];
603 struct pipe_context
*pipe
= st
->pipe
;
607 /* Remove previous bound image handles for this stage. */
608 st_destroy_bound_image_handles_per_stage(st
, shader
);
610 if (likely(!prog
->sh
.HasBoundBindlessImage
))
613 for (i
= 0; i
< prog
->sh
.NumBindlessImages
; i
++) {
614 struct gl_bindless_image
*image
= &prog
->sh
.BindlessImages
[i
];
619 /* Request a new image handle from the driver and make it resident. */
620 handle
= st_create_image_handle_from_unit(st
, prog
, image
->unit
);
624 pipe
->make_image_handle_resident(st
->pipe
, handle
, GL_READ_WRITE
, true);
626 /* Overwrite the image unit value by the resident handle before uploading
627 * the constant buffer.
629 *(uint64_t *)image
->data
= handle
;
631 /* Store the handle in the context. */
632 bound_handles
->handles
= (uint64_t *)
633 realloc(bound_handles
->handles
,
634 (bound_handles
->num_handles
+ 1) * sizeof(uint64_t));
635 bound_handles
->handles
[bound_handles
->num_handles
] = handle
;
636 bound_handles
->num_handles
++;