p_screen.h revision 985e71866a9eb4c6f18ff8766eb278e58bf09830
1aa59a937ccf41609081d3f9a4973df5478979785Brian/************************************************************************** 2aa59a937ccf41609081d3f9a4973df5478979785Brian * 3aa59a937ccf41609081d3f9a4973df5478979785Brian * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4aa59a937ccf41609081d3f9a4973df5478979785Brian * All Rights Reserved. 5aa59a937ccf41609081d3f9a4973df5478979785Brian * 6aa59a937ccf41609081d3f9a4973df5478979785Brian * Permission is hereby granted, free of charge, to any person obtaining a 7aa59a937ccf41609081d3f9a4973df5478979785Brian * copy of this software and associated documentation files (the 8aa59a937ccf41609081d3f9a4973df5478979785Brian * "Software"), to deal in the Software without restriction, including 9aa59a937ccf41609081d3f9a4973df5478979785Brian * without limitation the rights to use, copy, modify, merge, publish, 10aa59a937ccf41609081d3f9a4973df5478979785Brian * distribute, sub license, and/or sell copies of the Software, and to 11aa59a937ccf41609081d3f9a4973df5478979785Brian * permit persons to whom the Software is furnished to do so, subject to 12aa59a937ccf41609081d3f9a4973df5478979785Brian * the following conditions: 13aa59a937ccf41609081d3f9a4973df5478979785Brian * 14aa59a937ccf41609081d3f9a4973df5478979785Brian * The above copyright notice and this permission notice (including the 15aa59a937ccf41609081d3f9a4973df5478979785Brian * next paragraph) shall be included in all copies or substantial portions 16aa59a937ccf41609081d3f9a4973df5478979785Brian * of the Software. 17aa59a937ccf41609081d3f9a4973df5478979785Brian * 18aa59a937ccf41609081d3f9a4973df5478979785Brian * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19aa59a937ccf41609081d3f9a4973df5478979785Brian * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20aa59a937ccf41609081d3f9a4973df5478979785Brian * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21aa59a937ccf41609081d3f9a4973df5478979785Brian * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22aa59a937ccf41609081d3f9a4973df5478979785Brian * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23aa59a937ccf41609081d3f9a4973df5478979785Brian * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24aa59a937ccf41609081d3f9a4973df5478979785Brian * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25aa59a937ccf41609081d3f9a4973df5478979785Brian * 26aa59a937ccf41609081d3f9a4973df5478979785Brian **************************************************************************/ 27aa59a937ccf41609081d3f9a4973df5478979785Brian 28aa59a937ccf41609081d3f9a4973df5478979785Brian/** 29984a7c4e9c42cf8ddfcff5b880b522a6dd58bce2José Fonseca * @file 30984a7c4e9c42cf8ddfcff5b880b522a6dd58bce2José Fonseca * 31aa59a937ccf41609081d3f9a4973df5478979785Brian * Screen, Adapter or GPU 32aa59a937ccf41609081d3f9a4973df5478979785Brian * 33aa59a937ccf41609081d3f9a4973df5478979785Brian * These are driver functions/facilities that are context independent. 34aa59a937ccf41609081d3f9a4973df5478979785Brian */ 35aa59a937ccf41609081d3f9a4973df5478979785Brian 36aa59a937ccf41609081d3f9a4973df5478979785Brian 37aa59a937ccf41609081d3f9a4973df5478979785Brian#ifndef P_SCREEN_H 38aa59a937ccf41609081d3f9a4973df5478979785Brian#define P_SCREEN_H 39aa59a937ccf41609081d3f9a4973df5478979785Brian 40aa59a937ccf41609081d3f9a4973df5478979785Brian 41aa59a937ccf41609081d3f9a4973df5478979785Brian#include "pipe/p_compiler.h" 42099e9d20f0e8f5ee108e4fbb4bf7cae97b5f9a4aBrian Paul#include "pipe/p_format.h" 43099e9d20f0e8f5ee108e4fbb4bf7cae97b5f9a4aBrian Paul#include "pipe/p_defines.h" 44aa59a937ccf41609081d3f9a4973df5478979785Brian 45aa59a937ccf41609081d3f9a4973df5478979785Brian 46aa59a937ccf41609081d3f9a4973df5478979785Brian 47aa59a937ccf41609081d3f9a4973df5478979785Brian#ifdef __cplusplus 48aa59a937ccf41609081d3f9a4973df5478979785Brianextern "C" { 49aa59a937ccf41609081d3f9a4973df5478979785Brian#endif 50aa59a937ccf41609081d3f9a4973df5478979785Brian 51aa59a937ccf41609081d3f9a4973df5478979785Brian 52adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin/** Opaque type */ 53adfbba476db1fc55006efb748656ebb1a481d143Zack Rusinstruct pipe_fence_handle; 540703b2e9ad9ef9d05f7ba53b93dba780ad34b47dBrian Paulstruct pipe_winsys; 55099e9d20f0e8f5ee108e4fbb4bf7cae97b5f9a4aBrian Paulstruct pipe_buffer; 560703b2e9ad9ef9d05f7ba53b93dba780ad34b47dBrian Paul 57aa59a937ccf41609081d3f9a4973df5478979785Brian 584617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer 59aa59a937ccf41609081d3f9a4973df5478979785Brian/** 60aa59a937ccf41609081d3f9a4973df5478979785Brian * Gallium screen/adapter context. Basically everything 61aa59a937ccf41609081d3f9a4973df5478979785Brian * hardware-specific that doesn't actually require a rendering 62aa59a937ccf41609081d3f9a4973df5478979785Brian * context. 63aa59a937ccf41609081d3f9a4973df5478979785Brian */ 64aa59a937ccf41609081d3f9a4973df5478979785Brianstruct pipe_screen { 65aa59a937ccf41609081d3f9a4973df5478979785Brian struct pipe_winsys *winsys; 66aa59a937ccf41609081d3f9a4973df5478979785Brian 67aa59a937ccf41609081d3f9a4973df5478979785Brian void (*destroy)( struct pipe_screen * ); 68aa59a937ccf41609081d3f9a4973df5478979785Brian 69aa59a937ccf41609081d3f9a4973df5478979785Brian 70aa59a937ccf41609081d3f9a4973df5478979785Brian const char *(*get_name)( struct pipe_screen * ); 71aa59a937ccf41609081d3f9a4973df5478979785Brian 72aa59a937ccf41609081d3f9a4973df5478979785Brian const char *(*get_vendor)( struct pipe_screen * ); 73aa59a937ccf41609081d3f9a4973df5478979785Brian 74aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 75aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Query an integer-valued capability/parameter/limit 76aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * \param param one of PIPE_CAP_x 77aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 78aa59a937ccf41609081d3f9a4973df5478979785Brian int (*get_param)( struct pipe_screen *, int param ); 79aa59a937ccf41609081d3f9a4973df5478979785Brian 80aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 81aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Query a float-valued capability/parameter/limit 82aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * \param param one of PIPE_CAP_x 83aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 84aa59a937ccf41609081d3f9a4973df5478979785Brian float (*get_paramf)( struct pipe_screen *, int param ); 85aa59a937ccf41609081d3f9a4973df5478979785Brian 86aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 87aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Check if the given pipe_format is supported as a texture or 88aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * drawing surface. 898aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca * \param tex_usage bitmask of PIPE_TEXTURE_USAGE_* 90985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * \param geom_flags bitmask of PIPE_TEXTURE_GEOM_* 91aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 92aa59a937ccf41609081d3f9a4973df5478979785Brian boolean (*is_format_supported)( struct pipe_screen *, 938aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca enum pipe_format format, 948aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca enum pipe_texture_target target, 958aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca unsigned tex_usage, 968aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca unsigned geom_flags ); 97aa59a937ccf41609081d3f9a4973df5478979785Brian 98aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 99aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Create a new texture object, using the given template info. 100aa59a937ccf41609081d3f9a4973df5478979785Brian */ 101aa59a937ccf41609081d3f9a4973df5478979785Brian struct pipe_texture * (*texture_create)(struct pipe_screen *, 102aa59a937ccf41609081d3f9a4973df5478979785Brian const struct pipe_texture *templat); 103aa59a937ccf41609081d3f9a4973df5478979785Brian 1046361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca /** 105985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * Create a new texture object, using the given template info, but on top of 1066361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca * existing memory. 1076361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca * 1086361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca * It is assumed that the buffer data is layed out according to the expected 1096361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca * by the hardware. NULL will be returned if any inconsistency is found. 1106361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca */ 1116361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca struct pipe_texture * (*texture_blanket)(struct pipe_screen *, 1126361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca const struct pipe_texture *templat, 113872b515e8f0bb1be5bad85fd9d01529c71f07ba2Zack Rusin const unsigned *stride, 1146361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca struct pipe_buffer *buffer); 1156361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca 1165e27cd46c04a9e7b5904cc014bffd0f4daae31feMichel Dänzer void (*texture_destroy)(struct pipe_texture *pt); 117aa59a937ccf41609081d3f9a4973df5478979785Brian 118aa59a937ccf41609081d3f9a4973df5478979785Brian /** Get a surface which is a "view" into a texture */ 119aa59a937ccf41609081d3f9a4973df5478979785Brian struct pipe_surface *(*get_tex_surface)(struct pipe_screen *, 120aa59a937ccf41609081d3f9a4973df5478979785Brian struct pipe_texture *texture, 121aa59a937ccf41609081d3f9a4973df5478979785Brian unsigned face, unsigned level, 122c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell unsigned zslice, 123c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell unsigned usage ); 124c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell 1255e27cd46c04a9e7b5904cc014bffd0f4daae31feMichel Dänzer void (*tex_surface_destroy)(struct pipe_surface *); 126c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell 127c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell 1284617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer /** Get a transfer object for transferring data to/from a texture */ 1294617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer struct pipe_transfer *(*get_tex_transfer)(struct pipe_screen *, 1304617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer struct pipe_texture *texture, 1314617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer unsigned face, unsigned level, 1324617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer unsigned zslice, 1334617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer enum pipe_transfer_usage usage, 1344617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer unsigned x, unsigned y, 1354617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer unsigned w, unsigned h); 1364617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer 1375e27cd46c04a9e7b5904cc014bffd0f4daae31feMichel Dänzer void (*tex_transfer_destroy)(struct pipe_transfer *); 1384617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer 1394617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer void *(*transfer_map)( struct pipe_screen *, 1404617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer struct pipe_transfer *transfer ); 141c9ed86a96483063f3d6789ed16645a3dca77d726Keith Whitwell 1424617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer void (*transfer_unmap)( struct pipe_screen *, 1434617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer struct pipe_transfer *transfer ); 144b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 145b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 146b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin /** 147985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * Create a new buffer. 148985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * \param alignment buffer start address alignment in bytes 149985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * \param usage bitmask of PIPE_BUFFER_USAGE_x 150985e71866a9eb4c6f18ff8766eb278e58bf09830Brian Paul * \param size size in bytes 151b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin */ 152b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin struct pipe_buffer *(*buffer_create)( struct pipe_screen *screen, 153b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned alignment, 154b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned usage, 155b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned size ); 156b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 157b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin /** 158b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Create a buffer that wraps user-space data. 159b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 160b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Effectively this schedules a delayed call to buffer_create 161b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * followed by an upload of the data at *some point in the future*, 162b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * or perhaps never. Basically the allocate/upload is delayed 163b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * until the buffer is actually passed to hardware. 164b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 165b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * The intention is to provide a quick way to turn regular data 166b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * into a buffer, and secondly to avoid a copy operation if that 167b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * data subsequently turns out to be only accessed by the CPU. 168b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 169b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Common example is OpenGL vertex buffers that are subsequently 170b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * processed either by software TNL in the driver or by passing to 171b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * hardware. 172b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 173b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * XXX: What happens if the delayed call to buffer_create() fails? 174b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 175b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Note that ptr may be accessed at any time upto the time when the 176b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * buffer is destroyed, so the data must not be freed before then. 177b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin */ 178b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin struct pipe_buffer *(*user_buffer_create)(struct pipe_screen *screen, 179b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin void *ptr, 180b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned bytes); 181b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 182b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin /** 183b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Allocate storage for a display target surface. 184b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 185b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Often surfaces which are meant to be blitted to the front screen (i.e., 186b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * display targets) must be allocated with special characteristics, memory 187b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * pools, or obtained directly from the windowing system. 188b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * 189b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * This callback is invoked by the pipe_screenwhen creating a texture marked 190b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * with the PIPE_TEXTURE_USAGE_DISPLAY_TARGET flag to get the underlying 191b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * buffer storage. 192b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin */ 193b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin struct pipe_buffer *(*surface_buffer_create)(struct pipe_screen *screen, 194b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned width, unsigned height, 195b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin enum pipe_format format, 196b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned usage, 197b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned *stride); 198b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 199b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 200b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin /** 201b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * Map the entire data store of a buffer object into the client's address. 202b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin * flags is bitmask of PIPE_BUFFER_USAGE_CPU_READ/WRITE flags. 203b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin */ 204b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin void *(*buffer_map)( struct pipe_screen *screen, 205b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin struct pipe_buffer *buf, 206b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin unsigned usage ); 20760e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca /** 20860e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca * Map a subrange of the buffer data store into the client's address space. 20960e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca * 2102a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * The returned pointer is always relative to buffer start, regardless of 2112a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * the specified range. This is different from the ARB_map_buffer_range 2122a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * semantics because we don't forbid multiple mappings of the same buffer 2132a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * (yet). 21460e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca */ 21560e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca void *(*buffer_map_range)( struct pipe_screen *screen, 21660e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca struct pipe_buffer *buf, 217190db8b4c36bffcaae996538e250eb144242c064José Fonseca unsigned offset, 218190db8b4c36bffcaae996538e250eb144242c064José Fonseca unsigned length, 219190db8b4c36bffcaae996538e250eb144242c064José Fonseca unsigned usage); 22060e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca 22160e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca /** 2222a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * Notify a range that was actually written into. 2232a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * 2242a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * The range is relative to the buffer start, regardless of the range 2252a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * specified to buffer_map_range. This is different from the 2262a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * ARB_map_buffer_range semantics because we don't forbid multiple mappings 2272a1f29c22003e819914d386f2117d6e186f59f20José Fonseca * of the same buffer (yet). 22848f6e754898879898165dca013157dffe2babb12José Fonseca * 22948f6e754898879898165dca013157dffe2babb12José Fonseca * If the buffer was mapped for writing and no buffer_flush_mapped_range 23048f6e754898879898165dca013157dffe2babb12José Fonseca * call was done until the buffer_unmap is called then the pipe driver will 23148f6e754898879898165dca013157dffe2babb12José Fonseca * assumed that the whole buffer was written. This is for backward 23248f6e754898879898165dca013157dffe2babb12José Fonseca * compatibility purposes and may affect performance -- the state tracker 23348f6e754898879898165dca013157dffe2babb12José Fonseca * should always specify exactly what got written while the buffer was 23448f6e754898879898165dca013157dffe2babb12José Fonseca * mapped. 23560e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca */ 236190db8b4c36bffcaae996538e250eb144242c064José Fonseca void (*buffer_flush_mapped_range)( struct pipe_screen *screen, 237190db8b4c36bffcaae996538e250eb144242c064José Fonseca struct pipe_buffer *buf, 238190db8b4c36bffcaae996538e250eb144242c064José Fonseca unsigned offset, 239190db8b4c36bffcaae996538e250eb144242c064José Fonseca unsigned length); 240190db8b4c36bffcaae996538e250eb144242c064José Fonseca 241190db8b4c36bffcaae996538e250eb144242c064José Fonseca void (*buffer_unmap)( struct pipe_screen *screen, 242190db8b4c36bffcaae996538e250eb144242c064José Fonseca struct pipe_buffer *buf ); 24360e5fe65067da76dea816535bec1e9073adc0ba7José Fonseca 2445e27cd46c04a9e7b5904cc014bffd0f4daae31feMichel Dänzer void (*buffer_destroy)( struct pipe_buffer *buf ); 245adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 246adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 247adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** 248adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Do any special operations to ensure frontbuffer contents are 249adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * displayed, eg copy fake frontbuffer. 250adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 251adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin void (*flush_frontbuffer)( struct pipe_screen *screen, 252adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_surface *surf, 253adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin void *context_private ); 254adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 255adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 256adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 257adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** Set ptr = fence, with reference counting */ 258adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin void (*fence_reference)( struct pipe_screen *screen, 259adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle **ptr, 260adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle *fence ); 261adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 262adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** 263adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Checks whether the fence has been signalled. 264adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * \param flags driver-specific meaning 265adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * \return zero on success. 266adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 267adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin int (*fence_signalled)( struct pipe_screen *screen, 268adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle *fence, 2697ea265888f19bcbc1771f6c671ce08855b80bf0aJosé Fonseca unsigned flags ); 270adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 271adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** 272adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Wait for the fence to finish. 273adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * \param flags driver-specific meaning 274adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * \return zero on success. 275adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 276adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin int (*fence_finish)( struct pipe_screen *screen, 277adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle *fence, 2787ea265888f19bcbc1771f6c671ce08855b80bf0aJosé Fonseca unsigned flags ); 279adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 280aa59a937ccf41609081d3f9a4973df5478979785Brian}; 281aa59a937ccf41609081d3f9a4973df5478979785Brian 282aa59a937ccf41609081d3f9a4973df5478979785Brian 283aa59a937ccf41609081d3f9a4973df5478979785Brian#ifdef __cplusplus 284aa59a937ccf41609081d3f9a4973df5478979785Brian} 285aa59a937ccf41609081d3f9a4973df5478979785Brian#endif 286aa59a937ccf41609081d3f9a4973df5478979785Brian 287aa59a937ccf41609081d3f9a4973df5478979785Brian#endif /* P_SCREEN_H */ 288