2 * Copyright 2008 Corbin Simpson <MostAwesomeDude@gmail.com>
3 * Copyright 2010 Marek Olšák <maraeo@gmail.com>
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 * on the rights to use, copy, modify, merge, publish, distribute, sub
9 * license, and/or sell copies of the Software, and to permit persons to whom
10 * the Software is furnished to do so, subject to the following conditions:
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
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 NON-INFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
22 * USE OR OTHER DEALINGS IN THE SOFTWARE. */
24 #include "r300_texture_desc.h"
25 #include "r300_context.h"
27 #include "util/u_format.h"
29 /* Returns the number of pixels that the texture should be aligned to
30 * in the given dimension. */
31 unsigned r300_get_pixel_alignment(enum pipe_format format
,
33 enum radeon_bo_layout microtile
,
34 enum radeon_bo_layout macrotile
,
35 enum r300_dim dim
, boolean is_rs690
)
37 static const unsigned table
[2][5][3][2] =
40 /* Macro: linear linear linear
41 Micro: linear tiled square-tiled */
42 {{ 32, 1}, { 8, 4}, { 0, 0}}, /* 8 bits per pixel */
43 {{ 16, 1}, { 8, 2}, { 4, 4}}, /* 16 bits per pixel */
44 {{ 8, 1}, { 4, 2}, { 0, 0}}, /* 32 bits per pixel */
45 {{ 4, 1}, { 2, 2}, { 0, 0}}, /* 64 bits per pixel */
46 {{ 2, 1}, { 0, 0}, { 0, 0}} /* 128 bits per pixel */
49 /* Macro: tiled tiled tiled
50 Micro: linear tiled square-tiled */
51 {{256, 8}, {64, 32}, { 0, 0}}, /* 8 bits per pixel */
52 {{128, 8}, {64, 16}, {32, 32}}, /* 16 bits per pixel */
53 {{ 64, 8}, {32, 16}, { 0, 0}}, /* 32 bits per pixel */
54 {{ 32, 8}, {16, 16}, { 0, 0}}, /* 64 bits per pixel */
55 {{ 16, 8}, { 0, 0}, { 0, 0}} /* 128 bits per pixel */
59 static const unsigned aa_block
[2] = {4, 8};
61 unsigned pixsize
= util_format_get_blocksize(format
);
63 assert(macrotile
<= RADEON_LAYOUT_TILED
);
64 assert(microtile
<= RADEON_LAYOUT_SQUARETILED
);
65 assert(pixsize
<= 16);
66 assert(dim
<= DIM_HEIGHT
);
68 if (num_samples
> 1) {
69 /* Multisampled textures have their own alignment scheme. */
74 /* Standard alignment. */
75 tile
= table
[macrotile
][util_logbase2(pixsize
)][microtile
][dim
];
76 if (macrotile
== 0 && is_rs690
&& dim
== DIM_WIDTH
) {
79 h_tile
= table
[macrotile
][util_logbase2(pixsize
)][microtile
][DIM_HEIGHT
];
80 align
= 64 / (pixsize
* h_tile
);
90 /* Return true if macrotiling should be enabled on the miplevel. */
91 static boolean
r300_texture_macro_switch(struct r300_resource
*tex
,
96 unsigned tile
, texdim
;
98 tile
= r300_get_pixel_alignment(tex
->b
.b
.b
.format
, tex
->b
.b
.b
.nr_samples
,
99 tex
->tex
.microtile
, RADEON_LAYOUT_TILED
, dim
, 0);
100 if (dim
== DIM_WIDTH
) {
101 texdim
= u_minify(tex
->tex
.width0
, level
);
103 texdim
= u_minify(tex
->tex
.height0
, level
);
106 /* See TX_FILTER1_n.MACRO_SWITCH. */
108 return texdim
>= tile
;
110 return texdim
> tile
;
115 * Return the stride, in bytes, of the texture image of the given texture
116 * at the given level.
118 static unsigned r300_texture_get_stride(struct r300_screen
*screen
,
119 struct r300_resource
*tex
,
122 unsigned tile_width
, width
, stride
;
123 boolean is_rs690
= (screen
->caps
.family
== CHIP_FAMILY_RS600
||
124 screen
->caps
.family
== CHIP_FAMILY_RS690
||
125 screen
->caps
.family
== CHIP_FAMILY_RS740
);
127 if (tex
->tex
.stride_in_bytes_override
)
128 return tex
->tex
.stride_in_bytes_override
;
130 /* Check the level. */
131 if (level
> tex
->b
.b
.b
.last_level
) {
132 SCREEN_DBG(screen
, DBG_TEX
, "%s: level (%u) > last_level (%u)\n",
133 __FUNCTION__
, level
, tex
->b
.b
.b
.last_level
);
137 width
= u_minify(tex
->tex
.width0
, level
);
139 if (util_format_is_plain(tex
->b
.b
.b
.format
)) {
140 tile_width
= r300_get_pixel_alignment(tex
->b
.b
.b
.format
,
141 tex
->b
.b
.b
.nr_samples
,
143 tex
->tex
.macrotile
[level
],
144 DIM_WIDTH
, is_rs690
);
145 width
= align(width
, tile_width
);
147 stride
= util_format_get_stride(tex
->b
.b
.b
.format
, width
);
148 /* The alignment to 32 bytes is sort of implied by the layout... */
151 return align(util_format_get_stride(tex
->b
.b
.b
.format
, width
), is_rs690
? 64 : 32);
155 static unsigned r300_texture_get_nblocksy(struct r300_resource
*tex
,
157 boolean
*out_aligned_for_cbzb
)
159 unsigned height
, tile_height
;
161 height
= u_minify(tex
->tex
.height0
, level
);
163 /* Mipmapped and 3D textures must have their height aligned to POT. */
164 if ((tex
->b
.b
.b
.target
!= PIPE_TEXTURE_1D
&&
165 tex
->b
.b
.b
.target
!= PIPE_TEXTURE_2D
&&
166 tex
->b
.b
.b
.target
!= PIPE_TEXTURE_RECT
) ||
167 tex
->b
.b
.b
.last_level
!= 0) {
168 height
= util_next_power_of_two(height
);
171 if (util_format_is_plain(tex
->b
.b
.b
.format
)) {
172 tile_height
= r300_get_pixel_alignment(tex
->b
.b
.b
.format
,
173 tex
->b
.b
.b
.nr_samples
,
175 tex
->tex
.macrotile
[level
],
177 height
= align(height
, tile_height
);
179 /* See if the CBZB clear can be used on the buffer,
180 * taking the texture size into account. */
181 if (out_aligned_for_cbzb
) {
182 if (tex
->tex
.macrotile
[level
]) {
183 /* When clearing, the layer (width*height) is horizontally split
184 * into two, and the upper and lower halves are cleared by the CB
185 * and ZB units, respectively. Therefore, the number of macrotiles
186 * in the Y direction must be even. */
188 /* Align the height so that there is an even number of macrotiles.
189 * Do so for 3 or more macrotiles in the Y direction. */
190 if (level
== 0 && tex
->b
.b
.b
.last_level
== 0 &&
191 (tex
->b
.b
.b
.target
== PIPE_TEXTURE_1D
||
192 tex
->b
.b
.b
.target
== PIPE_TEXTURE_2D
||
193 tex
->b
.b
.b
.target
== PIPE_TEXTURE_RECT
) &&
194 height
>= tile_height
* 3) {
195 height
= align(height
, tile_height
* 2);
198 *out_aligned_for_cbzb
= height
% (tile_height
* 2) == 0;
200 *out_aligned_for_cbzb
= FALSE
;
205 return util_format_get_nblocksy(tex
->b
.b
.b
.format
, height
);
208 /* Get a width in pixels from a stride in bytes. */
209 static unsigned stride_to_width(enum pipe_format format
,
210 unsigned stride_in_bytes
)
212 return (stride_in_bytes
/ util_format_get_blocksize(format
)) *
213 util_format_get_blockwidth(format
);
216 static void r300_setup_miptree(struct r300_screen
*screen
,
217 struct r300_resource
*tex
,
218 boolean align_for_cbzb
)
220 struct pipe_resource
*base
= &tex
->b
.b
.b
;
221 unsigned stride
, size
, layer_size
, nblocksy
, i
;
222 boolean rv350_mode
= screen
->caps
.family
>= CHIP_FAMILY_R350
;
223 boolean aligned_for_cbzb
;
225 tex
->tex
.size_in_bytes
= 0;
227 SCREEN_DBG(screen
, DBG_TEXALLOC
,
228 "r300: Making miptree for texture, format %s\n",
229 util_format_short_name(base
->format
));
231 for (i
= 0; i
<= base
->last_level
; i
++) {
232 /* Let's see if this miplevel can be macrotiled. */
233 tex
->tex
.macrotile
[i
] =
234 (tex
->tex
.macrotile
[0] == RADEON_LAYOUT_TILED
&&
235 r300_texture_macro_switch(tex
, i
, rv350_mode
, DIM_WIDTH
) &&
236 r300_texture_macro_switch(tex
, i
, rv350_mode
, DIM_HEIGHT
)) ?
237 RADEON_LAYOUT_TILED
: RADEON_LAYOUT_LINEAR
;
239 stride
= r300_texture_get_stride(screen
, tex
, i
);
241 /* Compute the number of blocks in Y, see if the CBZB clear can be
242 * used on the texture. */
243 aligned_for_cbzb
= FALSE
;
244 if (align_for_cbzb
&& tex
->tex
.cbzb_allowed
[i
])
245 nblocksy
= r300_texture_get_nblocksy(tex
, i
, &aligned_for_cbzb
);
247 nblocksy
= r300_texture_get_nblocksy(tex
, i
, NULL
);
249 layer_size
= stride
* nblocksy
;
251 if (base
->nr_samples
) {
252 layer_size
*= base
->nr_samples
;
255 if (base
->target
== PIPE_TEXTURE_CUBE
)
256 size
= layer_size
* 6;
258 size
= layer_size
* u_minify(tex
->tex
.depth0
, i
);
260 tex
->tex
.offset_in_bytes
[i
] = tex
->tex
.size_in_bytes
;
261 tex
->tex
.size_in_bytes
= tex
->tex
.offset_in_bytes
[i
] + size
;
262 tex
->tex
.layer_size_in_bytes
[i
] = layer_size
;
263 tex
->tex
.stride_in_bytes
[i
] = stride
;
264 tex
->tex
.stride_in_pixels
[i
] = stride_to_width(tex
->b
.b
.b
.format
, stride
);
265 tex
->tex
.cbzb_allowed
[i
] = tex
->tex
.cbzb_allowed
[i
] && aligned_for_cbzb
;
267 SCREEN_DBG(screen
, DBG_TEXALLOC
, "r300: Texture miptree: Level %d "
268 "(%dx%dx%d px, pitch %d bytes) %d bytes total, macrotiled %s\n",
269 i
, u_minify(tex
->tex
.width0
, i
), u_minify(tex
->tex
.height0
, i
),
270 u_minify(tex
->tex
.depth0
, i
), stride
, tex
->tex
.size_in_bytes
,
271 tex
->tex
.macrotile
[i
] ? "TRUE" : "FALSE");
275 static void r300_setup_flags(struct r300_resource
*tex
)
277 tex
->tex
.uses_stride_addressing
=
278 !util_is_power_of_two(tex
->b
.b
.b
.width0
) ||
279 (tex
->tex
.stride_in_bytes_override
&&
280 stride_to_width(tex
->b
.b
.b
.format
,
281 tex
->tex
.stride_in_bytes_override
) != tex
->b
.b
.b
.width0
);
284 tex
->tex
.uses_stride_addressing
||
285 !util_is_power_of_two(tex
->b
.b
.b
.height0
) ||
286 !util_is_power_of_two(tex
->b
.b
.b
.depth0
);
289 static void r300_setup_cbzb_flags(struct r300_screen
*rscreen
,
290 struct r300_resource
*tex
)
293 boolean first_level_valid
;
295 bpp
= util_format_get_blocksizebits(tex
->b
.b
.b
.format
);
297 /* 1) The texture must be point-sampled,
298 * 2) The depth must be 16 or 32 bits.
299 * 3) If the midpoint ZB offset is not aligned to 2048, it returns garbage
300 * with certain texture sizes. Macrotiling ensures the alignment. */
301 first_level_valid
= tex
->b
.b
.b
.nr_samples
<= 1 &&
302 (bpp
== 16 || bpp
== 32) &&
303 tex
->tex
.macrotile
[0];
305 if (SCREEN_DBG_ON(rscreen
, DBG_NO_CBZB
))
306 first_level_valid
= FALSE
;
308 for (i
= 0; i
<= tex
->b
.b
.b
.last_level
; i
++)
309 tex
->tex
.cbzb_allowed
[i
] = first_level_valid
&& tex
->tex
.macrotile
[i
];
312 static unsigned r300_pixels_to_dwords(unsigned stride
,
314 unsigned xblock
, unsigned yblock
)
316 return (util_align_npot(stride
, xblock
) * align(height
, yblock
)) / (xblock
* yblock
);
319 static void r300_setup_hyperz_properties(struct r300_screen
*screen
,
320 struct r300_resource
*tex
)
322 /* The tile size of 1 DWORD in ZMASK RAM is:
324 * GPU Pipes 4x4 mode 8x8 mode
325 * ------------------------------------------
326 * R580 4P/1Z 32x32 64x64
327 * RV570 3P/1Z 48x16 96x32
328 * RV530 1P/2Z 32x16 64x32
331 static unsigned zmask_blocks_x_per_dw
[4] = {4, 8, 12, 8};
332 static unsigned zmask_blocks_y_per_dw
[4] = {4, 4, 4, 8};
334 /* In HIZ RAM, one dword is always 8x8 pixels (each byte is 4x4 pixels),
335 * but the blocks have very weird ordering.
337 * With 2 pipes and an image of size 8xY, where Y >= 1,
338 * clearing 4 dwords clears blocks like this:
342 * where numbers correspond to dword indices. The blocks are interleaved
343 * in the X direction, so the alignment must be 4x1 blocks (32x8 pixels).
345 * With 4 pipes and an image of size 8xY, where Y >= 4,
346 * clearing 8 dwords clears blocks like this:
351 * where numbers correspond to dword indices. The blocks are interleaved
352 * in both directions, so the alignment must be 4x4 blocks (32x32 pixels)
354 static unsigned hiz_align_x
[4] = {8, 32, 48, 32};
355 static unsigned hiz_align_y
[4] = {8, 8, 8, 32};
357 if (util_format_is_depth_or_stencil(tex
->b
.b
.b
.format
) &&
358 util_format_get_blocksizebits(tex
->b
.b
.b
.format
) == 32 &&
359 tex
->tex
.microtile
) {
362 if (screen
->caps
.family
== CHIP_FAMILY_RV530
) {
363 pipes
= screen
->caps
.num_z_pipes
;
365 pipes
= screen
->caps
.num_frag_pipes
;
368 for (i
= 0; i
<= tex
->b
.b
.b
.last_level
; i
++) {
369 unsigned zcomp_numdw
, zcompsize
, hiz_numdw
, stride
, height
;
371 stride
= align(tex
->tex
.stride_in_pixels
[i
], 16);
372 height
= u_minify(tex
->b
.b
.b
.height0
, i
);
374 /* The 8x8 compression mode needs macrotiling. */
375 zcompsize
= screen
->caps
.z_compress
== R300_ZCOMP_8X8
&&
376 tex
->tex
.macrotile
[i
] &&
377 tex
->b
.b
.b
.nr_samples
<= 1 ? 8 : 4;
379 /* Get the ZMASK buffer size in dwords. */
380 zcomp_numdw
= r300_pixels_to_dwords(stride
, height
,
381 zmask_blocks_x_per_dw
[pipes
-1] * zcompsize
,
382 zmask_blocks_y_per_dw
[pipes
-1] * zcompsize
);
384 /* Check whether we have enough ZMASK memory. */
385 if (util_format_get_blocksizebits(tex
->b
.b
.b
.format
) == 32 &&
386 zcomp_numdw
<= screen
->caps
.zmask_ram
* pipes
) {
387 tex
->tex
.zmask_dwords
[i
] = zcomp_numdw
;
388 tex
->tex
.zcomp8x8
[i
] = zcompsize
== 8;
390 tex
->tex
.zmask_stride_in_pixels
[i
] =
391 util_align_npot(stride
, zmask_blocks_x_per_dw
[pipes
-1] * zcompsize
);
393 tex
->tex
.zmask_dwords
[i
] = 0;
394 tex
->tex
.zcomp8x8
[i
] = FALSE
;
395 tex
->tex
.zmask_stride_in_pixels
[i
] = 0;
399 stride
= util_align_npot(stride
, hiz_align_x
[pipes
-1]);
400 height
= align(height
, hiz_align_y
[pipes
-1]);
402 /* Get the HIZ buffer size in dwords. */
403 hiz_numdw
= (stride
* height
) / (8*8 * pipes
);
405 /* Check whether we have enough HIZ memory. */
406 if (hiz_numdw
<= screen
->caps
.hiz_ram
* pipes
) {
407 tex
->tex
.hiz_dwords
[i
] = hiz_numdw
;
408 tex
->tex
.hiz_stride_in_pixels
[i
] = stride
;
410 tex
->tex
.hiz_dwords
[i
] = 0;
411 tex
->tex
.hiz_stride_in_pixels
[i
] = 0;
417 static void r300_setup_tiling(struct r300_screen
*screen
,
418 struct r300_resource
*tex
)
420 enum pipe_format format
= tex
->b
.b
.b
.format
;
421 boolean rv350_mode
= screen
->caps
.family
>= CHIP_FAMILY_R350
;
422 boolean is_zb
= util_format_is_depth_or_stencil(format
);
423 boolean dbg_no_tiling
= SCREEN_DBG_ON(screen
, DBG_NO_TILING
);
425 tex
->tex
.microtile
= RADEON_LAYOUT_LINEAR
;
426 tex
->tex
.macrotile
[0] = RADEON_LAYOUT_LINEAR
;
428 if (!util_format_is_plain(format
)) {
432 /* If height == 1, disable microtiling except for zbuffer. */
433 if (!is_zb
&& (tex
->b
.b
.b
.height0
== 1 || dbg_no_tiling
)) {
437 /* Set microtiling. */
438 switch (util_format_get_blocksize(format
)) {
442 tex
->tex
.microtile
= RADEON_LAYOUT_TILED
;
446 tex
->tex
.microtile
= RADEON_LAYOUT_SQUARETILED
;
454 /* Set macrotiling. */
455 if (r300_texture_macro_switch(tex
, 0, rv350_mode
, DIM_WIDTH
) &&
456 r300_texture_macro_switch(tex
, 0, rv350_mode
, DIM_HEIGHT
)) {
457 tex
->tex
.macrotile
[0] = RADEON_LAYOUT_TILED
;
461 static void r300_tex_print_info(struct r300_resource
*tex
,
465 "r300: %s: Macro: %s, Micro: %s, Pitch: %i, Dim: %ix%ix%i, "
466 "LastLevel: %i, Size: %i, Format: %s\n",
468 tex
->tex
.macrotile
[0] ? "YES" : " NO",
469 tex
->tex
.microtile
? "YES" : " NO",
470 tex
->tex
.stride_in_pixels
[0],
471 tex
->b
.b
.b
.width0
, tex
->b
.b
.b
.height0
, tex
->b
.b
.b
.depth0
,
472 tex
->b
.b
.b
.last_level
, tex
->tex
.size_in_bytes
,
473 util_format_short_name(tex
->b
.b
.b
.format
));
476 boolean
r300_texture_desc_init(struct r300_screen
*rscreen
,
477 struct r300_resource
*tex
,
478 const struct pipe_resource
*base
)
480 tex
->b
.b
.b
.target
= base
->target
;
481 tex
->b
.b
.b
.format
= base
->format
;
482 tex
->b
.b
.b
.width0
= base
->width0
;
483 tex
->b
.b
.b
.height0
= base
->height0
;
484 tex
->b
.b
.b
.depth0
= base
->depth0
;
485 tex
->b
.b
.b
.array_size
= base
->array_size
;
486 tex
->b
.b
.b
.last_level
= base
->last_level
;
487 tex
->b
.b
.b
.nr_samples
= base
->nr_samples
;
488 tex
->tex
.width0
= base
->width0
;
489 tex
->tex
.height0
= base
->height0
;
490 tex
->tex
.depth0
= base
->depth0
;
492 r300_setup_flags(tex
);
494 /* Align a 3D NPOT texture to POT. */
495 if (base
->target
== PIPE_TEXTURE_3D
&& tex
->tex
.is_npot
) {
496 tex
->tex
.width0
= util_next_power_of_two(tex
->tex
.width0
);
497 tex
->tex
.height0
= util_next_power_of_two(tex
->tex
.height0
);
498 tex
->tex
.depth0
= util_next_power_of_two(tex
->tex
.depth0
);
502 if (tex
->tex
.microtile
== RADEON_LAYOUT_UNKNOWN
) {
503 r300_setup_tiling(rscreen
, tex
);
506 r300_setup_cbzb_flags(rscreen
, tex
);
508 /* Setup the miptree description. */
509 r300_setup_miptree(rscreen
, tex
, TRUE
);
510 /* If the required buffer size is larger the given max size,
511 * try again without the alignment for the CBZB clear. */
512 if (tex
->buf_size
&& tex
->tex
.size_in_bytes
> tex
->buf_size
) {
513 r300_setup_miptree(rscreen
, tex
, FALSE
);
516 r300_setup_hyperz_properties(rscreen
, tex
);
519 /* Make sure the buffer we got is large enough. */
520 if (tex
->tex
.size_in_bytes
> tex
->buf_size
) {
521 fprintf(stderr
, "r300: texture_desc_init: The buffer is not "
522 "large enough. Got: %i, Need: %i, Info:\n",
523 tex
->buf_size
, tex
->tex
.size_in_bytes
);
524 r300_tex_print_info(tex
, "texture_desc_init");
528 tex
->tex
.buffer_size_in_bytes
= tex
->buf_size
;
530 tex
->tex
.buffer_size_in_bytes
= tex
->tex
.size_in_bytes
;
533 if (SCREEN_DBG_ON(rscreen
, DBG_TEX
))
534 r300_tex_print_info(tex
, "texture_desc_init");
539 unsigned r300_texture_get_offset(struct r300_resource
*tex
,
540 unsigned level
, unsigned layer
)
542 unsigned offset
= tex
->tex
.offset_in_bytes
[level
];
544 switch (tex
->b
.b
.b
.target
) {
545 case PIPE_TEXTURE_3D
:
546 case PIPE_TEXTURE_CUBE
:
547 return offset
+ layer
* tex
->tex
.layer_size_in_bytes
[level
];