DemoGL::Reference::Structures::SStartupDat

SStartupDat

SStartupDat specifies the startup settings as they should be used when DEMOGL_AppRun is called. These settings are overruled by the settings stored in the registry, except when RUNTYPE_NODIALOG is specified.

typedef struct
{
	bool	m_bFullScreen;
	int	m_iResolution;
	bool	m_bDQ32bit;
	bool	m_bTQ32bit;
	bool	m_bSound;
	char	m_sDemoName[DGL_SD_STRINGLENGTH];
	char	m_sReleasedBy[DGL_SD_STRINGLENGTH];
	bool	m_bSaveInRegistry;
	bool	m_bRescaleTextures;
	bool	m_bSS_3DSound;
	int	m_iSS_SoundDevice;
	bool	m_bSS_Stereo;
	bool	m_bSS_16bit;
	bool	m_bSS_LowQuality;
	bool	m_bSS_A3D;
	bool	m_bSS_EAX;
	int	m_iSS_OverallVolume;
} SStartupDat;
Members.
m_bFullScreen
Specifies if the option 'full screen' should be selected (true) or 'windowed' (false).
m_iResolution
Specifies which of the supported resolution should be selected. m_iResolution can be one of the following resolution constants:

Resolution Constant Resolution in pixels
DGL_RES_320x240 320 x 240
DGL_RES_400x300 400 x 300
DGL_RES_512x384 512 x 384
DGL_RES_640x480 640 x 480
DGL_RES_800x600 800 x 600
DGL_RES_960x720 960 x 720
DGL_RES_1024x768 1024 x 768
DGL_RES_1152x864 1152 x 864
DGL_RES_1280x1024 1280 x 1024
DGL_RES_1600x1200 1600 x 1200. Be careful, not all monitors can handle this resolution.
DGL_RES_2048x1536 2048 x 1536. Be careful, not all monitors can handle this resolution.

m_bDQ32bit
Specifies if 32bits per pixel should be used in the color buffer (true) or 16bits per pixel (false).
m_bTQ32bit
Specifies if 32bits per pixel textures should be used (true) or 16bits per pixel textures (false). It's recommended to specify true with m_bTQ32bit, and switch color fragment depth with m_bDQ32bit, because this gives better results due to the better dithering of the overall colorbuffer instead of the already dithered textures.
m_bSound
Specifies if the user can select any sound devices (true) or that sound is disabled and can't be enabled (false).
m_sDemoName
Specifies the name of the application, or better: the application title. Should be terminated with a zero.
m_sReleasedBy
Specifies te name of the producer of the application. Should be terminated with a a zero.
m_bSaveInRegistry
Specifies if the option 'Save settings in registry' should be selected (true) or not (false). Will not have any effect when the RunType is RUNTYPE_NODIALOG.
m_bRescaleTextures
Specifies if the option 'Rescale textures if needed' should be selected (true) or not (false). Depends on the variable DGL_VF_NEVERRESCALETEXTURES, settable with DEMOGL_SetVariable(3), if the setting has any effect.
m_bSS_3DSound
Specifies if 3D sound calculations should be processed on 3D enabled sound channels (true) or not (false).
m_iSS_SoundDevice
Specifies which device should be chosen for sound playback or should be selected in the dropdown list in the startup dialog. m_iSS_SoundDevice is an index, starting with 0, in the SSoundSystemOptionDat structure returned by DEMOGL_SoundSystemDetermineOptionsData. You can specify a prefered device using m_iSS_SoundDevice, or specifiy 0 if you want the user to select the device, you then also don't have to call DEMOGL_SoundSystemDetermineOptionsData because DemoGL will do that for you. When the RunType is RUNTYPE_NODIALOG, m_iSS_SoundDevice should be set to the right device otherwise no sound can be played. You then must call DEMOGL_SoundSystemDetermineOptionsData before using SStartupDat.
m_bSS_Stereo
Specifies if the 'stereo' option should be selected (true) or mono (false).
m_bSS_16bit
Specifies if the '16bit' sound option should be selected (true) or '8bit' (false) sound.
m_bSS_LowQuality
Specifies if the 'Low quality' sound option should be selected (true) or not (false). Low quality will result in 22.1khz output, which saves some CPU power.
m_bSS_A3D
Specifies if the A3D option should be selected (true) or not (false). It depends on the selected device if A3D is used or not.
m_bSS_EAX
Specifies if the EAX option should be selected (true) or not (false). It depends on the selected device if EAX is used or not.
m_iSS_OverallVolume
Specifies the overall volume of the sound output, as is visualized with the slider in the startup dialog. Legal values fall in the range of [0,100], with 0 is total silence and 100 is the current wave output volume as selected in Windows.

Remarks.
Used with DEMOGL_AppRun.

Requirements.
DemoGL v1.3 (build 0112 or higher)

See also.
DEMOGL_AppRun, DEMOGL_SetVariable(3), DEMOGL_SoundSystemDetermineOptionsData, SSoundSystemOptionDat

Last changed on 20-jan-2001

©1999-2001 Solutions Design