/* * Copyright © 2014-2017 Broadcom * Copyright (C) 2012 Rob Clark * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS * IN THE SOFTWARE. */ #ifndef VC5_RESOURCE_H #define VC5_RESOURCE_H #include "vc5_screen.h" #include "util/u_transfer.h" /* A UIFblock is a 256-byte region of memory that's 256-byte aligned. These * will be grouped in 4x4 blocks (left-to-right, then top-to-bottom) in a 4KB * page. Those pages are then arranged left-to-right, top-to-bottom, to cover * an image. * * The inside of a UIFblock, for packed pixels, will be split into 4 64-byte * utiles. Utiles may be 8x8 (8bpp), 8x4(16bpp) or 4x4 (32bpp). */ /** * Tiling mode enum used for vc5_resource.c, which maps directly to the Memory * Format field of render target and Z/Stencil config. */ enum vc5_tiling_mode { /* Untiled resources. Not valid as texture inputs. */ VC5_TILING_RASTER, /* Single line of u-tiles. */ VC5_TILING_LINEARTILE, /* Departure from standard 4-UIF block column format. */ VC5_TILING_UBLINEAR_1_COLUMN, /* Departure from standard 4-UIF block column format. */ VC5_TILING_UBLINEAR_2_COLUMN, /* Normal tiling format: grouped in 4x4 UIFblocks, each of which is * split 2x2 into utiles. */ VC5_TILING_UIF_NO_XOR, /* Normal tiling format: grouped in 4x4 UIFblocks, each of which is * split 2x2 into utiles. */ VC5_TILING_UIF_XOR, }; struct vc5_transfer { struct pipe_transfer base; void *map; struct pipe_resource *ss_resource; struct pipe_box ss_box; }; struct vc5_resource_slice { uint32_t offset; uint32_t stride; uint32_t size; enum vc5_tiling_mode tiling; }; struct vc5_surface { struct pipe_surface base; uint32_t offset; enum vc5_tiling_mode tiling; /** * Output image format for TILE_RENDERING_MODE_CONFIGURATION */ uint8_t format; /** * Internal format of the tile buffer for * TILE_RENDERING_MODE_CONFIGURATION. */ uint8_t internal_type; /** * internal bpp value (0=32bpp, 2=128bpp) for color buffers in * TILE_RENDERING_MODE_CONFIGURATION. */ uint8_t internal_bpp; }; struct vc5_resource { struct u_resource base; struct vc5_bo *bo; struct vc5_resource_slice slices[VC5_MAX_MIP_LEVELS]; uint32_t cube_map_stride; int cpp; bool tiled; /** One of V3D_TEXTURE_DATA_FORMAT_* */ uint8_t tex_format; /** * Number of times the resource has been written to. * * This is used to track whether we need to load the surface on first * rendering. */ uint64_t writes; /** * Bitmask of PIPE_CLEAR_COLOR0, PIPE_CLEAR_DEPTH, PIPE_CLEAR_STENCIL * for which parts of the resource are defined. * * Used for avoiding fallback to quad clears for clearing just depth, * when the stencil contents have never been initialized. Note that * we're lazy and fields not present in the buffer (DEPTH in a color * buffer) may get marked. */ uint32_t initialized_buffers; }; static inline struct vc5_resource * vc5_resource(struct pipe_resource *prsc) { return (struct vc5_resource *)prsc; } static inline struct vc5_surface * vc5_surface(struct pipe_surface *psurf) { return (struct vc5_surface *)psurf; } static inline struct vc5_transfer * vc5_transfer(struct pipe_transfer *ptrans) { return (struct vc5_transfer *)ptrans; } void vc5_resource_screen_init(struct pipe_screen *pscreen); void vc5_resource_context_init(struct pipe_context *pctx); struct pipe_resource *vc5_resource_create(struct pipe_screen *pscreen, const struct pipe_resource *tmpl); #endif /* VC5_RESOURCE_H */