/**************************************************************************
 * 
 * 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
 * llvmpipe public interface.
 */


#ifndef LP_WINSYS_H
#define LP_WINSYS_H


#include "pipe/p_compiler.h" // for boolean
#include "pipe/p_format.h"


#ifdef __cplusplus
extern "C" {
#endif


struct pipe_screen;
struct pipe_context;


/**
 * Opaque pointer.
 */
struct llvmpipe_displaytarget;


/**
 * This is the interface that llvmpipe expects any window system
 * hosting it to implement.
 * 
 * llvmpipe is for the most part a self sufficient driver. The only thing it
 * does not know is how to display a surface.
 */
struct llvmpipe_winsys
{
   void 
   (*destroy)( struct llvmpipe_winsys *ws );

   boolean
   (*is_displaytarget_format_supported)( struct llvmpipe_winsys *ws,
                                         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_TEXTURE_USAGE_DISPLAY_TARGET flag to get the underlying 
    * storage.
    */
   struct llvmpipe_displaytarget *
   (*displaytarget_create)( struct llvmpipe_winsys *ws,
                            enum pipe_format format,
                            unsigned width, unsigned height,
                            unsigned alignment,
                            unsigned *stride );

   void *
   (*displaytarget_map)( struct llvmpipe_winsys *ws, 
                         struct llvmpipe_displaytarget *dt,
                         unsigned flags );

   void
   (*displaytarget_unmap)( struct llvmpipe_winsys *ws,
                           struct llvmpipe_displaytarget *dt );

   /**
    * @sa pipe_screen:flush_frontbuffer.
    *
    * This call will likely become asynchronous eventually.
    */
   void
   (*displaytarget_display)( struct llvmpipe_winsys *ws, 
                             struct llvmpipe_displaytarget *dt,
                             void *context_private );

   void 
   (*displaytarget_destroy)( struct llvmpipe_winsys *ws, 
                             struct llvmpipe_displaytarget *dt );
};


struct pipe_context *
llvmpipe_create( struct pipe_screen * );


struct pipe_screen *
llvmpipe_create_screen( struct llvmpipe_winsys * );


#ifdef __cplusplus
}
#endif

#endif /* LP_WINSYS_H */
