XGL Programmer's Guide
  Buscar sólo este libro
Descargar este libro en PDF

Changes to the XGL Library

A

This appendix provides information on the differences between the previous XGL product and the current XGL product. It lists and briefly describes additions, changes, and deletions to the XGL library. For complete information on all XGL operators, attributes, and data structures, see the XGL Reference Manual.

Changed Operators

Table A-1
OperatorDescription
xgl_inquire()Added areturn value to indicate the X extensions supported by the frame buffer. Currently, only a query to the multibuffer extension to X (MBX) is provided.

New Attributes

Table A-2
AttributeDescription
XGL_3D_CTX_SURF_FRONT_TMAP_NUM
XGL_3D_CTX_SURF_BACK_TMAP_NUM
XGL_3D_CTX_SURF_FRONT_TMAP
XGL_3D_CTX_SURF_BACK_TMAP
XGL_3D_CTX_SURF_FRONT_TMAP_SWITCHES
XGL_3D_CTX_SURF_BACK_TMAP_SWITCHES
Context attributes that apply one or more textures
to the front or back of geometric objects. These
attributes specify a list of Texture Map objects,
specify the number of Texture Map objects, and
specify which of the Texture Map objects should
be applied.
XGL_3D_SURF_TMAP_PERSP_CORRECTIONSpecifies the method used to compute texture coordinate values for surface interiors.
XGL_3D_CTX_SURF_LIGHTING_NORMAL_FLIPDefines how surface normals are treated for lighting.
XGL_PCACHE_CONTEXTAssociates a Pcache object with a 2D or 3D Context.
XGL_CTX_PAINT_TYPESets the paint type on a transparent overlay window.
XGL_CTX_NEW_FRAME_PAINT_TYPEDefines the paint type used when an overlay windows is cleared with

xgl_context_new_frame().

XGL_TMAP_DESCRIPTORAssociates the texture descriptor structure with
the Texture Map object.
XGL_TMAP_COORD_SOURCESpecifies the initial source within a primitive's vertex data of the texture coordinate.
XGL_TMAP_DOMAINSpecifies the domain to which the texture is to be applied.
XGL_TMAP_PARAM_TYPEDefines the parameterization method for mapping a texture to a 3D surface.
XGL_TMAP_T0_INDEX
XGL_TMAP_T1_INDEX
When the source of the texture coordinates is the
floating point data, these attributes define the
indices into the vertex data array of the surface
primitives.
Table A-2
AttributeDescription
XGL_WIN_RAS_MULTIBUFFERRequests multibuffering using the MBX extension to X for a Window Raster.
XGL_WIN_RAS_MBUF_DRAWSpecifies the buffer to read and write pixels into when using MBX multibuffering.

Deleted Attributes

Table A-3
AttributeDescription
XGL_CMAP_COLOR_CUBE_RSIZE
XGL_CMAP_COLOR_CUBE_GSIZE
XGL_CMAP_COLOR_CUBE_BSIZE
Deleted.Use the XGL_CMAP_COLOR_CUBE_SIZE
attribute, which contains all three color cube size
values.
XGL_CTX_RENDERINGDeleted. Use XGL_CTX_RENDER_BUFFER.
XGL_CTX_VIEW_MODEL_DATA_TYPEDeleted.
XGL_DEV_PICK_BUFFER_SIZEDeleted.
XGL_LPAT_COORD_SYSDeleted.
XGL_SYS_ST_ERROR_FILE_NAMEDeleted.
XGL_3D_CTX_SURF_FRONT_LIGHT_TYPE
XGL_3D_CTX_SURF_BACK_LIGHT_TYPE
Deleted.

New Data Structures

Table A-4
Data StructureDescription
Xgl_paint_typeAdded new paint type structure for transparent overlay window support.
Xgl_texture_persp_correctionAdded enumerated type to support texture map perspective correction.
Xgl_texture_coord_sourceAdded enumerated type to define the source of the texture coordinates in the primitive's point data.
Xgl_texture_domainAdded enumerated type to define the texture domain.
Xgl_texture_typeAdded enumerated type to define the type of texture mapping.
Xgl_texture_general_mipmap_descAdded new MipMap descriptor structure for the Texture Map object.
Xgl_texture_comp_infoAdded data structure to specify how the texture map is blended with the primitive's data.
Xgl_texture_general_descAdded new texture descriptor structure for the Texture Map object.

Changed Data Structures

Table A-5
Data StructureDescription
Xgl_ctx_new_frame_actionThe value

XGL_CTX_NEW_FRAME_POINT_TYPE_ACTION has been added to

Xgl_ctx_new_frame_action.

Xgl_render_modeThe value XGL_RENDER_NONE has been removed from Xgl_render_mode.
Xgl_texture_boundaryAdded new values to support texture mapping.
Xgl_texture_interp_methodAdded value to support texture mapping.
Xgl_texture_opAdded new values to support texture mapping.
Xgl_texture_color_comp_infoAdded channel information to the color composition method.