File: light_correct.1

package info (click to toggle)
vips 8.4.5-1%2Bdeb9u1
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 25,724 kB
  • sloc: ansic: 102,605; cpp: 57,527; sh: 4,957; xml: 3,317; python: 3,105; makefile: 1,089; perl: 40
file content (39 lines) | stat: -rw-r--r-- 1,284 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
.TH LIGHT_CORRECT 1 "14 Oct 1996"
.SH NAME
light_correct \- correct illumination errors on set of images
.SH SYNOPSIS
.B light_correct grey image1 image2 image3 ...
.SH DESCRIPTION
The first argument should be an image of a piece of grey card, subsequent
arguments should be images taken with the same lighting set-up which need
correcting. The corrected images are written to files prefixed with "ic_". 

For example, suppose you have a directory with the following files in:

  example% ls
  dat1.1.v dat1.2.v dat2.1.v dat2.2.v dat3.1.v dat3.2.v
  dat4.1.v dat4.2.v grey.v

then run light_correct like this:

  example% light_correct grey.v dat*.v

to generate this:

  example% ls
  dat1.1.v dat1.2.v dat2.1.v dat2.2.v dat3.1.v dat3.2.v
  dat4.1.v dat4.2.v grey.v
  ic_dat1.1.v ic_dat1.2.v ic_dat2.1.v ic_dat2.2.v ic_dat3.1.v
  ic_dat3.2.v ic_dat4.1.v ic_dat4.2.v

light_correct works by smoothing out the grey card image, finding
grey-mean/pixel for each point, and then multiplying the result by all the
following images. It also removes any .desc files it generates, to avoid
problems with im_global_balance(3).

.SH RETURN VALUE
returns 0 on success and non-zero on error.
.SH SEE ALSO
vipsheader(1), vips(1)
.SH COPYRIGHT
The National Gallery and Birkbeck College, 1989-1996.