fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2025-12-24 17:30:12 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

panfrost: Document arguments to tiling routines

Browse source 
The exact semantics of these routines are subtle, although they match what
Gallium wants. We're about to add unit tests. Add some comments that make it
obvious what it is we expect these routines to do. (In particular, it's not a
general region-of-interest copy, it's a region-of-interest of the tiled image
and the entire linear staging image.)

Signed-off-by: Alyssa Rosenzweig <alyssa@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15803>
This commit is contained in:
Alyssa Rosenzweig 2022-04-14 11:48:41 -04:00 • committed by Marge Bot
parent 1d8ea77645
commit 944049dedc
1 changed files with 26 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
src/panfrost/shared/pan_tiling.h
View file

@ -30,6 +30,19 @@
#include <stdint.h>
#include <util/format/u_format.h>
/**
* Load a rectangular region from a tiled image to a linear staging image.
*
* @dst Linear destination
* @src Tiled source
* @x Region of interest of source in pixels, aligned to block size
* @y Region of interest of source in pixels, aligned to block size
* @z Region of interest of source in pixels, aligned to block size
* @w Region of interest of source in pixels, aligned to block size
* @dst_stride Stride in bytes of linear destination
* @src_stride Stride in bytes of tiled source
* @format Format of the source and destination image
*/
void panfrost_load_tiled_image(void *dst, const void *src,
unsigned x, unsigned y,
unsigned w, unsigned h,
@ -37,6 +50,19 @@ void panfrost_load_tiled_image(void *dst, const void *src,
uint32_t src_stride,
enum pipe_format format);
/**
* Store a linear staging image to a rectangular region of a tiled image.
*
* @dst Tiled destination
* @src Linear source
* @x Region of interest of destination in pixels, aligned to block size
* @y Region of interest of destination in pixels, aligned to block size
* @z Region of interest of destination in pixels, aligned to block size
* @w Region of interest of destination in pixels, aligned to block size
* @dst_stride Stride in bytes of tiled destination
* @src_stride Stride in bytes of linear source
* @format Format of the source and destination image
*/
void panfrost_store_tiled_image(void *dst, const void *src,
unsigned x, unsigned y,
unsigned w, unsigned h,