KDcrawIface::RawDecodingSettings Class Reference

#include <rawdecodingsettings.h>

Public Types
enum	DecodingQuality {   BILINEAR = 0 , VNG = 1 , PPG = 2 , AHD = 3 ,   DCB = 4 , PL_AHD = 5 , AFD = 6 , VCD = 7 ,   VCD_AHD = 8 , LMMSE = 9 , AMAZE = 10 , DHT = 11 ,   AAHD = 12 }
enum	InputColorSpace { NOINPUTCS = 0 , EMBEDDED , CUSTOMINPUTCS }
enum	NoiseReduction {   NONR = 0 , WAVELETSNR , FBDDNR , LINENR ,   IMPULSENR }
enum	OutputColorSpace {   RAWCOLOR = 0 , SRGB , ADOBERGB , WIDEGAMMUT ,   PROPHOTO , CUSTOMOUTPUTCS }
enum	WhiteBalance {   NONE = 0 , CAMERA = 1 , AUTO = 2 , CUSTOM = 3 ,   AERA = 4 }

Public Member Functions
	RawDecodingSettings ()
	RawDecodingSettings (const RawDecodingSettings &prm)
virtual	~RawDecodingSettings ()
RawDecodingSettings &	operator= (const RawDecodingSettings &prm)
bool	operator== (const RawDecodingSettings &o) const
void	optimizeTimeLoading ()

Public Attributes
bool	autoBrightness
int	blackPoint
double	brightness
double	caMultiplier [2]
int	customWhiteBalance
double	customWhiteBalanceGreen
bool	dcbEnhanceFl
int	dcbIterations
QString	deadPixelMap
bool	DontStretchPixels
bool	eeciRefine
bool	enableBlackPoint
bool	enableCACorrection
bool	enableWhitePoint
int	esMedPasses
bool	expoCorrection
double	expoCorrectionHighlight
double	expoCorrectionShift
bool	fixColorsHighlights
bool	halfSizeColorImage
InputColorSpace	inputColorSpace
QString	inputProfile
int	medianFilterPasses
int	NRChroThreshold
int	NRThreshold
NoiseReduction	NRType
OutputColorSpace	outputColorSpace
QString	outputProfile
DecodingQuality	RAWQuality
bool	RGBInterpolate4Colors
bool	sixteenBitsImage
int	unclipColors
WhiteBalance	whiteBalance
QRect	whiteBalanceArea
int	whitePoint

Detailed Description

Settings for raw decoding.

Definition at line 27 of file rawdecodingsettings.h.

Member Enumeration Documentation

DecodingQuality

enum KDcrawIface::RawDecodingSettings::DecodingQuality

RAW decoding Interpolation methods.

Bilinear: use high-speed but low-quality bilinear interpolation (default - for slow computer). In this method, the red value of a non-red pixel is computed as the average of the adjacent red pixels, and similar for blue and green. VNG: use Variable Number of Gradients interpolation. This method computes gradients near the pixel of interest and uses the lower gradients (representing smoother and more similar parts of the image) to make an estimate. PPG: use Patterned Pixel Grouping interpolation. Pixel Grouping uses assumptions about natural scenery in making estimates. It has fewer color artifacts on natural images than the Variable Number of Gradients method. AHD: use Adaptive Homogeneity-Directed interpolation. This method selects the direction of interpolation so as to maximize a homogeneity metric, thus typically minimizing color artifacts. DCB: DCB interpolation (see http://www.linuxphoto.org/html/dcb.html for details)

NOTE: from GPL2/GPL3 demosaic packs - will not work with libraw>=0.19

PL_AHD: modified AHD interpolation (see https://sites.google.com/site/demosaicalgorithms/modified-dcraw for details). AFD: demosaicing through 5 pass median filter from PerfectRaw project. VCD: VCD interpolation. VCD_AHD: mixed demosaicing between VCD and AHD. LMMSE: LMMSE interpolation from PerfectRaw. AMAZE: AMaZE interpolation and color aberration removal from RawTherapee project.

NOTE: for libraw>=0.19 only

DHT: DHT interpolation. AAHD: Enhanced Adaptive AHD interpolation.

Definition at line 66 of file rawdecodingsettings.h.

InputColorSpace

enum KDcrawIface::RawDecodingSettings::InputColorSpace

Input color profile used to decoded image NOINPUTCS: No input color profile.

EMBEDDED: Use the camera profile embedded in RAW file if exist. CUSTOMINPUTCS: Use a custom input color space profile.

Definition at line 120 of file rawdecodingsettings.h.

NoiseReduction

enum KDcrawIface::RawDecodingSettings::NoiseReduction

Noise Reduction method to apply before demosaicing NONR: No noise reduction.

WAVELETSNR: wavelets correction to erase noise while preserving real detail. It's applied after interpolation. FBDDNR: Fake Before Demosaicing Denoising noise reduction. It's applied before interpolation. LINENR: CFA Line Denoise. It's applied after interpolation. IMPULSENR: Impulse Denoise. It's applied after interpolation.

Definition at line 106 of file rawdecodingsettings.h.

OutputColorSpace

enum KDcrawIface::RawDecodingSettings::OutputColorSpace

Output RGB color space used to decoded image RAWCOLOR: No output color profile (Linear RAW).

SRGB: Use standard sRGB color space. ADOBERGB: Use standard Adobe RGB color space. WIDEGAMMUT: Use standard RGB Wide Gamut color space. PROPHOTO: Use standard RGB Pro Photo color space. CUSTOMOUTPUTCS: Use a custom workspace color profile.

Definition at line 135 of file rawdecodingsettings.h.

WhiteBalance

enum KDcrawIface::RawDecodingSettings::WhiteBalance

White balances alternatives NONE: no white balance used : reverts to standard daylight D65 WB.

CAMERA: Use the camera embedded WB if available. Reverts to NONE if not. AUTO: Averages an auto WB on the entire image. CUSTOM: Let use set its own temperature and green factor (later converted to RGBG factors). AERA: Let use an area from image to average white balance (see whiteBalanceArea for details).

Definition at line 90 of file rawdecodingsettings.h.

Constructor & Destructor Documentation

RawDecodingSettings()

KDcrawIface::RawDecodingSettings::RawDecodingSettings

(

)

Standard constructor with default settings.

Definition at line 14 of file rawdecodingsettings.cpp.

~RawDecodingSettings()

KDcrawIface::RawDecodingSettings::~RawDecodingSettings ( )

virtual

Standard destructor.

Definition at line 65 of file rawdecodingsettings.cpp.

Member Function Documentation

operator=()

RawDecodingSettings & KDcrawIface::RawDecodingSettings::operator= ( const RawDecodingSettings & prm )

default

Equivalent to the copy constructor.

operator==()

bool KDcrawIface::RawDecodingSettings::operator==

(

const RawDecodingSettings &

o

)

const

Compare for equality.

Definition at line 73 of file rawdecodingsettings.cpp.

optimizeTimeLoading()

void KDcrawIface::RawDecodingSettings::optimizeTimeLoading

(

)

Method to use a settings to optimize time loading, for example to compute image histogram.

Definition at line 117 of file rawdecodingsettings.cpp.

Member Data Documentation

autoBrightness

bool KDcrawIface::RawDecodingSettings::autoBrightness

If false, use a fixed white level, ignoring the image histogram.

Definition at line 175 of file rawdecodingsettings.h.

blackPoint

int KDcrawIface::RawDecodingSettings::blackPoint

Black Point value of output image.

Definition at line 258 of file rawdecodingsettings.h.

brightness

double KDcrawIface::RawDecodingSettings::brightness

Brightness of output image.

Definition at line 250 of file rawdecodingsettings.h.

caMultiplier

double KDcrawIface::RawDecodingSettings::caMultiplier[2]

Magnification factor for Red and Blue layers.

• caMultiplier[0] = amount of correction on red-green axis.
• caMultiplier[1] = amount of correction on blue-yellow axis.
• Both values set to 0.0 = automatic CA correction.

  Deprecated

  does not work with libraw>=0.19

Definition at line 246 of file rawdecodingsettings.h.

customWhiteBalance

int KDcrawIface::RawDecodingSettings::customWhiteBalance

The temperature and the green multiplier of the custom white balance.

Definition at line 193 of file rawdecodingsettings.h.

customWhiteBalanceGreen

double KDcrawIface::RawDecodingSettings::customWhiteBalanceGreen

Definition at line 194 of file rawdecodingsettings.h.

dcbEnhanceFl

bool KDcrawIface::RawDecodingSettings::dcbEnhanceFl

Turn on the DCB interpolation with enhance interpolated colors.

Definition at line 306 of file rawdecodingsettings.h.

dcbIterations

int KDcrawIface::RawDecodingSettings::dcbIterations

For DCB interpolation.

Number of DCB median filtering correction passes. -1 : disable (default) 1-10 : DCB correction passes

Definition at line 302 of file rawdecodingsettings.h.

deadPixelMap

QString KDcrawIface::RawDecodingSettings::deadPixelMap

Path to text file including dead pixel list.

Definition at line 288 of file rawdecodingsettings.h.

DontStretchPixels

bool KDcrawIface::RawDecodingSettings::DontStretchPixels

For cameras with non-square pixels, do not stretch the image to its correct aspect ratio.

In any case, this option guarantees that each output pixel corresponds to one RAW pixel.

Definition at line 204 of file rawdecodingsettings.h.

eeciRefine

bool KDcrawIface::RawDecodingSettings::eeciRefine

For VCD_AHD interpolation.

Turn on the EECI refine for VCD Demosaicing.

Deprecated

does not work with libraw>=0.19

Definition at line 313 of file rawdecodingsettings.h.

enableBlackPoint

bool KDcrawIface::RawDecodingSettings::enableBlackPoint

Turn on the black point setting to decode RAW image.

Definition at line 254 of file rawdecodingsettings.h.

enableCACorrection

bool KDcrawIface::RawDecodingSettings::enableCACorrection

Turn on chromatic aberrations correction.

Deprecated

does not work with libraw>=0.19

Definition at line 238 of file rawdecodingsettings.h.

enableWhitePoint

bool KDcrawIface::RawDecodingSettings::enableWhitePoint

Turn on the white point setting to decode RAW image.

Definition at line 262 of file rawdecodingsettings.h.

esMedPasses

int KDcrawIface::RawDecodingSettings::esMedPasses

Use edge-sensitive median filtering for artifact suppression after VCD demosaicing.

0 : disable (default) 1-10 : median filter passes.

Deprecated

does not work with libraw>=0.19

Definition at line 320 of file rawdecodingsettings.h.

expoCorrection

bool KDcrawIface::RawDecodingSettings::expoCorrection

Turn on the Exposure Correction before interpolation.

Definition at line 330 of file rawdecodingsettings.h.

expoCorrectionHighlight

double KDcrawIface::RawDecodingSettings::expoCorrectionHighlight

Amount of highlight preservation for exposure correction before interpolation in E.V.

Usable range is from 0.0 (linear exposure shift, highlights may blow) to 1.0 (maximum highlights preservation) This settings can only take effect if expoCorrectionShift > 1.0.

Definition at line 341 of file rawdecodingsettings.h.

expoCorrectionShift

double KDcrawIface::RawDecodingSettings::expoCorrectionShift

Shift of Exposure Correction before interpolation in linear scale.

Usable range is from 0.25 (darken image 1 stop : -2EV) to 8.0 (lighten ~1.5 photographic stops : +3EV).

Definition at line 335 of file rawdecodingsettings.h.

fixColorsHighlights

bool KDcrawIface::RawDecodingSettings::fixColorsHighlights

If true, images with overblown channels are processed much more accurate, without 'pink clouds' (and blue highlights under tungsten lamps).

Definition at line 171 of file rawdecodingsettings.h.

halfSizeColorImage

bool KDcrawIface::RawDecodingSettings::halfSizeColorImage

Half-size color image decoding (twice as fast as "enableRAWQuality").

Turn on this option to reduce time loading to render histogram for example, no to render an image to screen.

Definition at line 185 of file rawdecodingsettings.h.

inputColorSpace

InputColorSpace KDcrawIface::RawDecodingSettings::inputColorSpace

The input color profile used to decoded RAW data.

See OutputColorProfile values for details.

Definition at line 271 of file rawdecodingsettings.h.

inputProfile

QString KDcrawIface::RawDecodingSettings::inputProfile

Path to custom input ICC profile to define the camera's raw colorspace.

Definition at line 275 of file rawdecodingsettings.h.

medianFilterPasses

int KDcrawIface::RawDecodingSettings::medianFilterPasses

After interpolation, clean up color artifacts by repeatedly applying a 3x3 median filter to the R-G and B-G channels.

Definition at line 224 of file rawdecodingsettings.h.

NRChroThreshold

int KDcrawIface::RawDecodingSettings::NRChroThreshold

For IMPULSENR Noise reduction.

Set the amount of Chrominance impulse denoise. Null value disable NR. Range is between 100 and 1000.

Deprecated

does not work with libraw>=0.19

Definition at line 326 of file rawdecodingsettings.h.

NRThreshold

int KDcrawIface::RawDecodingSettings::NRThreshold

Noise reduction threshold value.

Null value disable NR. Range is between 100 and 1000. For IMPULSENR : set the amount of Luminance impulse denoise.

Definition at line 233 of file rawdecodingsettings.h.

NRType

NoiseReduction KDcrawIface::RawDecodingSettings::NRType

Noise reduction method to apply before demosaicing.

Definition at line 228 of file rawdecodingsettings.h.

outputColorSpace

OutputColorSpace KDcrawIface::RawDecodingSettings::outputColorSpace

The output color profile used to decoded RAW data.

See OutputColorProfile values for details.

Definition at line 280 of file rawdecodingsettings.h.

outputProfile

QString KDcrawIface::RawDecodingSettings::outputProfile

Path to custom output ICC profile to define the color workspace.

Definition at line 284 of file rawdecodingsettings.h.

RAWQuality

DecodingQuality KDcrawIface::RawDecodingSettings::RAWQuality

RAW quality decoding factor value.

See DecodingQuality values for details.

Definition at line 219 of file rawdecodingsettings.h.

RGBInterpolate4Colors

bool KDcrawIface::RawDecodingSettings::RGBInterpolate4Colors

Turn on RAW file decoding using RGB interpolation as four colors.

Definition at line 198 of file rawdecodingsettings.h.

sixteenBitsImage

bool KDcrawIface::RawDecodingSettings::sixteenBitsImage

Turn on RAW file decoding in 16 bits per color per pixel instead 8 bits.

Definition at line 179 of file rawdecodingsettings.h.

unclipColors

int KDcrawIface::RawDecodingSettings::unclipColors

Unclip Highlight color level: 0 = Clip all highlights to solid white.

1 = Leave highlights unclipped in various shades of pink. 2 = Blend clipped and unclipped values together for a gradual fade to white. 3-9 = Reconstruct highlights. Low numbers favor whites; high numbers favor colors.

Definition at line 214 of file rawdecodingsettings.h.

whiteBalance

WhiteBalance KDcrawIface::RawDecodingSettings::whiteBalance

White balance type to use.

See WhiteBalance values for detail

Definition at line 189 of file rawdecodingsettings.h.

whiteBalanceArea

QRect KDcrawIface::RawDecodingSettings::whiteBalanceArea

Rectangle used to calculate the white balance by averaging the region of image.

Definition at line 292 of file rawdecodingsettings.h.

whitePoint

int KDcrawIface::RawDecodingSettings::whitePoint

White Point value of output image.

Definition at line 266 of file rawdecodingsettings.h.

---

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

• rawdecodingsettings.h
• rawdecodingsettings.cpp