1 2 3=head1 NAME 4 5fulla - Correct lens distortion, vignetting and chromatic aberration 6 7=head1 SYNOPSIS 8 9B<fulla> [options] I<inputfile(s)> 10 11 12=head1 DESCRIPTION 13 14Apply radial or flat-field vignetting correction as well as geometrical radial 15distortion and transversal chromatic aberration correction. 16 17fulla can be used to batch correct a large number of files. Radial distortion coefficients can be read from a lens database. 18 19Vignetting correction is done the same way as described in the nona script file documentation, or from lens database. 20Vignetting correction can be done based on a flat-field or a radial scaling. 21 22Vignetting correction by flat-field division: 23 I = I / c, c = flat-field / mean(flat-field) 24 25Radial vignetting correction: 26 I = I / c, c = a + b*r^2 + c*r^4 + d*r^6 27 28 29The radial distortion correction is identical to the one implemented by PanoTools: 30 31r_new = a*r^4 + b*r^3 + c*r^2 + d*r [1] 32 33Since transversal chromatic aberrations (TCA) leads to differently scaled objects in the 34red, green and blue channel, it can be corrected by scaling the red and blue channel 35so that they match the green channel. Most applications, like Photoshop or Picture Window Pro 36offer TCA correction by linear scaling. This is equal to varying the d parameter in equation [1]. 37 38See http://hugin.sf.net/tutorials/tca for a method to determine these parameters. 39 40 41=head1 OPTIONS 42 43=over 44 45=item B<--green=db|a:b:c:d> 46 47Correct radial distortion coefficient for all channels, (a, b, c, d) 48Specify 'db' for database lookup or the 4 coefficients a:b:c:d 49 50=item B<--blue=db|a:b:c:d> 51 52Correct radial distortion coefficients for blue channel, (a, b, c, d). This is 53applied on top of the B<--green> distortion coefficients, use for TCA corr 54Specify 'db' for database lookup or the 4 coefficients a:b:c:d 55 56=item B<--red=db|a:b:c:d> 57 58Correct radial distortion coefficients for red channel, (a, b, c, d). This is 59applied on top of the B<--green> distortion coefficients, use for TCA corr 60Specify 'db' for database lookup or the 4 coefficients a:b:c:d 61 62 63=item B<--camera-maker=Maker> 64 65Camera manufacturer, for database query 66 67=item B<--camera-model=Cam> 68 69Camera name, for database query 70 71=item B<--lensname=Lens> 72 73Lens name, for database query 74 75=over 76 77Specify --camera-maker and --camera-model for fixed lens cameras or --lensname for interchangeable lenses. 78 79=back 80 81=item B<--focallength=50> 82 83Specify focal length in mm, for database query 84 85=item B<--aperature=3.5> 86 87Specify aperture for vignetting data database query 88 89=item B<--dont-rescale> 90 91Do not rescale the image to avoid black borders. 92 93=item B<--flatfield=filename> 94 95Vignetting correction by flatfield division 96I = I / c, c = flatfield / mean(flatfield) 97 98=item B<--vignetting=db|a:b:c:d> 99 100Correct vignetting (by division) 101Specify db for database look up or the the 4 coefficients a:b:c:d 102I = I / ( a + b*r^2 + c*r^4 + d*r^6) 103 104=item B<--linear> 105 106Do vignetting correction in linear color space 107 108=item B<--gamma=value> 109 110Gamma of input data. 111Used for gamma correction before and after flatfield correction 112 113=item B<threads=n> 114 115Number of threads that should be used 116 117=item B<-h|--help> 118 119Display help 120 121=item B<--output=name> 122 123Set output filename. If more than one image is given, the name will be used as suffix. 124(default suffix: _corr) 125 126=item B<--compression=value> 127 128Compression of the output files. 129For jpeg output: 0-100 130For tiff output: PACKBITS, DEFLATE, LZW 131 132=item B<--offset=X:Y> 133 134Horizontal and vertical shift 135 136=item B<--verbose> 137 138Verbose 139 140=back 141 142 143=head1 AUTHORS 144 145Written by Pablo d'Angelo. Also contains contributions from Douglas Wilkins, Ippei Ukai, Ed Halley, Bruno Postle, Gerry Patterson, Brent Townshend and Thomas Modes. 146 147