DI-Guy SDK Documentation  13.7.1
bdiGraphicsInitOgl Struct Reference

The initialization structure for the built-in opengl rendering engine. More...

#include <graphics_init_ogl.h>

Public Attributes

int use_textures
 Determines whether textures will be applied. More...
 
int use_materials
 Determines whether materials will be applied. More...
 
GLenum texture_mag_filter
 Determines the OpenGL magnification filtering method for textures. More...
 
GLenum texture_min_filter
 Determines the OpenGL minification filtering method for textures. More...
 
float texture_anisotropic_filter
 Determines the OpenGL anisotropic filtering level for textures. More...
 
int use_FBOs
 Determines whether frame buffer object extensions are used. More...
 
float polygon_offset_factor
 Sets the value passed to the factor argument of the glPolygonOffset() function. More...
 
float polygon_offset_units
 Sets the value passed to the units argument of the glPolygonOffset() function. More...
 
int use_default_fire_weapon_intersection_function
 Sets if a default shooting intersection function should be automatically set up. More...
 
int use_cached_optimized_geometry
 Sets whether .flt and .dae files will be loaded as geometry files optimized for DI-Guy use. More...
 
int use_cached_compressed_textures
 Sets whether compressed texture files should be generated from source uncompressed texture files in order to reduce texture memory usage. More...
 
int use_sRGB_corrected_textures
 Sets whether SRGB textures should be used, these allow a relatively free lookup into texture maps that have been transformed into sRBG space allowing a linear lighting pipeline to be setup. More...
 
int use_4x3_shader_matrices
 Whether matrices that will be used as transforms in shaders should be sent as a 4x3 matrix instead of 4x4. More...
 
int use_shader_instancing
 Whether instancing should be used for rendering. More...
 
int instancing_respect_graphics_state_switch
 Instructs the instancing system to respect the graphics state switch of geometry when constructing instance groups. More...
 
int use_qt_license_dialog
 Instructs the initializing system to pop up a Qt based dialog box for setting up licensing. More...
 

Detailed Description

The initialization structure for the built-in opengl rendering engine.

Link against: libdiguy_graphics_ogl

Member Data Documentation

int bdiGraphicsInitOgl::use_textures

Determines whether textures will be applied.

Default is 1.

int bdiGraphicsInitOgl::use_materials

Determines whether materials will be applied.

Default is 1.

GLenum bdiGraphicsInitOgl::texture_mag_filter

Determines the OpenGL magnification filtering method for textures.

Should be one of:

GL_NEAREST
GL_LINEAR

Default is GL_LINEAR

GLenum bdiGraphicsInitOgl::texture_min_filter

Determines the OpenGL minification filtering method for textures.

Should be one of:

GL_NEAREST
GL_LINEAR
GL_NEAREST_MIPMAP_NEAREST
GL_NEAREST_MIPMAP_LINEAR
GL_LINEAR_MIPMAP_NEAREST
GL_LINEAR_MIPMAP_LINEAR

Default is GL_LINEAR_MIPMAP_LINEAR

float bdiGraphicsInitOgl::texture_anisotropic_filter

Determines the OpenGL anisotropic filtering level for textures.

Should be a power of 2 typically up to 16. Default is 0.0f

int bdiGraphicsInitOgl::use_FBOs

Determines whether frame buffer object extensions are used.

In some cases using frame buffer objects can improve performance of intersection testing.

This currently only has an effect on Win32 platforms.

There is a known problem with some graphics cards that using frame buffer objects leads to a program crash.

Possible values are:

Parameters
0don't use frame buffer object extensions
1do use frame buffer object extensions

Default is 0.

float bdiGraphicsInitOgl::polygon_offset_factor

Sets the value passed to the factor argument of the glPolygonOffset() function.

This function is used when rendering polygon subfaces, which are commonly used for edge highlighting and decals on signs.

Default is -1.0.

float bdiGraphicsInitOgl::polygon_offset_units

Sets the value passed to the units argument of the glPolygonOffset() function.

Default is -1.0.

int bdiGraphicsInitOgl::use_default_fire_weapon_intersection_function

Sets if a default shooting intersection function should be automatically set up.

See diguyScenario::set_default_fire_weapon_intersection_function() for more details.

Default is 1.

int bdiGraphicsInitOgl::use_cached_optimized_geometry

Sets whether .flt and .dae files will be loaded as geometry files optimized for DI-Guy use.

Generated files will be put into a subdirectory of the DI-Guy geometry directory, and will be automatically updated as needed (doesn't exist, or original file is newer).

The .bdg geometry format is a smaller, more efficient version of the geometry data encoded in .flt and .dae files. It is an internal DI-Guy format that is not directly supported by geometry editing programs.

There is no quality trade-off in using optimized geometry files, so it is recommended that they always be enabled.

Default is 1.

int bdiGraphicsInitOgl::use_cached_compressed_textures

Sets whether compressed texture files should be generated from source uncompressed texture files in order to reduce texture memory usage.

There is a quality trade-off when using compressed textures. If there are too many undesired artifacts in the generated textures, they should not be used.

Generated files will be put into a subdirectory of the DI-Guy geometry directory, and will be automatically updated as needed (doesn't exist, or original file is newer).

The compressed texture files will be in the .dds (DirectDraw Surface) format.

Default is 1.

int bdiGraphicsInitOgl::use_sRGB_corrected_textures

Sets whether SRGB textures should be used, these allow a relatively free lookup into texture maps that have been transformed into sRBG space allowing a linear lighting pipeline to be setup.

Default is 1.

int bdiGraphicsInitOgl::use_4x3_shader_matrices

Whether matrices that will be used as transforms in shaders should be sent as a 4x3 matrix instead of 4x4.

This should only be changed if your video card is unable to use 4x4 matrices.

Default is 1.

int bdiGraphicsInitOgl::use_shader_instancing

Whether instancing should be used for rendering.

Default is 0.

int bdiGraphicsInitOgl::instancing_respect_graphics_state_switch

Instructs the instancing system to respect the graphics state switch of geometry when constructing instance groups.

Setting value to 0 while not graphically correct results in increased performance

Default is 1.

int bdiGraphicsInitOgl::use_qt_license_dialog

Instructs the initializing system to pop up a Qt based dialog box for setting up licensing.

Default is 1.


The documentation for this struct was generated from the following file: