Lytro.pm 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217
  1. #------------------------------------------------------------------------------
  2. # File: Lytro.pm
  3. #
  4. # Description: Read Lytro LFP files
  5. #
  6. # Revisions: 2014-07-17 - P. Harvey Created
  7. #
  8. # References: 1) http://optics.miloush.net/lytro/TheFileFormat.aspx
  9. #------------------------------------------------------------------------------
  10. package Image::ExifTool::Lytro;
  11. use strict;
  12. use vars qw($VERSION);
  13. use Image::ExifTool qw(:DataAccess :Utils);
  14. use Image::ExifTool::Import;
  15. $VERSION = '1.02';
  16. sub ExtractTags($$$);
  17. # Lytro LFP tags (ref PH)
  18. %Image::ExifTool::Lytro::Main = (
  19. GROUPS => { 2 => 'Camera' },
  20. VARS => { NO_ID => 1 },
  21. NOTES => q{
  22. Tag definitions for Lytro Light Field Picture (LFP) files. ExifTool
  23. extracts the full JSON metadata blocks, as well as breaking them down into
  24. individual tags. All available tags are extracted from the JSON metadata,
  25. even if they don't appear in the table below.
  26. },
  27. JSONMetadata => {
  28. Notes => 'the full JSON-format metadata blocks',
  29. Binary => 1,
  30. List => 1,
  31. },
  32. EmbeddedImage => {
  33. Notes => 'JPEG image embedded in LFP files written by Lytro Desktop',
  34. Groups => { 2 => 'Preview' },
  35. Binary => 1,
  36. },
  37. Type => { Name => 'CameraType' },
  38. CameraMake => { Name => 'Make' },
  39. CameraModel => { Name => 'Model', Description => 'Camera Model Name' },
  40. CameraSerialNumber => { Name => 'SerialNumber'},
  41. CameraFirmware => { Name => 'FirmwareVersion'},
  42. DevicesAccelerometerSampleArrayTime => { Name => 'AccelerometerTime'},
  43. DevicesAccelerometerSampleArrayX => { Name => 'AccelerometerX'},
  44. DevicesAccelerometerSampleArrayY => { Name => 'AccelerometerY'},
  45. DevicesAccelerometerSampleArrayZ => { Name => 'AccelerometerZ'},
  46. DevicesClockZuluTime => {
  47. Name => 'DateTimeOriginal',
  48. Groups => { 2 => 'Time' },
  49. ValueConv => 'require Image::ExifTool::XMP; Image::ExifTool::XMP::ConvertXMPDate($val)',
  50. PrintConv => '$self->ConvertDateTime($val)',
  51. },
  52. DevicesLensFNumber => {
  53. Name => 'FNumber',
  54. PrintConv => 'Image::ExifTool::Exif::PrintFNumber($val)',
  55. },
  56. DevicesLensFocalLength => {
  57. Name => 'FocalLength',
  58. ValueConv => '$val * 1000', # convert from metres to mm
  59. PrintConv => 'sprintf("%.1f mm",$val)',
  60. },
  61. DevicesLensTemperature => {
  62. Name => 'LensTemperature',
  63. PrintConv => 'sprintf("%.1f C",$val)',
  64. },
  65. DevicesSocTemperature => {
  66. Name => 'SocTemperature',
  67. PrintConv => 'sprintf("%.1f C",$val)',
  68. },
  69. DevicesShutterFrameExposureDuration => {
  70. Name => 'FrameExposureTime',
  71. PrintConv => 'Image::ExifTool::Exif::PrintExposureTime($val)',
  72. },
  73. DevicesShutterPixelExposureDuration => {
  74. Name => 'ExposureTime',
  75. PrintConv => 'Image::ExifTool::Exif::PrintExposureTime($val)',
  76. },
  77. DevicesSensorPixelPitch => {
  78. Name => 'FocalPlaneXResolution',
  79. Notes => 'Y resolution is the same as X resolution',
  80. ValueConv => '25.4 / $val / 1000', # convert from metres to pixels/inch
  81. },
  82. DevicesSensorSensorSerial => { Name => 'SensorSerialNumber'},
  83. DevicesSensorIso => { Name => 'ISO' },
  84. ImageLimitExposureBias => { Groups => { 2 => 'Image' }, PrintConv => 'sprintf("%+.1f", $val)' },
  85. ImageModulationExposureBias => { Groups => { 2 => 'Image' }, PrintConv => 'sprintf("%+.1f", $val)' },
  86. ImageOrientation => {
  87. Name => 'Orientation',
  88. Groups => { 2 => 'Image' },
  89. PrintConv => {
  90. 1 => 'Horizontal (normal)',
  91. },
  92. },
  93. );
  94. #------------------------------------------------------------------------------
  95. # Extract tags from a parsed JSON hash
  96. # Inputs: 0) ExifTool ref, 1) tag hash ref, 2) base tag name
  97. sub ExtractTags($$$)
  98. {
  99. my ($et, $meta, $parent) = @_;
  100. ref $meta eq 'HASH' or $et->Warn('Invalid LFP metadata'), return;
  101. my ($key, $val, $name, $tagTablePtr);
  102. foreach $key (sort keys %$meta) {
  103. my $tag = $parent . ucfirst($key);
  104. foreach $val (ref $$meta{$key} eq 'ARRAY' ? @{$$meta{$key}} : $$meta{$key}) {
  105. ref $val eq 'HASH' and ExtractTags($et, $val, $tag), next;
  106. $tagTablePtr or $tagTablePtr = GetTagTable('Image::ExifTool::Lytro::Main');
  107. unless ($$tagTablePtr{$tag}) {
  108. ($name = $tag) =~ s/[^-_a-zA-Z0-9](.?)/\U$1/g;
  109. $name =~ s/ParametersVendorContentComLytroTags//;
  110. my %tagInfo;
  111. $tagInfo{Groups} = { 2 => 'Image' } unless $name =~ s/^Devices//;
  112. $tagInfo{List} = 1 if ref $$meta{$key} eq 'ARRAY';
  113. $tagInfo{Name} = $name;
  114. my $str = $tag eq $name ? '' : " as $name";
  115. $et->VPrint(0, " [adding $tag$str]\n");
  116. AddTagToTable($tagTablePtr, $tag, \%tagInfo);
  117. }
  118. $et->HandleTag($tagTablePtr, $tag, $val);
  119. }
  120. }
  121. }
  122. #------------------------------------------------------------------------------
  123. # Process segments from a Lytro LFP image
  124. # Inputs: 0) ExifTool object reference, 1) dirInfo reference
  125. # Returns: 1 on success, 0 if this wasn't a valid Lytro image
  126. sub ProcessLFP($$)
  127. {
  128. my ($et, $dirInfo) = @_;
  129. my $raf = $$dirInfo{RAF};
  130. my $verbose = $et->Options('Verbose');
  131. my ($buff, $id, %dumpParms);
  132. # validate the Lytro file header
  133. return 0 unless $raf->Read($buff, 16) == 16 and $buff =~ /^\x89LFP\x0d\x0a\x1a\x0a/;
  134. $et->SetFileType(); # set the FileType tag
  135. SetByteOrder('MM');
  136. if ($verbose > 2) {
  137. %dumpParms = ( Out => $$et{OPTIONS}{TextOut} );
  138. $dumpParms{MaxLen} = 128 if $verbose < 4;
  139. }
  140. my $tagTablePtr = GetTagTable('Image::ExifTool::Lytro::Main');
  141. while ($raf->Read($buff, 16) == 16) {
  142. $buff =~ /^\x89LF/ or $et->Warn('LFP format error'), last;
  143. my $size = Get32u(\$buff, 12);
  144. $size & 0x80000000 and $et->Warn('Invalid LFP segment size'), last;
  145. $raf->Read($id, 80) == 80 or $et->Warn('Truncated LFP segment'), last; # ignore the sha1
  146. if ($verbose) {
  147. $id =~ s/\0.*//s;
  148. $et->VPrint(0, substr($buff,1,3), " segment ($size bytes, $id)\n");
  149. }
  150. if ($size > 20000000) {
  151. $raf->Seek($size, 1) or $et->Warn('Seek error in LFP file'), last;
  152. } else {
  153. $raf->Read($buff,$size) == $size or $et->Warn('Truncated LFP data'), last;
  154. HexDump(\$buff, undef, %dumpParms, Addr=>$raf->Tell()-$size) if $verbose > 2;
  155. if ($buff =~ /^\{\s+"/) { # JSON metadata?
  156. pos($buff) = 0;
  157. $et->HandleTag($tagTablePtr, 'JSONMetadata', $buff);
  158. my $meta = Image::ExifTool::Import::ReadJSONObject(undef, \$buff);
  159. ExtractTags($et, $meta, '');
  160. } elsif ($buff =~ /^\xff\xd8\xff/) { # embedded JPEG image?
  161. $et->HandleTag($tagTablePtr, 'EmbeddedImage', $buff);
  162. }
  163. }
  164. # skip padding if necessary
  165. my $pad = 16 - ($size % 16);
  166. $raf->Seek($pad, 1) if $pad != 16;
  167. }
  168. return 1;
  169. }
  170. 1; # end
  171. __END__
  172. =head1 NAME
  173. Image::ExifTool::Lytro - Read Lytro LFP files
  174. =head1 SYNOPSIS
  175. This module is used by Image::ExifTool
  176. =head1 DESCRIPTION
  177. This module contains routines required by Image::ExifTool to read metadata
  178. from Lytro Light Field Picture (LFP) files.
  179. =head1 AUTHOR
  180. Copyright 2003-2016, Phil Harvey (phil at owl.phy.queensu.ca)
  181. This library is free software; you can redistribute it and/or modify it
  182. under the same terms as Perl itself.
  183. =head1 REFERENCES
  184. =over 4
  185. =item L<http://optics.miloush.net/lytro/TheFileFormat.aspx>
  186. =back
  187. =head1 SEE ALSO
  188. L<Image::ExifTool::TagNames/Lytro Tags>,
  189. L<Image::ExifTool(3pm)|Image::ExifTool>
  190. =cut