src/gallium/drivers/iris/iris_resource.h

   1 /*
   2  * Copyright 2017 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * on the rights to use, copy, modify, merge, publish, distribute, sub
   8  * license, and/or sell copies of the Software, and to permit persons to whom
   9  * the Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  18  * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  19  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  20  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  21  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  22  */
  23 #ifndef IRIS_RESOURCE_H
  24 #define IRIS_RESOURCE_H
  25
  26 #include "pipe/p_state.h"
  27 #include "util/u_inlines.h"
  28 #include "intel/isl/isl.h"
  29
  30 /**
  31  * Resources represent a GPU buffer object or image (mipmap tree).
  32  *
  33  * They contain the storage (BO) and layout information (ISL surface).
  34  */
  35 struct iris_resource {
  36    struct pipe_resource base;
  37    struct isl_surf surf;
  38    struct iris_bo *bo;
  39 };
  40
  41 /**
  42  * A simple <resource, offset> tuple for storing a reference to a
  43  * piece of state stored in a GPU buffer object.
  44  */
  45 struct iris_state_ref {
  46    struct pipe_resource *res;
  47    uint32_t offset;
  48 };
  49
  50 /**
  51  * A view of a surface that can be bound to a color render target or
  52  * depth/stencil attachment.
  53  */
  54 struct iris_surface {
  55    struct pipe_surface pipe;
  56    struct isl_view view;
  57
  58    /** The resource (BO) holding our SURFACE_STATE. */
  59    struct iris_state_ref surface_state;
  60 };
  61
  62 /**
  63  * Transfer object - information about a buffer mapping.
  64  */
  65 struct iris_transfer {
  66    struct pipe_transfer base;
  67    struct pipe_debug_callback *dbg;
  68    void *buffer;
  69    void *ptr;
  70
  71    void (*unmap)(struct iris_transfer *);
  72 };
  73
  74 static inline struct iris_bo *
  75 iris_resource_bo(struct pipe_resource *p_res)
  76 {
  77    struct iris_resource *res = (void *) p_res;
  78    return res->bo;
  79 }
  80
  81 enum isl_format iris_isl_format_for_pipe_format(enum pipe_format pf);
  82
  83 void iris_init_screen_resource_functions(struct pipe_screen *pscreen);
  84
  85 #endif