This group of settings controls the file processing rules
Program startup group:
- Start without filename – to set the behavior if FastRawViewer was started without passing a filename to view:
- Empty Screen – FastRawViewer starts up "without file".
- Last opened file – opens the top (last) file from the Recent Files list.
- Last visited folder – opens the folder from the list of Recent Folders.
- Specified folder – allows you to set a "start folder".
- Do not recall network/removable media – forbids the automatic display of files/folders from network volumes and removable media.
- Reset folder tree filtering on start – will clear folder filtering on program start.
File Browsing group
- Warn on broken RAWs – turns on the warning if a damaged RAW file is encountered.
- File sort order – sets the order of file selection when browsing through the files:
- Filename, alphabetical – by filename, in alphabetical order, without accounting for letter case, accounting the current localization settings (like with previous FastRawViewer versions).
- Filename, reversed – the order is opposite to the previous.
- Modification time, newest to oldest – sorts the files by date of creation/last modification of the files, new files in the top of the list.
- Modification time, oldest to newest – the order is opposite to the previous.
- File type (extension) – files are sorted by extension; files with the same extension are sorted alphabetically.
- EXIF Timestamp newest to oldest/oldest to newest – sorting by date/time of shoot.
When sorting by time of modification of the file or by EXIF timestamps, files that have the same modification time (usually, time is kept to an accuracy of within a second) are sorted alphabetically when sorting oldest to newest, and reverse alphabetically when sorting newest to oldest.
- Additional RAW extensions – additional extensions for the RAW files FastRawViewer should process (appended to the built-in extension list).
- Ignore extensions when file browsing – this setting allows the user to supply a list of file extensions. Files having the extensions listed here:
- will be ignored during file browsing;
- not displayed in the "Open file" dialogue window.
- Open folder dialog starts at – sets the folder at which the “Open Folder” dialog starts:
- Current folder – Current folder.
- One level up – One level up.
- Specified folder – the folder specified by the user, always the same (until a different folder is specified here).
- Use global rejected folder – sets the folder for Rejected files as a global folder, or as a subfolder in the current folder (checkbox is unchecked).
- Subfolder for rejected files – the name of the subfolder to store the rejected files.
- Warn when file(s) are moved to rejected – customizes the warning settings for when files are moved to the _Rejected subfolder:
- No – never warn me.
- Always – always warn me.
- Multiple files – warn only moving several files to the _Rejected subfolder.
- Show progress bar on copy/move/reject – controls the display of the progress bar for these operations (the progress bar also allows to stop the operation, if necessary).
- Confirm move to the same destination – customizes the warning about moving a file(s) to the same destination as for the previous operation, with same options as for the setting directly above this.
- Undo settings – Customizing the Undo mode:
- Clear undo history on folder change – clears the undo history when the undo is changed.
- Undo history length – sets the number of undo levels.
This group of settings sets the specifics of work with removable media and network volumes.
- On removable media arrive – what to do when removable media is detected:
- Open most recent subfolder in – opens the most recent (by date of modification) subfolder in the selected folder (/DCIM by default).
- Open folder – opens the selected folder.
- Do nothing – Do Nothing.
- Warn before automatically open folder on removable media – display a warning before automatically opening a folder on removable media.
- Disable A: and B: floppy access – prevents any access to the A: and B: drives, as well as monitoring of changing media for those drives (Windows only). This preference is intended for the (fairly common in our day) case of a computer having a floppy drive controller, and one or two drives being “visible” to the system, though they’re not actually present.
- Preferences – Removable Media – Show unmounted network volumes in Folders panel
– this setting will switch on the display of the contents of the current un-mounted volume in this panel (if this setting is Off, the network devices that do not have a drive letter assigned will not be displayed).
- Monitor folder changes on removable media/network volumes – monitor changes in removable media/network volume folders, updating the Folders and Filmstrip panels when new subfolders and files are added.
- Prefetch depth on removable media/network volumes – sets how many files to decode before moving to the next file.
- Handle RAW+JPEG together – turns on the pairing of RAW and JPEG of the same name: displaying them as different representations of the same image, and treating them as a single unit for move operations, so that both are relocated to a different folder when a move operation is invoked.
- Do not show internal JPEG if external JPEG is present – removes the embedded JPEG from the list of available representations if there is an external JPEG (which, usually, has better resolution).
- Decode and show external JPEGs – enables the decoding and the display of external JPEG files.
- Analyze external JPEG Orientation tag and image dimensions to match RAW
– FastRawViewer will rotate the external JPEG if necessary, to match the orientation of the RAW image.
- Ignore internal JPEGs – unconditionally disables decoding of embedded JPEG previews. Automatically turns on and disables changing of Do not show internal JPEG if external JPEG is present setting.
- Default image to display – which representation to display when switching to the next file:
- Same as previous – the same as for the current file.
- RAW, internal JPEG, external JPEG – explicit designation of the representation.
This group of settings controls the processing of XMP files
- Use XMP for RAW files – turns on/off the use of XMP files.
- Read Only XMP – turns on the mode, where XMP files are read, but not changed.
- Warn about XMP writing errors – informs the user of any errors that occurred during the XMP file recording process.
- Warn if overwrite XMP for file with same name – If it is "on", FastRawViewer will ask user for confirmation before overwriting an XMP sidecar file containing settings for a file with the same name but different extension.
- Disable batch XMP operations if files with same name are selected – If it is "on" (default) and the selected files contain filenames that differ in extension only, the batch editing of XMP (setting or changing orientation, labels, ratings) will be grayed out / disabled in Menu - Select/Batch and in context menu.
- Force XMP file creation – turns on the unconditional creation of XMP files, even if no adjustments were changed manually while viewing the RAW file (those adjustments are orientation, white balance, exposure adjustment, labels and ratings). Useful for automatic propagation of adjustments to the next file.
- Refresh XMP metadata and thumbnails after batch operation – turns on the unconditional rereading of the current folder after an operation over a group of files is preformed.
- XMP rating and labels Section:
- Use XMP Reject Rating – turns on the possibility of setting the rating to -1. This rating is supported in Adobe Bridge. The setting is turned on automatically when selecting XMP Label Style: Adobe Bridge.
- XMP Label Style – sets the label format in XMP files:
- Adobe Bridge: Select, Second, Approved, Review, To Do.
- Color labels/Adobe Lightroom: Red, Yellow, Green, Blue, Purple.
- Review status/Adobe Lightroom: To Delete, Color Correction Needed, Good to Use, Retouching Needed, To Print.
- Custom – user labels (any text you choose).
- Write photoshop:Urgency tag with color labels (for PhaseOne C1) – Turns on the recording of the XMP-tag photoshop:Urgency, which is used by CaptureOne to recognize and set color labels. The setting is activated only if the mode XMP labels is set in 'Color Labels' (this is the default). In other modes, the XMP Labels photoshop:Urgency tag is not modified: if it was in the XMP file, it stays unchanged.
- Read ratings/labels from XMP blocks embedded into RAW files – turns on the reading of XMP blocks embedded in RAW files. For more detail, see the “Embedded XMP Blocks” section above.
- Adobe compatible Exposure and White Balance – turns on reading and recording into XMP files exposure compensation and white balance in Adobe format:
- Adobe process version for newly created XMP files. Default: 2012, can be set to 2010 or 2003.
- If the tag crs:ProcessVersion is set already in XMP file, the version doesn't change and the exposure is written according to the version.
- If the crs:ProcessVersion tag isn't present in XMP file, then it's added in accordance to the setting (this way, XMP-files created in older versions of FastRawViewer and then not changed by ACR/LR will be "upgraded");
- For 2012 process, Exposure2012 (equal to expo correction in FastRawViewer plus Adobe Shift) and the tags Contrast2012, Whites2012, Blacks2012 (set to 0, if these tags are not present in the file) are recorded.
- For the 2003/2010 processes the tags crs:Exposure, crs:Brightness, and crs:Contrast are recorded (if the file already had the values for those tags, they are preserved, otherwise they are set to 0).
- Write adobe-compatible Contrast/Blacks into XMP files – enables the recording of the contrast settings in the Adobe-compatible format.
- Adobe process version for newly created XMP files. Default: 2012, can be set to 2010 or 2003.
The group of settings to control the user interface.
- Panel’s font size: sets the font size in the informational panels.
- Panels color scheme – sets the brightness of the panel background.
- Hide Menu bar when hiding information panels – for the hide informational panels mode (Tab), controls if the menu bar should be hidden too.
- Hide bottom window bar when hiding information panels – hide main program window status bar in ‘hide information panels’ (Tab key) mode.
- Disable transparency for panels outside of main window – allows disabling transparency for informational panels that are placed completely outside the main program window.
- Hide floating panels – controls floating (not “docked”) informational panels behavior on Menu-Panels-Hide All panels action:
- Hide all – hide all panels
- Those inside main window – hide only panels, that float within main program window
- Do not hide – do not hide floating panels
- Bottom bar font size – controls bottom bar font size (Small – Extra Large on Windows and Normal – Extra Large on OS X).
- Background Gray level allows you set the brightness of the main program window background.
- Selected files background – allows one to set the background color for selected files.
- Activate program on file drop – controls program behavior for file Drag-n-Drop operations and if started in ‘Single instance’ mode:
- None – the program remains on the background (if it is already there)
- Fullscreen – the program brings itself to the foreground if it is in Fullscreen mode
- Always – the program brings itself to the foreground for both Fullscreen and “windowed” modes.
- Ignore successive wheel events for NN msec – this setting is designed to tame the stream of events generated by mouse wheel, Apple Magic Mouse, or trackpad.
- Restore last View settings on program start – when closing the program the following image display parameters are saved (independent of the status of the settings):
Display mode (RGB, per-channel, BW Conversion)
Focus Peaking mode
Boost Shadows mode
Exposure correction on/off
If 'Restore last View settings' is turned on, then during the next start-up of the program, the above-listed parameters will be in effect.
- Use built-in drive/folder icons in Folders panel – show icons built-in into FastRawViewer in the Folders panel (in several cases, using the system’s icon can lead to problems).
- Use system Open file/Open folder dialogs – switches between standard and smaller dialogs when opening files/folders.
- Use built-in file/folder icons in Open File/Open Folder dialogs – when using non-system dialogs for opening files/folders – use built-in icons.
- Force open Folders panel if started without filename – if this setting is on, starting the program without a file to be opened, or with an invalid / non-existent filename will result in the display of Folders panel, even if this panel was switched off previously.
- Disable splash screen – switches off the display of logo at FastRawViewer start.
- Edit bottom bar items – launches the dialog that allows one edit the composition of the program’s bottom bar.
- Image zoom on next file – sets the zoom factor to be used when displaying the next file:
- Keep zoom ratio – will keep the zoom factor.
- Keep image width – will keep the visible width of the image
- Fit to window – the Fit to screen mode will be turned on.
- Zoom and Drag Zoom to – sets zoom factor to use in the Zoom and Drag mode (Shift – left mouse click).
- Zoom and Pan Zoom to – sets zoom factor to use in the Zoom and Pan mode (Shift – right mouse click).
- Toggle Zoom Zoom to – sets the magnification/zoom level used for the Toggle Zoom (Z) mode.
- Zoom step (for shortcut) – controls the zoom step for keyboard (and mouse) shortcuts:
- Large – fixed zoom step value of about 50%, to be used for keyboard control.
- Medium – zoom step is set to 20%.
- Small – zoom step is set to 5%.
The last two settings are designed to be used while zooming with the Mouse Wheel or trackpad.
- Zoom+Pan within visible area – if this setting is on, then the panning will take place inside the area visible before the start of the panning. If it is off, then the panning will be over the entire image.
- Zoom anchor at mouse cursor – zooming will happen taking the position of the mouse cursor into account; the point underneath it will retain its position respective of the window during zooming.
- Use Logical pixels for zoom calculation (Mac OS X only):
- If turned on (default, "legacy" behavior), then the pixel in the screen is considered to be the "logical pixel" (in the case of Retina, it's a block of 2x2 "physical" pixels) and the calculation of the zoom size is done in these units.
- If turned off, the zoom value is calculated in "physical pixels", so for Retina screens the displayed zoom value will now be doubled, and at 100% zoom the image will be half the size compared to "legacy" behavior.
The settings in this group control the display of the image in Grid mode and the Filmstrip panel.
- Enable Grid mode – Turns on/off support for Grid Mode. You must restart the program for the change to take effect.
- Start in Grid mode – when launched without passing a filename, FastRawViewer will start in Grid mode.
- Remember Grid/Single file state on exit – turns on restoration of the previous mode for the next time FastRawViewer is launched.
- Browse folders in Grid mode – when moving from the current folder to another one, FastRawViewer will switch to Grid Mode.
- Hide panels floating within main window in Grid mode – if the setting is on, all floating panels in the Grid Mode that are currently positioned inside the program’s main window will be hidden; they will reappear when switching to Single File View Mode.
- Hide Filmstrip in Grid mode – customizes the visibility of the Filmstrip panel in Grid Mode (the Filmstrip panel can be brought back to display through Menu – Panels – Filmstrip):
- No – do not hide the Filmstrip panel
- If Docked at bottom – if the Filmstrip panel is at the bottom of the program window, it will be hidden upon switching to Grid Mode. The setting has no effect for a Filmstrip that is anywhere else.
- If Docked anywhere – the Filmstrip panel will be hidden if it is located in one of the main dock areas of the main window (at the top, at the bottom, and on the left). If the Filmstrip panel is dragged out of the main window, it will stay visible after switching to Grid Mode.
- RAW processing in Grid mode – customizes the RAW decoding when Grid Mode is enabled and RAW decoding is switched on through the Show Histogram/Stats/EXIF icon:
- Partial – only partial decoding is preformed, enough for displaying the exposure statistics and histogram. In this mode, browsing files happens faster.
- Full – full decoding is preformed, and switching to Single File view mode is nearly instantaneous.
- Grid View Font size, Filmstrip panel font size – to set the size of the fonts for the Grid View and Filmstrip panels:
- Auto – the font size is set automatically, based on the setting for the Panel Font size and the preview size.
- Extra small…Extra Large – the font size is set to the same as that of the Panels (using the same setting).
- Pause thumbnail decoding while RAW being processed – this control allows one to set priorities between the decoding of preview files and the decoding of RAW data (these two processes compete for CPU resources and hard drive access):
- No – concurrency; Thumbnail decoding is not postponed while RAW decoding takes place.
- Single file mode – Thumbnail decoding is postponed in Single File View Mode until the RAW decoding is finished.
- Single file and grid modes – Thumbnail recording is postponed for any RAW decoding action.
- Center edge filmstrip items – controls what happens when the first or the last visible image in the Filmstrip is selected. If on, the Filmstrip is moved in such a way that this image is placed in the center of the visible portion of the Filmstrip.
The settings in this group control the processing and the display of the images (except for white balancing, as the WB settings are in a separate group).
- Contrast curve – sets the tone curve to be used when displaying the image:
- Gamma 1.8, Gamma 2.2, sRGB, L* - sets one of the standard tone curves, typically used in image editing.
- Adobe Linear – corresponds to the linear tone curve in Adobe Camera Raw/Lightroom.
- BW Movie, Monochrome, Landscape, Portrait, Vivid – more punchy tone curves, may be useful for a quick demonstration of unedited images, adding to a more finished look.
- Boost shadows amount – controls the additional gamma adjustment while in Boost Shadows mode, the range is 0.2 to 2.0.
- Highlights inspection – this group of settings controls the Highlight Inspection mode:
- Gamma decrease – the amount by which the Gamma for the image will be reduced.
- Decrease Exposure by – additional image darkening.
- Apply UniWB white balance – White Balance will be substituted with UniWB, thus avoiding any possible clipping caused by White Balance.
- Use embedded color data for – controls the use of color data embedded into RAW files and allows using that data instead of data that comes with FastRawViewer.
- On-screen sharpening – enables sharpening for display.
- Preset 1/Mode:
- Always on – sharpening for display is always on
- Button/Shortcut – turns on when the button is press.
- Preset 2/Enabled – allows one to use a second group of parameters for sharpening, thus cycling will be between Off-Preset1-Preset2 or Off-Preset1.
- Radius – the radius the Unsharp Mask filter, which closely correlates to the Radius parameter in Adobe Photoshop USM settings.
- Amount – the strength of the sharpening, same as Amount Photoshop USM amount.
- Sharpen RAW files only – if this setting is on, the sharpening for display will affect RAW files only.
- Preset 1/Mode:
- Force Black-White mode for Bayer images – turns on the black’n’white mode for color cameras. This mode is intended for modified cameras, where the color filter array is removed.
- Apply Adobe hidden exposure correction – switches ON the automatic exposure correction similar to the one used by Adobe RAW converters, such as Camera Raw and Lightroom. With this correction ON, same values in exposure correction will result in overall image brightness being similar between Adobe converters and FastRawViewer.
- Set hidden exposure correction to – allows setting a user-defined value for the hidden automatic exposure correction. Often this is not necessary, as FastRawViewer already comes with the corrections for all cameras supported in Adobe converters.
- Exposure correction on file open:
- No correction – no additional exposure correction (apart from the Adobe-style one, if it is ON) is applied when a file is opened, unless the correction is found in the accompanying XMP sidecar file.
- Autoexposure – automatic exposure correction is applied, according to the settings listed below.
- Keep from prev. file – the new file will be opened with the same exposure correction that was set for the previous file (it does not matter here how that exposure correction was set, manually or automatically).
- Auto Exposure – controls the automatic exposure correction (the one that is applied when ‘automatic correction’ action is performed).
- Fixed Exposure Shift – the exposure is shifted by the fixed value.
- ETTR-style autoexposure (shift histogram to the right) – positive exposure correction that forces the saturation of the given percentage of pixels (those saturated pixels are having value of 255 on the 8-bit scale); the percentage is controlled through Saturate up to %NN of pixels setting.
The amount of the positive exposure correction shift is limited by the ‘Limit to’ setting:
Unlimited – no limit
Hard limit – the limit is set to the given amount.
Virtual ISO – limits the automatic exposure correction, taking into account the ISO setting in the camera. For example, if the current shot is taken at ISO 400 setting in the camera, while auto limit is set to ISO 6400 (the default value), the positive exposure correction is limited to (6400/400 =) 16 times, or, in photographic units, to 4EV.
- Manual exposure big step size/small step size – sets the step of manual exposure adjustment change.
- Exposure adjustments affect OverExposure display – when turning on this setting the change in exposure adjustment (both automatic and manual) will affect the display of overexposed areas.
- Under/Overexposure layer opacity – controls the perceived contrast of the highlighting for over- and underexposed areas.
- Underexposure detection limit NN EV below sensor saturation – sets the “usable dynamic range” of the camera. Everything below this limit will be displayed as underexposed.
This group contains all the white balance processing controls:
- White Balance Sampler size – for “click-on-gray” (Alt-Click) method, sets the size of the area used to evaluate the white balance
- White Balance for next file (same camera) – sets the white balance mode when opening a file coming from the same camera model as the current file. Choices here are:
- Same as previous – keep the current white balance choice.
- All others – the respective white balance mode will be in effect.
- White Balance for next file (another camera) – sets the white balance mode when opening
a file coming from a different camera model.
- White Balance display mode:
- Color Temperature/Tint – a mode commonly used in many RAW converters, including those by Adobe
- Mired/Tint – instead of correlated color temperatures, the value indicated is in Mired. Useful for selecting color filters to be used on the lens and on studio lights.
- WB Coefficients – the per-channel multipliers for white balance are indicated.
- Channel EV Correction – per-channel correction in EV (stops) for white balance are indicated.
- White Balance edit mode:
- Color Temperature/Tint – a mode commonly used in many RAW converters, including those by Adobe
- Channel EV Correction – per-channel correction in EV (stops) for white balance are indicated.
- Keep Custom WB for next file (same camera) – instructs FastRawViewer if the current white balance coefficients should be applied to the next file coming from the same camera model.
- Read White Balance presets from RAW (if present) – turns on reading white balance tables from RAW files.
This group of settings controls the appearance of the color on-screen in respect to color management:
- Enable Color Management – turns on ICC-compatible color management.
- Use system profile (for monitor where program starts) – the ICC profile chosen in the system for that monitor where the program is being started will be used as the profile for the monitor.
- Display Color profile – allows one to specify a file with the ICC profile for the monitor.
- RAW processing color space – allows one to set a color space in which the last steps of the RAW data processing are done (the first steps are performed in the camera’s color space).
- Color space for untagged JPEGs – allows one to set a color space for JPEG files for which the color space is not specified (not recorded in EXIF tags or ICCProfile of JPEG sections).
- Warn on incorrect, broken or nonexistent display profiles – turns on a warning for when one tries to use an incorrect display profile.
- Warn on incorrect or broken embedded profiles – turns on a warning for incorrect profiles built into the JPEG data.
- Color space for thumbnails: sets the mode for color space for previews (thumbnails).
This group controls the video card modes and how the sharp areas of the image will be displayed.
- Graphics Engine (Windows only): sets the method of using the graphics hardware acceleration: DirectX 9, DirectX 11 (Windows7 and newer), OpenGL, OpenGL emulator. The last option can only be set through an external script, as it results in extremely low performance, and can be selected only for the purposes of testing.
- Image resampling method:
- No resampling – for large zoom factors, the image will look as if it is constituted of small square tiles. The fastest method.
- Bilinear resampling – pretty fast, mid-quality method
- Bicubic resampling – high-quality method, can be slow, a relatively fast vast video card is recommended.
- Downsampling options:
- None – no additional processing, the downsized image may have a low quality look.
- Generate low resolution previews – low-resolution previews are rendered in advance with the help of video card driver.
Requires additional memory for the graphic textures, compatible with all video cards.
- Suppress downsampling artifacts – suppresses the colored noise on the high ISO images. Not supported on all video cards.
- Focus peaking mode:
- High contrast edges – enables the outlines for contrasty details using color contouring. Edges display color sets the color for the contours.
- Fine details – enables the outlines for the areas with plenty of smaller sharp details using color contouring. Details display color sets the color for the contours.
- Focus Peaking layer opacity – controls the fading of the main image for the Focus Peaking contours to be visible better.
- GPU compatibility settings
This group of settings is helps with the cases when certain compatibility problems are encountered (for instance, the image is not completely refreshed):
- Store compile GPU programs (shaders) – on those video cards on which this is supported, compiled GPU programs will be saved on the disk during the first startup. Program will start faster ever after.
- Store all renderings in GPU memory – if the setting is on, all of the file representations (RAW, internal JPEG, and external JPEG) will be stored in the video memory, right after the first use; this makes switching between RAW and JPEG for the same file nearly instantaneous.
- Synchronous GPU operations turns on the synchronous mode of video card work (slower, but more reliable).
- Force window refresh by slight resize – turns on bouncing to force image redraw
- Exit program on OS Sleep/suspend – forces the program to exit when the computer goes to sleep (that is to address the issue with some older OS being unable to correctly restart OpenGL operations after the wake up).
This window displays the paths to external programs. FastRawViewer can launch those, passing to them the name of the currently displayed file.
- Supports batch processing: if this checkbox is marked for the program, then this program will be included in both Menu – Select/Batch – Batch Run program and in the context menu for groups of files.
- Use […] buttons to lookup executable file on your system.
- Add slot button adds additional slot for external program (up to 10).
- Check external programs presence on startup enables check each program existence on FastRawViewer start.
Memory usage and performance Group
- Decoded RAW cache size – the number of decoded RAW files that are kept in the operational memory (RAM) to boost the speed of the browsing.
- JPEG cache size – the number of JPEG files that are kept in the operational memory to boost the speed of the browsing.
- Number of simultaneous RAW decode threads – the number of concurrent processes of RAW decoding.
- Downscale JPEGs larger than NN Mpix – JPEG files larger than the specified size will be down-sampled during the decoding process, so less memory will be required, while decoding and display will happen faster.
- Do not decode RAW files larger than NN Mpix – RAW data with a pixel count more than the specified will not be decoded; only an internal JPEG will be shown (if it exists)
All changes made to this group of settings come into effect only after restarting FastRawViewer.
- Use high speed preview for Fujifilm X-Trans – this preference turns on faster (but lower quality) processing for files created by Fujifilm X-Trans sensors.
This mode is recommended if you are not satisfied with the display rate of these files in standard mode.
Automatically turns on during the first start-up, and when resetting to default the preferences if the system has one of the following processors:
- Intel Core2Duo and older.
- Intel i3-i7 1st generation with fewer than 4 cores.
- Use all subframes for Pentax 4-shot files – enables merging all subframes into one when working with Pentax frames shot in Pixel Shift mode.
Thumbnail cache Group:
- Prefetch thumbnails for preceding images: to decode previews for the files “before” those visible on the screen.
- Thumbnail cache size: maximum size of the cached previews in the memory (each preview is stored in 4-byte per pixel format, so standard 200x133 preview is about 100kb, so 200Mbytes cache limit translates to ~2000 images).
- Thumbnail prefetch depth: how many files (relative to those viewed on the screen) to read ahead and decode previews.
- Thumbnail decoder thread count: how many parallel decode streams (threads) are enabled.
- Re-read current folder in – sets the refresh rate for the list of files in the current folder (if the folder changes, for instance other files are copied into it, then it won’t be reread very often).
This section contains other settings that cannot be grouped with any other preceding group:
- Write RPPS files – saves an .rpps file (for RawPhotoProcessor) if manual changes of WB/exposure are applied to the image
- Force RPPS files creation – saves an .rpps file with automatic settings for WB/Exposure when a RAW file is opened.
- Check for updates – this parameter schedules the checks for updates - at each program launch or once in every 1-3-7-15-30 days.
- Debug log messages – turns on the debug mode, the debug messages are available through Menu – Help – Debug log.
- Run single program instance – (Windows only) turns on the “one instance” mode of the program. At an attempt of starting the second instance, the file is displayed in the already existing program window.
- Faster program close – (Windows only) turns on the fast program completion mode.
- Manage File Associations – (Windows-only, not supported in Legacy Windows version): activates the system dialogue to edit file association with FastRawViewer:
A few of FastRawViewer’s settings are accessible only by running scripts that are installed alongside the program. These “hidden” settings are needed extremely rarely, and should be applied, as a rule, only once.
These scripts should only be used while the program is not running; otherwise FastRawViewer will overwrite the configurations with the old values during the program exit.
Using Additional Settings Scripts: Windows
Scripts installed with the program are copied into the folder
To use scripts, one needs to open the shown above folder with any file manager (Windows Explorer, for example), choose the necessary script, and run it (double click or Enter).
Registry Editor will run, which will first display a Windows UAC message:
Press Yes to agree to the warning, after which Register Editor will warn you again:
Once again confirm by pressing Yes, and Registry Editor will inform you of your success:
Using Additional Settings Scripts: Mac OS X
The Mac version of FastRawViewer contains additional settings scripts in the Scripts folder in the installation icon (FastRawViewer-1.2.N.MMM.dmg).
To use the scripts:
- Mount the disk image (double-click on the regular FastRawViewer installation dmg you’ve downloaded from our site):
- Go to the Scripts folder:
- Open the Terminal program
Applications – Utilities – Terminal.
- Drag the needed script onto the Terminal window, and you will see the full path to the script you are about to execute.
- Switch to the Terminal window and press Enter. The script will be executed without any output to the Terminal window; if there’s some sort of message, it means that there was an error.
Additional Settings Description
Name of script file
Windows: choosing the program graphics acceleration method
Sets the graphics “engine” DirectX9, OpenGL, or DirectX11
Turning resource-intensive graphics operations on and off
Turns on (default)/off resource-intensive graphics operations:
These scripts are for both Mac and Windows, however for all modern Macs, it is not necessary to turn off resource-intensive operations – the efficiency of the graphics adapters is good enough to use those.
Switching them off may be necessary for Windows platforms using low-end graphics (chipset Intel graphics, the oldest and weakest graphics processing cores).
Controlling the Folders panel
Enable (default value) turns on the default behavior of the Folders panel:
Disable: FastRawViewer starts with a closed Folders panel. It can be opened through Menu – Panels – Folders.
This setting is intended, first of all, as a test in extraordinary situations – in a few rare cases, the monitoring of the removable media status and/or the use of the folder/disc system icons leads to FastRawViewer not being able to work.
Allows one to switch the Interface – Use built-In file/folder icons setting without launching FastRawViewer.
This is intended for the case when the additional icon provider that is built into the system isn’t working (this has been known to happen, for example, with some versions of Dell Backup) and FastRawViewer cannot be launched to change these settings because the program crashes during the communication with the icon provider.
Using Adobe DNG SDK
Use DNG SDK for
Use/do not use DNG SDK in multi-thread mode.
Controlling the Filmstrip/Thumbnails panels behavior
Turns on/off the monitoring of any changes in the current folder on:
Turns on (default)/off the centering of the highlighted Filmstrip element when changing the contents of the current folder.
Sets the default contrast for the highlighted element in the Filmstrip panel.
If one wants to increase/decrease the contrast – copy the script, and edit it (change the default value by 5 more or 5 less) and run it.
Sets the default mouse wheel scroll step for all scrolling lists (folders, thumbnails in Filmstrip and Grid View, EXIF table).
If one wants to increase/decrease the contrast – copy the script, and edit it (change the default value to wheel step needed) and run it.
File selected by Filmstrip panel navigation is not opened immediately. This delay allows arrow keys Filmstrip navigation without CPU/disk overload (not every intermediate file will be opened).
Default delay is 30 milliseconds. If one wants to increase/decrease this delay – copy the script and edit it.
Designed to prevent FastRawViewer from attempting to display files that are not yet fully copied into the current folder. FastRawViewer
Scripts that control the delay:
Attempts to decode files with a JPEG extension the same as for RAW files.
This setting is useful for cameras with modified Firmware (the DiagRAW hack and old versions of the CHDK hack) because these cameras save RAW files with JPG extensions.
|Check GPS Status field (default) or ignore it and display GPS coordinates regardless of status.|
Alternate keyboard shortcuts handling
Alternate keyboard handler (Windows only) – turns on the alternative keyboard shortcuts processing mode. Turn on only if there are problems with the processing of keyboard shortcuts (this happens when using utterly non-standard keyboard layouts, for instance when switching between Qwerty и Dvorak).
By default, FastRawViewer uses all of the available processing cores to process RAW data.
Setting the Prefs.ProcessingMaxParallel parameter to a smaller value (taking HyperThreading into account) may increase the performance if there are many cores while the RAW files are relatively small.
Turns on/off the use of AVX2 instructions where for those computers where this instruction set is supported. By default, this is turned on.
Turns on (default)/off the display of the Drag and Pan cursors in the case when the image fits completely in the Window and there is nowhere to Drag/Pan.
FastRawViewer can be used for the display and analysis of images from “engineering” cameras, which are saved in the form of “sensor data dumps” without any other additional metadata.
A series of such cameras are already directly supported by the program (FastRawViewer contains an internal table with the necessary data); to support other (arbitrary) sensors, one has to add a description of the structure of the sensor’s data into the Windows Registry (on Windows) or OS X defaults (on Mac OS X).
To do this one must:
Windows: prepare a registry-script with content similar to the following:
"Camera01"="24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3,0"
And run it in Windows Explorer.
OS X: run a command in the Terminal, similar to the following one-liner:
defaults write com.libraw-llc.CustomCameras "Camera01" "24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3"
In both cases:
Camera01 (or Camera02 … Camera64) – the “number line” in the table, up to 64 records of this type are supported.
The line “24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3,0” defines the format of the camera’s data and consists of 14 fields separated by commas (a note for engineers: the format of this line is completely analogous to the line in the “sensor dump” table’s description in dcraw.c with the one difference being that the CFA filter’s format is set in base 10):
- The exact size of the file in bytes (in this example – 24096096). This is the only criterion by which FastRawViewer recognizes a data “format”, files of a different size will be ignored.
- The width of the sensor in pixels. Put the entire width, including the “black frame” in this field.
- The height of the sensor in pixels, including the black frame.
- The width of the black frame at the left edge of the sensor (in pixels)
- The width (height) of the black frame at the top.
- The width of the black frame at the right edge.
- The width (height) of the black frame at the bottom.
- Additional parameters for the file decoding subprogram (see below).
- The Bayer filter CFA format, with the byte field taking one of the following values:
- 22 – BGGR
- 97 – GRBG
- 73 – GBRG
- 148 – RGGB
- 180 - GMYC
- The amount of unused bit data (for example, if 14-bit data is recorded in a 16-bit format)
- Additional metadata, bit mask.
- Bit 0 – find a .JPG file with the same name and read the EXIF data from it.
- Bit 1 – filter (average neighbors) for pixels with values of zero
- Bits 2-4 – the orientation of the image (0=do not rotate, 3=180, 5=90CCW, 6=90CW)
- Camera manufacturer
- Camera model
- The offset of the beginning of the sensor data from the beginning of the file (the value range is 0-65534, the special value 65535 means that “the rows are going in the opposite direction”).
8, 10, 12, and 16-bit data formats are supported, the amount of bits is calculated as (the size of the file minus the offset from the beginning of the data)/number of pixels.
Depending on the bit-ness of the data, the 8th field (“additional parameters for the file decoding subprogram”) can accept the following values for 10-bit data:
- 1: “4 pixels in 5 bytes” packing is used
- 0: “6 pixels in 8 bytes” packing is used
For the cameras that are supported through this method, the data needed for proper color transforms is (obviously) missing in FastRawViewer. As a result:
- the color displayed will be "raw", that is the saturation is low and hues are inaccurate;
- only Auto WB is available in drop-down;
- no calculation of CCT and Tint
Backing up the Settings
Windows: to back up the settings, please use the BackupSettings.cmd script, which is installed in the same C:\Program Files\LibRaw\FastRawViewer\scripts\ folder as the scripts described above.
As a result of running this script, an FRV-backup folder will be created in your Documents folder. This FRV-backup folder will contain three files containing a copy of your program’s settings:
- Preferences.reg – for the settings which are controlled through the Preferences
- Shortcuts.reg – the settings for the keyboard shortcuts
- LastUsedSettings.reg – this contains the automatically-saved settings such as a list of Recent Files/Recent Folders, window position, etc.
To restore settings from the backup copy:
- Quite FastRawViewer
- Double-click the file with the backup copy of the settings you want to restore – this will import them into the Windows Registry.
Mac OS X: the settings are stored in ~/Library/Preferences/com.libraw-llc.FastRawViewer.plist
All of the standard backup procedures for Macintosh (TimeMachine, etc.) will save and restore those settings without any trouble.