1

# DeGAL - A pretty simple web image gallery

     2

# Copyright (C) 2007 Tero Marttila

     3

# http://marttila.de/~terom/degal/

     4

#

     5

# This program is free software; you can redistribute it and/or modify

     6

# it under the terms of the GNU General Public License as published by

     7

# the Free Software Foundation; either version 2 of the License, or

     8

# (at your option) any later version.

     9

#

    10

# This program is distributed in the hope that it will be useful,

    11

# but WITHOUT ANY WARRANTY; without even the implied warranty of

    12

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    13

# GNU General Public License for more details.

    14

#

    15

# You should have received a copy of the GNU General Public License

    16

# along with this program; if not, write to the

    17

# Free Software Foundation, Inc.,

    18

# 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

    19

#

    20

    21

import os, os.path

    22

    23

import PIL.Image

    24

    25

import settings, utils

    26

from log import index, render

    27

from template import image as image_tpl

    28

    29

class Image (object) :

    30

    def __init__ (self, dir, name) :

    31

        # the image filename, e.g. DSC3948.JPG

    33

    34

        # the Folder object that we are in

    35

        self.dir = dir

    36

    37

        # the relative path from the root to us

    39

    40

        # the basename+ext, e.g. DSCR3948, .JPG

    42

    43

        # our user-friendly title

    45

    46

        # our long-winded description

    47

        self.descr = ''

    48

    49

        # the image before and after us, both may be None

    50

        self.prev = self.next = None

    51

    52

        # the image-relative names for the html page, thumb and preview images

    53

        self.html_name = self.name + ".html"

    54

        self.thumb_name = utils.url_join(settings.THUMB_DIR, self.name)

    55

        self.preview_name = utils.url_join(settings.PREVIEW_DIR, self.name)

    56

    57

        # the root-relative paths to the html page, thumb and preview images

    58

        self.html_path = self.dir.pathFor(self.html_name)

    59

        self.thumb_path = self.dir.pathFor(settings.THUMB_DIR, self.name)

    60

        self.preview_path = self.dir.pathFor(settings.PREVIEW_DIR, self.name)        

    61

    62

        #

    63

        # Figured out after prepare

    64

        #

    65

    66

        # (w, h) tuple

    67

        self.img_size = None

    68

    69

        # the ShortURL code for this image

    70

        self.shorturl_code = None

    71

    72

        # what to use in the rendered templates, intended to be overridden by subclasses

    73

        self.series_act = "add"

    74

        self.series_verb = "Add to"

    75

    76

    def getObjInfo (self) :

    77

        """

    78

            Metadata for shorturl2.db

    79

        """

    80

        return 'img', self.dir.path, self.name

    81

    82

    def breadcrumb (self) :

    83

        """

    84

            Returns a [(fname, title)] list of this image's parents

    85

       """

    86

    87

        return self.dir.breadcrumb(forImg=self) + [(self.html_name, self.title)]

    88

    89

    def render (self) :

    90

        """

    91

            Write out the .html file

    92

        """

    93

    94

        # stat the image file to get the filesize and mtime

    95

        st = os.stat(self.path)

    96

    97

        self.filesize = st.st_size

    98

        self.timestamp = st.st_mtime

    99

   100

        # open the image in PIL to get image attributes + generate thumbnails

   101

        img = PIL.Image.open(self.path)

   102

   103

        self.img_size = img.size

   104

   105

        for out_path, geom in ((self.thumb_path, settings.THUMB_GEOM), (self.preview_path, settings.PREVIEW_GEOM)) :

   106

            # if it doesn't exist, or it's older than the image itself, generate

   107

            if not (os.path.exists(out_path) and os.stat(out_path).st_mtime > self.timestamp) :

   108

                render.info("Create thumbnailed image at %s with geom %s", out_path, geom)

   109

   110

                # XXX: is this the most efficient way to do this? It seems slow

   111

                out_img = img.copy()

   112

                out_img.thumbnail(geom, resample=True)

   113

                out_img.save(out_path)

   114

   115

        # look for the metadata file

   116

        title_path = self.dir.pathFor(self.base_name + '.txt')

   117

   118

        self.title, self.descr = utils.readTitleDescr(title_path)

   119

   120

        if not self.title :

   121

            self.title = self.name

   122

   123

        render.info("Rendering image %s", self.path)

   124

   125

        image_tpl.render_to(self.html_path,

   126

            stylesheet_url             = self.dir.inRoot('style.css'),

   127

            title                      = self.title,

   128

            breadcrumb                 = self.breadcrumb(),

   129

   130

            prev                       = self.prev,

   131

            next                       = self.next,

   132

            img                        = self,

   133

   134

            description                = self.descr,

   135

   136

            filename                   = self.name,

   137

            img_size                   = self.img_size,

   138

            file_size                  = self.filesize,

   139

            timestamp                  = self.timestamp,

   140

   141

            shorturl                   = self.dir.inRoot('s', self.shorturl_code),

   142

            shorturl_code              = self.shorturl_code,

   143

   144

            series_url                 = self.dir.inRoot('series/%s/%s' % (self.series_act, self.shorturl_code)),

   145

            series_verb                = self.series_verb,

   146

        )   

   147

   148

    def __str__ (self) :

   149

        return "Image `%s' in `%s'" % (self.name, self.dir.path)