108 lines
5.1 KiB
Markdown
108 lines
5.1 KiB
Markdown
# Leaf
|
|
|
|
```man
|
|
USAGE: leaf [mode] [-options] directory
|
|
|
|
Modes:
|
|
autocrop crop using row/column brightness method
|
|
-levels=<params> levels adjustment for resulting image (ex. "0-253,0-2,0-255")
|
|
-trim=<t,r,l,b> pixels to trim from top, right, left, bottom
|
|
build combine images into a pdf with img2pdf
|
|
clean remove scratch files
|
|
crop define EXIF crop values using template files
|
|
-crops=<num> (6) specify how many files to use
|
|
desort remove image sequence prefix
|
|
deskew detect rotation angles
|
|
-max=<num> (.4) angles greater than this value are ignored
|
|
-pad=<num> (80) pixels to pad around crop area
|
|
-contrast=<num> (20) levels attenuation
|
|
-size=<num> (2200) dmap size in pixels
|
|
-nomap don't use dmaps
|
|
depaper divide page with itself using mask (better despine)
|
|
-mask=<file> mask file for spine-left image
|
|
-mpush=<levels> levels for divide map (ex. "0-253,0-2,0-255")
|
|
-mix=<0-100> (null) percentage mix with original (90% = mostly og)
|
|
-skip=<label> (null) skip files with this label
|
|
despine remove shadow from spine
|
|
-levels=<params> levels for overlay (ex. "0-253,0-2,0-255")
|
|
-width=<pixels> (300) spine width in pixels
|
|
-q=<0-100> (auto) jpeg quality, default read from source or 95
|
|
divide wrapper for imagemagick Divide_Src
|
|
-map=<file> specify brightness file
|
|
-mpush=<levels> levels for map (ex. "0-253,0-2,0-255") or "auto"
|
|
-blur=<pixels> apply in-place blur to map (slow/dumb)
|
|
-levels=<params> levels adjustment for resulting image (ex. "0-253,0-2,0-255")
|
|
-q=<quality> (95) quality out of 100
|
|
-pages map file is for LR rotated pages
|
|
-mix=<0-100> percentage mix with original (90% = mostly og)
|
|
dupes Find duplicate images using computed PHASH on thumbnails
|
|
-threshold=<num> (10) match threshold
|
|
-walk=<num> (5) comparison scope (compare n image to n, n+1, n+2, etc)
|
|
fixpdf de-rotate all pages in a pdf
|
|
-file=<pdf> pdf file in target dir
|
|
generate create final jpg images for pdf creation
|
|
-pixels=<num> scale to x pixels on longest side
|
|
-inches=<num> set dpi to x inches on longest side
|
|
-q=<0-100> (90) jpeg quality
|
|
-levels=<params> photoshop levels adjustment (ex. "0-253,0-2,0-255")
|
|
-px=<num> png size multiplier
|
|
-plevels=<params> png levels adjustment (otherwise calculated from adjust)
|
|
-pt=<0-255> use threshold method with photoshop level value
|
|
-pc=<2,2!,3> (2) colors for final png (2! = intermediary dithering)
|
|
-unsharp=<params> photoshop unsharp parameters (ex. "100,1,0")
|
|
-skipc skip color images
|
|
-skipg skip grayscale images
|
|
-skipb skip bitmap images
|
|
match move files and set crop values to match source dir
|
|
-source=<dir> read FROM dir
|
|
profile apply xmp profile to images (requires exiv2 > 0.25)
|
|
-file=<file> xmp profile
|
|
resort reorder image sequence by adding a new image
|
|
-file=<file> file to insert
|
|
-x=<num> position of inserted file
|
|
review print a table of image dimension statistics
|
|
rotate batch transform rotate (lossy)
|
|
-x=<angle> (90) rotation angle
|
|
-q=<0-100> (auto) jpeg quality, default read from source or 95
|
|
setdpi set image dpi with exiftool
|
|
-x=<dpi> specify dpi
|
|
-height=<inches> calculate dpi from specified height
|
|
sort sort files as AAABBB -> ABABAB
|
|
-m=<num> (auto) specify midpoint (cover image)
|
|
-prerotated images are already rotated
|
|
strip strip exif crop values from images with exiftool
|
|
```
|
|
|
|
#Typical Usage
|
|
|
|
digicam images are sorted into Left-Right page spreads
|
|
|
|
`leaf sort -prerotated canon/`
|
|
|
|
images are analized to determine rotation angle
|
|
|
|
`leaf deskew -contrast=50 canon/`
|
|
|
|
images are selected as "crop templates"
|
|
|
|
`leaf crop -crops=4 canon/`
|
|
|
|
intermediate images are generated from crop/skew/format tags
|
|
|
|
`leaf generate -pixels=1800 -inches=8.5 -q=90 -levels=10,1,225 -px=2 canon/`
|
|
|
|
intermediate images are assembled into a PDF
|
|
|
|
`leaf build canon_generated/`
|
|
|
|
#Dependencies
|
|
|
|
* [ImageMagick](https://github.com/ImageMagick/ImageMagick)
|
|
* [VIPS](https://github.com/jcupitt/libvips)
|
|
* [exiftool](https://github.com/exiftool/exiftool)
|
|
* [exiv2](https://github.com/Exiv2/exiv2)
|
|
* [img2pdf](https://gitlab.mister-muffin.de/josch/img2pdf)
|
|
* [pdftk](https://www.macports.org/ports.php?by=name&substr=pdftk)
|
|
* [trash](http://hasseg.org/trash) (for gentle deletion)
|
|
* [iTerm](https://www.iterm2.com) (for inline image previews)
|
|
* [Bridge](https://www.adobe.com/products/bridge.html) (for tweaking crops) |