Class containing all settings for renderers. More...

#include <RenderSettings.hh>

Inheritance diagram for openmsx::RenderSettings:

Collaboration diagram for openmsx::RenderSettings:

Public Types
enum	RendererID { UNINITIALIZED , DUMMY , SDLGL_PP }
	Enumeration of Renderers known to openMSX. More...

enum	Accuracy { ACC_SCREEN , ACC_LINE , ACC_PIXEL }
	Render accuracy: granularity of the rendered area. More...

enum	ScaleAlgorithm { SCALER_SIMPLE , SCALER_SCALE , SCALER_HQ , SCALER_HQLITE , SCALER_RGBTRIPLET , SCALER_TV , NO_SCALER }
	Scaler algorithm. More...

enum	DisplayDeform { DEFORM_NORMAL , DEFORM_3D }

using	RendererSetting = EnumSetting< RendererID >

Public Member Functions
	RenderSettings (CommandController &commandController)

	~RenderSettings ()

Accuracy	getAccuracy () const
	Accuracy [screen, line, pixel]. More...

BooleanSetting &	getDeinterlaceSetting ()
	Deinterlacing [on, off]. More...

bool	getDeinterlace () const

BooleanSetting &	getDeflickerSetting ()
	Deflicker [on, off]. More...

bool	getDeflicker () const

IntegerSetting &	getMaxFrameSkipSetting ()
	The current max frameskip. More...

int	getMaxFrameSkip () const

IntegerSetting &	getMinFrameSkipSetting ()
	The current min frameskip. More...

int	getMinFrameSkip () const

BooleanSetting &	getFullScreenSetting ()
	Full screen [on, off]. More...

bool	getFullScreen () const

FloatSetting &	getGammaSetting ()
	The amount of gamma correction. More...

float	getGamma () const

FloatSetting &	getBrightnessSetting ()
	Brightness video setting. More...

float	getBrightness () const

FloatSetting &	getContrastSetting ()
	Contrast video setting. More...

float	getContrast () const

StringSetting &	getColorMatrixSetting ()
	Color matrix setting. More...

bool	isColorMatrixIdentity () const
	Returns true iff the current color matrix is the identity matrix. More...

IntegerSetting &	getGlowSetting ()
	The amount of glow [0..100]. More...

int	getGlow () const

FloatSetting &	getNoiseSetting ()
	The amount of noise to add to the frame. More...

float	getNoise () const

IntegerSetting &	getBlurSetting ()
	The amount of horizontal blur [0..256]. More...

int	getBlurFactor () const

IntegerSetting &	getScanlineSetting ()
	The alpha value [0..255] of the gap between scanlines. More...

int	getScanlineFactor () const

float	getScanlineGap () const
	The amount of space [0..1] between scanlines. More...

RendererSetting &	getRendererSetting ()
	The current renderer. More...

RendererID	getRenderer () const

auto &	getScaleAlgorithmSetting ()
	The current scaling algorithm. More...

ScaleAlgorithm	getScaleAlgorithm () const

IntegerSetting &	getScaleFactorSetting ()
	The current scaling factor. More...

int	getScaleFactor () const

BooleanSetting &	getLimitSpritesSetting ()
	Limit number of sprites per line? If true, limit number of sprites per line as real VDP does. More...

BooleanSetting &	getDisableSpritesSetting ()
	Disable sprite rendering? More...

bool	getDisableSprites () const

EnumSetting< bool > &	getCmdTimingSetting ()
	CmdTiming [real, broken]. More...

EnumSetting< bool > &	getTooFastAccessSetting ()
	TooFastAccess [real, ignored]. More...

auto &	getDisplayDeformSetting ()
	Display deformation (normal, 3d). More...

DisplayDeform	getDisplayDeform () const

BooleanSetting &	getVSyncSetting ()
	VSync [on, off]. More...

FloatSetting &	getHorizontalStretchSetting ()
	Amount of horizontal stretch. More...

float	getHorizontalStretch () const

FloatSetting &	getPointerHideDelaySetting ()
	The amount of time until the pointer is hidden in the openMSX window. More...

float	getPointerHideDelay () const

bool	getInterleaveBlackFrame () const
	Is black frame interleaving enabled? More...

float	transformComponent (float c) const
	Apply brightness, contrast and gamma transformation on the input color component. More...

gl::vec3	transformRGB (gl::vec3 rgb) const
	Apply brightness, contrast and gamma transformation on the input color. More...

Detailed Description

Class containing all settings for renderers.

Keeping the settings here makes sure they are preserved when the user switches to another renderer.

Definition at line 22 of file RenderSettings.hh.

Member Typedef Documentation

◆ RendererSetting

using openmsx::RenderSettings::RendererSetting = EnumSetting<RendererID>

Definition at line 29 of file RenderSettings.hh.

Member Enumeration Documentation

◆ Accuracy

enum openmsx::RenderSettings::Accuracy

Render accuracy: granularity of the rendered area.

Enumerator
ACC_SCREEN
ACC_LINE
ACC_PIXEL

Definition at line 33 of file RenderSettings.hh.

◆ DisplayDeform

enum openmsx::RenderSettings::DisplayDeform

Enumerator
DEFORM_NORMAL
DEFORM_3D

Definition at line 43 of file RenderSettings.hh.

◆ RendererID

enum openmsx::RenderSettings::RendererID

Enumeration of Renderers known to openMSX.

This is the full list, the list of available renderers may be smaller.

Enumerator
UNINITIALIZED
DUMMY
SDLGL_PP

Definition at line 28 of file RenderSettings.hh.

◆ ScaleAlgorithm

enum openmsx::RenderSettings::ScaleAlgorithm

Scaler algorithm.

Enumerator
SCALER_SIMPLE
SCALER_SCALE
SCALER_HQ
SCALER_HQLITE
SCALER_RGBTRIPLET
SCALER_TV
NO_SCALER

Definition at line 37 of file RenderSettings.hh.

Constructor & Destructor Documentation

◆ RenderSettings()

openmsx::RenderSettings::RenderSettings ( CommandController & commandController )

explicit

Definition at line 38 of file RenderSettings.cc.

References ACC_SCREEN.

◆ ~RenderSettings()

openmsx::RenderSettings::~RenderSettings ( )

Definition at line 196 of file RenderSettings.cc.

Member Function Documentation

◆ getAccuracy()

Accuracy openmsx::RenderSettings::getAccuracy ( ) const

inline

Accuracy [screen, line, pixel].

Definition at line 51 of file RenderSettings.hh.

References openmsx::EnumSetting< T >::getEnum().

Referenced by openmsx::PixelRenderer::frameStart(), and openmsx::V9990PixelRenderer::frameStart().

◆ getBlurFactor()

int openmsx::RenderSettings::getBlurFactor ( ) const

inline

Definition at line 100 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::GLRGBScaler::scaleImage(), and openmsx::GLSimpleScaler::scaleImage().

◆ getBlurSetting()

IntegerSetting & openmsx::RenderSettings::getBlurSetting ( )

inline

The amount of horizontal blur [0..256].

Definition at line 99 of file RenderSettings.hh.

◆ getBrightness()

float openmsx::RenderSettings::getBrightness ( ) const

inline

Definition at line 79 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

◆ getBrightnessSetting()

FloatSetting & openmsx::RenderSettings::getBrightnessSetting ( )

inline

Brightness video setting.

Definition at line 78 of file RenderSettings.hh.

Referenced by openmsx::SDLRasterizer::SDLRasterizer(), openmsx::V9990SDLRasterizer::V9990SDLRasterizer(), openmsx::SDLRasterizer::~SDLRasterizer(), and openmsx::V9990SDLRasterizer::~V9990SDLRasterizer().

◆ getCmdTimingSetting()

EnumSetting< bool > & openmsx::RenderSettings::getCmdTimingSetting ( )

inline

CmdTiming [real, broken].

This setting is intended for debugging only, not for users.

Definition at line 142 of file RenderSettings.hh.

Referenced by openmsx::V9990CmdEngine::V9990CmdEngine(), and openmsx::V9990CmdEngine::~V9990CmdEngine().

◆ getColorMatrixSetting()

StringSetting & openmsx::RenderSettings::getColorMatrixSetting ( )

inline

Color matrix setting.

Definition at line 86 of file RenderSettings.hh.

Referenced by openmsx::SDLRasterizer::SDLRasterizer(), openmsx::V9990SDLRasterizer::V9990SDLRasterizer(), openmsx::SDLRasterizer::~SDLRasterizer(), and openmsx::V9990SDLRasterizer::~V9990SDLRasterizer().

◆ getContrast()

float openmsx::RenderSettings::getContrast ( ) const

inline

Definition at line 83 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

◆ getContrastSetting()

FloatSetting & openmsx::RenderSettings::getContrastSetting ( )

inline

Contrast video setting.

Definition at line 82 of file RenderSettings.hh.

Referenced by openmsx::SDLRasterizer::SDLRasterizer(), openmsx::V9990SDLRasterizer::V9990SDLRasterizer(), openmsx::SDLRasterizer::~SDLRasterizer(), and openmsx::V9990SDLRasterizer::~V9990SDLRasterizer().

◆ getDeflicker()

bool openmsx::RenderSettings::getDeflicker ( ) const

inline

Definition at line 59 of file RenderSettings.hh.

References openmsx::BooleanSetting::getBoolean().

Referenced by openmsx::PostProcessor::rotateFrames().

◆ getDeflickerSetting()

BooleanSetting & openmsx::RenderSettings::getDeflickerSetting ( )

inline

Deflicker [on, off].

Definition at line 58 of file RenderSettings.hh.

◆ getDeinterlace()

bool openmsx::RenderSettings::getDeinterlace ( ) const

inline

Definition at line 55 of file RenderSettings.hh.

References openmsx::BooleanSetting::getBoolean().

Referenced by openmsx::PixelRenderer::frameEnd(), openmsx::V9990PixelRenderer::frameEnd(), openmsx::PixelRenderer::frameStart(), openmsx::V9990PixelRenderer::frameStart(), and openmsx::PostProcessor::rotateFrames().

◆ getDeinterlaceSetting()

BooleanSetting & openmsx::RenderSettings::getDeinterlaceSetting ( )

inline

Deinterlacing [on, off].

Definition at line 54 of file RenderSettings.hh.

◆ getDisableSprites()

bool openmsx::RenderSettings::getDisableSprites ( ) const

inline

Definition at line 138 of file RenderSettings.hh.

References openmsx::BooleanSetting::getBoolean().

Referenced by openmsx::V9990SDLRasterizer::drawDisplay().

◆ getDisableSpritesSetting()

BooleanSetting & openmsx::RenderSettings::getDisableSpritesSetting ( )

inline

Disable sprite rendering?

Definition at line 137 of file RenderSettings.hh.

◆ getDisplayDeform()

DisplayDeform openmsx::RenderSettings::getDisplayDeform ( ) const

inline

Definition at line 152 of file RenderSettings.hh.

References openmsx::EnumSetting< T >::getEnum().

Referenced by openmsx::PostProcessor::paint().

◆ getDisplayDeformSetting()

auto & openmsx::RenderSettings::getDisplayDeformSetting ( )

inline

Display deformation (normal, 3d).

Definition at line 151 of file RenderSettings.hh.

◆ getFullScreen()

bool openmsx::RenderSettings::getFullScreen ( ) const

inline

Definition at line 71 of file RenderSettings.hh.

References openmsx::BooleanSetting::getBoolean().

Referenced by openmsx::VisibleSurface::resize().

◆ getFullScreenSetting()

BooleanSetting & openmsx::RenderSettings::getFullScreenSetting ( )

inline

Full screen [on, off].

Definition at line 70 of file RenderSettings.hh.

Referenced by openmsx::SDLVideoSystem::SDLVideoSystem(), and openmsx::SDLVideoSystem::~SDLVideoSystem().

◆ getGamma()

float openmsx::RenderSettings::getGamma ( ) const

inline

Definition at line 75 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

◆ getGammaSetting()

FloatSetting & openmsx::RenderSettings::getGammaSetting ( )

inline

The amount of gamma correction.

Definition at line 74 of file RenderSettings.hh.

Referenced by openmsx::SDLRasterizer::SDLRasterizer(), openmsx::V9990SDLRasterizer::V9990SDLRasterizer(), openmsx::SDLRasterizer::~SDLRasterizer(), and openmsx::V9990SDLRasterizer::~V9990SDLRasterizer().

◆ getGlow()

int openmsx::RenderSettings::getGlow ( ) const

inline

Definition at line 92 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::PostProcessor::paint().

◆ getGlowSetting()

IntegerSetting & openmsx::RenderSettings::getGlowSetting ( )

inline

The amount of glow [0..100].

Definition at line 91 of file RenderSettings.hh.

◆ getHorizontalStretch()

float openmsx::RenderSettings::getHorizontalStretch ( ) const

inline

Definition at line 163 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

Referenced by openmsx::PostProcessor::paint(), and openmsx::PostProcessor::PostProcessor().

◆ getHorizontalStretchSetting()

FloatSetting & openmsx::RenderSettings::getHorizontalStretchSetting ( )

inline

Amount of horizontal stretch.

This number represents the amount of MSX pixels (normal width) that will be stretched to the complete width of the host window.

Definition at line 160 of file RenderSettings.hh.

Referenced by openmsx::PostProcessor::PostProcessor(), and openmsx::PostProcessor::~PostProcessor().

◆ getInterleaveBlackFrame()

bool openmsx::RenderSettings::getInterleaveBlackFrame ( ) const

inline

Is black frame interleaving enabled?

Definition at line 177 of file RenderSettings.hh.

References openmsx::BooleanSetting::getBoolean().

Referenced by openmsx::PostProcessor::paint(), and openmsx::PostProcessor::rotateFrames().

◆ getLimitSpritesSetting()

BooleanSetting & openmsx::RenderSettings::getLimitSpritesSetting ( )

inline

Limit number of sprites per line? If true, limit number of sprites per line as real VDP does.

If false, display all sprites. For accurate emulation, this setting should be on. Turning it off can improve games with a lot of flashing sprites, such as Aleste.

Definition at line 134 of file RenderSettings.hh.

◆ getMaxFrameSkip()

int openmsx::RenderSettings::getMaxFrameSkip ( ) const

inline

Definition at line 63 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::PixelRenderer::frameStart(), and openmsx::V9990PixelRenderer::frameStart().

◆ getMaxFrameSkipSetting()

IntegerSetting & openmsx::RenderSettings::getMaxFrameSkipSetting ( )

inline

The current max frameskip.

Definition at line 62 of file RenderSettings.hh.

Referenced by openmsx::PixelRenderer::PixelRenderer(), openmsx::V9990PixelRenderer::V9990PixelRenderer(), openmsx::PixelRenderer::~PixelRenderer(), and openmsx::V9990PixelRenderer::~V9990PixelRenderer().

◆ getMinFrameSkip()

int openmsx::RenderSettings::getMinFrameSkip ( ) const

inline

Definition at line 67 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::PixelRenderer::frameStart(), and openmsx::V9990PixelRenderer::frameStart().

◆ getMinFrameSkipSetting()

IntegerSetting & openmsx::RenderSettings::getMinFrameSkipSetting ( )

inline

The current min frameskip.

Definition at line 66 of file RenderSettings.hh.

Referenced by openmsx::PixelRenderer::PixelRenderer(), openmsx::V9990PixelRenderer::V9990PixelRenderer(), openmsx::PixelRenderer::~PixelRenderer(), and openmsx::V9990PixelRenderer::~V9990PixelRenderer().

◆ getNoise()

float openmsx::RenderSettings::getNoise ( ) const

inline

Definition at line 96 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

Referenced by openmsx::PostProcessor::PostProcessor().

◆ getNoiseSetting()

FloatSetting & openmsx::RenderSettings::getNoiseSetting ( )

inline

The amount of noise to add to the frame.

Definition at line 95 of file RenderSettings.hh.

Referenced by openmsx::PostProcessor::PostProcessor(), and openmsx::PostProcessor::~PostProcessor().

◆ getPointerHideDelay()

float openmsx::RenderSettings::getPointerHideDelay ( ) const

inline

Definition at line 172 of file RenderSettings.hh.

References openmsx::FloatSetting::getFloat().

◆ getPointerHideDelaySetting()

FloatSetting & openmsx::RenderSettings::getPointerHideDelaySetting ( )

inline

The amount of time until the pointer is hidden in the openMSX window.

negative means: no hiding, 0 means immediately.

Definition at line 169 of file RenderSettings.hh.

◆ getRenderer()

RendererID openmsx::RenderSettings::getRenderer ( ) const

inline

Definition at line 116 of file RenderSettings.hh.

References openmsx::EnumSetting< T >::getEnum().

Referenced by openmsx::SDLVideoSystem::createLDRasterizer(), openmsx::RendererFactory::createLDRenderer(), openmsx::SDLVideoSystem::createRasterizer(), openmsx::RendererFactory::createRenderer(), openmsx::SDLVideoSystem::createV9990Rasterizer(), openmsx::RendererFactory::createV9990Renderer(), openmsx::Display::createVideoSystem(), and openmsx::RendererFactory::createVideoSystem().

◆ getRendererSetting()

RendererSetting & openmsx::RenderSettings::getRendererSetting ( )

inline

The current renderer.

Definition at line 115 of file RenderSettings.hh.

Referenced by openmsx::Display::Display(), and openmsx::Display::~Display().

◆ getScaleAlgorithm()

ScaleAlgorithm openmsx::RenderSettings::getScaleAlgorithm ( ) const

inline

Definition at line 120 of file RenderSettings.hh.

References openmsx::EnumSetting< T >::getEnum().

Referenced by openmsx::GLScalerFactory::createScaler(), and openmsx::PostProcessor::paint().

◆ getScaleAlgorithmSetting()

auto & openmsx::RenderSettings::getScaleAlgorithmSetting ( )

inline

The current scaling algorithm.

Definition at line 119 of file RenderSettings.hh.

◆ getScaleFactor()

int openmsx::RenderSettings::getScaleFactor ( ) const

inline

Definition at line 126 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

◆ getScaleFactorSetting()

IntegerSetting & openmsx::RenderSettings::getScaleFactorSetting ( )

inline

The current scaling factor.

Definition at line 125 of file RenderSettings.hh.

Referenced by openmsx::SDLVideoSystem::SDLVideoSystem(), and openmsx::SDLVideoSystem::~SDLVideoSystem().

◆ getScanlineFactor()

int openmsx::RenderSettings::getScanlineFactor ( ) const

inline

Definition at line 106 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::GLRGBScaler::scaleImage(), and openmsx::GLSimpleScaler::scaleImage().

◆ getScanlineGap()

float openmsx::RenderSettings::getScanlineGap ( ) const

inline

The amount of space [0..1] between scanlines.

Definition at line 110 of file RenderSettings.hh.

References openmsx::IntegerSetting::getInt().

Referenced by openmsx::GLTVScaler::scaleImage().

◆ getScanlineSetting()

IntegerSetting & openmsx::RenderSettings::getScanlineSetting ( )

inline

The alpha value [0..255] of the gap between scanlines.

Definition at line 105 of file RenderSettings.hh.

◆ getTooFastAccessSetting()

EnumSetting< bool > & openmsx::RenderSettings::getTooFastAccessSetting ( )

inline

TooFastAccess [real, ignored].

Indicates whether too fast VDP VRAM access should be correctly emulated (= some accesses are dropped) or ignored (= all accesses are correctly executed).

Definition at line 148 of file RenderSettings.hh.

◆ getVSyncSetting()

BooleanSetting & openmsx::RenderSettings::getVSyncSetting ( )

inline

VSync [on, off].

Definition at line 155 of file RenderSettings.hh.

Referenced by openmsx::VisibleSurface::~VisibleSurface().

◆ isColorMatrixIdentity()

bool openmsx::RenderSettings::isColorMatrixIdentity ( ) const

inline

Returns true iff the current color matrix is the identity matrix.

Definition at line 88 of file RenderSettings.hh.

Referenced by openmsx::V9990SDLRasterizer::preCalcPalettes().

◆ transformComponent()

float openmsx::RenderSettings::transformComponent ( float c ) const

Apply brightness, contrast and gamma transformation on the input color component.

The component is expected to be in the range [0.0 .. 1.0] but it's not an error if it lays outside of this range. The return value is guaranteed to lay inside this range. This method skips the cross-influence of color components on each other that is controlled by the "color_matrix" setting.

Definition at line 226 of file RenderSettings.cc.

Referenced by openmsx::V9990SDLRasterizer::preCalcPalettes().

◆ transformRGB()

vec3 openmsx::RenderSettings::transformRGB ( gl::vec3 rgb ) const

Apply brightness, contrast and gamma transformation on the input color.

The R, G and B component are expected to be in the range [0.0 .. 1.0] but it's not an error if a component lays outside of this range. After transformation it's guaranteed all components lay inside this range.

Definition at line 232 of file RenderSettings.cc.

References g.

Referenced by openmsx::V9990SDLRasterizer::preCalcPalettes().

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ RendererSetting

Member Enumeration Documentation

◆ Accuracy

◆ DisplayDeform

◆ RendererID

◆ ScaleAlgorithm

Constructor & Destructor Documentation

◆ RenderSettings()

◆ ~RenderSettings()

Member Function Documentation

◆ getAccuracy()

◆ getBlurFactor()

◆ getBlurSetting()

◆ getBrightness()

◆ getBrightnessSetting()

◆ getCmdTimingSetting()

◆ getColorMatrixSetting()

◆ getContrast()

◆ getContrastSetting()

◆ getDeflicker()

◆ getDeflickerSetting()

◆ getDeinterlace()

◆ getDeinterlaceSetting()

◆ getDisableSprites()

◆ getDisableSpritesSetting()

◆ getDisplayDeform()

◆ getDisplayDeformSetting()

◆ getFullScreen()

◆ getFullScreenSetting()

◆ getGamma()

◆ getGammaSetting()

◆ getGlow()

◆ getGlowSetting()

◆ getHorizontalStretch()

◆ getHorizontalStretchSetting()

◆ getInterleaveBlackFrame()

◆ getLimitSpritesSetting()

◆ getMaxFrameSkip()

◆ getMaxFrameSkipSetting()

◆ getMinFrameSkip()

◆ getMinFrameSkipSetting()

◆ getNoise()

◆ getNoiseSetting()

◆ getPointerHideDelay()

◆ getPointerHideDelaySetting()

◆ getRenderer()

◆ getRendererSetting()

◆ getScaleAlgorithm()

◆ getScaleAlgorithmSetting()

◆ getScaleFactor()

◆ getScaleFactorSetting()

◆ getScanlineFactor()

◆ getScanlineGap()

◆ getScanlineSetting()

◆ getTooFastAccessSetting()

◆ getVSyncSetting()

◆ isColorMatrixIdentity()

◆ transformComponent()

◆ transformRGB()