mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2025-01-22 13:43:48 +08:00
257 lines
7.6 KiB
C
257 lines
7.6 KiB
C
/* $Id: osmesa.h,v 1.1 1999/08/19 00:55:40 jtg Exp $ */
|
|
|
|
/*
|
|
* Mesa 3-D graphics library
|
|
* Version: 3.1
|
|
*
|
|
* Copyright (C) 1999 Brian Paul 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, 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 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
|
|
* BRIAN PAUL 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.
|
|
*/
|
|
|
|
|
|
/*
|
|
* $Log: osmesa.h,v $
|
|
* Revision 1.1 1999/08/19 00:55:40 jtg
|
|
* Initial revision
|
|
*
|
|
* Revision 1.4 1999/02/14 03:39:09 brianp
|
|
* new copyright
|
|
*
|
|
* Revision 1.3 1999/01/03 02:52:30 brianp
|
|
* now using GLAPI and GLAPIENTRY keywords (Ted Jump)
|
|
*
|
|
* Revision 1.2 1998/07/26 01:33:51 brianp
|
|
* added WINGDIAPI and APIENTRY keywords per Ted Jump
|
|
*
|
|
* Revision 1.1 1998/02/13 03:17:50 brianp
|
|
* Initial revision
|
|
*
|
|
*/
|
|
|
|
|
|
/*
|
|
* Mesa Off-Screen rendering interface.
|
|
*
|
|
* This is an operating system and window system independent interface to
|
|
* Mesa which allows one to render images into a client-supplied buffer in
|
|
* main memory. Such images may manipulated or saved in whatever way the
|
|
* client wants.
|
|
*
|
|
* These are the API functions:
|
|
* OSMesaCreateContext - create a new Off-Screen Mesa rendering context
|
|
* OSMesaMakeCurrent - bind an OSMesaContext to a client's image buffer
|
|
* and make the specified context the current one.
|
|
* OSMesaDestroyContext - destroy an OSMesaContext
|
|
* OSMesaGetCurrentContext - return thread's current context ID
|
|
* OSMesaPixelStore - controls how pixels are stored in image buffer
|
|
* OSMesaGetIntegerv - return OSMesa state parameters
|
|
*
|
|
*
|
|
* The limits on the width and height of an image buffer are MAX_WIDTH and
|
|
* MAX_HEIGHT as defined in Mesa/src/config.h. Defaults are 1280 and 1024.
|
|
* You can increase them as needed but beware that many temporary arrays in
|
|
* Mesa are dimensioned by MAX_WIDTH or MAX_HEIGHT.
|
|
*/
|
|
|
|
|
|
|
|
#ifndef OSMESA_H
|
|
#define OSMESA_H
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
#include "GL/gl.h"
|
|
|
|
|
|
|
|
#define OSMESA_MAJOR_VERSION 3
|
|
#define OSMESA_MINOR_VERSION 0
|
|
|
|
|
|
|
|
/*
|
|
* Values for the format parameter of OSMesaCreateContext()
|
|
* New in version 2.0.
|
|
*/
|
|
#define OSMESA_COLOR_INDEX GL_COLOR_INDEX
|
|
#define OSMESA_RGBA GL_RGBA
|
|
#define OSMESA_BGRA 0x1
|
|
#define OSMESA_ARGB 0x2
|
|
#define OSMESA_RGB GL_RGB
|
|
#define OSMESA_BGR 0x4
|
|
|
|
|
|
/*
|
|
* OSMesaPixelStore() parameters:
|
|
* New in version 2.0.
|
|
*/
|
|
#define OSMESA_ROW_LENGTH 0x10
|
|
#define OSMESA_Y_UP 0x11
|
|
|
|
|
|
/*
|
|
* Accepted by OSMesaGetIntegerv:
|
|
*/
|
|
#define OSMESA_WIDTH 0x20
|
|
#define OSMESA_HEIGHT 0x21
|
|
#define OSMESA_FORMAT 0x22
|
|
#define OSMESA_TYPE 0x23
|
|
|
|
|
|
|
|
typedef struct osmesa_context *OSMesaContext;
|
|
|
|
|
|
#if defined(__BEOS__) || defined(__QUICKDRAW__)
|
|
#pragma export on
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Create an Off-Screen Mesa rendering context. The only attribute needed is
|
|
* an RGBA vs Color-Index mode flag.
|
|
*
|
|
* Input: format - one of OSMESA_COLOR_INDEX, OSMESA_RGBA, OSMESA_BGRA,
|
|
* OSMESA_ARGB, OSMESA_RGB, or OSMESA_BGR.
|
|
* sharelist - specifies another OSMesaContext with which to share
|
|
* display lists. NULL indicates no sharing.
|
|
* Return: an OSMesaContext or 0 if error
|
|
*/
|
|
GLAPI OSMesaContext GLAPIENTRY OSMesaCreateContext( GLenum format,
|
|
OSMesaContext sharelist );
|
|
|
|
|
|
|
|
|
|
/*
|
|
* Destroy an Off-Screen Mesa rendering context.
|
|
*
|
|
* Input: ctx - the context to destroy
|
|
*/
|
|
GLAPI void GLAPIENTRY OSMesaDestroyContext( OSMesaContext ctx );
|
|
|
|
|
|
|
|
/*
|
|
* Bind an OSMesaContext to an image buffer. The image buffer is just a
|
|
* block of memory which the client provides. Its size must be at least
|
|
* as large as width*height*sizeof(type). Its address should be a multiple
|
|
* of 4 if using RGBA mode.
|
|
*
|
|
* Image data is stored in the order of glDrawPixels: row-major order
|
|
* with the lower-left image pixel stored in the first array position
|
|
* (ie. bottom-to-top).
|
|
*
|
|
* Since the only type initially supported is GL_UNSIGNED_BYTE, if the
|
|
* context is in RGBA mode, each pixel will be stored as a 4-byte RGBA
|
|
* value. If the context is in color indexed mode, each pixel will be
|
|
* stored as a 1-byte value.
|
|
*
|
|
* If the context's viewport hasn't been initialized yet, it will now be
|
|
* initialized to (0,0,width,height).
|
|
*
|
|
* Input: ctx - the rendering context
|
|
* buffer - the image buffer memory
|
|
* type - data type for pixel components, only GL_UNSIGNED_BYTE
|
|
* supported now
|
|
* width, height - size of image buffer in pixels, at least 1
|
|
* Return: GL_TRUE if success, GL_FALSE if error because of invalid ctx,
|
|
* invalid buffer address, type!=GL_UNSIGNED_BYTE, width<1, height<1,
|
|
* width>internal limit or height>internal limit.
|
|
*/
|
|
GLAPI GLboolean GLAPIENTRY OSMesaMakeCurrent( OSMesaContext ctx,
|
|
void *buffer, GLenum type,
|
|
GLsizei width, GLsizei height );
|
|
|
|
|
|
|
|
|
|
/*
|
|
* Return the current Off-Screen Mesa rendering context handle.
|
|
*/
|
|
GLAPI OSMesaContext GLAPIENTRY OSMesaGetCurrentContext( void );
|
|
|
|
|
|
|
|
/*
|
|
* Set pixel store/packing parameters for the current context.
|
|
* This is similar to glPixelStore.
|
|
* Input: pname - OSMESA_ROW_LENGTH
|
|
* specify actual pixels per row in image buffer
|
|
* 0 = same as image width (default)
|
|
* OSMESA_Y_UP
|
|
* zero = Y coordinates increase downward
|
|
* non-zero = Y coordinates increase upward (default)
|
|
* value - the value for the parameter pname
|
|
*
|
|
* New in version 2.0.
|
|
*/
|
|
GLAPI void GLAPIENTRY OSMesaPixelStore( GLint pname, GLint value );
|
|
|
|
|
|
|
|
/*
|
|
* Return context info. This is like glGetIntegerv.
|
|
* Input: pname -
|
|
* OSMESA_WIDTH return current image width
|
|
* OSMESA_HEIGHT return current image height
|
|
* OSMESA_FORMAT return image format
|
|
* OSMESA_TYPE return color component data type
|
|
* OSMESA_ROW_LENGTH return row length in pixels
|
|
* OSMESA_Y_UP returns 1 or 0 to indicate Y axis direction
|
|
* value - pointer to integer in which to return result.
|
|
*/
|
|
GLAPI void GLAPIENTRY OSMesaGetIntegerv( GLint pname, GLint *value );
|
|
|
|
|
|
|
|
/*
|
|
* Return the depth buffer associated with an OSMesa context.
|
|
* Input: c - the OSMesa context
|
|
* Output: width, height - size of buffer in pixels
|
|
* bytesPerValue - bytes per depth value (2 or 4)
|
|
* buffer - pointer to depth buffer values
|
|
* Return: GL_TRUE or GL_FALSE to indicate success or failure.
|
|
*
|
|
* New in Mesa 2.4.
|
|
*/
|
|
GLAPI GLboolean GLAPIENTRY OSMesaGetDepthBuffer( OSMesaContext c,
|
|
GLint *width, GLint *height,
|
|
GLint *bytesPerValue, void **buffer );
|
|
|
|
|
|
|
|
|
|
#if defined(__BEOS__) || defined(__QUICKDRAW__)
|
|
#pragma export off
|
|
#endif
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif
|