RubyGems - mini_exiftool_vendored - Versions diffs - 8.9.7.v2 → 9.2.7.v1 - Mend

mini_exiftool_vendored 8.9.7.v2 → 9.2.7.v1

Files changed (1023) hide show

data/vendor/Image-ExifTool-8.97/lib/Image/ExifTool/HtmlDump.pm DELETED

@@ -1,886 +0,0 @@
-#------------------------------------------------------------------------------
-# File:         HtmlDump.pm
-#
-# Description:  Dump information in hex to HTML page
-#
-# Revisions:    12/05/2005 - P. Harvey Created
-#------------------------------------------------------------------------------
-package Image::ExifTool::HtmlDump;
-use strict;
-use vars qw($VERSION);
-use Image::ExifTool;    # only for FinishTiffDump()
-use Image::ExifTool::HTML qw(EscapeHTML);
-$VERSION = '1.30';
-sub DumpTable($$$;$$$$$);
-sub Open($$$;@);
-sub Write($@);
-my ($bkgStart, $bkgEnd, @bkgSpan);
-my $htmlHeader1 = <<_END_PART_1_;
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
- "http://www.w3.org/TR/1998/REC-html40-19980424/loose.dtd">
-<html>
-<head>
-<title>
-_END_PART_1_
-# Note: Don't change font-weight style because it can affect line height
-my $htmlHeader2 = <<_END_PART_2_;
-</title>
-<style type="text/css">
-<!--
-/* character style ID's */
-.D { color: #000000 } /* default color */
-.V { color: #ff0000 } /* duplicate block 1 */
-.W { color: #004400 } /* normal block 1 */
-.X { color: #ff4488 } /* duplicate block 2 */
-.Y { color: #448844 } /* normal block 2 */
-.U { color: #cc8844 } /* unused data block */
-.H { color: #0000ff } /* highlighted tag name */
-.F { color: #aa00dd } /* actual offset differs */
-.M { text-decoration: underline } /* maker notes data */
-.tt { /* tooltip text */
-    visibility: hidden;
-    position: absolute;
-    white-space: nowrap;
-    top: 0;
-    left: 0;
-    font-family: Verdana, sans-serif;
-    font-size: .7em;
-    padding: 2px 4px;
-    border: 1px solid gray;
-    z-index: 3;
-}
-.tb { /* tooltip background */
-    visibility: hidden;
-    position: absolute;
-    background: #ffffdd;
-    opacity: 0.8;
-    -moz-opacity: 0.8;
-    filter: alpha(opacity=80);
-    -ms-filter: 'progid:DXImageTransform.Microsoft.Alpha(Opacity=80)';
-    z-index: 2;
-}
-/* table styles */
-table.dump {
-  border-top: 1px solid gray;
-  border-bottom: 1px solid gray;
-}
-table.dump td { padding: .2em .3em }
-td.c2 {
-  border-left: 1px solid gray;
-  border-right: 1px solid gray;
-}
-pre   { margin: 0 }
-table { font-size: .9em }
-body  { color: black; background: white }
--->
-</style>
-<script language="JavaScript" type="text/JavaScript">
-<!-- Begin
-// tooltip positioning constants
-var TMAR = 4;   // top/left margins
-var BMAR = 16;  // bottom/right margins (scrollbars may overhang inner dimensions)
-var XOFF = 10;  // x offset from cursor
-var YOFF = 40;  // y offset
-var YMIN = 10;  // minimum y offset
-var YTOP = 20;  // y offset when above cursor
-// common variables
-var safari1 = navigator.userAgent.indexOf("Safari/312.6") >= 0;
-var ie6 = navigator.userAgent.toLowerCase().indexOf('msie 6') >= 0;
-var mspan = new Array;
-var hlist, tt, tb;
-function GetElementsByClass(classname, tagname) {
-  var found = new Array();
-  var list = document.getElementsByTagName(tagname);
-  var len = list.length;
-  for (var i=0, j=0; i<len; ++i) {
-    var classes = list[i].className.split(' ');
-    for (var k=0; k<classes.length; ++k) {
-      if (classes[k] == classname) {
-        found[j++] = list[i];
-        break;
-      }
-    }
-  }
-  delete list;
-  return found;
-}
-// move tooltip
-function move(e)
-{
-  if (!tt) return;
-  if (ie6 && (tt.style.top  == '' || tt.style.top  == 0) &&
-             (tt.style.left == '' || tt.style.left == 0))
-  {
-    tt.style.width  = tt.offsetWidth  + 'px';
-    tt.style.height = tt.offsetHeight + 'px';
-  }
-  var w, h;
-  // browser inconsistencies make getting window size more complex than it should be,
-  // and even then we don't know if it is smaller due to scrollbar width
-  if (typeof(window.innerWidth) == 'number') {
-    w = window.innerWidth;
-    h = window.innerHeight;
-  } else if (document.documentElement && document.documentElement.clientWidth) {
-    w = document.documentElement.clientWidth;
-    h = document.documentElement.clientHeight;
-  } else {
-    w = document.body.clientWidth;
-    h = document.body.clientHeight;
-  }
-  var x = e.clientX + XOFF;
-  var y = e.clientY + YOFF;
-  if (safari1) { // patch for people still using OS X 10.3.9
-    x -= document.body.scrollLeft + document.documentElement.scrollLeft;
-    y -= document.body.scrollTop  + document.documentElement.scrollTop;
-  }
-  var mx = w - BMAR - tt.offsetWidth;
-  var my = h - BMAR - tt.offsetHeight;
-  if (y > my + YOFF - YMIN) y = e.clientY - YTOP - tt.offsetHeight;
-  if (x > mx) x = mx;
-  if (y > my) y = my;
-  if (x < TMAR) x = TMAR;
-  if (y < TMAR) y = TMAR;
-  x += document.body.scrollLeft + document.documentElement.scrollLeft;
-  y += document.body.scrollTop  + document.documentElement.scrollTop;
-  tb.style.width  = tt.offsetWidth  + 'px';
-  tb.style.height = tt.offsetHeight + 'px';
-  tt.style.top  = tb.style.top  = y + 'px';
-  tt.style.left = tb.style.left = x + 'px';
-  tt.style.visibility = tb.style.visibility = 'visible';
-}
-// highlight/unhighlight text
-function high(e,on) {
-  var targ;
-  if (e.target) targ = e.target;
-  else if (e.srcElement) targ = e.srcElement;
-  if (targ.nodeType == 3) targ = targ.parentNode; // defeat Safari bug
-  if (!targ.name) targ = targ.parentNode; // go up another level if necessary
-  if (targ.name && document.getElementsByName) {
-    // un-highlight current objects
-    if (hlist) {
-      for (var i=0; i<hlist.length; ++i) {
-        hlist[i].style.background = 'transparent';
-      }
-      hlist = null;
-    }
-    if (tt) {
-      // hide old tooltip
-      tt.style.visibility = tb.style.visibility = 'hidden';
-      tt = null;
-    }
-    if (on) {
-      if (targ.name.substring(0,1) == 't') {
-        // show our tooltip (ID is different than name to avoid confusing IE)
-        tt = document.getElementById('p' + targ.name.substring(1));
-        if (tt) {
-          tb = document.getElementById('tb');
-          move(e);
-        }
-      }
-      // highlight anchor elements with the same name
-      hlist = document.getElementsByName(targ.name);
-      // use class name to highlight span elements if necessary
-      for (var i=0; i<mspan.length; ++i) {
-        if (mspan[i] != targ.name) continue;
-        var slist = GetElementsByClass(targ.name, 'span');
-        // add elements from hlist collection to our array
-        for (var j=0; j<hlist.length; ++j) {
-            slist[slist.length] = hlist[j];
-        }
-        hlist = slist;
-        break;
-      }
-      for (var j=0; j<hlist.length; ++j) {
-        hlist[j].style.background = '#ffcc99';
-      }
-    }
-  }
-}
-_END_PART_2_
-my $htmlHeader3 = q[
-// End --->
-</script></head>
-<body><noscript><b class=V>--&gt;
-Enable JavaScript for active highlighting and information tool tips!
-</b></noscript>
-<table class=dump cellspacing=0 cellpadding=2>
-<tr><td valign='top'><pre>];
-my $preMouse = q(<pre onmouseover="high(event,1)" onmouseout="high(event,0)" onmousemove="move(event)">);
-#------------------------------------------------------------------------------
-# New - create new HtmlDump object
-# Inputs: 0) reference to HtmlDump object or HtmlDump class name
-sub new
-{
-    local $_;
-    my $that = shift;
-    my $class = ref($that) || $that || 'Image::ExifTool::HtmlDump';
-    return bless { Block => {}, TipNum => 0 }, $class;
-}
-#------------------------------------------------------------------------------
-# Add information to dump
-# Inputs: 0) HTML dump hash ref, 1) absolute offset in file, 2) data size,
-#         3) comment string, 4) tool tip (or SAME to use previous tip),
-#         5) bit flags (see below)
-# Bits: 0x01 - print at start of line
-#       0x02 - print red address
-#       0x04 - maker notes data ('M'-class span)
-#       0x08 - limit block length
-#       0x10 - allow double references
-#       0x100 - (reserved)
-# Notes: Block will be shown in 'unused' color if comment string begins with '['
-sub Add($$$$;$)
-{
-    my ($self, $start, $size, $msg, $tip, $flag) = @_;
-    my $block = $$self{Block};
-    $$block{$start} or $$block{$start} = [ ];
-    my $htip;
-    if ($tip and $tip eq 'SAME') {
-        $htip = '';
-    } else {
-        # use message as first line of tip, and make bold unless in brackets
-        $htip = ($msg =~ /^[[(]/) ? $msg : "<b>$msg</b>";
-        if (defined $tip) {
-            ($tip = EscapeHTML($tip)) =~ s/\n/<br>/g;   # HTML-ize tooltip text
-            $htip .= '<br>' . $tip;
-        }
-        # add size if not already done
-        $htip .= "<br>($size bytes)" unless $htip =~ /<br>Size:/;
-        ++$self->{TipNum};
-    }
-    push @{$$block{$start}}, [ $size, $msg, $htip, $flag, $self->{TipNum} ];
-}
-#------------------------------------------------------------------------------
-# Print dump information to HTML page
-# Inputs: 0) Dump information hash reference, 1) source file RAF reference,
-#         2) data pointer, 3) data position, 4) output file or scalar reference,
-#         5) limit level (1-3), 6) title
-# Returns: non-zero if useful output was generated,
-#          or -1 on error loading data and "ERROR" is set to offending data name
-# Note: The "Error" member may be set externally to print a specific error
-#       message instead of doing the dump.
-sub Print($$;$$$$$)
-{
-    local $_;
-    my ($self, $raf, $dataPt, $dataPos, $outfile, $level, $title) = @_;
-    my ($i, $buff, $rtnVal, $limit, $err);
-    my $block = $$self{Block};
-    $dataPos = 0 unless $dataPos;
-    $outfile = \*STDOUT unless ref $outfile;
-    $title = 'HtmlDump' unless $title;
-    $level or $level = 0;
-    my $tell = $raf->Tell();
-    my $pos = 0;
-    my $dataEnd = $dataPos + ($dataPt ? length($$dataPt) : 0);
-    # initialize member variables
-    $$self{Open} = [];
-    $$self{Closed} = [];
-    $$self{TipList} = [];
-    $$self{MSpanList} = [];
-    $$self{Cols} = [ '', '', '', '' ];  # text columns
-    # set dump size limits (limits are 4x smaller if bit 0x08 set in flags)
-    if ($level <= 1) {
-        $limit = 1024;
-    } elsif ($level <= 2) {
-        $limit = 16384;
-    } else {
-        $limit = 256 * 1024 * 1024; # never dump bigger than 256 MB
-    }
-    $$self{Limit} = $limit;
-    # pre-initialize open/closed hashes for all columns
-    for ($i=0; $i<4; ++$i) {
-        $self->{Open}->[$i] = { ID => [ ], Element => { } };
-        $self->{Closed}->[$i] = { ID => [ ], Element => { } };
-    }
-    $bkgStart = $bkgEnd = 0;
-    undef @bkgSpan;
-    my $index = 0;  # initialize tooltip index
-    my (@names, $wasUnused, @starts);
-    # only do dump if we didn't have a serious error
-    @starts = sort { $a <=> $b } keys %$block unless $$self{Error};
-    for ($i=0; $i<@starts; ++$i) {
-        my $start = $starts[$i];
-        my $parmList = $$block{$start};
-        my $len = $start - $pos;
-        if ($len > 0 and not $wasUnused) {
-            # we have an unused bytes before this data block
-            --$i;           # dump the data block next time around
-            # split unused data into 2 blocks if it spans end of a bkg block
-            my ($nextBkgEnd, $bkg);
-            if (not defined $wasUnused and $bkgEnd) {
-                foreach $bkg (@bkgSpan) {
-                    next if $pos >= $$bkg{End} + $dataPos or $pos + $len <= $$bkg{End} + $dataPos;
-                    $nextBkgEnd = $$bkg{End} unless $nextBkgEnd and $nextBkgEnd < $$bkg{End};
-                }
-            }
-            if ($nextBkgEnd) {
-                $start = $pos;
-                $len = $nextBkgEnd + $dataPos - $pos;
-                $wasUnused = 0;
-            } else {
-                $start = $pos;  # dump the unused bytes now
-                $wasUnused = 1; # avoid re-dumping unused bytes if we get a read error
-            }
-            my $str = ($len > 1) ? "unused $len bytes" : 'pad byte';
-            $parmList = [ [ $len, "[$str]", undef, 0x108 ] ];
-        } else {
-            undef $wasUnused;
-        }
-        my $parms;
-        foreach $parms (@$parmList) {
-            my ($len, $msg, $tip, $flag, $tipNum) = @$parms;
-            next unless $len > 0;
-            $flag = 0 unless defined $flag;
-            # generate same name for all blocks indexed by this tooltip
-            my $name;
-            $name = $names[$tipNum] if defined $tipNum;
-            my $idx = $index;
-            if ($name) {
-                # get index from existing ID
-                $idx = substr($name, 1);
-            } else {
-                $name = "t$index";
-                $names[$tipNum] = $name if defined $tipNum;
-                ++$index;
-            }
-            if ($flag & 0x14) {
-                my %bkg = (
-                    Class => $flag & 0x04 ? "$name M" : $name,
-                    Start => $start - $dataPos,
-                    End   => $start - $dataPos + $len,
-                );
-                push @bkgSpan, \%bkg;
-                $bkgStart = $bkg{Start} unless $bkgStart and $bkgStart < $bkg{Start};
-                $bkgEnd = $bkg{End} unless $bkgEnd and $bkgEnd > $bkg{End};
-                push @{$self->{MSpanList}}, $name;
-                next;
-            }
-            # loop until we read the value properly
-            my ($end, $try);
-            for ($try=0; $try<2; ++$try) {
-                $end = $start + $len;
-                # only load as much of the block as we are going to dump
-                my $size = ($len > $limit) ? $limit / 2 : $len;
-                if ($start >= $dataPos and $end <= $dataEnd) {
-                    $buff = substr($$dataPt, $start-$dataPos, $size);
-                    if ($len != $size) {
-                        $buff .= substr($$dataPt, $start-$dataPos+$len-$size, $size);
-                    }
-                } else {
-                    $buff = '';
-                    if ($raf->Seek($start, 0) and $raf->Read($buff, $size) == $size) {
-                        # read end of block
-                        if ($len != $size) {
-                            my $buf2 = '';
-                            unless ($raf->Seek($start+$len-$size, 0) and
-                                    $raf->Read($buf2, $size) == $size)
-                            {
-                                $err = $msg;
-                                # reset $len to the actual length of available data
-                                $raf->Seek(0, 2);
-                                $len = $raf->Tell() - $start;
-                                $tip .= "<br>Error: Only $len bytes available!" if $tip;
-                                next;
-                            }
-                            $buff .= $buf2;
-                            undef $buf2;
-                        }
-                    } else {
-                        $err = $msg;
-                        $len = length $buff;
-                        $tip .= "<br>Error: Only $len bytes available!" if $tip;
-                    }
-                }
-                last;
-            }
-            $tip and $self->{TipList}->[$idx] = $tip;
-            next unless length $buff;
-            # set flag to continue this line if next block is contiguous
-            if ($i+1 < @starts and $parms eq $$parmList[-1] and
-                ($end == $starts[$i+1] or ($end < $starts[$i+1] and $end >= $pos)))
-            {
-                my $nextFlag = $block->{$starts[$i+1]}->[0]->[3] || 0;
-                $flag |= 0x100 unless $flag & 0x01 or $nextFlag & 0x01;
-            }
-            $self->DumpTable($start-$dataPos, \$buff, $msg, $name,
-                             $flag, $len, $pos-$dataPos);
-            undef $buff;
-            $pos = $end if $pos < $end;
-        }
-    }
-    $self->Open('','');     # close all open elements
-    $raf->Seek($tell,0);
-    # write output HTML file
-    Write($outfile, $htmlHeader1, $title);
-    if ($self->{Cols}->[0]) {
-        Write($outfile, $htmlHeader2);
-        my $mspan = \@{$$self{MSpanList}};
-        for ($i=0; $i<@$mspan; ++$i) {
-            Write($outfile, qq(mspan[$i] = "$$mspan[$i]";\n));
-        }
-        Write($outfile, $htmlHeader3, $self->{Cols}->[0]);
-        Write($outfile, '</pre></td><td valign="top">',
-                        $preMouse, $self->{Cols}->[1]);
-        Write($outfile, '</pre></td><td class=c2 valign="top">',
-                        $preMouse, $self->{Cols}->[2]);
-        Write($outfile, '</pre></td><td valign="top">',
-                        $preMouse, $self->{Cols}->[3]);
-        Write($outfile, "</pre></td></tr></table>\n<div id=tb class=tb> </div>\n");
-        my $tips = \@{$$self{TipList}};
-        for ($i=0; $i<@$tips; ++$i) {
-            my $tip = $$tips[$i];
-            Write($outfile, "<div id=p$i class=tt>$tip</div>\n") if defined $tip;
-        }
-        delete $$self{TipList};
-        $rtnVal = 1;
-    } else {
-        my $err = $$self{Error} || 'No EXIF or TIFF information found in image';
-        Write($outfile, "$title</title></head><body>\n$err\n");
-        $rtnVal = 0;
-    }
-    Write($outfile, "</body></html>\n");
-    for ($i=0; $i<4; ++$i) {
-        $self->{Cols}->[$i] = '';   # free memory
-    }
-    if ($err) {
-        $err =~ tr/()//d;
-        $$self{ERROR} = $err;
-        return -1;
-    }
-    return $rtnVal;
-}
-#------------------------------------------------------------------------------
-# Open or close a specified html element
-# Inputs: 0) HtmlDump object ref, 1) element id, 2) element string,
-#         3-N) list of column numbers (empty for all columns)
-# - element id may be '' to close all elements
-# - element string may be '' to close element by ID (or 0 to close without reopening)
-# - element id and string may both be 1 to reopen temporarily closed elements
-sub Open($$$;@)
-{
-    my ($self, $id, $element, @colNums) = @_;
-    # loop through specified columns
-    @colNums or @colNums = (0 .. $#{$self->{Open}});
-    my $col;
-    foreach $col (@colNums) {
-        # get information about open elements in this column
-        my $opHash = $self->{Open}->[$col];
-        my $opElem = $$opHash{Element};
-        if ($element) {
-            # next if already open
-            next if $$opElem{$id} and $$opElem{$id} eq $element;
-        } elsif ($id and not $$opElem{$id}) {
-            # next if already closed and nothing to reopen
-            next unless $element eq '' and @{$self->{Closed}->[$col]->{ID}};
-        }
-        my $opID = $$opHash{ID};
-        my $clHash = $self->{Closed}->[$col];
-        my $clID = $$clHash{ID};
-        my $clElem = $$clHash{Element};
-        # get reference to output column list (use temp list if available)
-        my $cols = $$self{TmpCols} || $$self{Cols};
-        # close everything down to this element if necessary
-        if ($$opElem{$id} or not $id) {
-            while (@$opID) {
-                my $tid = pop @$opID;
-                my $e = $$opElem{$tid};
-                $e =~ s/^<(\S+).*/<\/$1>/s;
-                $$cols[$col] .= $e;
-                if ($id eq $tid or not $id) {
-                    delete $$opElem{$tid};
-                    last if $id;
-                    next;
-                }
-                # add this to the temporarily closed list
-                # (because we really didn't want to close it)
-                push @$clID, $tid;
-                $$clElem{$tid} = $$opElem{$tid};
-                delete $$opElem{$tid};
-            }
-            unless ($id) {
-                # forget all temporarily closed elements
-                $clID = $$clHash{ID} = [ ];
-                $clElem = $$clHash{Element} = { };
-            }
-        } elsif ($$clElem{$id}) {
-            # delete from the list of temporarily closed elements
-            delete $$clElem{$id};
-            @$clID = grep !/^$id$/, @$clID;
-        }
-        next if $element eq '0'; # 0 = don't reopen temporarily closed elements
-        # re-open temporarily closed elements
-        while (@$clID) {
-            my $tid = pop @$clID;
-            $$cols[$col] .= $$clElem{$tid};
-            push @$opID, $tid;
-            $$opElem{$tid} = $$clElem{$tid};
-            delete $$clElem{$tid};
-        }
-        # open specified element
-        if ($element and $element ne '1') {
-            $$cols[$col] .= $element;
-            push @$opID, $id;
-            $$opElem{$id} = $element;
-        }
-    }
-}
-#------------------------------------------------------------------------------
-# Dump a block of data in HTML table form
-# Inputs: 0) HtmlDump object ref, 1) data position, 2) block pointer,
-#         3) message, 4) object name, 5) flag, 6) full block length (actual
-#         data may be shorter), 7) data end position
-sub DumpTable($$$;$$$$$)
-{
-    my ($self, $pos, $blockPt, $msg, $name, $flag, $len, $endPos) = @_;
-    $len = length $$blockPt unless defined $len;
-    $endPos = 0 unless $endPos;
-    my ($f0, $dblRef, $id);
-    my $skipped = 0;
-    if (($endPos and $pos < $endPos) or $flag & 0x02) {
-        # display double-reference addresses in red
-        $f0 = "<span class=V>";
-        $dblRef = 1 if $endPos and $pos < $endPos;
-    } else {
-        $f0 = '';
-    }
-    my @c = ('','','','');
-    $$self{TmpCols} = \@c;
-    if ($name) {
-        if ($msg and $msg =~ /^\[/) {
-            $id = 'U';
-        } else {
-            if ($$self{A}) {
-                $id = 'X';
-                $$self{A} = 0;
-            } else {
-                $id = 'V';
-                $$self{A} = 1;
-            }
-            ++$id unless $dblRef;
-        }
-        $name = "<a name=$name class=$id>";
-        $msg and $msg = "$name$msg</a>";
-    } else {
-        $name = '';
-    }
-    # use base-relative offsets from now on
-    my $cols = 0;
-    my $p = $pos;
-    if ($$self{Cont}) {
-        $cols = $pos & 0x0f;
-        $c[1] .= ($cols == 8) ? '  ' : ' ';
-    } else {
-        my $addr = $pos < 0 ? sprintf("-%.4x",-$pos) : sprintf("%5.4x",$pos);
-        $self->Open('fgd', $f0, 0);
-        $self->Open('fgd', '', 3);
-        $c[0] .= "$addr";
-        $p -= $pos & 0x0f unless $flag & 0x01;
-        if ($p < $pos) {
-            $self->Open('bkg', '', 1, 2); # don't underline white space
-            $cols = $pos - $p;
-            my $n = 3 * $cols;
-            ++$n if $cols > 7;
-            $c[1] .= ' ' x $n;
-            $c[2] .= ' ' x $cols;
-            $p = $pos;
-        }
-    }
-    # loop through each column of hex numbers
-    for (;;) {
-        my (@spanClass, @spanCont, $spanClose, $bkg);
-        if ($p >= $bkgStart and $p < $bkgEnd) {
-            foreach $bkg (@bkgSpan) {
-                next unless $p >= $$bkg{Start} and $p < $$bkg{End};
-                push @spanClass, $$bkg{Class};
-                if ($p + 1 == $$bkg{End}) {
-                    $spanClose = 1;
-                } else {
-                    push @spanCont, $$bkg{Class};   # this span continues
-                }
-            }
-            $self->Open('bkg', @spanClass ? "<span class='@spanClass'>" : '', 1, 2);
-        } else {
-            $self->Open('bkg', '', 1, 2);
-        }
-        $self->Open('a', $name, 1, 2);
-        my $ch = substr($$blockPt,$p-$pos-$skipped,1);
-        $c[1] .= sprintf("%.2x", ord($ch));
-        # make the character HTML-friendly
-        $ch =~ tr/\x00-\x1f\x7f-\xff/./;
-        $ch =~ s/&/&amp;/g;
-        $ch =~ s/>/&gt;/g;
-        $ch =~ s/</&lt;/g;
-        $c[2] .= $ch;
-        ++$p;
-        ++$cols;
-        # close necessary elements
-        if ($spanClose) {
-            my $spanCont = @spanCont ? "<span class='@spanCont'>" : '';
-            # close without reopening if closing anchor later
-            my $arg = ($p - $pos >= $len) ? 0 : $spanCont;
-            $self->Open('bkg', $arg, 1, 2);
-        }
-        if ($dblRef and $p >= $endPos) {
-            $dblRef = 0;
-            ++$id;
-            $name =~ s/class=\w\b/class=$id/;
-            $f0 = '';
-            $self->Open('fgd', $f0, 0);
-        }
-        if ($p - $pos >= $len) {
-            $self->Open('a', '', 1, 2);     # close our anchor
-            last;
-        }
-        if ($cols < 16) {
-            $c[1] .= ($cols == 8 ? '  ' : ' ');
-            next;
-        } elsif ($flag & 0x01 and $cols < $len) {
-            $c[1] .= ' ';
-            next;   # put it all on one line
-        }
-        unless ($$self{Msg}) {
-            $c[3] .= $msg;
-            $msg = '';
-        }
-        $_ .= "\n" foreach @c;  # add CR to all lines
-        $$self{Msg} = 0;
-        # limit data length if specified
-        if ($$self{Limit}) {
-            my $div = ($flag & 0x08) ? 4 : 1;
-            my $lim = $$self{Limit} / (2 * $div) - 16;
-            if ($p - $pos > $lim and $len - $p + $pos > $lim) {
-                my $n = ($len - $p + $pos - $lim) & ~0x0f;
-                if ($n > 16) { # (no use just cutting out one line)
-                    $self->Open('bkg', '', 1, 2); # no underline
-                    my $note = sprintf "[snip %d lines]", $n / 16;
-                    $note = (' ' x (24-length($note)/2)) . $note;
-                    $c[0] .= "  ...\n";
-                    $c[1] .= $note . (' ' x (48-length($note))) . "\n";
-                    $c[2] .= "     [snip]     \n";
-                    $c[3] .= "\n";
-                    $p += $n;
-                    $skipped += $len - length $$blockPt;
-                }
-            }
-        }
-        $c[0] .= ($p < 0 ? sprintf("-%.4x",-$p) : sprintf("%5.4x",$p));
-        $cols = 0;
-    }
-    if ($msg) {
-        $msg = " $msg" if $$self{Msg};
-        $c[3] .= $msg;
-    }
-    if ($flag & 0x100 and $cols < 16) {    # continue on same line?
-        $$self{Cont} = 1;
-        $$self{Msg} = 1 if $msg;
-    } else {
-        $_ .= "\n" foreach @c;
-        $$self{Msg} = 0;
-        $$self{Cont} = 0;
-    }
-    # add temporary column data to our real columns
-    my $i;
-    for ($i=0; $i<4; ++$i) {
-        $self->{Cols}->[$i] .= $c[$i];
-    }
-    delete $$self{TmpCols};
-}
-#------------------------------------------------------------------------------
-# Finish dumping of TIFF image data
-# Inputs: 0) HtmlDump object ref, 1) ExifTool object ref, 2) length of file
-# (this really belongs in Image::ExifTool::Exif, but is placed here so it
-#  is only compiled when needed)
-sub FinishTiffDump($$$)
-{
-    my ($self, $exifTool, $size) = @_;
-    my ($tag, $key, $start, $blockInfo, $i);
-    # list of all indirectly referenced TIFF data tags
-    my %offsetPair = (
-        StripOffsets      => 'StripByteCounts',
-        TileOffsets       => 'TileByteCounts',
-        FreeOffsets       => 'FreeByteCounts',
-        ThumbnailOffset   => 'ThumbnailLength',
-        PreviewImageStart => 'PreviewImageLength',
-        JpgFromRawStart   => 'JpgFromRawLength',
-        OtherImageStart   => 'OtherImageLength',
-        ImageOffset       => 'ImageByteCount',
-        AlphaOffset       => 'AlphaByteCount',
-        MPImageStart      => 'MPImageLength',
-        IDCPreviewStart   => 'IDCPreviewLength',
-    );
-    # add TIFF data to html dump
-    foreach $tag (keys %offsetPair) {
-        my $info = $exifTool->GetInfo($tag);
-        next unless %$info;
-        # Panasonic hack: StripOffsets is not valid for Panasonic RW2 files,
-        # and StripRowBytes is not valid for some RAW images
-        if ($tag eq 'StripOffsets' and $exifTool->{TAG_INFO}{$tag}{PanasonicHack}) {
-            # use RawDataOffset instead if available since it is valid in RW2
-            my $info2 = $exifTool->GetInfo('RawDataOffset');
-            $info2 = $info unless %$info2;
-            my @keys = keys %$info2;
-            my $offset = $$info2{$keys[0]};
-            my $raf = $$exifTool{RAF};
-            # ignore StripByteCounts and assume raw data runs to the end of file
-            if (@keys == 1 and $offset =~ /^\d+$/ and $raf) {
-                my $pos = $raf->Tell();
-                $raf->Seek(0, 2);   # seek to end
-                my $len = $raf->Tell() - $offset;
-                $raf->Seek($pos, 0);
-                if ($len > 0) {
-                    $self->Add($offset, $len, "(Panasonic raw data)", "Size: $len bytes", 0x08);
-                    next;
-                }
-            }
-        }
-        # loop through all offsets tags
-        foreach $key (keys %$info) {
-            my $name = Image::ExifTool::GetTagName($key);
-            my $grp1 = $exifTool->GetGroup($key, 1);
-            my $info2 = $exifTool->GetInfo($offsetPair{$tag}, { Group1 => $grp1 });
-            my $key2 = $offsetPair{$tag};
-            $key2 .= $1 if $key =~ /( .*)/; # use same instance number as $tag
-            next unless $$info2{$key2};
-            my $offsets = $$info{$key};
-            my $byteCounts = $$info2{$key2};
-            # ignore primary MPImage (this is the whole JPEG)
-            next if $tag eq 'MPImageStart' and $offsets eq '0';
-            # (long lists may be SCALAR references)
-            my @offsets = split ' ', (ref $offsets ? $$offsets : $offsets);
-            my @byteCounts = split ' ', (ref $byteCounts ? $$byteCounts : $byteCounts);
-            my $num = scalar @offsets;
-            my $li = 0;
-            my $padBytes = 0;
-            for ($i=0; @offsets and @byteCounts; ++$i) {
-                my $offset = shift @offsets;
-                my $byteCount = shift @byteCounts;
-                my $end = $offset + $byteCount;
-                if (@offsets and @byteCounts) {
-                    # show data as contiguous if only normal pad bytes between blocks
-                    if ($end & 0x01 and $end + 1 == $offsets[0]) {
-                        $end += 1;
-                        ++$padBytes;    # count them
-                    }
-                    if ($end == $offsets[0]) {
-                        # combine these two blocks
-                        $byteCounts[0] += $offsets[0] - $offset;
-                        $offsets[0] = $offset;
-                        next;
-                    }
-                }
-                my $msg = $exifTool->GetGroup($key, 1) . ':' . $tag;
-                $msg =~ s/(Offsets?|Start)$/ /;
-                if ($num > 1) {
-                    $msg .= "$li-" if $li != $i;
-                    $msg .= "$i ";
-                    $li = $i + 1;
-                }
-                $msg .= "data";
-                my $tip = "Size: $byteCount bytes";
-                $tip .= ", incl. $padBytes pad bytes" if $padBytes;
-                $self->Add($offset, $byteCount, "($msg)", $tip, 0x08);
-            }
-        }
-    }
-    # find offset of last dumped information, and dump any unknown trailer
-    my $last = 0;
-    my $block = $$self{Block};
-    foreach $start (keys %$block) {
-        foreach $blockInfo (@{$$block{$start}}) {
-            my $end = $start + $$blockInfo[0];
-            $last = $end if $last < $end;
-        }
-    }
-    my $diff = $size - $last;
-    if ($diff > 0 and ($last or $exifTool->Options('Unknown'))) {
-        if ($diff > 1 or $size & 0x01) {
-            $self->Add($last, $diff, "[unknown data]", "Size: $diff bytes", 0x08);
-        } else {
-            $self->Add($last, $diff, "[trailing pad byte]", undef, 0x08);
-        }
-    }
-}
-#------------------------------------------------------------------------------
-# utility routine to write to file or memory
-# Inputs: 0) file or scalar reference, 1-N) list of stuff to write
-# Returns: true on success
-sub Write($@)
-{
-    my $outfile = shift;
-    if (UNIVERSAL::isa($outfile,'GLOB')) {
-        return print $outfile @_;
-    } elsif (ref $outfile eq 'SCALAR') {
-        $$outfile .= join('', @_);
-        return 1;
-    }
-    return 0;
-}
-1;  # end
-__END__
-=head1 NAME
-Image::ExifTool::HtmlDump - Dump information in hex to HTML page
-=head1 SYNOPSIS
-    use Image::ExifTool::HtmlDump;
-    my $dump = new Image::ExifTool::HtmlDump;
-    $dump->Add($start, $size, $comment);
-    $dump->Print($dumpInfo, $raf, $dataPt, $dataPos, $outfile);
-=head1 DESCRIPTION
-This module contains code used to generate an HTML-based hex dump of
-information for debugging purposes.  This is code is called when the
-ExifTool 'HtmlDump' option is used.
-Currently, only EXIF/TIFF and JPEG information is dumped.
-=head1 BUGS
-Due to a memory allocation bug in ActivePerl 5.8.x for Windows, this code
-may run extremely slowly when processing large files with this version of
-Perl.
-An HTML 4 compliant browser is needed to properly display the generated HTML
-page.
-=head1 AUTHOR
-Copyright 2003-2012, 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 SEE ALSO
-L<Image::ExifTool(3pm)|Image::ExifTool>
-=cut