luminance-hdr-cli - Man Page

command-line high dynamic range image processing

Synopsis

luminance-hdr-cli [Options]... [INPUTFILES]...

Options

-h [ --help ]

Display detailed help text.

-V [ --version ]

Display program version.

-v [ --verbose ]

Print more messages during execution.

-c [ --cameras ]

Print a list of all supported cameras.

-a [ --align ] [AIS|MTB]

Align Engine to use during HDR creation (default: no alignment).

-e [ --ev ] EV1,EV2,...

Specify numerical EV values (as many as INPUTFILES).

-d [ --savealigned ] prefix

Save aligned images to files which names start with prefix

-l [ --load ] HDR_FILE

Load an HDR instead of creating a new one.

-s [ --save ] HDR_FILE

Save to a HDR file format. (default: don't save)

-g [ --gamma ] VALUE

Gamma value to use during tone mapping. (default: 1)

-S [ --saturation ] VALUE

Saturation value to use during tone mapping. (default: 1)

-G [ --postgamma ] VALUE

Gamma value to use after tone mapping. (default: 1)

-r [ --resize ] VALUE

Width you want to resize your HDR to (resized before gamma and tone mapping)

-o [ --output ] LDR_FILE

File name you want to save your tone mapped LDR to.

-t [ --autoag ] THRESHOLD

Enable auto anti-ghosting with given threshold. (0.0-1.0)

-b [ --autolevels ]

Apply autolevels correction after tonemapping.

-w [ --createwebpage ]

Enable generation of a webpage with embedded HDR viewer.

-p [ --proposedldrname ] FILE_EXTENSION

Save LDR file with a name of the form first-last_tmparameters.extension.

-z [ --proposedhdrname ] FILE_EXTENSION

Save HDR file with a name of the form first-last_HdrCreationModel.extension.

HDR Creation Parameters

You must either load an existing HDR file (via the -l option) or specify INPUTFILES to create a new HDR.

--hdrWeight [triangular|gaussian|plateau|flat]

(Default is triangular)

--hdrResponseCurve [from_file|linear|gamma|log|srgb]

(Default is linear)

--hdrModel [robertson|robertsonauto|debevec]

(Default is debevec)

--hdrCurveFilename your_file_here.m

LDR Output Parameters

-q [ --ldrQuality ] VALUE

Quality of the saved tone mapped file (1-100).

--ldrTiff [8b|16b|32b|logluv]

Tiff format. (Default is 8b)

--ldrTiffDeflate [true|false]

Tiff deflate compression. (Default is true)

HTML Output Parameters

-k [ --htmlQuality ] VALUE

Quality of the interpolated exposures, from the worst (1) to the best (4). Higher quality will introduce less distortions in the brightest and the darkest tones, but will also generate more images. More images means that there is more data that needs to be transferred to the web-browser, making HDR viewer less responsive. (Default is 2, which is sufficient for most applications)

--pageName page_name

Specifies the file name of the web page to be generated. If page_name is missing, the file name of the first image with .html extension will be used. (Default is first image name)

--imagesDir directory

Specify where to store the resulting image files. Links to images in HTML will be updated accordingly. This must be a relative path and the directory must exist. Useful to avoid clutter in the current directory. (Default is current working directory)

Tone Mapping Parameters

No tonemapping is performed unless -o is specified.

--tmo [ashikhmin|drago|durand|fattal|ferradans|ferwerda|kimkautz|pattanaik|reinhard02|reinhard05|mai|mantiuk06|mantiuk08|vanhateren|lischinski]

Tone mapping operator. (Default is mantiuk06)

--tmofile SETTING_FILE

Load an existing setting file containing pre-gamma and all TMO settings

Fattal
--tmoFatAlpha FLOAT

alpha

--tmoFatBeta FLOAT

beta

--tmoFatColor FLOAT

color

--tmoFatNoise FLOAT

noise

--tmoFatNew [true|false]

new

Ferradans
--tmoFerRho FLOAT

rho

--tmoFerInvAlpha FLOAT

inv_alpha

KimKautz
--tmoKimKautzC1 FLOAT

c1

--tmoKimKautzC2 FLOAT

c2

Mantiuk 06
--tmoM06Contrast FLOAT

contrast

--tmoM06Saturation FLOAT

saturation

--tmoM06Detail FLOAT

detail

--tmoM06ContrastEqual [true|false]

equalization

Mantiuk 08
--tmoM08ColorSaturation FLOAT

color saturation

--tmoM08ConstrastEnh FLOAT

contrast enhancement

--tmoM08LuminanceLvl FLOAT

luminance level

--tmoM08SetLuminance [true|false]

enable luminance level

Durand
--tmoDurSigmaS FLOAT

spatial kernel sigma

--tmoDurSigmaR FLOAT

range kernel sigma

--tmoDurBase FLOAT

base contrast

Drago
--tmoDrgBias FLOAT

bias

Reinhard 02
--tmoR02Key FLOAT

key value

--tmoR02Phi FLOAT

phi

--tmoR02Scales [true|false]

use scales

--tmoR02Num FLOAT

range

--tmoR02Low FLOAT

lower scale

--tmoR02High FLOAT

upper scale

Reinhard 05
--tmoR05Brightness FLOAT

Brightness

--tmoR05Chroma FLOAT

Chroma adaption

--tmoR05Lightness FLOAT

Light adaption

Ashikmin
--tmoAshEq2 [true|false]

Equation number 2

--tmoAshSimple [true|false]

Simple

--tmoAshLocal FLOAT

Local threshold

Pattanaik
--tmoPatMultiplier FLOAT

multiplier

--tmoPatLocal [true|false]

Local tone mapping

--tmoPatAutoLum [true|false]

Auto luminance

--tmoPatCone FLOAT

cone level

--tmoPatRod FLOAT

rod level

VanHateren
--tmoVanHaterenPupilArea FLOAT

pupil_area

Lischinski
--tmoLischinskiAlpha FLOAT

alpha

See Also

luminance-hdr(1)

pfstools

pfsabsolute(1), pfscat(1), pfsclamp(1), pfscolortransform(1), pfscut(1), pfsdisplayfunction(1), pfsextractchannels(1), pfsflip(1), pfsgamma(1), pfsin(1), pfsindcraw(1), pfsinpfm(1), pfsinppm(1), pfsinrgbe(1), pfsintiff(1), pfsinyuv(1), pfsout(1), pfsouthdrhtml(1), pfsoutpfm(1), pfsoutppm(1), pfsoutrgbe(1), pfsouttiff(1), pfsoutyuv(1), pfspad(1), pfspanoramic(1), pfsretime(1), pfsrotate(1), pfssize(1), pfstag(1)

pfstmo

pfstmo_drago03(1), pfstmo_durand02(1), pfstmo_fattal02(1), pfstmo_ferradans11(1), pfstmo_mai11(1), pfstmo_mantiuk06(1), pfstmo_mantiuk08(1), pfstmo_pattanaik00(1), pfstmo_reinhard02(1), pfstmo_reinhard05(1)

pfscalibration

dcraw2hdrgen(1), jpeg2hdrgen(1), pfshdrcalibrate(1), pfsinhdrgen(1), pfsinme(1), pfsplotresponse(1)

Referenced By

luminance-hdr(1).

April 2021