| /************************************************************************** |
| * |
| * Copyright 2007-2009 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 TUNGSTEN GRAPHICS 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. |
| * |
| **************************************************************************/ |
| |
| /** |
| * @file |
| * Software rasterizer winsys. |
| */ |
| |
| |
| #ifndef SW_WINSYS_H |
| #define SW_WINSYS_H |
| |
| |
| #include "pipe/p_compiler.h" /* for boolean */ |
| #include "pipe/p_format.h" |
| |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| |
| struct winsys_handle; |
| struct pipe_screen; |
| struct pipe_context; |
| struct pipe_resource; |
| |
| |
| /** |
| * Opaque pointer. |
| */ |
| struct sw_displaytarget; |
| |
| |
| /** |
| * This is the interface that sw expects any window system |
| * hosting it to implement. |
| * |
| * sw is for the most part a self sufficient driver. The only thing it |
| * does not know is how to display a surface. |
| */ |
| struct sw_winsys |
| { |
| void |
| (*destroy)( struct sw_winsys *ws ); |
| |
| boolean |
| (*is_displaytarget_format_supported)( struct sw_winsys *ws, |
| unsigned tex_usage, |
| enum pipe_format format ); |
| |
| /** |
| * Allocate storage for a render target. |
| * |
| * Often surfaces which are meant to be blitted to the front screen (i.e., |
| * display targets) must be allocated with special characteristics, memory |
| * pools, or obtained directly from the windowing system. |
| * |
| * This callback is invoked by the pipe_screen when creating a texture marked |
| * with the PIPE_BIND_DISPLAY_TARGET flag to get the underlying |
| * storage. |
| */ |
| struct sw_displaytarget * |
| (*displaytarget_create)( struct sw_winsys *ws, |
| unsigned tex_usage, |
| enum pipe_format format, |
| unsigned width, unsigned height, |
| unsigned alignment, |
| unsigned *stride ); |
| |
| /** |
| * Used to implement texture_from_handle. |
| */ |
| struct sw_displaytarget * |
| (*displaytarget_from_handle)( struct sw_winsys *ws, |
| const struct pipe_resource *templat, |
| struct winsys_handle *whandle, |
| unsigned *stride ); |
| |
| /** |
| * Used to implement texture_get_handle. |
| */ |
| boolean |
| (*displaytarget_get_handle)( struct sw_winsys *ws, |
| struct sw_displaytarget *dt, |
| struct winsys_handle *whandle ); |
| |
| /** |
| * \param flags bitmask of PIPE_TRANSFER_x flags |
| */ |
| void * |
| (*displaytarget_map)( struct sw_winsys *ws, |
| struct sw_displaytarget *dt, |
| unsigned flags ); |
| |
| void |
| (*displaytarget_unmap)( struct sw_winsys *ws, |
| struct sw_displaytarget *dt ); |
| |
| /** |
| * @sa pipe_screen:flush_frontbuffer. |
| * |
| * This call will likely become asynchronous eventually. |
| */ |
| void |
| (*displaytarget_display)( struct sw_winsys *ws, |
| struct sw_displaytarget *dt, |
| void *context_private ); |
| |
| void |
| (*displaytarget_destroy)( struct sw_winsys *ws, |
| struct sw_displaytarget *dt ); |
| }; |
| |
| |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* SW_WINSYS_H */ |