MinoltaRaw.pm 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534
  1. #------------------------------------------------------------------------------
  2. # File: MinoltaRaw.pm
  3. #
  4. # Description: Read/write Konica-Minolta RAW (MRW) meta information
  5. #
  6. # Revisions: 03/11/2006 - P. Harvey Split out from Minolta.pm
  7. #
  8. # References: 1) http://www.cybercom.net/~dcoffin/dcraw/
  9. # 2) http://www.chauveau-central.net/mrw-format/
  10. # 3) Igal Milchtaich private communication (A100)
  11. #------------------------------------------------------------------------------
  12. package Image::ExifTool::MinoltaRaw;
  13. use strict;
  14. use vars qw($VERSION);
  15. use Image::ExifTool qw(:DataAccess :Utils);
  16. use Image::ExifTool::Minolta;
  17. $VERSION = '1.14';
  18. sub ProcessMRW($$;$);
  19. sub WriteMRW($$;$);
  20. # Minolta MRW tags
  21. %Image::ExifTool::MinoltaRaw::Main = (
  22. GROUPS => { 0 => 'MakerNotes', 2 => 'Camera' },
  23. PROCESS_PROC => \&Image::ExifTool::MinoltaRaw::ProcessMRW,
  24. WRITE_PROC => \&Image::ExifTool::MinoltaRaw::WriteMRW,
  25. NOTES => 'These tags are used in Minolta RAW format (MRW) images.',
  26. "\0TTW" => { # TIFF Tags
  27. Name => 'MinoltaTTW',
  28. SubDirectory => {
  29. TagTable => 'Image::ExifTool::Exif::Main',
  30. # this EXIF information starts with a TIFF header
  31. ProcessProc => \&Image::ExifTool::ProcessTIFF,
  32. WriteProc => \&Image::ExifTool::WriteTIFF,
  33. },
  34. },
  35. "\0PRD" => { # Raw Picture Dimensions
  36. Name => 'MinoltaPRD',
  37. SubDirectory => { TagTable => 'Image::ExifTool::MinoltaRaw::PRD' },
  38. },
  39. "\0WBG" => { # White Balance Gains
  40. Name => 'MinoltaWBG',
  41. SubDirectory => { TagTable => 'Image::ExifTool::MinoltaRaw::WBG' },
  42. },
  43. "\0RIF" => { # Requested Image Format
  44. Name => 'MinoltaRIF',
  45. SubDirectory => { TagTable => 'Image::ExifTool::MinoltaRaw::RIF' },
  46. },
  47. # "\0CSA" is padding
  48. );
  49. # Minolta MRW PRD information (ref 2)
  50. %Image::ExifTool::MinoltaRaw::PRD = (
  51. PROCESS_PROC => \&Image::ExifTool::ProcessBinaryData,
  52. WRITE_PROC => \&Image::ExifTool::WriteBinaryData,
  53. CHECK_PROC => \&Image::ExifTool::CheckBinaryData,
  54. WRITABLE => 1,
  55. GROUPS => { 0 => 'MakerNotes', 2 => 'Camera' },
  56. FIRST_ENTRY => 0,
  57. 0 => {
  58. Name => 'FirmwareID',
  59. Format => 'string[8]',
  60. },
  61. 8 => {
  62. Name => 'SensorHeight',
  63. Format => 'int16u',
  64. },
  65. 10 => {
  66. Name => 'SensorWidth',
  67. Format => 'int16u',
  68. },
  69. 12 => {
  70. Name => 'ImageHeight',
  71. Format => 'int16u',
  72. },
  73. 14 => {
  74. Name => 'ImageWidth',
  75. Format => 'int16u',
  76. },
  77. 16 => {
  78. Name => 'RawDepth',
  79. Format => 'int8u',
  80. },
  81. 17 => {
  82. Name => 'BitDepth',
  83. Format => 'int8u',
  84. },
  85. 18 => {
  86. Name => 'StorageMethod',
  87. Format => 'int8u',
  88. PrintConv => {
  89. 82 => 'Padded',
  90. 89 => 'Linear',
  91. },
  92. },
  93. 23 => {
  94. Name => 'BayerPattern',
  95. Format => 'int8u',
  96. PrintConv => {
  97. # 0 - seen in some Sony A850 ARW images
  98. 1 => 'RGGB',
  99. 4 => 'GBRG',
  100. },
  101. },
  102. );
  103. # Minolta MRW WBG information (ref 2)
  104. %Image::ExifTool::MinoltaRaw::WBG = (
  105. PROCESS_PROC => \&Image::ExifTool::ProcessBinaryData,
  106. WRITE_PROC => \&Image::ExifTool::WriteBinaryData,
  107. CHECK_PROC => \&Image::ExifTool::CheckBinaryData,
  108. WRITABLE => 1,
  109. GROUPS => { 0 => 'MakerNotes', 2 => 'Camera' },
  110. FIRST_ENTRY => 0,
  111. 0 => {
  112. Name => 'WBScale',
  113. Format => 'int8u[4]',
  114. },
  115. 4 => [
  116. {
  117. Condition => '$$self{Model} =~ /DiMAGE A200\b/',
  118. Name => 'WB_GBRGLevels',
  119. Format => 'int16u[4]',
  120. Notes => 'DiMAGE A200',
  121. },
  122. {
  123. Name => 'WB_RGGBLevels',
  124. Format => 'int16u[4]',
  125. Notes => 'other models',
  126. },
  127. ],
  128. );
  129. # Minolta MRW RIF information (ref 2)
  130. %Image::ExifTool::MinoltaRaw::RIF = (
  131. PROCESS_PROC => \&Image::ExifTool::ProcessBinaryData,
  132. WRITE_PROC => \&Image::ExifTool::WriteBinaryData,
  133. CHECK_PROC => \&Image::ExifTool::CheckBinaryData,
  134. WRITABLE => 1,
  135. GROUPS => { 0 => 'MakerNotes', 2 => 'Image' },
  136. FIRST_ENTRY => 0,
  137. 1 => {
  138. Name => 'Saturation',
  139. Format => 'int8s',
  140. },
  141. 2 => {
  142. Name => 'Contrast',
  143. Format => 'int8s',
  144. },
  145. 3 => {
  146. Name => 'Sharpness',
  147. Format => 'int8s',
  148. },
  149. 4 => {
  150. Name => 'WBMode',
  151. PrintConv => 'Image::ExifTool::MinoltaRaw::ConvertWBMode($val)',
  152. },
  153. 5 => {
  154. Name => 'ProgramMode',
  155. PrintConv => {
  156. 0 => 'None',
  157. 1 => 'Portrait',
  158. 2 => 'Text',
  159. 3 => 'Night Portrait',
  160. 4 => 'Sunset',
  161. 5 => 'Sports',
  162. # have seen these values in Sony ARW images: - PH
  163. # 7, 128, 129, 160
  164. },
  165. },
  166. 6 => {
  167. Name => 'ISOSetting',
  168. RawConv => '$val == 255 ? undef : $val',
  169. PrintConv => { #3
  170. 0 => 'Auto',
  171. 48 => 100,
  172. 56 => 200,
  173. 64 => 400,
  174. 72 => 800,
  175. 80 => 1600,
  176. 174 => '80 (Zone Matching Low)',
  177. 184 => '200 (Zone Matching High)',
  178. OTHER => sub {
  179. my ($val, $inv) = @_;
  180. return int(2 ** (($val-48)/8) * 100 + 0.5) unless $inv;
  181. return 48 + 8*log($val/100)/log(2) if Image::ExifTool::IsFloat($val);
  182. return undef;
  183. },
  184. },
  185. #ValueConv => '2 ** (($val-48)/8) * 100',
  186. #ValueConvInv => '48 + 8*log($val/100)/log(2)',
  187. #PrintConv => 'int($val + 0.5)',
  188. #PrintConvInv => '$val',
  189. },
  190. 7 => [
  191. {
  192. Name => 'ColorMode',
  193. Condition => '$$self{Make} !~ /^SONY/',
  194. Priority => 0,
  195. Writable => 'int32u',
  196. PrintConv => \%Image::ExifTool::Minolta::minoltaColorMode,
  197. },
  198. { #3
  199. Name => 'ColorMode',
  200. Condition => '$$self{Model} eq "DSLR-A100"',
  201. Writable => 'int32u',
  202. Notes => 'Sony A100',
  203. Priority => 0,
  204. PrintHex => 1,
  205. PrintConv => \%Image::ExifTool::Minolta::sonyColorMode,
  206. },
  207. ],
  208. # NOTE: some of these WB_RBLevels may apply to other models too...
  209. 8 => { #3
  210. Name => 'WB_RBLevelsTungsten',
  211. Condition => '$$self{Model} eq "DSLR-A100"',
  212. Format => 'int16u[2]',
  213. Notes => 'these WB_RBLevels currently decoded only for the Sony A100',
  214. },
  215. 12 => { #3
  216. Name => 'WB_RBLevelsDaylight',
  217. Condition => '$$self{Model} eq "DSLR-A100"',
  218. Format => 'int16u[2]',
  219. },
  220. 16 => { #3
  221. Name => 'WB_RBLevelsCloudy',
  222. Condition => '$$self{Model} eq "DSLR-A100"',
  223. Format => 'int16u[2]',
  224. },
  225. 20 => { #3
  226. Name => 'WB_RBLevelsCoolWhiteF',
  227. Condition => '$$self{Model} eq "DSLR-A100"',
  228. Format => 'int16u[2]',
  229. },
  230. 24 => { #3
  231. Name => 'WB_RBLevelsFlash',
  232. Condition => '$$self{Model} eq "DSLR-A100"',
  233. Format => 'int16u[2]',
  234. },
  235. 28 => { #3
  236. Name => 'WB_RBLevelsUnknown',
  237. Condition => '$$self{Model} eq "DSLR-A100"',
  238. Format => 'int16u[2]',
  239. Unknown => 1,
  240. },
  241. 32 => { #3
  242. Name => 'WB_RBLevelsShade',
  243. Condition => '$$self{Model} eq "DSLR-A100"',
  244. Format => 'int16u[2]',
  245. },
  246. 36 => { #3
  247. Name => 'WB_RBLevelsDaylightF',
  248. Condition => '$$self{Model} eq "DSLR-A100"',
  249. Format => 'int16u[2]',
  250. },
  251. 40 => { #3
  252. Name => 'WB_RBLevelsDayWhiteF',
  253. Condition => '$$self{Model} eq "DSLR-A100"',
  254. Format => 'int16u[2]',
  255. },
  256. 44 => { #3
  257. Name => 'WB_RBLevelsWhiteF',
  258. Condition => '$$self{Model} eq "DSLR-A100"',
  259. Format => 'int16u[2]',
  260. },
  261. 56 => {
  262. Name => 'ColorFilter',
  263. Condition => '$$self{Make} !~ /^SONY/',
  264. Format => 'int8s',
  265. Notes => 'Minolta models',
  266. },
  267. 57 => 'BWFilter',
  268. 58 => {
  269. Name => 'ZoneMatching',
  270. Condition => '$$self{Make} !~ /^SONY/',
  271. Priority => 0,
  272. Notes => 'Minolta models',
  273. PrintConv => {
  274. 0 => 'ISO Setting Used',
  275. 1 => 'High Key',
  276. 2 => 'Low Key',
  277. },
  278. },
  279. 59 => {
  280. Name => 'Hue',
  281. Format => 'int8s',
  282. },
  283. 60 => {
  284. Name => 'ColorTemperature',
  285. Condition => '$$self{Make} !~ /^SONY/',
  286. Notes => 'Minolta models',
  287. ValueConv => '$val * 100',
  288. ValueConvInv => '$val / 100',
  289. },
  290. 74 => { #3
  291. Name => 'ZoneMatching',
  292. Condition => '$$self{Make} =~ /^SONY/',
  293. Priority => 0,
  294. Notes => 'Sony models',
  295. PrintConv => {
  296. 0 => 'ISO Setting Used',
  297. 1 => 'High Key',
  298. 2 => 'Low Key',
  299. },
  300. },
  301. 76 => { #3
  302. Name => 'ColorTemperature',
  303. Condition => '$$self{Model} eq "DSLR-A100"',
  304. Notes => 'A100',
  305. ValueConv => '$val * 100',
  306. ValueConvInv => '$val / 100',
  307. PrintConv => '$val ? $val : "Auto"',
  308. PrintConvInv => '$val=~/Auto/i ? 0 : $val',
  309. },
  310. 77 => { #3
  311. Name => 'ColorFilter',
  312. Condition => '$$self{Model} eq "DSLR-A100"',
  313. Notes => 'A100',
  314. },
  315. 78 => { #3
  316. Name => 'ColorTemperature',
  317. Condition => '$$self{Model} =~ /^DSLR-A(200|700)$/',
  318. Notes => 'A200 and A700',
  319. ValueConv => '$val * 100',
  320. ValueConvInv => '$val / 100',
  321. PrintConv => '$val ? $val : "Auto"',
  322. PrintConvInv => '$val=~/Auto/i ? 0 : $val',
  323. },
  324. 79 => { #3
  325. Name => 'ColorFilter',
  326. Condition => '$$self{Model} =~ /^DSLR-A(200|700)$/',
  327. Notes => 'A200 and A700',
  328. },
  329. 80 => { #3
  330. Name => 'RawDataLength',
  331. Condition => '$$self{Model} eq "DSLR-A100"',
  332. Format => 'int32u',
  333. Notes => 'A100',
  334. Writable => 0,
  335. },
  336. );
  337. #------------------------------------------------------------------------------
  338. # PrintConv for WBMode
  339. sub ConvertWBMode($)
  340. {
  341. my $val = shift;
  342. my %mrwWB = (
  343. 0 => 'Auto',
  344. 1 => 'Daylight',
  345. 2 => 'Cloudy',
  346. 3 => 'Tungsten',
  347. 4 => 'Flash/Fluorescent',
  348. 5 => 'Fluorescent',
  349. 6 => 'Shade',
  350. 7 => 'User 1',
  351. 8 => 'User 2',
  352. 9 => 'User 3',
  353. 10 => 'Temperature',
  354. );
  355. my $lo = $val & 0x0f;
  356. my $wbstr = $mrwWB{$lo} || "Unknown ($lo)";
  357. my $hi = $val >> 4;
  358. $wbstr .= ' (' . ($hi - 8) . ')' if $hi >= 6 and $hi <=12;
  359. return $wbstr;
  360. }
  361. #------------------------------------------------------------------------------
  362. # Write MRW directory (eg. in ARW images)
  363. # Inputs: 0) ExifTool object ref, 1) dirInfo ref, 2) optional tag table ref
  364. # Returns: new MRW data or undef on error
  365. sub WriteMRW($$;$)
  366. {
  367. my ($et, $dirInfo, $tagTablePtr) = @_;
  368. $et or return 1; # allow dummy access
  369. my $buff = '';
  370. $$dirInfo{OutFile} = \$buff;
  371. ProcessMRW($et, $dirInfo, $tagTablePtr) > 0 or undef $buff;
  372. return $buff;
  373. }
  374. #------------------------------------------------------------------------------
  375. # Read or write Minolta MRW file
  376. # Inputs: 0) ExifTool object ref, 1) dirInfo ref, 2) optional tag table ref
  377. # Returns: 1 on success, 0 if this wasn't a valid MRW file, or -1 on write error
  378. # Notes: File pointer must be set to start of MRW in RAF upon entry
  379. sub ProcessMRW($$;$)
  380. {
  381. my ($et, $dirInfo, $tagTablePtr) = @_;
  382. my $raf = $$dirInfo{RAF};
  383. my $outfile = $$dirInfo{OutFile};
  384. my $verbose = $et->Options('Verbose');
  385. my $out = $et->Options('TextOut');
  386. my ($data, $err, $outBuff);
  387. if ($$dirInfo{DataPt}) {
  388. # make a RAF object for MRW information extracted from other file types
  389. $raf = new File::RandomAccess($$dirInfo{DataPt});
  390. # MRW information in DNG images may not start at beginning of data block
  391. $raf->Seek($$dirInfo{DirStart}, 0) if $$dirInfo{DirStart};
  392. }
  393. $raf->Read($data,8) == 8 or return 0;
  394. # "\0MRM" for big-endian (MRW images), and
  395. # "\0MRI" for little-endian (MRWInfo in ARW images)
  396. $data =~ /^\0MR([MI])/ or return 0;
  397. my $hdr = "\0MR$1";
  398. SetByteOrder($1 . $1);
  399. $et->SetFileType();
  400. $tagTablePtr = GetTagTable('Image::ExifTool::MinoltaRaw::Main');
  401. if ($outfile) {
  402. $et->InitWriteDirs('TIFF'); # use same write dirs as TIFF
  403. $outBuff = '';
  404. }
  405. my $pos = $raf->Tell();
  406. my $offset = Get32u(\$data, 4) + $pos;
  407. my $rtnVal = 1;
  408. $verbose and printf $out " [MRW Data Offset: 0x%x]\n", $offset;
  409. # loop through MRW segments (ref 1)
  410. while ($pos < $offset) {
  411. $raf->Read($data,8) == 8 or $err = 1, last;
  412. $pos += 8;
  413. my $tag = substr($data, 0, 4);
  414. my $len = Get32u(\$data, 4);
  415. if ($verbose) {
  416. print $out "MRW ",$et->Printable($tag)," segment ($len bytes):\n";
  417. if ($verbose > 2) {
  418. $raf->Read($data,$len) == $len and $raf->Seek($pos,0) or $err = 1, last;
  419. $et->VerboseDump(\$data);
  420. }
  421. }
  422. my $tagInfo = $et->GetTagInfo($tagTablePtr, $tag);
  423. if ($tagInfo and $$tagInfo{SubDirectory}) {
  424. my $subTable = GetTagTable($tagInfo->{SubDirectory}->{TagTable});
  425. my $buff;
  426. # save shift for values stored with wrong base offset
  427. $$et{MRW_WrongBase} = -($raf->Tell());
  428. $raf->Read($buff, $len) == $len or $err = 1, last;
  429. my %subdirInfo = (
  430. DataPt => \$buff,
  431. DataLen => $len,
  432. DataPos => $pos,
  433. DirStart => 0,
  434. DirLen => $len,
  435. DirName => $$tagInfo{Name},
  436. Parent => 'MRW',
  437. NoTiffEnd => 1, # no end-of-TIFF check
  438. );
  439. if ($outfile) {
  440. my $writeProc = $tagInfo->{SubDirectory}->{WriteProc};
  441. my $val = $et->WriteDirectory(\%subdirInfo, $subTable, $writeProc);
  442. if (defined $val and length $val) {
  443. # pad to an even 4 bytes (can't hurt, and it seems to be the standard)
  444. $val .= "\0" x (4 - (length($val) & 0x03)) if length($val) & 0x03;
  445. $outBuff .= $tag . Set32u(length $val) . $val;
  446. } elsif (not defined $val) {
  447. $outBuff .= $data . $buff; # copy over original information
  448. }
  449. } else {
  450. my $processProc = $tagInfo->{SubDirectory}->{ProcessProc};
  451. $et->ProcessDirectory(\%subdirInfo, $subTable, $processProc);
  452. }
  453. } elsif ($outfile) {
  454. # add this segment to the output buffer
  455. my $buff;
  456. $raf->Read($buff, $len) == $len or $err = 1, last;
  457. $outBuff .= $data . $buff;
  458. } else {
  459. # skip this segment
  460. $raf->Seek($pos+$len, 0) or $err = 1, last;
  461. }
  462. $pos += $len;
  463. }
  464. $pos == $offset or $err = 1; # meta information length check
  465. if ($outfile) {
  466. # write the file header then the buffered meta information
  467. Write($outfile, $hdr, Set32u(length $outBuff), $outBuff) or $rtnVal = -1;
  468. # copy over image data
  469. while ($raf->Read($outBuff, 65536)) {
  470. Write($outfile, $outBuff) or $rtnVal = -1;
  471. }
  472. # Sony IDC utility corrupts MRWInfo when writing ARW images,
  473. # so make this a minor error for these images
  474. $err and $et->Error("MRW format error", $$et{TIFF_TYPE} eq 'ARW');
  475. } else {
  476. $err and $et->Warn("MRW format error");
  477. }
  478. return $rtnVal;
  479. }
  480. 1; # end
  481. __END__
  482. =head1 NAME
  483. Image::ExifTool::MinoltaRaw - Read/write Konica-Minolta RAW (MRW) information
  484. =head1 SYNOPSIS
  485. This module is loaded automatically by Image::ExifTool when required.
  486. =head1 DESCRIPTION
  487. This module contains definitions required by Image::ExifTool to read and
  488. write Konica-Minolta RAW (MRW) images.
  489. =head1 AUTHOR
  490. Copyright 2003-2016, Phil Harvey (phil at owl.phy.queensu.ca)
  491. This library is free software; you can redistribute it and/or modify it
  492. under the same terms as Perl itself.
  493. =head1 REFERENCES
  494. =over 4
  495. =item L<http://www.cybercom.net/~dcoffin/dcraw/>
  496. =item L<http://www.chauveau-central.net/mrw-format/>
  497. =back
  498. =head1 SEE ALSO
  499. L<Image::ExifTool::TagNames/MinoltaRaw Tags>,
  500. L<Image::ExifTool::Minolta(3pm)|Image::ExifTool::Minolta>,
  501. L<Image::ExifTool(3pm)|Image::ExifTool>
  502. =cut