The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
AxKit-App-Gallery-0.5
River stage zero No dependents
++
/ AxKit::App::Gallery::proofsheet

NAME

AxKit::App::Gallery::proofsheet

DESCRIPTION

A proofsheet is generated by AxKit::App::Gallery whenever the user requests a directory listing of a ::Gallery managed directory. The proofsheet is an XML document, and the last stylesheet in the proofsheet processing chain should style this to HTML (or your final delivery format).

If you have enabled ?style=xml processing in your Apache configuration file you can always get the internally generated XML for a proofsheet by appending ?style=xml to a proofsheet URL.

PROOFSHEET STRUCTURE

This is an annotated proofsheet. I should really create this as a DTD.

  <?xml version="1.0"?>
  <proofsheet>                  <!-- Root proofsheet element -->

    <!-- These elements contain information about the gallery's
         configuration, as specified in the Apache config file -->
    <config>

      <!-- <perl-vars> contains values that are set using the PerlSetVar
           command that relate to the gallery config.  A simple

               <var name="foo">value</var>

           syntax is used (mostly). -->
      <perl-vars>
        <var name="ProofsheetColumns">4</var>
        <var name="ImagesPerProofsheet">16</var>
        <var name="GalleryCache">/var/tmp/gallery</var>
        <var name="GalleryThumbQuality">preview</var>

        <!-- GallerySizes is different.  It's a space separated string
             in the config file.  XSLT would much prefer this to be  
             broken out in to tree of nodes, so that's what we do.  
             Note the 'type="thumb"' attribute, which indicates which
             of the sizes is going to be used for thumbnails -->
        <GallerySizes>
          <size type="thumb">133</size>
          <size>640</size>
          <size>800</size>
          <size>1024</size>
          <size>full</size>
        </GallerySizes>
      </perl-vars>

      <!-- <server> contains information about the web server 
           configuration -->
      <server>
        <site>http://www.example.com</site>
        <admin>you@example.com</admin>
        <hostname>www.example.com</site>
        <port>80</port>
      </server>
    </config>

    <!-- Each directory to be listed is represented as an <album>
         element, with a top-level <albums> wrapper -->
    <albums>
      <album>

        <!-- The current directory is always included.  This is so that
             the breadcrumb trail navigation can be constructed. -->

        <name>.</name>

        <!-- The URI for this directory is included, for the breadcrumb
             trail, and so that links to it can easily be generated.
             For ease of parsing in XSLT, the URI is split in to tokens,
             delimited by the '/' in the URI (which is not included).
             Each token becomes a <component>, which then contains an
             <e>scaped and an <u>nescaped version of the URI.  The
             escaped version is for use in href attributes, the
             unescaped version is for use when displaying the directory
             name to the end user in a web page.

             So this URI might end up as:

             <a href="/pics/2002%2005%20(May)%20Singapore/">/pics/2002
             05 (May) Singapore</a>

             -->
        <uri>
          <component>
            <e>pics</e>
            <u>pics</u>
          </component>
          <component>
            <e>2002%2005%20(May)%20Singapore</e>
            <u>2002 05 (May) Singapore</u>
          </component>
        </uri>

        <!-- The local path to the directory and the content-type are
             also included -->
        <dirpath>/local/2/pub/Pictures/2002 05 (May) Singapore</dirpath>
        <content-type>httpd/unix-directory</content-type>
      </album>

      <!-- Repeat <album> elements as necessary -->
    </albums>

    <!-- Each image is wrapped in an <image> element with various child
         elements.  All the images are wrapped in an <images> element.  -->

    <images>
      <image>
        <filename>P0001065.JPG</filename>       <!-- Filename -->
        <filesize>359856</filesize>             <!-- Size in bytes -->

        <!-- The modification time is 'seconds-since-the-epoch', which
             may not be terribly useful in XSLT.  I'm not too worried
             about this at the moment, since (I think) it's more likely
             that the EXIF info about when the image was taken or 
             modified (see <imageinfo> later) is going to be more useful
             -->

        <modified>1021152828</modified>         

        <!-- The URI for this image.  Actually, it's the URI for the 
             directory that the image is in.  This follows the same 
             format as the <uri> element in the <album> element -->

        <uri>
          <component>
            <e>pics</e>
            <u>pics</u>
          </component>
          <component>
            <e>2002%2005%20(May)%20Singapore</e>
            <u>2002 05 (May) Singapore</u>
          </component>
        </uri>

        <!-- Full path to the image on the local file system -->
        <dirpath>/local/2/pub/Pictures/2002 05 (May) Singapore</dirpath>

        <!-- Content type, as determined by Apache -->
        <content-type>image/jpeg</content-type>

        <!-- There now follows information gleaned from the image using
             the Image::Info module.

             The information is structured as RDF, with elements from a
             number of different XML namespaces used.  Details about the
             namespaces can be found in AxKit::App::Gallery::namespaces.

             Elements in this example have been grouped according to 
             namespace prefix, and sorted according to element name for
             ease of reading.  The actual output from the stylesheets is
             not sorted this way. -->

        <rdf:RDF 
          xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
          xmlns:a="http://dublincore.org/documents/2003/02/04/dces/" 
          xmlns:b="http://impressive.net/people/gerald/2001/exif#" 
          xmlns:c="http://www.cpan.org/authors/id/G/GA/GAAS/#"
          xmlns:d="http://search.cpan.org/author/NIKC/xml#" 
          xmlns:e="http://xmlns.com/foaf/0.1/">

          <rdf:Description 
            rdf:about="/pics/2003 10 25 Eighty Days Photoshoot/PICT3257.JPG">

            <!-- EXIF, from Image::Info -->
            <b:BrightnessValue>60/10</b:BrightnessValue>
            <b:ColorSpace>1</b:ColorSpace>
            <b:Comment>AppleMark
            </b:Comment>
            <b:ComponentsConfiguration>YCbCr</b:ComponentsConfiguration>
            <b:Contrast>Normal</b:Contrast>
            <b:CustomRendered>Custom process</b:CustomRendered>
            <b:DateTime>2003:10:25 18:09:00</b:DateTime>
            <b:DateTimeDigitized>2003:10:25 13:23:24</b:DateTimeDigitized>
            <b:DateTimeOriginal>2003:10:25 13:23:24</b:DateTimeOriginal>
            <b:DigitalZoomRatio>0/1</b:DigitalZoomRatio>
            <b:ExifImageLength>1920</b:ExifImageLength>
            <b:ExifImageWidth>2560</b:ExifImageWidth>
            <b:ExifVersion>0220</b:ExifVersion>
            <b:ExposureBiasValue>0/10</b:ExposureBiasValue>
            <b:ExposureMode>Auto exposure</b:ExposureMode>
            <b:ExposureTime>1/60</b:ExposureTime>
            <b:FNumber>56/10</b:FNumber>
            <b:Flash>Flash did not fire, compulsory flash mode</b:Flash>
            <b:FlashPixVersion>0100</b:FlashPixVersion>
            <b:FocalLength>4537/256</b:FocalLength>
            <b:FocalLengthIn35mmFilm>71</b:FocalLengthIn35mmFilm>
            <b:ISOSpeedRatings>100</b:ISOSpeedRatings>
            <b:ImageDescription>DCF 1.0</b:ImageDescription>
            <b:JFIF_Version>1.01</b:JFIF_Version>
            <b:JPEG_Type>Baseline</b:JPEG_Type>
            <b:LightSource>unknown</b:LightSource>
            <b:Make>Minolta Co., Ltd.</b:Make>
            <b:MaxApertureValue>35/10</b:MaxApertureValue>
            <b:Model>DiMAGE 7i</b:Model>
            <b:SamplesPerPixel>3</b:SamplesPerPixel>
            <b:SceneCaptureType>Standard</b:SceneCaptureType>
            <b:Sharpness>Normal</b:Sharpness>
            <b:Software>QuickTime 6.4</b:Software>
            <b:SubjectDistanceRange>Close view</b:SubjectDistanceRange>
            <b:Tag-0x013c>Mac OS X 10.2.8</b:Tag-0x013c>
            <b:WhiteBalance>Auto white balance</b:WhiteBalance>
            <b:YCbCrPositioning>1</b:YCbCrPositioning>
            <b:ExposureProgram>Program</b:ExposureProgram>
            <b:MeteringMode>Pattern</b:MeteringMode>
            <b:Saturation>Normal</b:Saturation>
        
            <!-- Non-EXIF, from Image::Info -->
            <c:width>1920</c:width>
            <c:file_media_type>image/jpeg</c:file_media_type>
            <c:color_type>YCbCr</c:color_type>
            <c:height>2560</c:height>
            <c:file_ext>jpg</c:file_ext>

            <!-- Each potential version of the image is also representated.
                 The 'e:thumbnail/rdf:Description/rdf/@about' element is the
                 URI that will generate the thumbnail at this particular
                 size. -->
            <e:thumbnail>
              <rdf:Description 
                rdf:about="/pics/2003 10 25 Eighty Days Photoshoot/PICT3257.JPG?size=133">
                <a:title>133.jpg</a:title>
                <c:height>133</c:height>
                <c:width>99</c:width>
                <d:size>133</d:size>
              </rdf:Description>
            </e:thumbnail>
            <e:thumbnail>
              <rdf:Description rdf:about="/pics/2003 10 25 Eighty Days Photoshoot/PICT3257.JPG?size=640">
                <a:title>640.jpg</a:title>
                <c:height>640</c:height>
                <c:width>480</c:width>
                <d:size>640</d:size>
              </rdf:Description>
            </e:thumbnail>
            <e:thumbnail>
              <rdf:Description rdf:about="/pics/2003 10 25 Eighty Days Photoshoot/PICT3257.JPG?size=800">
                <a:title>800.jpg</a:title>
                <c:height>800</c:height>
                <c:width>600</c:width>
                <d:size>800</d:size>
              </rdf:Description>
            </e:thumbnail>
            <e:thumbnail>
              <rdf:Description rdf:about="/pics/2003 10 25 Eighty Days Photoshoot/PICT3257.JPG?size=1024">
                <a:title>1024.jpg</a:title>
                <c:height>1024</c:height>
                <c:width>768</c:width>
                <d:size>1024</d:size>
              </rdf:Description>
            </e:thumbnail>
          </rdf:Description>
        </rdf:RDF>
      </image>
    </images>

    <!-- The proofsheet may need to be spread over multiple 'virtual'
         pages, depending on the number of images in the directory, and
         the value of the ImagesPerProofSheet variable.

         The <pages> element contains one or more <page> elements.  Each
         <page> element has a 'number' attribute, indicating the page
         number.  The current page will have a 'current' attribute to
         indicate that. -->

    <pages>
      <page number="1" current="yes"/>

      <!-- A second page would appear as:

           <page number="2"/>

           -->
    </pages>
  </proofsheet>

SEE ALSO

AxKit::App::Gallery, AxKit::App::Gallery::proofsheet, AxKit::App::Gallery::imagesheet, AxKit::App::Gallery::namespaces, AxKit::App::Gallery::Plugin, AxKit::App::Gallery::Provider

AUTHOR

Nik Clayton, nik@FreeBSD.org

BUGS

Undoubtedly.