src/gallium/drivers/ilo/ilo_cp.h

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 2012-2013 LunarG, Inc.
   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 shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  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 NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  22  * DEALINGS IN THE SOFTWARE.
  23  *
  24  * Authors:
  25  *    Chia-I Wu <olv@lunarg.com>
  26  */
  27
  28 #ifndef ILO_CP_H
  29 #define ILO_CP_H
  30
  31 #include "core/ilo_builder.h"
  32 #include "core/intel_winsys.h"
  33
  34 #include "ilo_common.h"
  35
  36 struct ilo_cp;
  37 struct ilo_shader_cache;
  38
  39 typedef void (*ilo_cp_callback)(struct ilo_cp *cp, void *data);
  40
  41 /**
  42  * Parser owners are notified when they gain or lose the ownership of the
  43  * parser.  This gives owners a chance to emit prolog or epilog.
  44  */
  45 struct ilo_cp_owner {
  46    ilo_cp_callback own;
  47    ilo_cp_callback release;
  48    void *data;
  49
  50    /*
  51     * Space reserved for release().  This can be modified at any time, as long
  52     * as it is never increased by more than ilo_cp_space().
  53     */
  54    int reserve;
  55 };
  56
  57 /**
  58  * Command parser.
  59  */
  60 struct ilo_cp {
  61    struct intel_winsys *winsys;
  62    struct ilo_shader_cache *shader_cache;
  63    struct intel_context *render_ctx;
  64
  65    ilo_cp_callback submit_callback;
  66    void *submit_callback_data;
  67
  68    enum intel_ring_type ring;
  69    const struct ilo_cp_owner *owner;
  70
  71    unsigned one_off_flags;
  72
  73    struct ilo_builder builder;
  74    struct intel_bo *last_submitted_bo;
  75
  76    uint32_t active_lost;
  77    uint32_t pending_lost;
  78 };
  79
  80 struct ilo_cp *
  81 ilo_cp_create(const struct ilo_dev *dev,
  82               struct intel_winsys *winsys,
  83               struct ilo_shader_cache *shc);
  84
  85 void
  86 ilo_cp_destroy(struct ilo_cp *cp);
  87
  88 void
  89 ilo_cp_submit_internal(struct ilo_cp *cp);
  90
  91 static inline void
  92 ilo_cp_submit(struct ilo_cp *cp, const char *reason)
  93 {
  94    if (ilo_debug & ILO_DEBUG_SUBMIT) {
  95       ilo_printf("submit batch buffer to %s ring because of %s: ",
  96             (cp->ring == INTEL_RING_RENDER) ? "render" : "unknown", reason);
  97       ilo_builder_batch_print_stats(&cp->builder);
  98    }
  99
 100    ilo_cp_submit_internal(cp);
 101 }
 102
 103 void
 104 ilo_cp_set_owner(struct ilo_cp *cp, enum intel_ring_type ring,
 105                  const struct ilo_cp_owner *owner);
 106
 107 /**
 108  * Return the remaining space (in dwords) in the parser buffer.
 109  */
 110 static inline int
 111 ilo_cp_space(struct ilo_cp *cp)
 112 {
 113    const int space = ilo_builder_batch_space(&cp->builder);
 114    const int mi_batch_buffer_end_space = 2;
 115
 116    assert(space >= cp->owner->reserve + mi_batch_buffer_end_space);
 117
 118    return space - cp->owner->reserve - mi_batch_buffer_end_space;
 119 }
 120
 121 /**
 122  * Set one-off flags.  They will be cleared after submission.
 123  */
 124 static inline void
 125 ilo_cp_set_one_off_flags(struct ilo_cp *cp, unsigned flags)
 126 {
 127    cp->one_off_flags |= flags;
 128 }
 129
 130 /**
 131  * Set submit callback.  The callback is invoked after the bo has been
 132  * successfully submitted, and before the bo is reallocated.
 133  */
 134 static inline void
 135 ilo_cp_set_submit_callback(struct ilo_cp *cp, ilo_cp_callback callback,
 136                           void *data)
 137 {
 138    cp->submit_callback = callback;
 139    cp->submit_callback_data = data;
 140 }
 141
 142 #endif /* ILO_CP_H */