123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319 |
- #------------------------------------------------------------------------------
- # File: DV.pm
- #
- # Description: Read DV meta information
- #
- # Revisions: 2010/12/24 - P. Harvey Created
- #
- # References: 1) http://www.ffmpeg.org/
- # 2) http://dvswitch.alioth.debian.org/wiki/DV_format/
- #------------------------------------------------------------------------------
- package Image::ExifTool::DV;
- use strict;
- use vars qw($VERSION);
- use Image::ExifTool qw(:DataAccess :Utils);
- $VERSION = '1.01';
- # DV profiles (ref 1)
- my @dvProfiles = (
- {
- DSF => 0,
- VideoSType => 0x0,
- FrameSize => 120000,
- VideoFormat => 'IEC 61834, SMPTE-314M - 525/60 (NTSC)',
- VideoScanType => 'Progressive',
- Colorimetry => '4:1:1',
- FrameRate => 30000/1001,
- ImageHeight => 480,
- ImageWidth => 720,
- },{
- DSF => 1,
- VideoSType => 0x0,
- FrameSize => 144000,
- VideoFormat => 'IEC 61834 - 625/50 (PAL)',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:0',
- FrameRate => 25/1,
- ImageHeight => 576,
- ImageWidth => 720,
- },{
- DSF => 1,
- VideoSType => 0x0,
- FrameSize => 144000,
- VideoFormat => 'SMPTE-314M - 625/50 (PAL)',
- VideoScanType => 'Progressive',
- Colorimetry => '4:1:1',
- FrameRate => 25/1,
- ImageHeight => 576,
- ImageWidth => 720,
- },{
- DSF => 0,
- VideoSType => 0x4,
- FrameSize => 240000,
- VideoFormat => 'DVCPRO50: SMPTE-314M - 525/60 (NTSC) 50 Mbps',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:2',
- FrameRate => 30000/1001,
- ImageHeight => 480,
- ImageWidth => 720,
- },{
- DSF => 1,
- VideoSType => 0x4,
- FrameSize => 288000,
- VideoFormat => 'DVCPRO50: SMPTE-314M - 625/50 (PAL) 50 Mbps',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:2',
- FrameRate => 25/1,
- ImageHeight => 576,
- ImageWidth => 720,
- },{
- DSF => 0,
- VideoSType => 0x14,
- FrameSize => 480000,
- VideoFormat => 'DVCPRO HD: SMPTE-370M - 1080i60 100 Mbps',
- VideoScanType => 'Interlaced',
- Colorimetry => '4:2:2',
- FrameRate => 30000/1001,
- ImageHeight => 1080,
- ImageWidth => 1280,
- },{
- DSF => 1,
- VideoSType => 0x14,
- FrameSize => 576000,
- VideoFormat => 'DVCPRO HD: SMPTE-370M - 1080i50 100 Mbps',
- VideoScanType => 'Interlaced',
- Colorimetry => '4:2:2',
- FrameRate => 25/1,
- ImageHeight => 1080,
- ImageWidth => 1440,
- },{
- DSF => 0,
- VideoSType => 0x18,
- FrameSize => 240000,
- VideoFormat => 'DVCPRO HD: SMPTE-370M - 720p60 100 Mbps',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:2',
- FrameRate => 60000/1001,
- ImageHeight => 720,
- ImageWidth => 960,
- },{
- DSF => 1,
- VideoSType => 0x18,
- FrameSize => 288000,
- VideoFormat => 'DVCPRO HD: SMPTE-370M - 720p50 100 Mbps',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:2',
- FrameRate => 50/1,
- ImageHeight => 720,
- ImageWidth => 960,
- },{
- DSF => 1,
- VideoSType => 0x1,
- FrameSize => 144000,
- VideoFormat => 'IEC 61883-5 - 625/50 (PAL)',
- VideoScanType => 'Progressive',
- Colorimetry => '4:2:0',
- FrameRate => 25/1,
- ImageHeight => 576,
- ImageWidth => 720,
- },
- );
- # tags to extract, in the order we want to extract them
- my @dvTags = (
- 'DateTimeOriginal', 'ImageWidth', 'ImageHeight', 'Duration',
- 'TotalBitrate', 'VideoFormat', 'VideoScanType', 'FrameRate',
- 'AspectRatio', 'Colorimetry', 'AudioChannels', 'AudioSampleRate',
- 'AudioBitsPerSample',
- );
- # DV tags
- %Image::ExifTool::DV::Main = (
- GROUPS => { 2 => 'Video' },
- VARS => { NO_ID => 1 },
- NOTES => 'The following tags are extracted from DV videos.',
- DateTimeOriginal => {
- Groups => { 2 => 'Time' },
- PrintConv => '$self->ConvertDateTime($val)',
- },
- ImageWidth => { },
- ImageHeight => { },
- Duration => { PrintConv => 'ConvertDuration($val)' },
- TotalBitrate => { PrintConv => 'ConvertBitrate($val)' },
- VideoFormat => { },
- VideoScanType => { },
- FrameRate => { PrintConv => 'int($val * 1000 + 0.5) / 1000' },
- AspectRatio => { },
- Colorimetry => { },
- AudioChannels => { Groups => { 2 => 'Audio' } },
- AudioSampleRate => { Groups => { 2 => 'Audio' } },
- AudioBitsPerSample => { Groups => { 2 => 'Audio' } },
- );
- #------------------------------------------------------------------------------
- # Read information in a DV file (ref 1)
- # Inputs: 0) ExifTool ref, 1) dirInfo ref
- # Returns: 1 on success, 0 if this wasn't a valid DV file
- sub ProcessDV($$)
- {
- my ($et, $dirInfo) = @_;
- local $_;
- my $raf = $$dirInfo{RAF};
- my ($buff, $start, $profile, $tag, $i, $j);
- $raf->Read($buff, 12000) or return 0;
- if ($buff =~ /\x1f\x07\0[\x3f\xbf]/sg) {
- $start = pos($buff) - 4;
- } else {
- while ($buff =~ /[\0\xff]\x3f\x07\0.{76}\xff\x3f\x07\x01/sg) {
- next if pos($buff) - 163 < 0;
- $start = pos($buff) - 163;
- last;
- }
- return 0 unless defined $start;
- }
- my $len = length $buff;
- # must at least have a full DIF header
- return 0 if $start + 80 * 6 > $len;
- $et->SetFileType();
- my $pos = $start;
- my $dsf = Get8u(\$buff, $pos + 3) & 0x80 >> 7;
- my $stype = Get8u(\$buff, $pos + 80*5 + 48 + 3) & 0x1f;
- # 576i50 25Mbps 4:1:1 is a special case
- if ($dsf == 1 && $stype == 0 && Get8u(\$buff, 4) & 0x07) {
- $profile = $dvProfiles[2];
- } else {
- foreach (@dvProfiles) {
- next unless $dsf == $$_{DSF} and $stype == $$_{VideoSType};
- $profile = $_;
- last;
- }
- $profile or $et->Warn("Unrecognized DV profile"), return 1;
- }
- my $tagTablePtr = GetTagTable('Image::ExifTool::DV::Main');
- # calculate total bit rate and duration
- my $byteRate = $$profile{FrameSize} * $$profile{FrameRate};
- my $fileSize = $$et{VALUE}{FileSize};
- $$profile{TotalBitrate} = 8 * $byteRate;
- $$profile{Duration} = $fileSize / $byteRate if defined $fileSize;
- # read DVPack metadata from the VAUX DIF's to extract video tags
- delete $$profile{DateTimeOriginal};
- delete $$profile{AspectRatio};
- my ($date, $time, $is16_9);
- for ($i=1; $i<6; ++$i) {
- $pos += 80;
- my $type = Get8u(\$buff, $pos);
- next unless ($type & 0xf0) == 0x50; # look for VAUX types
- for ($j=0; $j<15; ++$j) {
- my $p = $pos + $j * 5 + 3;
- $type = Get8u(\$buff, $p);
- if ($type == 0x61) { # video control
- my $apt = Get8u(\$buff, $start + 4) & 0x07;
- my $t = Get8u(\$buff, $p + 2);
- $is16_9 = (($t & 0x07) == 0x02 or (not $apt and ($t & 0x07) == 0x07));
- } elsif ($type == 0x62) { # date
- # mask off unused bits
- my @d = unpack('C*', substr($buff, $p + 1, 4));
- # (ignore timezone in byte 0 until we can test this properly - see ref 2)
- $date = sprintf('%.2x:%.2x:%.2x', $d[3], $d[2] & 0x1f, $d[1] & 0x3f);
- if ($date =~ /[a-f]/) {
- undef $date; # invalid date
- } else {
- # add century (this will work until 2089)
- $date = ($date lt '9' ? '20' : '19') . $date;
- }
- undef $time;
- } elsif ($type == 0x63 and $date) { # time
- # (ignore frames past second in byte 0 for now - see ref 2)
- my $val = Get32u(\$buff, $p + 1) & 0x007f7f3f;
- my @t = unpack('C*', substr($buff, $p + 1, 4));
- $time = sprintf('%.2x:%.2x:%.2x', $t[3] & 0x3f, $t[2] & 0x7f, $t[1] & 0x7f);
- last;
- } else {
- undef $time; # must be consecutive
- }
- }
- }
- if ($date and $time) {
- $$profile{DateTimeOriginal} = "$date $time";
- $$profile{AspectRatio} = $is16_9 ? '16:9' : '5:4' if defined $is16_9;
- }
- # read audio tags if available
- delete $$profile{AudioSampleRate};
- delete $$profile{AudioBitsPerSample};
- delete $$profile{AudioChannels};
- $pos = $start + 80*6 + 80*16*3 + 3;
- if ($pos + 4 < $len and Get8u(\$buff, $pos) == 0x50) {
- my $smpls = Get8u(\$buff, $pos + 1);
- my $freq = (Get8u(\$buff, $pos + 4) >> 3) & 0x07;
- my $stype = Get8u(\$buff, $pos + 3) & 0x1f;
- my $quant = Get8u(\$buff, $pos + 4) & 0x07;
- if ($freq < 3) {
- $$profile{AudioSampleRate} = {0=>48000, 1=>44100, 2=>32000}->{$freq};
- }
- if ($stype < 3) {
- $stype = 2 if $stype == 0 and $quant and $freq == 2;
- $$profile{AudioChannels} = {0=>2, 1=>0, 2=>4, 3=>8}->{$stype};
- }
- $$profile{AudioBitsPerSample} = $quant ? 12 : 16;
- }
- # save our metadata
- foreach $tag (@dvTags) {
- next unless defined $$profile{$tag};
- $et->HandleTag($tagTablePtr, $tag, $$profile{$tag});
- }
- return 1;
- }
- 1; # end
- __END__
- =head1 NAME
- Image::ExifTool::DV - Read DV meta information
- =head1 SYNOPSIS
- This module is used by Image::ExifTool
- =head1 DESCRIPTION
- This module contains definitions required by Image::ExifTool to read meta
- information from DV (raw Digital Video) files.
- =head1 AUTHOR
- Copyright 2003-2016, Phil Harvey (phil at owl.phy.queensu.ca)
- This library is free software; you can redistribute it and/or modify it
- under the same terms as Perl itself.
- =head1 REFERENCES
- =over 4
- =item L<http://ffmpeg.org/>
- =item L<http://dvswitch.alioth.debian.org/wiki/DV_format/>
- =back
- =head1 SEE ALSO
- L<Image::ExifTool::TagNames/DV Tags>,
- L<Image::ExifTool(3pm)|Image::ExifTool>
- =cut
|