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  NoiseReduction {
enum  OutputColorSpace {
enum  WhiteBalance {
  NONE = 0, CAMERA = 1, AUTO = 2, CUSTOM = 3,
  AERA = 4

Public Member Functions

 RawDecodingSettings ()
virtual ~RawDecodingSettings ()
RawDecodingSettingsoperator= (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

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.

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.

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.

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.

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

KDcrawIface::RawDecodingSettings::RawDecodingSettings ( )

Standard constructor with default settings.

Definition at line 14 of file rawdecodingsettings.cpp.

KDcrawIface::RawDecodingSettings::~RawDecodingSettings ( )

Standard destructor.

Definition at line 65 of file rawdecodingsettings.cpp.

Member Function Documentation

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

Equivalent to the copy constructor.

Definition at line 69 of file rawdecodingsettings.cpp.

bool KDcrawIface::RawDecodingSettings::operator== ( const RawDecodingSettings o) const

Compare for equality.

Definition at line 114 of file rawdecodingsettings.cpp.

void KDcrawIface::RawDecodingSettings::optimizeTimeLoading ( )

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

Definition at line 158 of file rawdecodingsettings.cpp.

Member Data Documentation

bool KDcrawIface::RawDecodingSettings::autoBrightness

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

Definition at line 174 of file rawdecodingsettings.h.

int KDcrawIface::RawDecodingSettings::blackPoint

Black Point value of output image.

Definition at line 257 of file rawdecodingsettings.h.

double KDcrawIface::RawDecodingSettings::brightness

Brightness of output image.

Definition at line 249 of file rawdecodingsettings.h.

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.
    does not work with libraw>=0.19

Definition at line 245 of file rawdecodingsettings.h.

int KDcrawIface::RawDecodingSettings::customWhiteBalance

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

Definition at line 192 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::dcbEnhanceFl

Turn on the DCB interpolation with enhance interpolated colors.

Definition at line 305 of file rawdecodingsettings.h.

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 301 of file rawdecodingsettings.h.

QString KDcrawIface::RawDecodingSettings::deadPixelMap

Path to text file including dead pixel list.

Definition at line 287 of file rawdecodingsettings.h.

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 203 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::eeciRefine

For VCD_AHD interpolation.

Turn on the EECI refine for VCD Demosaicing.

does not work with libraw>=0.19

Definition at line 312 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::enableBlackPoint

Turn on the black point setting to decode RAW image.

Definition at line 253 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::enableCACorrection

Turn on chromatic aberrations correction.

does not work with libraw>=0.19

Definition at line 237 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::enableWhitePoint

Turn on the white point setting to decode RAW image.

Definition at line 261 of file rawdecodingsettings.h.

int KDcrawIface::RawDecodingSettings::esMedPasses

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

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

does not work with libraw>=0.19

Definition at line 319 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::expoCorrection

Turn on the Exposure Correction before interpolation.

Definition at line 329 of file rawdecodingsettings.h.

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 340 of file rawdecodingsettings.h.

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 334 of file rawdecodingsettings.h.

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 170 of file rawdecodingsettings.h.

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 184 of file rawdecodingsettings.h.

InputColorSpace KDcrawIface::RawDecodingSettings::inputColorSpace

The input color profile used to decoded RAW data.

See OutputColorProfile values for details.

Definition at line 270 of file rawdecodingsettings.h.

QString KDcrawIface::RawDecodingSettings::inputProfile

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

Definition at line 274 of file rawdecodingsettings.h.

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 223 of file rawdecodingsettings.h.

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.

does not work with libraw>=0.19

Definition at line 325 of file rawdecodingsettings.h.

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 232 of file rawdecodingsettings.h.

NoiseReduction KDcrawIface::RawDecodingSettings::NRType

Noise reduction method to apply before demosaicing.

Definition at line 227 of file rawdecodingsettings.h.

OutputColorSpace KDcrawIface::RawDecodingSettings::outputColorSpace

The output color profile used to decoded RAW data.

See OutputColorProfile values for details.

Definition at line 279 of file rawdecodingsettings.h.

QString KDcrawIface::RawDecodingSettings::outputProfile

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

Definition at line 283 of file rawdecodingsettings.h.

DecodingQuality KDcrawIface::RawDecodingSettings::RAWQuality

RAW quality decoding factor value.

See DecodingQuality values for details.

Definition at line 218 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::RGBInterpolate4Colors

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

Definition at line 197 of file rawdecodingsettings.h.

bool KDcrawIface::RawDecodingSettings::sixteenBitsImage

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

Definition at line 178 of file rawdecodingsettings.h.

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 213 of file rawdecodingsettings.h.

WhiteBalance KDcrawIface::RawDecodingSettings::whiteBalance

White balance type to use.

See WhiteBalance values for detail

Definition at line 188 of file rawdecodingsettings.h.

QRect KDcrawIface::RawDecodingSettings::whiteBalanceArea

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

Definition at line 291 of file rawdecodingsettings.h.

int KDcrawIface::RawDecodingSettings::whitePoint

White Point value of output image.

Definition at line 265 of file rawdecodingsettings.h.

The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2021 The KDE developers.
Generated on Wed Jan 20 2021 22:38:26 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.