src/gallium/drivers/freedreno/freedreno_resource.h

   1 /* -*- mode: C; c-file-style: "k&r"; tab-width 4; indent-tabs-mode: t; -*- */
   2
   3 /*
   4  * Copyright (C) 2012 Rob Clark <robclark@freedesktop.org>
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice (including the next
  14  * paragraph) shall be included in all copies or substantial portions of the
  15  * Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  22  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23  * SOFTWARE.
  24  *
  25  * Authors:
  26  *    Rob Clark <robclark@freedesktop.org>
  27  */
  28
  29 #ifndef FREEDRENO_RESOURCE_H_
  30 #define FREEDRENO_RESOURCE_H_
  31
  32 #include "util/list.h"
  33 #include "util/u_range.h"
  34 #include "util/u_transfer.h"
  35
  36 #include "freedreno_util.h"
  37
  38 /* Texture Layout on a3xx:
  39  *
  40  * Each mipmap-level contains all of it's layers (ie. all cubmap
  41  * faces, all 1d/2d array elements, etc).  The texture sampler is
  42  * programmed with the start address of each mipmap level, and hw
  43  * derives the layer offset within the level.
  44  *
  45  * Texture Layout on a4xx:
  46  *
  47  * For cubemap and 2d array, each layer contains all of it's mipmap
  48  * levels (layer_first layout).
  49  *
  50  * 3d textures are layed out as on a3xx, but unknown about 3d-array
  51  * textures.
  52  *
  53  * In either case, the slice represents the per-miplevel information,
  54  * but in layer_first layout it only includes the first layer, and
  55  * an additional offset of (rsc->layer_size * layer) must be added.
  56  */
  57 struct fd_resource_slice {
  58         uint32_t offset;         /* offset of first layer in slice */
  59         uint32_t pitch;
  60         uint32_t size0;          /* size of first layer in slice */
  61 };
  62
  63 /* status of queued up but not flushed reads and write operations.
  64  * In _transfer_map() we need to know if queued up rendering needs
  65  * to be flushed to preserve the order of cpu and gpu access.
  66  */
  67 enum fd_resource_status {
  68         FD_PENDING_WRITE = 0x01,
  69         FD_PENDING_READ  = 0x02,
  70 };
  71
  72 struct fd_resource {
  73         struct u_resource base;
  74         struct fd_bo *bo;
  75         uint32_t cpp;
  76         enum pipe_format internal_format;
  77         bool layer_first;        /* see above description */
  78         uint32_t layer_size;
  79         struct fd_resource_slice slices[MAX_MIP_LEVELS];
  80         uint32_t timestamp;
  81         /* buffer range that has been initialized */
  82         struct util_range valid_buffer_range;
  83
  84         /* reference to the resource holding stencil data for a z32_s8 texture */
  85         /* TODO rename to secondary or auxiliary? */
  86         struct fd_resource *stencil;
  87
  88         /* pending read/write state: */
  89         enum fd_resource_status status;
  90         /* resources accessed by queued but not flushed draws are tracked
  91          * in the used_resources list.
  92          */
  93         struct list_head list;
  94         struct fd_context *pending_ctx;
  95 };
  96
  97 static inline struct fd_resource *
  98 fd_resource(struct pipe_resource *ptex)
  99 {
 100         return (struct fd_resource *)ptex;
 101 }
 102
 103 struct fd_transfer {
 104         struct pipe_transfer base;
 105         void *staging;
 106 };
 107
 108 static inline struct fd_transfer *
 109 fd_transfer(struct pipe_transfer *ptrans)
 110 {
 111         return (struct fd_transfer *)ptrans;
 112 }
 113
 114 static inline struct fd_resource_slice *
 115 fd_resource_slice(struct fd_resource *rsc, unsigned level)
 116 {
 117         assert(level <= rsc->base.b.last_level);
 118         return &rsc->slices[level];
 119 }
 120
 121 /* get offset for specified mipmap level and texture/array layer */
 122 static inline uint32_t
 123 fd_resource_offset(struct fd_resource *rsc, unsigned level, unsigned layer)
 124 {
 125         struct fd_resource_slice *slice = fd_resource_slice(rsc, level);
 126         unsigned offset;
 127         if (rsc->layer_first) {
 128                 offset = slice->offset + (rsc->layer_size * layer);
 129         } else {
 130                 offset = slice->offset + (slice->size0 * layer);
 131         }
 132         debug_assert(offset < fd_bo_size(rsc->bo));
 133         return offset;
 134 }
 135
 136 void fd_resource_screen_init(struct pipe_screen *pscreen);
 137 void fd_resource_context_init(struct pipe_context *pctx);
 138
 139 bool fd_render_condition_check(struct pipe_context *pctx);
 140
 141 #endif /* FREEDRENO_RESOURCE_H_ */