xref: /xsrc/external/mit/MesaLib/dist/src/gallium/drivers/i915/i915_resource.h

/**************************************************************************
 *
 * Copyright 2008 VMware, Inc.
 * All Rights Reserved.
 *
 * 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, sub license, 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 NON-INFRINGEMENT.
 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS 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 I915_RESOURCE_H
#define I915_RESOURCE_H

struct i915_screen;

#include "util/u_debug.h"
#include "util/u_transfer.h"
#include "i915_winsys.h"

struct i915_context;
struct i915_screen;

struct i915_buffer {
   struct pipe_resource b;
   uint8_t *data;
   bool free_on_destroy;
};

/* Texture transfer. */
struct i915_transfer {
   /* Base class. */
   struct pipe_transfer b;
   struct pipe_resource *staging_texture;
};

#define I915_MAX_TEXTURE_2D_LEVELS 12 /* max 2048x2048 */
#define I915_MAX_TEXTURE_3D_LEVELS 9  /* max 256x256x256 */

struct offset_pair {
   unsigned short nblocksx;
   unsigned short nblocksy;
};

struct i915_texture {
   struct pipe_resource b;

   /* tiling flags */
   enum i915_winsys_buffer_tile tiling;
   unsigned stride;
   unsigned depth_stride; /* per-image on i945? */
   unsigned total_nblocksy;

   unsigned nr_images[I915_MAX_TEXTURE_2D_LEVELS];

   /* Explicitly store the offset of each image for each cube face or
    * depth value.
    *
    * Array [depth] off offsets.
    */
   struct offset_pair *image_offset[I915_MAX_TEXTURE_2D_LEVELS];

   /* The data is held here:
    */
   struct i915_winsys_buffer *buffer;
};

unsigned i915_texture_offset(const struct i915_texture *tex, unsigned level,
                             unsigned layer);
void i915_init_screen_resource_functions(struct i915_screen *is);
void i915_init_resource_functions(struct i915_context *i915);

static inline struct i915_texture *
i915_texture(struct pipe_resource *resource)
{
   struct i915_texture *tex = (struct i915_texture *)resource;
   assert(tex->b.target != PIPE_BUFFER);
   return tex;
}

static inline struct i915_buffer *
i915_buffer(struct pipe_resource *resource)
{
   struct i915_buffer *tex = (struct i915_buffer *)resource;
   assert(tex->b.target == PIPE_BUFFER);
   return tex;
}

struct pipe_resource *i915_texture_create(struct pipe_screen *screen,
                                          const struct pipe_resource *template,
                                          bool force_untiled);

bool i915_resource_get_handle(struct pipe_screen *screen,
                              struct pipe_context *context,
                              struct pipe_resource *texture,
                              struct winsys_handle *whandle, unsigned usage);

struct pipe_resource *
i915_texture_from_handle(struct pipe_screen *screen,
                         const struct pipe_resource *template,
                         struct winsys_handle *whandle);

struct pipe_resource *i915_user_buffer_create(struct pipe_screen *screen,
                                              void *ptr, unsigned bytes,
                                              unsigned usage);

struct pipe_resource *i915_buffer_create(struct pipe_screen *screen,
                                         const struct pipe_resource *template);

void i915_resource_destroy(struct pipe_screen *screen,
                           struct pipe_resource *resource);

void i915_buffer_subdata(struct pipe_context *rm_ctx,
                         struct pipe_resource *resource, unsigned usage,
                         unsigned offset, unsigned size, const void *data);

void *i915_buffer_transfer_map(struct pipe_context *pipe,
                               struct pipe_resource *resource, unsigned level,
                               unsigned usage, const struct pipe_box *box,
                               struct pipe_transfer **ptransfer);

void i915_buffer_transfer_unmap(struct pipe_context *pipe,
                                struct pipe_transfer *transfer);

void *i915_texture_transfer_map(struct pipe_context *pipe,
                                struct pipe_resource *resource, unsigned level,
                                unsigned usage, const struct pipe_box *box,
                                struct pipe_transfer **ptransfer);

void i915_texture_transfer_unmap(struct pipe_context *pipe,
                                 struct pipe_transfer *transfer);

void i915_texture_subdata(struct pipe_context *pipe,
                          struct pipe_resource *resource, unsigned level,
                          unsigned usage, const struct pipe_box *box,
                          const void *data, unsigned stride,
                          unsigned layer_stride);

#endif /* I915_RESOURCE_H */