mesa/src/imagination/vulkan/pvr_job_render.h

/*
 * Copyright © 2022 Imagination Technologies Ltd.
 *
 * 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 PVR_JOB_RENDER_H
#define PVR_JOB_RENDER_H

#include <stdbool.h>
#include <stdint.h>
#include <vulkan/vulkan.h>

#include "hwdef/rogue_hw_defs.h"
#include "pvr_common.h"
#include "pvr_csb.h"
#include "pvr_limits.h"
#include "pvr_types.h"

struct pvr_device;
struct pvr_device_info;
struct pvr_render_ctx;
struct pvr_rt_dataset;
struct vk_sync;

/* Macrotile information. */
struct pvr_rt_mtile_info {
   uint32_t tile_size_x;
   uint32_t tile_size_y;

   uint32_t num_tiles_x;
   uint32_t num_tiles_y;

   uint32_t tiles_per_mtile_x;
   uint32_t tiles_per_mtile_y;

   uint32_t x_tile_max;
   uint32_t y_tile_max;

   uint32_t mtiles_x;
   uint32_t mtiles_y;

   uint32_t mtile_x1;
   uint32_t mtile_y1;
   uint32_t mtile_x2;
   uint32_t mtile_y2;
   uint32_t mtile_x3;
   uint32_t mtile_y3;
};

/* FIXME: Turn 'struct pvr_sub_cmd' into 'struct pvr_job' and change 'struct
 * pvr_render_job' to subclass it? This is approximately what v3dv does
 * (although it doesn't subclass).
 */
struct pvr_render_job {
   struct {
      bool run_frag : 1;
      bool geometry_terminate : 1;
      bool frag_uses_atomic_ops : 1;
      bool disable_compute_overlap : 1;
      bool enable_bg_tag : 1;
      bool process_empty_tiles : 1;
      bool get_vis_results : 1;
      bool has_depth_attachment : 1;
      bool has_stencil_attachment : 1;
      bool requires_spm_scratch_buffer : 1;
      bool disable_pixel_merging : 1;
      bool z_only_render : 1;
   };

   /* PDS pixel event for partial renders do not depend on the view index. */
   uint32_t pr_pds_pixel_event_data_offset;

   pvr_dev_addr_t ctrl_stream_addr;

   pvr_dev_addr_t depth_bias_table_addr;
   pvr_dev_addr_t scissor_table_addr;

   /* Unless VK_KHR_dynamic_rendering or core 1.3 is supported, Vulkan does not
    * allow for separate depth and stencil attachments. We don't bother storing
    * separate parameters for them here (yet). If both has_depth_attachment and
    * has_stencil_attachment are false, the contents are undefined.
    */
   struct pvr_ds_attachment {
      struct {
         bool d : 1;
         bool s : 1;
      } load, store;

      pvr_dev_addr_t addr;
      uint32_t stride;
      uint32_t height;
      VkExtent2D physical_extent;
      uint32_t layer_size;
      enum ROGUE_CR_ZLS_FORMAT_TYPE zls_format;
      enum pvr_memlayout memlayout;

      /* TODO: Is this really necessary? Maybe we can extract all useful
       * information and drop this member. */
      const struct pvr_image_view *iview;

      bool has_alignment_transfers;
   } ds;

   VkClearDepthStencilValue ds_clear_value;

   uint32_t samples;

   uint32_t pixel_output_width;

   uint8_t max_shared_registers;

   /* Upper limit for tiles in flight, '0' means use default limit based
    * on partition store.
    */
   uint32_t max_tiles_in_flight;

   uint64_t pbe_reg_words[PVR_MAX_COLOR_ATTACHMENTS]
                         [ROGUE_NUM_PBESTATE_REG_WORDS];
   uint64_t pr_pbe_reg_words[PVR_MAX_COLOR_ATTACHMENTS]
                            [ROGUE_NUM_PBESTATE_REG_WORDS];

   struct pvr_view_state {
      struct {
         uint32_t pds_pixel_event_data_offset;
         uint64_t pds_bgnd_reg_values[ROGUE_NUM_CR_PDS_BGRND_WORDS];
         uint64_t pr_pds_bgnd_reg_values[ROGUE_NUM_CR_PDS_BGRND_WORDS];
      } view[PVR_MAX_MULTIVIEW];

      /* True if pds_pixel_event_data_offset should be taken from the first
       * element of the view array. Otherwise view_index should be used.
       */
      bool force_pds_pixel_event_data_offset_zero : 1;

      /* True if a partial render job uses the same EOT program data for a
       * pixel event as the fragment job and not from the scratch buffer.
       */
      bool use_pds_pixel_event_data_offset : 1;

      /* True if first_pds_bgnd_reg_values should be taken from the first
       * element of the view array. Otherwise view_index should be used.
       */
      bool force_pds_bgnd_reg_values_zero : 1;

      struct pvr_rt_dataset **rt_datasets;

      uint32_t view_index;
   } view_state;
};

#ifdef PVR_PER_ARCH

void PVR_PER_ARCH(rt_mtile_info_init)(const struct pvr_device_info *dev_info,
                                      struct pvr_rt_mtile_info *info,
                                      uint32_t width,
                                      uint32_t height,
                                      uint32_t samples);

#   define pvr_arch_rt_mtile_info_init PVR_PER_ARCH(rt_mtile_info_init)

VkResult PVR_PER_ARCH(render_target_dataset_create)(
   struct pvr_device *device,
   uint32_t width,
   uint32_t height,
   uint32_t samples,
   uint32_t layers,
   struct pvr_rt_dataset **const rt_dataset_out);

#   define pvr_arch_render_target_dataset_create \
      PVR_PER_ARCH(render_target_dataset_create)

VkResult PVR_PER_ARCH(render_job_submit)(struct pvr_render_ctx *ctx,
                                         struct pvr_render_job *job,
                                         struct vk_sync *wait_geom,
                                         struct vk_sync *wait_frag,
                                         struct vk_sync *signal_sync_geom,
                                         struct vk_sync *signal_sync_frag);

#   define pvr_arch_render_job_submit PVR_PER_ARCH(render_job_submit)

#endif

#endif /* PVR_JOB_RENDER_H */