mesa/src/nouveau/nil/nil_image.h

/*
 * Copyright © 2022 Collabora Ltd.
 * SPDX-License-Identifier: MIT
 */
#ifndef NIL_IMAGE_H
#define NIL_IMAGE_H

#include <assert.h>
#include <stdbool.h>
#include <stdint.h>

#include "util/macros.h"
#include "util/format/u_format.h"

struct nv_device_info;

enum ENUM_PACKED nil_image_dim {
   NIL_IMAGE_DIM_1D = 1,
   NIL_IMAGE_DIM_2D = 2,
   NIL_IMAGE_DIM_3D = 3,
};

enum ENUM_PACKED nil_sample_layout {
   NIL_SAMPLE_LAYOUT_1X1,
   NIL_SAMPLE_LAYOUT_2X1,
   NIL_SAMPLE_LAYOUT_2X2,
   NIL_SAMPLE_LAYOUT_4X2,
   NIL_SAMPLE_LAYOUT_4X4,
   NIL_SAMPLE_LAYOUT_INVALID,
};

enum nil_sample_layout nil_choose_sample_layout(uint32_t samples);

enum nil_image_usage_flags {
   NIL_IMAGE_USAGE_RENDER_TARGET_BIT   = BITFIELD_BIT(0),
   NIL_IMAGE_USAGE_DEPTH_BIT           = BITFIELD_BIT(1),
   NIL_IMAGE_USAGE_STENCIL_BIT         = BITFIELD_BIT(2),
   NIL_IMAGE_USAGE_TEXTURE_BIT         = BITFIELD_BIT(3),
   NIL_IMAGE_USAGE_STORAGE_BIT         = BITFIELD_BIT(4),
   NIL_IMAGE_USAGE_CUBE_BIT            = BITFIELD_BIT(5),
   NIL_IMAGE_USAGE_2D_VIEW_BIT         = BITFIELD_BIT(6),
   NIL_IMAGE_USAGE_LINEAR_BIT          = BITFIELD_BIT(7),
};

enum ENUM_PACKED nil_view_type {
   NIL_VIEW_TYPE_1D,
   NIL_VIEW_TYPE_2D,
   NIL_VIEW_TYPE_3D,
   NIL_VIEW_TYPE_CUBE,
   NIL_VIEW_TYPE_1D_ARRAY,
   NIL_VIEW_TYPE_2D_ARRAY,
   NIL_VIEW_TYPE_CUBE_ARRAY,
};

struct nil_extent4d {
   union { uint32_t w, width; };
   union { uint32_t h, height; };
   union { uint32_t d, depth; };
   union { uint32_t a, array_len; };
};

static inline struct nil_extent4d
nil_extent4d(uint32_t w, uint32_t h, uint32_t d, uint32_t a)
{
   struct nil_extent4d e;
   e.w = w;
   e.h = h;
   e.d = d;
   e.a = a;
   return e;
}

struct nil_extent4d
nil_extent4d_px_to_el(struct nil_extent4d extent_px,
                      enum pipe_format format,
                      enum nil_sample_layout sample_layout);

struct nil_offset4d {
   uint32_t x;
   uint32_t y;
   uint32_t z;
   uint32_t a;
};

static inline struct nil_offset4d
nil_offset4d(uint32_t x, uint32_t y, uint32_t z, uint32_t a)
{
   struct nil_offset4d o;
   o.x = x;
   o.y = y;
   o.z = z;
   o.a = a;
   return o;
}

struct nil_offset4d
nil_offset4d_px_to_el(struct nil_offset4d offset_px,
                      enum pipe_format format,
                      enum nil_sample_layout sample_layout);

#define NIL_GOB_WIDTH_B 64
#define NIL_GOB_HEIGHT(gob_height_8) ((gob_height_8) ? 8 : 4)
#define NIL_GOB_DEPTH 1
#define NIL_MAX_LEVELS 16

struct nil_tiling {
   bool is_tiled:1;
   bool gob_height_8:1; /**< GOB height is 4 or 8 */
   uint8_t y_log2:3; /**< log2 of the Y tile dimension in GOBs */
   uint8_t z_log2:3; /**< log2 of the Z tile dimension in GOBs */
};

struct nil_image_init_info {
   enum nil_image_dim dim;
   enum pipe_format format;

   struct nil_extent4d extent_px;
   uint32_t levels;
   uint32_t samples;

   enum nil_image_usage_flags usage;
};

/** Represents the data layout of a single slice (level+lod) of an image */
struct nil_image_level {
   /** Offset into the image of this level in bytes */
   uint64_t offset_B;

   /** Tiling for this level */
   struct nil_tiling tiling;

   /** Stride between rows in bytes */
   uint32_t row_stride_B;
};

struct nil_image {
   enum nil_image_dim dim;
   enum pipe_format format;

   struct nil_extent4d extent_px;
   enum nil_sample_layout sample_layout;
   uint8_t num_levels;

   struct nil_image_level levels[NIL_MAX_LEVELS];

   uint32_t array_stride_B;

   uint32_t align_B;
   uint64_t size_B;

   uint16_t tile_mode;
   uint8_t pte_kind;
};

struct nil_view {
   enum nil_view_type type;

   /**
    * The format to use in the view
    *
    * This may differ from the format of the actual isl_surf but must have
    * the same block size.
    */
   enum pipe_format format;

   uint32_t base_level;
   uint32_t num_levels;

   /**
    * Base array layer
    *
    * For cube maps, both base_array_layer and array_len should be
    * specified in terms of 2-D layers and must be a multiple of 6.
    */
   uint32_t base_array_layer;

   /**
    * Array Length
    *
    * Indicates the number of array elements starting at  Base Array Layer.
    */
   uint32_t array_len;

   enum pipe_swizzle swizzle[4];

   /* VK_EXT_image_view_min_lod */
   float min_lod_clamp;
};

bool nil_image_init(struct nv_device_info *dev,
                    struct nil_image *image,
                    const struct nil_image_init_info *restrict info);

static inline uint64_t
nil_image_level_layer_offset_B(const struct nil_image *image,
                               uint32_t level, uint32_t layer)
{
   assert(level < image->num_levels);
   assert(layer < image->extent_px.array_len);
   return image->levels[level].offset_B + (layer * image->array_stride_B);
}

struct nil_extent4d nil_image_level_extent_px(const struct nil_image *image,
                                              uint32_t level);
struct nil_extent4d nil_image_level_extent_sa(const struct nil_image *image,
                                              uint32_t level);
uint64_t nil_image_level_size_B(const struct nil_image *image,
                                uint32_t level);
uint64_t nil_image_level_depth_stride_B(const struct nil_image *image,
                                        uint32_t level);

void nil_image_for_level(const struct nil_image *image_in,
                         uint32_t level,
                         struct nil_image *level_image_out,
                         uint64_t *offset_B_out);

void nil_image_level_as_uncompressed(const struct nil_image *image_3d,
                                     uint32_t level,
                                     struct nil_image *uc_image_out,
                                     uint64_t *offset_B_out);

void nil_image_3d_level_as_2d_array(const struct nil_image *image_3d,
                                    uint32_t level,
                                    struct nil_image *image_2d_out,
                                    uint64_t *offset_B_out);

void nil_image_fill_tic(struct nv_device_info *dev,
                        const struct nil_image *image,
                        const struct nil_view *view,
                        uint64_t base_address,
                        void *desc_out);

void nil_buffer_fill_tic(struct nv_device_info *dev,
                         uint64_t base_address,
                         enum pipe_format format,
                         uint32_t num_elements,
                         void *desc_out);

#endif /* NIL_IMAGE_H */