DxGetStatus: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 14: Line 14:
*'''VideoCardRAM :''' The installed memory in MB of the graphics card.
*'''VideoCardRAM :''' The installed memory in MB of the graphics card.
*'''VideoCardPSVersion :''' The maximum pixel shader version of the graphics card.
*'''VideoCardPSVersion :''' The maximum pixel shader version of the graphics card.
{{New feature/item|4.0141|1.4.1|7310|
*'''VideoCardNumRenderTargets:''' The maximum number of simultaneous render targets a shader can use.
}}
*'''VideoMemoryFreeForMTA :''' The amount of memory in MB available for MTA to use. '''When this gets to zero, [[guiCreateFont]], [[dxCreateFont]] and [[dxCreateRenderTarget]] will fail.'''
*'''VideoMemoryFreeForMTA :''' The amount of memory in MB available for MTA to use. '''When this gets to zero, [[guiCreateFont]], [[dxCreateFont]] and [[dxCreateRenderTarget]] will fail.'''
*'''VideoMemoryUsedByFonts :''' The amount of graphic memory in MB used by custom fonts.
*'''VideoMemoryUsedByFonts :''' The amount of graphic memory in MB used by custom fonts.
Line 36: Line 39:
*'''SettingFOV:''' The FOV setting
*'''SettingFOV:''' The FOV setting
}}
}}
==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 55: Line 57:
{{ChangelogItem|1.3.4-9.05731|Added SettingHUDMatchAspectRatio and SettingAspectRatio}}
{{ChangelogItem|1.3.4-9.05731|Added SettingHUDMatchAspectRatio and SettingAspectRatio}}
{{ChangelogItem|1.4.1-9.07181|Added SettingFOV}}
{{ChangelogItem|1.4.1-9.07181|Added SettingFOV}}
{{ChangelogItem|1.4.1-9.07310|Added VideoCardNumRenderTargets}}


==See Also==
==See Also==
{{Drawing_functions}}
{{Drawing_functions}}

Revision as of 02:47, 22 June 2015

This function gets information about various internal datum

Syntax

table dxGetStatus ( )

Returns

Returns a table with the following entries:

  • TestMode : The current dx test mode. See dxSetTestMode.
  • VideoCardName : The name of the graphics card.
  • VideoCardRAM : The installed memory in MB of the graphics card.
  • VideoCardPSVersion : The maximum pixel shader version of the graphics card.
ADDED/UPDATED IN VERSION 1.4.1 r7310:
  • VideoCardNumRenderTargets: The maximum number of simultaneous render targets a shader can use.
  • VideoMemoryFreeForMTA : The amount of memory in MB available for MTA to use. When this gets to zero, guiCreateFont, dxCreateFont and dxCreateRenderTarget will fail.
  • VideoMemoryUsedByFonts : The amount of graphic memory in MB used by custom fonts.
  • VideoMemoryUsedByTextures : The amount of graphic memory in MB used by textures.
  • VideoMemoryUsedByRenderTargets : The amount of graphic memory in MB used by render targets.
  • SettingWindowed : The windowed setting. (true/false)
  • SettingFXQuality : The FX Quality. (0-3)
  • SettingDrawDistance : The draw distance setting. (0-100)
  • SettingVolumetricShadows : The volumetric shadows setting. (true/false)
  • SettingStreamingVideoMemoryForGTA : The usable graphics memory setting. (64-256)
  • AllowScreenUpload : The allows screen uploads setting. (true/false)
  • DepthBufferFormat: The format of the shader readable depth buffer, or 'unknown' if not available
  • VideoCardMaxAnisotropy: The maximum anisotropic filtering available. (0-4 which respectively mean: off,2x,4x,8x,16x)
  • SettingAnisotropicFiltering: The anisotropic filtering setting. (0-4 which respectively mean: off,2x,4x,8x,16x)
  • SettingAntiAliasing: The anti-aliasing setting. (0-3 which respectively mean: off,1x,2x,3x)
  • SettingHeatHaze: The heat haze setting. (true/false)
  • SettingGrassEffect: The grass effect setting. (true/false)
  • Setting32BitColor: The color depth of the screen. (false is 16bit, true is 32bit)
  • SettingHUDMatchAspectRatio: The hud match aspect ratio setting (true/false)
  • SettingAspectRatio: The aspect ratio setting ("auto", "4:3", "16:10", "16:9")
ADDED/UPDATED IN VERSION 1.4.1 r7181:
  • SettingFOV: The FOV setting

Example

addCommandHandler( "getinfo",
	function( )
		local info = dxGetStatus( )
		for k, v in pairs( info ) do
			outputChatBox( k .. " : " .. tostring( v ) )
		end
	end
)

Changelog

Version Description
1.3.0-9.04715 Added DepthBufferFormat argument
1.3.0-9.04811 Added VideoCardMaxAnisotropy, SettingAnisotropicFiltering, SettingAntiAliasing,
SettingHeatHaze, SettingGrassEffect and Setting32BitColor arguments
1.3.4-9.05731 Added SettingHUDMatchAspectRatio and SettingAspectRatio
1.4.1-9.07181 Added SettingFOV
1.4.1-9.07310 Added VideoCardNumRenderTargets

See Also