/************************************************************************** * * 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 BRW_WINSYS_H #define BRW_WINSYS_H #include "pipe/p_compiler.h" #include "pipe/p_defines.h" #include "util/u_inlines.h" struct brw_winsys; struct pipe_fence_handle; /* Not sure why the winsys needs this: */ #define BRW_BATCH_SIZE (32*1024) struct brw_winsys_screen; /* Need a tiny bit of information inside the abstract buffer struct: */ struct brw_winsys_buffer { struct pipe_reference reference; struct brw_winsys_screen *sws; unsigned size; }; /* Should be possible to validate usages above against buffer creation * types, below: */ enum brw_buffer_type { BRW_BUFFER_TYPE_TEXTURE, BRW_BUFFER_TYPE_SCANOUT, /**< a texture used for scanning out from */ BRW_BUFFER_TYPE_VERTEX, BRW_BUFFER_TYPE_CURBE, BRW_BUFFER_TYPE_QUERY, BRW_BUFFER_TYPE_SHADER_CONSTANTS, BRW_BUFFER_TYPE_SHADER_SCRATCH, BRW_BUFFER_TYPE_BATCH, BRW_BUFFER_TYPE_GENERAL_STATE, BRW_BUFFER_TYPE_SURFACE_STATE, BRW_BUFFER_TYPE_PIXEL, /* image uploads, pbo's, etc */ BRW_BUFFER_TYPE_GENERIC, /* unknown */ BRW_BUFFER_TYPE_MAX /* Count of possible values */ }; /* Describe the usage of a particular buffer in a relocation. The DRM * winsys will translate these back to GEM read/write domain flags. */ enum brw_buffer_usage { BRW_USAGE_STATE, /* INSTRUCTION, 0 */ BRW_USAGE_QUERY_RESULT, /* INSTRUCTION, INSTRUCTION */ BRW_USAGE_RENDER_TARGET, /* RENDER, 0 */ BRW_USAGE_DEPTH_BUFFER, /* RENDER, RENDER */ BRW_USAGE_BLIT_SOURCE, /* RENDER, 0 */ BRW_USAGE_BLIT_DEST, /* RENDER, RENDER */ BRW_USAGE_SAMPLER, /* SAMPLER, 0 */ BRW_USAGE_VERTEX, /* VERTEX, 0 */ BRW_USAGE_SCRATCH, /* 0, 0 */ BRW_USAGE_MAX }; enum brw_buffer_data_type { BRW_DATA_GS_CC_VP, BRW_DATA_GS_CC_UNIT, BRW_DATA_GS_WM_PROG, BRW_DATA_GS_SAMPLER_DEFAULT_COLOR, BRW_DATA_GS_SAMPLER, BRW_DATA_GS_WM_UNIT, BRW_DATA_GS_SF_PROG, BRW_DATA_GS_SF_VP, BRW_DATA_GS_SF_UNIT, BRW_DATA_GS_VS_UNIT, BRW_DATA_GS_VS_PROG, BRW_DATA_GS_GS_UNIT, BRW_DATA_GS_GS_PROG, BRW_DATA_GS_CLIP_VP, BRW_DATA_GS_CLIP_UNIT, BRW_DATA_GS_CLIP_PROG, BRW_DATA_SS_SURFACE, BRW_DATA_SS_SURF_BIND, BRW_DATA_CONSTANT_BUFFER, BRW_DATA_BATCH_BUFFER, BRW_DATA_OTHER, BRW_DATA_MAX }; /* Matches the i915_drm definitions: */ #define BRW_TILING_NONE 0 #define BRW_TILING_X 1 #define BRW_TILING_Y 2 /* Relocations to be applied with subdata in a call to sws->bo_subdata, below. * * Effectively this encodes: * * (unsigned *)(subdata + offset) = bo->offset + delta */ struct brw_winsys_reloc { enum brw_buffer_usage usage; /* debug only */ unsigned delta; unsigned offset; struct brw_winsys_buffer *bo; }; static INLINE void make_reloc(struct brw_winsys_reloc *reloc, enum brw_buffer_usage usage, unsigned delta, unsigned offset, struct brw_winsys_buffer *bo) { reloc->usage = usage; reloc->delta = delta; reloc->offset = offset; reloc->bo = bo; /* Note - note taking a reference yet */ } struct brw_winsys_screen { /** * Buffer functions. */ /*@{*/ /** * Create a buffer. */ enum pipe_error (*bo_alloc)(struct brw_winsys_screen *sws, enum brw_buffer_type type, unsigned size, unsigned alignment, struct brw_winsys_buffer **bo_out); enum pipe_error (*bo_from_handle)(struct brw_winsys_screen *sws, struct winsys_handle *whandle, unsigned *stride, unsigned *tiling, struct brw_winsys_buffer **bo_out); enum pipe_error (*bo_get_handle)(struct brw_winsys_buffer *buffer, struct winsys_handle *whandle, unsigned stride); /* Destroy a buffer when our refcount goes to zero: */ void (*bo_destroy)(struct brw_winsys_buffer *buffer); /* delta -- added to b2->offset, and written into buffer * offset -- location above value is written to within buffer */ enum pipe_error (*bo_emit_reloc)(struct brw_winsys_buffer *buffer, enum brw_buffer_usage usage, unsigned delta, unsigned offset, struct brw_winsys_buffer *b2); enum pipe_error (*bo_exec)(struct brw_winsys_buffer *buffer, unsigned bytes_used); enum pipe_error (*bo_subdata)(struct brw_winsys_buffer *buffer, enum brw_buffer_data_type data_type, size_t offset, size_t size, const void *data, const struct brw_winsys_reloc *reloc, unsigned nr_reloc ); boolean (*bo_is_busy)(struct brw_winsys_buffer *buffer); boolean (*bo_references)(struct brw_winsys_buffer *a, struct brw_winsys_buffer *b); /* XXX: couldn't this be handled by returning true/false on * bo_emit_reloc? */ enum pipe_error (*check_aperture_space)(struct brw_winsys_screen *iws, struct brw_winsys_buffer **buffers, unsigned count); /** * Map a buffer. */ void *(*bo_map)(struct brw_winsys_buffer *buffer, enum brw_buffer_data_type data_type, unsigned offset, unsigned length, boolean write, boolean discard, boolean flush_explicit); void (*bo_flush_range)(struct brw_winsys_buffer *buffer, unsigned offset, unsigned length); /** * Unmap a buffer. */ void (*bo_unmap)(struct brw_winsys_buffer *buffer); /*@}*/ /* Wait for buffer to go idle. Similar to map+unmap, but doesn't * mark buffer contents as dirty. */ void (*bo_wait_idle)(struct brw_winsys_buffer *buffer); /** * Destroy the winsys. */ void (*destroy)(struct brw_winsys_screen *iws); }; static INLINE void * bo_map_read(struct brw_winsys_screen *sws, struct brw_winsys_buffer *buf) { return sws->bo_map( buf, BRW_DATA_OTHER, 0, buf->size, FALSE, FALSE, FALSE ); } static INLINE void bo_reference(struct brw_winsys_buffer **ptr, struct brw_winsys_buffer *buf) { struct brw_winsys_buffer *old_buf = *ptr; if (pipe_reference(&(*ptr)->reference, &buf->reference)) old_buf->sws->bo_destroy(old_buf); *ptr = buf; } /** * Create brw pipe_screen. */ struct pipe_screen *brw_create_screen(struct brw_winsys_screen *iws, unsigned pci_id); /** * Get the brw_winsys buffer backing the texture. * * TODO UGLY */ struct pipe_texture; boolean brw_texture_get_winsys_buffer(struct pipe_texture *texture, struct brw_winsys_buffer **buffer, unsigned *stride); /** * Wrap a brw_winsys buffer with a texture blanket. * * TODO UGLY */ struct pipe_texture * brw_texture_blanket_winsys_buffer(struct pipe_screen *screen, const struct pipe_texture *template, unsigned pitch, unsigned tiling, struct brw_winsys_buffer *buffer); /************************************************************************* * Cooperative dumping between winsys and driver. TODO: make this * driver-only by wrapping calls to winsys->bo_subdata(). */ #ifdef DEBUG extern int BRW_DUMP; #else #define BRW_DUMP 0 #endif #define DUMP_ASM 0x1 #define DUMP_STATE 0x2 #define DUMP_BATCH 0x4 void brw_dump_data( unsigned pci_id, enum brw_buffer_data_type data_type, unsigned offset, const void *data, size_t size ); #endif