1aa59a937ccf41609081d3f9a4973df5478979785Brian/************************************************************************** 2a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 3aa59a937ccf41609081d3f9a4973df5478979785Brian * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4aa59a937ccf41609081d3f9a4973df5478979785Brian * All Rights Reserved. 5a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 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: 13a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 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. 17a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 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. 25a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 26aa59a937ccf41609081d3f9a4973df5478979785Brian **************************************************************************/ 27aa59a937ccf41609081d3f9a4973df5478979785Brian 28aa59a937ccf41609081d3f9a4973df5478979785Brian/** 29984a7c4e9c42cf8ddfcff5b880b522a6dd58bce2José Fonseca * @file 30a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König * 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" 44a5a942256162eb0ca4df2f8202a916b080396141Brian Paul#include "pipe/p_video_enums.h" 45aa59a937ccf41609081d3f9a4973df5478979785Brian 46aa59a937ccf41609081d3f9a4973df5478979785Brian 47aa59a937ccf41609081d3f9a4973df5478979785Brian 48aa59a937ccf41609081d3f9a4973df5478979785Brian#ifdef __cplusplus 49aa59a937ccf41609081d3f9a4973df5478979785Brianextern "C" { 50aa59a937ccf41609081d3f9a4973df5478979785Brian#endif 51aa59a937ccf41609081d3f9a4973df5478979785Brian 52aa59a937ccf41609081d3f9a4973df5478979785Brian 5381e2a238bcdaeb71d5a35b5d9e1c425cca8672bcBrian Paul/** Opaque types */ 54b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantzstruct winsys_handle; 55adfbba476db1fc55006efb748656ebb1a481d143Zack Rusinstruct pipe_fence_handle; 56287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwellstruct pipe_resource; 57f547472bfa0a797adacc2a7688b4c1ba65381a80Younes Mantonstruct pipe_surface; 58f547472bfa0a797adacc2a7688b4c1ba65381a80Younes Mantonstruct pipe_transfer; 59aa59a937ccf41609081d3f9a4973df5478979785Brian 604617981ec72f7985941bee4b03c534d97ff96bc6Michel Dänzer 61aa59a937ccf41609081d3f9a4973df5478979785Brian/** 62aa59a937ccf41609081d3f9a4973df5478979785Brian * Gallium screen/adapter context. Basically everything 63aa59a937ccf41609081d3f9a4973df5478979785Brian * hardware-specific that doesn't actually require a rendering 64aa59a937ccf41609081d3f9a4973df5478979785Brian * context. 65aa59a937ccf41609081d3f9a4973df5478979785Brian */ 66aa59a937ccf41609081d3f9a4973df5478979785Brianstruct pipe_screen { 67aa59a937ccf41609081d3f9a4973df5478979785Brian void (*destroy)( struct pipe_screen * ); 68aa59a937ccf41609081d3f9a4973df5478979785Brian 69aa59a937ccf41609081d3f9a4973df5478979785Brian const char *(*get_name)( struct pipe_screen * ); 70aa59a937ccf41609081d3f9a4973df5478979785Brian 71aa59a937ccf41609081d3f9a4973df5478979785Brian const char *(*get_vendor)( struct pipe_screen * ); 72aa59a937ccf41609081d3f9a4973df5478979785Brian 73aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 74aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Query an integer-valued capability/parameter/limit 75aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * \param param one of PIPE_CAP_x 76aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 77e1238b5cad3845c029f60d92c08e810274517d33José Fonseca int (*get_param)( struct pipe_screen *, enum pipe_cap param ); 78aa59a937ccf41609081d3f9a4973df5478979785Brian 79aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 80aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Query a float-valued capability/parameter/limit 81aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * \param param one of PIPE_CAP_x 82aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 83bb71f9249a66b9a4921a878766c0a2d87624c369Marek Olšák float (*get_paramf)( struct pipe_screen *, enum pipe_capf param ); 84aa59a937ccf41609081d3f9a4973df5478979785Brian 85a508d2dddcc67d0f92cc36b9ed6f36a9bbfc579dLuca Barbieri /** 86a508d2dddcc67d0f92cc36b9ed6f36a9bbfc579dLuca Barbieri * Query a per-shader-stage integer-valued capability/parameter/limit 87a508d2dddcc67d0f92cc36b9ed6f36a9bbfc579dLuca Barbieri * \param param one of PIPE_CAP_x 88a508d2dddcc67d0f92cc36b9ed6f36a9bbfc579dLuca Barbieri */ 89a508d2dddcc67d0f92cc36b9ed6f36a9bbfc579dLuca Barbieri int (*get_shader_param)( struct pipe_screen *, unsigned shader, enum pipe_shader_cap param ); 90aa59a937ccf41609081d3f9a4973df5478979785Brian 91f265a194263bb2a3fa204947a9c98f472835f121Christian König /** 92f265a194263bb2a3fa204947a9c98f472835f121Christian König * Query an integer-valued capability/parameter/limit for a codec/profile 93f265a194263bb2a3fa204947a9c98f472835f121Christian König * \param param one of PIPE_VIDEO_CAP_x 94f265a194263bb2a3fa204947a9c98f472835f121Christian König */ 95a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König int (*get_video_param)( struct pipe_screen *, 96a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König enum pipe_video_profile profile, 97a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König enum pipe_video_cap param ); 98f265a194263bb2a3fa204947a9c98f472835f121Christian König 99d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez /** 100d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * Query a compute-specific capability/parameter/limit. 101d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * \param param one of PIPE_COMPUTE_CAP_x 102d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * \param ret pointer to a preallocated buffer that will be 103d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * initialized to the parameter value, or NULL. 104d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * \return size in bytes of the parameter value that would be 105d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez * returned. 106d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez */ 107d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez int (*get_compute_param)(struct pipe_screen *, 108d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez enum pipe_compute_cap param, 109d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez void *ret); 110d9d82dcd006c124e6569789c90390c43c1360c06Francisco Jerez 111bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák /** 112bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák * Query a timestamp in nanoseconds. The returned value should match 113bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák * PIPE_QUERY_TIMESTAMP. This function returns immediately and doesn't 114bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák * wait for rendering to complete (which cannot be achieved with queries). 115bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák */ 116bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák uint64_t (*get_timestamp)(struct pipe_screen *); 117bcc735aaca3b305d05c28e4076996d91b19d80fdMarek Olšák 118a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König struct pipe_context * (*context_create)( struct pipe_screen *, 119a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König void *priv ); 120f64d0cf524b2203e648a060366a2e4220096aa1fYounes Manton 121aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 122aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Check if the given pipe_format is supported as a texture or 123aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * drawing surface. 124d888812324719723de3256612886dd61de3bd282Brian Paul * \param bindings bitmask of PIPE_BIND_* 125aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul */ 126aa59a937ccf41609081d3f9a4973df5478979785Brian boolean (*is_format_supported)( struct pipe_screen *, 1278aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca enum pipe_format format, 1288aafc03b260ab8923f1b373f7effa75bcdb40a72José Fonseca enum pipe_texture_target target, 1296272d7632a8d2948e45698d1c75eae8c441c3916Roland Scheidegger unsigned sample_count, 130e968975cb57eb854769292f7c6ff773c64a386c3Marek Olšák unsigned bindings ); 131a7ec477ebc8b256381854f1cef0ec03a2d713555Christian König 1327eca76952b6726be9459375dde7478a01789577eChristian König /** 1337eca76952b6726be9459375dde7478a01789577eChristian König * Check if the given pipe_format is supported as output for this codec/profile. 1347eca76952b6726be9459375dde7478a01789577eChristian König * \param profile profile to check, may also be PIPE_VIDEO_PROFILE_UNKNOWN 1357eca76952b6726be9459375dde7478a01789577eChristian König */ 1367eca76952b6726be9459375dde7478a01789577eChristian König boolean (*is_video_format_supported)( struct pipe_screen *, 1377eca76952b6726be9459375dde7478a01789577eChristian König enum pipe_format format, 1387eca76952b6726be9459375dde7478a01789577eChristian König enum pipe_video_profile profile ); 139aa59a937ccf41609081d3f9a4973df5478979785Brian 140aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul /** 141aad9dd14d8ef44e55f70b639765dae89e9976345Brian Paul * Create a new texture object, using the given template info. 142aa59a937ccf41609081d3f9a4973df5478979785Brian */ 143287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct pipe_resource * (*resource_create)(struct pipe_screen *, 144287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell const struct pipe_resource *templat); 145aa59a937ccf41609081d3f9a4973df5478979785Brian 1466361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca /** 147b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz * Create a texture from a winsys_handle. The handle is often created in 148b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz * another process by first creating a pipe texture and then calling 1494c7001462607e6e99e474d6271dd481d3f8f201cRoland Scheidegger * resource_get_handle. 1506361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca */ 151287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct pipe_resource * (*resource_from_handle)(struct pipe_screen *, 152287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell const struct pipe_resource *templat, 153287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct winsys_handle *handle); 154b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz 155b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz /** 156b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz * Get a winsys_handle from a texture. Some platforms/winsys requires 157b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz * that the texture is created with a special usage flag like 158b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz * DISPLAYTARGET or PRIMARY. 159b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz */ 160287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell boolean (*resource_get_handle)(struct pipe_screen *, 161287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct pipe_resource *tex, 162287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct winsys_handle *handle); 163b2e94d05c9602e2814a513a51eed67d014b338f3Jakob Bornecrantz 1646361d6f48d13ce481253faf106fba5c6a41488edJosé Fonseca 165287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell void (*resource_destroy)(struct pipe_screen *, 166287c94ea4987033f9c99a2f91c5750c9083504caKeith Whitwell struct pipe_resource *pt); 167aa59a937ccf41609081d3f9a4973df5478979785Brian 168b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin 169b3028acd98e2b7fd09344f9005c5b20bba91262cZack Rusin /** 170adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Do any special operations to ensure frontbuffer contents are 171adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * displayed, eg copy fake frontbuffer. 172e4848d21e8f384f4157076d5e7c7c9d38da6598eChia-I Wu * \param winsys_drawable_handle an opaque handle that the calling context 173e4848d21e8f384f4157076d5e7c7c9d38da6598eChia-I Wu * gets out-of-band 174adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 175adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin void (*flush_frontbuffer)( struct pipe_screen *screen, 1764c7001462607e6e99e474d6271dd481d3f8f201cRoland Scheidegger struct pipe_resource *resource, 1774c7001462607e6e99e474d6271dd481d3f8f201cRoland Scheidegger unsigned level, unsigned layer, 178e4848d21e8f384f4157076d5e7c7c9d38da6598eChia-I Wu void *winsys_drawable_handle ); 179adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 180adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 181adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 182adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** Set ptr = fence, with reference counting */ 183adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin void (*fence_reference)( struct pipe_screen *screen, 184adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle **ptr, 185adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin struct pipe_fence_handle *fence ); 186adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 187adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** 188adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Checks whether the fence has been signalled. 189adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 190bfe88e69988b3d3bdff0b9f6051d0428e1315653Marek Olšák boolean (*fence_signalled)( struct pipe_screen *screen, 191bfe88e69988b3d3bdff0b9f6051d0428e1315653Marek Olšák struct pipe_fence_handle *fence ); 192adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 193adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin /** 194adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin * Wait for the fence to finish. 195b39bccbd4ed71e9585da4cf5acf7b887b2e90899Marek Olšák * \param timeout in nanoseconds 196adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin */ 197bfe88e69988b3d3bdff0b9f6051d0428e1315653Marek Olšák boolean (*fence_finish)( struct pipe_screen *screen, 198bfe88e69988b3d3bdff0b9f6051d0428e1315653Marek Olšák struct pipe_fence_handle *fence, 199bfe88e69988b3d3bdff0b9f6051d0428e1315653Marek Olšák uint64_t timeout ); 200adfbba476db1fc55006efb748656ebb1a481d143Zack Rusin 201aa59a937ccf41609081d3f9a4973df5478979785Brian}; 202aa59a937ccf41609081d3f9a4973df5478979785Brian 203aa59a937ccf41609081d3f9a4973df5478979785Brian 204aa59a937ccf41609081d3f9a4973df5478979785Brian#ifdef __cplusplus 205aa59a937ccf41609081d3f9a4973df5478979785Brian} 206aa59a937ccf41609081d3f9a4973df5478979785Brian#endif 207aa59a937ccf41609081d3f9a4973df5478979785Brian 208aa59a937ccf41609081d3f9a4973df5478979785Brian#endif /* P_SCREEN_H */ 209