0,0 → 1,257 |
/************************************************************************** |
* |
* Copyright © 2009 Jakob Bornecrantz |
* |
* 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 I915_WINSYS_H |
#define I915_WINSYS_H |
|
#include "pipe/p_compiler.h" |
|
struct i915_winsys; |
struct i915_winsys_buffer; |
struct i915_winsys_batchbuffer; |
struct pipe_resource; |
struct pipe_fence_handle; |
struct winsys_handle; |
|
enum i915_winsys_buffer_usage |
{ |
/* use on textures */ |
I915_USAGE_RENDER = 0x01, |
I915_USAGE_SAMPLER = 0x02, |
I915_USAGE_2D_TARGET = 0x04, |
I915_USAGE_2D_SOURCE = 0x08, |
/* use on vertex */ |
I915_USAGE_VERTEX = 0x10 |
}; |
|
enum i915_winsys_buffer_type |
{ |
I915_NEW_TEXTURE, |
I915_NEW_SCANOUT, /**< a texture used for scanning out from */ |
I915_NEW_VERTEX |
}; |
|
/* These need to be in sync with the definitions of libdrm-intel! */ |
enum i915_winsys_buffer_tile |
{ |
I915_TILE_NONE, |
I915_TILE_X, |
I915_TILE_Y |
}; |
|
enum i915_winsys_flush_flags |
{ |
I915_FLUSH_ASYNC = 0, |
I915_FLUSH_END_OF_FRAME = 1 |
}; |
|
struct i915_winsys_batchbuffer { |
|
struct i915_winsys *iws; |
|
/** |
* Values exported to speed up the writing the batchbuffer, |
* instead of having to go trough a accesor function for |
* each dword written. |
*/ |
/*{@*/ |
uint8_t *map; |
uint8_t *ptr; |
size_t size; |
|
size_t relocs; |
/*@}*/ |
}; |
|
struct i915_winsys { |
|
unsigned pci_id; /**< PCI ID for the device */ |
|
/** |
* Batchbuffer functions. |
*/ |
/*@{*/ |
/** |
* Create a new batchbuffer. |
*/ |
struct i915_winsys_batchbuffer * |
(*batchbuffer_create)(struct i915_winsys *iws); |
|
/** |
* Validate buffers for usage in this batchbuffer. |
* Does space-checking and asorted other book-keeping. |
* |
* @batch |
* @buffers array to buffers to validate |
* @num_of_buffers size of the passed array |
*/ |
boolean (*validate_buffers)(struct i915_winsys_batchbuffer *batch, |
struct i915_winsys_buffer **buffers, |
int num_of_buffers); |
|
/** |
* Emit a relocation to a buffer. |
* Target position in batchbuffer is the same as ptr. |
* |
* @batch |
* @reloc buffer address to be inserted into target. |
* @usage how is the hardware going to use the buffer. |
* @offset add this to the reloc buffers address |
* @target buffer where to write the address, null for batchbuffer. |
* @fenced relocation needs a fence. |
*/ |
int (*batchbuffer_reloc)(struct i915_winsys_batchbuffer *batch, |
struct i915_winsys_buffer *reloc, |
enum i915_winsys_buffer_usage usage, |
unsigned offset, boolean fenced); |
|
/** |
* Flush a bufferbatch. |
*/ |
void (*batchbuffer_flush)(struct i915_winsys_batchbuffer *batch, |
struct pipe_fence_handle **fence, |
enum i915_winsys_flush_flags flags); |
|
/** |
* Destroy a batchbuffer. |
*/ |
void (*batchbuffer_destroy)(struct i915_winsys_batchbuffer *batch); |
/*@}*/ |
|
|
/** |
* Buffer functions. |
*/ |
/*@{*/ |
/** |
* Create a buffer. |
*/ |
struct i915_winsys_buffer * |
(*buffer_create)(struct i915_winsys *iws, |
unsigned size, |
enum i915_winsys_buffer_type type); |
|
/** |
* Create a tiled buffer. |
* |
* *stride, height are in bytes. The winsys tries to allocate the buffer with |
* the tiling mode provide in *tiling. If tiling is no possible, *tiling will |
* be set to I915_TILE_NONE. The calculated stride (incorporateing hw/kernel |
* requirements) is always returned in *stride. |
*/ |
struct i915_winsys_buffer * |
(*buffer_create_tiled)(struct i915_winsys *iws, |
unsigned *stride, unsigned height, |
enum i915_winsys_buffer_tile *tiling, |
enum i915_winsys_buffer_type type); |
|
/** |
* Creates a buffer from a handle. |
* Used to implement pipe_screen::resource_from_handle. |
* Also provides the stride information needed for the |
* texture via the stride argument. |
*/ |
struct i915_winsys_buffer * |
(*buffer_from_handle)(struct i915_winsys *iws, |
struct winsys_handle *whandle, |
enum i915_winsys_buffer_tile *tiling, |
unsigned *stride); |
|
/** |
* Used to implement pipe_screen::resource_get_handle. |
* The winsys might need the stride information. |
*/ |
boolean (*buffer_get_handle)(struct i915_winsys *iws, |
struct i915_winsys_buffer *buffer, |
struct winsys_handle *whandle, |
unsigned stride); |
|
/** |
* Map a buffer. |
*/ |
void *(*buffer_map)(struct i915_winsys *iws, |
struct i915_winsys_buffer *buffer, |
boolean write); |
|
/** |
* Unmap a buffer. |
*/ |
void (*buffer_unmap)(struct i915_winsys *iws, |
struct i915_winsys_buffer *buffer); |
|
/** |
* Write to a buffer. |
* |
* Arguments follows pipe_buffer_write. |
*/ |
int (*buffer_write)(struct i915_winsys *iws, |
struct i915_winsys_buffer *dst, |
size_t offset, |
size_t size, |
const void *data); |
|
void (*buffer_destroy)(struct i915_winsys *iws, |
struct i915_winsys_buffer *buffer); |
|
/** |
* Check if a buffer is busy. |
*/ |
boolean (*buffer_is_busy)(struct i915_winsys *iws, |
struct i915_winsys_buffer *buffer); |
/*@}*/ |
|
|
/** |
* Fence functions. |
*/ |
/*@{*/ |
/** |
* Reference fence and set ptr to fence. |
*/ |
void (*fence_reference)(struct i915_winsys *iws, |
struct pipe_fence_handle **ptr, |
struct pipe_fence_handle *fence); |
|
/** |
* Check if a fence has finished. |
*/ |
int (*fence_signalled)(struct i915_winsys *iws, |
struct pipe_fence_handle *fence); |
|
/** |
* Wait on a fence to finish. |
*/ |
int (*fence_finish)(struct i915_winsys *iws, |
struct pipe_fence_handle *fence); |
/*@}*/ |
|
|
/** |
* Destroy the winsys. |
*/ |
void (*destroy)(struct i915_winsys *iws); |
}; |
|
#endif |