View Single Post
Old 15th February 2015, 05:00   #1  |  Link
Asmodian
Registered User
 
Join Date: Feb 2002
Location: San Jose, California
Posts: 4,406
madVR Options Explained

Current as of madVR v0.92.17

Please ask questions or offer corrections and suggestions. Thanks.

devices

device name: [EDID Product Name] A name for the display (customizable).
device type: [unknown] Sets the icon for the display. When set to projector the 'screen config' section is available.

identification
EDID information, some displays are detected with different identifications depending on how they are attached or detected. You can drag and drop these identification entries to combine displays.

properties

the display expects the following RGB output levels: [PC levels (0-255)] This is what your display expects to receive. 'PC levels (0-255)' means “use a 16-235 YCbCr to 0-255 RGB conversion matrix” and 'TV levels (16-235)' means “use a 0-255 YCbCr to 0-255 RGB conversion matrix”. If the source is flagged full range either a 0-255 YCbCr to 0-255 RGB or a 0-255 YCbCr to 16-235 RGB conversion matrix is used instead.
the native display bitdepth is: [8 bit] This is the bit depth madVR will dither to. madVR offers very high quality dithering so if you are using a low bit depth display (e.g. a 6-bit TN) you may get better quality when setting this to 6-bit. Due to limited support for high bit depths, madVR dithers to 8-bit even when this is set to 9 or 10-bit except when using D3D11 'full screen exclusive' (or D3D11 fullscreen windowed in Windows 10 with AMD or Nvidia GPUs). It can be interesting to turn this down to a very low value (2-4) while testing the dithering options but make sure to have the 'trade quality for performance' option 'don’t use linear light for dithering' unchecked even if you leave it checked for normal use.
3D format: [auto, disabled] Set the 3D format to: auto, side-by-side, top-and-bottom, row alternative, or column alternative. There is also an option to swap the left and right eyes.

calibration [disable calibration controls for this display]

disable calibration controls for this display: The display is assumed to have a BT.709 gamut with a pure power gamma of 2.2 (probably). If outputting HDR madVR assumes the display is expecting BT.2020 with the PQ transfer function.
this display is already calibrated: [BT.709, pure power curve, 2.20] This sets the current display characteristics. The gamut option affects the conversions used by madVR when playing video with different gamuts. The gamma options only have an effect when using 'tone map HDR using pixel shaders' for HDR content or when using the 'enable gamma processing' option in 'color & gamma'.
calibrate this display by using yCMS: yCMS offers a simple gamut and gamma calibration method. It requires a few measurements of the display that can be done with HCFR. If gamut or grayscale measurements are not supplied only the other correction is performed. Usually bad results (mostly banding and odd effects in shadows) are obtained if gamma measurements below ~20% IRE are used so only enter values above 15-30% IRE.
calibrate this display by using external 3DLUT files: Use a calibration package such as Argyllcms, Calman, or LightSpace to generate a 256x256x256 3DLUT to perform a full calibration. For Argyllcms see this AVS Forum thread, for Calman, or for LightSpace. If the provided 3DLUT file contains calibration curves (e.g. in the case of ArgyllCMS, the collink "-a" or "-H" options were used), madVR will load the calibration curves into the system-wide GPU hardware gamma ramps, which affects everything displayed, not only madVR. madVR will restore the original gamma ramps (if any) when it is closed.
disable GPU gamma ramps: [Disabled] Clears system-wide GPU gamma ramps (monitor calibration), if any, replacing them with linear (no-op) curves. This affects everything displayed, not only madVR. madVR will restore the original GPU gamma ramps (if any) when it is closed. This option changes its behavior when using the 'rendering -> general settings' option 'enable windowed overlay' to only apply to madVR because madVR is emulating the gamma ramps in that case. This option has no effect if a 3DLUT file that contains calibration curves is loaded (see above).

display modes [None]
Allows setting refresh rate and resolution automatically depending on the source video.
list all display modes madVR may switch to: An example for a modern 4K display: 2160p23, 2160p24, 2160p25, 2160p29, 2160p30, 2160p50, 2160p59, 2160p60
treat 25p movies as 24p (requires Reclock or VideoClock): [Disabled] Uses 24 Hz modes to display 25 fps content, it requires Reclock or VideoClock to slow down the audio to match.
hack Direct3D to make 24.000Hz and 60.000Hz work: [Disabled] A hack to Direct3D that enables true 24 and 60 Hz display modes in Windows 8.1 or 10 which are usually locked to 23.976 Hz and 59.940 Hz. May cause presentation queues to not fill.

custom modes
A second tab in display modes. Allows configuring custom refresh rates and can assist in optimizing them for the purpose of avoiding dropped or repeated frames without frame blending (smooth motion) or resampling the audio (ReClock, VideoClock). Only custom timings can be optimized but simply editing a mode and applying the "EDID / CTA" timing parameters creates a custom mode, and is the recommended way to start optimizing a refresh rate. New timing parameters must be tested before they can be applied. Delete replaces the add button when selecting a custom mode. It uses each of GPU vendor's private APIs to add these modes and does not work with EDID override methods like CRU; supports AMD, Intel, and Nvidia GPUs. With Nvidia these custom modes can only be set to 8-bit.

color & gamma [Disabled]

pure power curve: [Default] use the standard pure power gamma function
BT.709/601 curve: Use the inverse of a meant for camera gamma function. It has a linear section near black so shadows lighten faster as you move away from black. This can be helpful if your display has crushed shadows.
2.20, 2.40, etc.: [2.20] changes the display's gamma, based on the display's settings in 'calibration', to this target gamma. Lower brightens mid range values which can be nice in a brightly lit room. Higher darkens mid range values which might look better in a darker room.

hdr [let madVR decide]

let madVR decide: Sends HDR data to displays capable of HDR, otherwise coverts to SDR using pixel shader math.
passthrough HDR to display: Passes the HDR video to the display as is, along with the metadata if 'send HDR metadata to the display' is enabled.
tone map HDR using pixel shaders: Enables the options below-
-target peak nits: [200] Set the target display's peak white brightness. Above this value is used as the highlights. A lower setting increases the brightness of mid range values.
-tone mapping curve: [BT.2390] The curve used when compressing the range.
-color tweaks for fire & explosions:: [balanced] Keeps the color approximately the same while de-saturating and/or reducing luminance to bring a pixel to a value the display can represent.
-highlight recovery strength: [None] Sharpening the highlights after range compression.
-measure each frame's peak luminance: [Disabled] Allows madVR to only compress highlights as much as necessary on a per frame basis resulting in more detail in highlights.
-output video in HDR format: [Disabled] Add HDR metadata to the output video.
convert or process HDR content by using an external 3DLUT: Requires display calibration hardware and software. Possible with DisplayCal (Argyllcms) or Lightspace.

screen config [Disabled]
This section is hidden unless the device is set as a projector.

define visible screen area by cropping masked borders: Allows scaling to a smaller resolution and adding black pixels to the edges. Useful if the projector is overshooting the edges of the screen. Only active when full screen.
activate lens memory number: Sends a command to a JVC or Sony projector to activate an on-projector lens memory number.
anamorphic lens: Allows output to non-square pixels.

processing

deinterlacing

if in doubt, activate deinterlacing: [Disabled] deinterlace video not flagged as progressive
if in doubt, deactivate deinterlacing: [Enabled] deinterlace video flagged as interlaced
force film mode: [Disabled] force IVTC, reconstructing the original progressive frames from video encoded as interlaced, decimating duplicate frames if necessary. madVR's IVTC is not functional when using DXVA2 or D3D11 native GPU decoding because madVR's IVTC algorithm runs on the CPU and the decoded video data is never copied to system memory.
force video mode: [Disabled]force DXVA deinterlacing, uses the GPU's native deinterlacing. This is the same as automatic and cannot decimate frames.
only look at pixels in the frame center: [Enabled] As described; good for broadcast (with its messy edges) but bad for Anime.

artifact removal

reduce banding artifacts: [Disabled, low/high] Fade detection does not run if both options are set to the same value for a small increase in performance. Five frames are removed from madVR's rendering buffer every time a fade is detected if the trade quality for performance option 'don't rerender frames when fade in/out is detected' is disabled.
reduce ringing artifacts: [Disabled] Attempts to reduce any ringing/halos present in the source caused by downscaling or sharpening before madVR, e.g. during mastering.
reduce compression artifacts: [Disabled] A deblocking and deringing algorithm. high quality is more significant at higher strengths and is much slower. Chroma often has artifacts but they are usually less obvious and it takes a lot of power to process the chroma channels too.
activate only if it comes for free (as part of NGU): [Disabled] Only runs RCA if it can be run as part of NGU image upscaling. Requires NGU Sharp high for medium quality and NGU Sharp very high for high quality.
reduce random noise: [Disabled] A denoising or grain reduction algorithm. Chroma often has less random noise than the luma.

image enhancements [Disabled]
These are applied before scaling. See 'upscaling refinement'

zoom control

disable scaling if image size changes by only: [Enabled, ... 2 lines or less] If the resolution needs scaling by the number of pixels set or less no image scaling is done, black pixels are added to the right and/or bottom edge instead.
move subtitles: [Enabled, ... to bottom of the screen/window] Move subtitles, this is important when removing black bars or subtitles can be displayed outside the visible screen area. Cannot move PGS subtitles if they are encoded as fullscreen images or Advanced Substation Alpha (ASS) subtitles which have a specific location defined.
automatically detect hard coded black bars: [Disabled] This enables the options below. madVR can detect and remove black bars on all sides of the video. Black bars cannot be detected when using DXVA2 or D3D11 Native decoding.
if black bars change pick one zoom factor: [Disabled, ... which doesn't lose any image content] Using this setting madVR will avoid changing the zoom or crop. e.g. It will not zoom or crop a 16:9 section in a normally 4:3 film when set to "which doesn't lose any image content" and will zoom or crop all of the 4:3 footage the amount needed to remove the black bars from any 16:9 sections when set to "which doesn't show any black bars".
if black bars change quickly back and forth: [Disabled, ... once every 2 sec] If not using the above option this option allows a limit on how often madVR can change the zoom or crop while playing to remove black bars as they are detected. Without either of these options madVR will always change the crop or zoom to only remove the black bars.
notify media player about cropped black bars: [Disabled, ... no more than once every 2 sec] How often to notify the media player of changes in the black bars. Some media players use this information to resize the window.
always shift the image: [Disabled, ... to the top of the screen] This allows setting whether the top or bottom of the video is cropped when zooming.
keep bars visible if they contain subtitles: [Disabled, ... forever] Disables zooming or cropping any black bar in which subtitles are detected. Either forever or for a set time.
cleanup image borders by cropping: [Disabled, ... 1 line from all black bar borders] Crop extra non-black pixels away from black bars or all edges. When set to crop all edges they are cropped even when no black bars are detected.
if there are big black bars: [Disabled, ... reduce bar size by 25%] Allows setting separate handling of large black bars.
zoom small black bars away: [Disabled] This zooms into the video to remove the black bars, cropping a small amount of video off of one edge to maintain the original aspect ratio and resizing to the original display resolution. e.g. The bottom is cropped when cropping small black bars on the left and right and the video scaled to the original resolution.
crop black bars: [Disabled] This crops black bars, changing the display aspect ratio and resolution. Cropping black bars increases performance; the pixels no longer need to be processed. Profile rules referencing resolution will use the after crop resolution.

Last edited by Asmodian; 29th February 2024 at 19:26.
Asmodian is offline   Reply With Quote