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, log

    26

from template import image as image_tpl

    27

    28

class Image (object) :

    29

    def __init__ (self, dir, name) :

    30

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

    31

        self.name = unicode(name)

    32

    33

        # the Folder object that we are in

    34

        self.dir = dir

    35

    36

        # the relative path from the root to us

    37

        self.path = dir.pathFor(self.name)

    38

    39

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

    40

        self.base_name, self.ext = os.path.splitext(self.name)

    41

    42

        # our user-friendly title

    43

        self.title = self.name

    44

    45

        # our long-winded description

    46

        self.descr = ''

    47

    48

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

    49

        self.prev = self.next = None

    50

    51

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

    52

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

    53

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

    54

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

    55

    56

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

    57

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

    58

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

    59

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

    60

    61

        #

    62

        # Figured out after prepare

    63

        #

    64

    65

        # (w, h) tuple

    66

        self.img_size = None

    67

    68

        # the ShortURL code for this image

    69

        self.shorturl_code = None

    70

    71

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

    72

        self.series_act = "add"

    73

        self.series_verb = "Add to"

    74

    75

    def getObjInfo (self) :

    76

        """

    77

            Metadata for shorturl2.db

    78

        """

    79

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

    80

    81

    def breadcrumb (self) :

    82

        """

    83

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

    84

       """

    85

    86

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

    87

    88

    def render (self) :

    89

        """

    90

            Write out the .html file

    91

        """

    92

    93

        # stat the image file to get the filesize and mtime

    94

        st = os.stat(self.path)

    95

    96

        self.filesize = st.st_size

    97

        self.timestamp = st.st_mtime

    98

    99

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

   100

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

   101

   102

        self.img_size = img.size

   103

   104

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

   105

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

   106

            if utils.mtime(out_path) < self.timestamp :

   107

                log.info("render [%sx%s]", geom[0], geom[1], wait=True)

   108

   109

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

   110

                out_img = img.copy()

   111

                out_img.thumbnail(geom, resample=True)

   112

                out_img.save(out_path)

   113

   114

                log.done()

   115

   116

        # look for the metadata file

   117

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

   118

   119

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

   120

   121

        if not self.title :

   122

            self.title = self.name

   123

   124

        if utils.mtime(self.html_path) < self.timestamp :

   125

            log.info("render %s.html", self.name)

   126

   127

            image_tpl.render_to(self.html_path,

   128

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

   129

                title                      = self.title,

   130

                breadcrumb                 = self.breadcrumb(),

   131

   132

                prev                       = self.prev,

   133

                next                       = self.next,

   134

                img                        = self,

   135

   136

                description                = self.descr,

   137

   138

                filename                   = self.name,

   139

                img_size                   = self.img_size,

   140

                file_size                  = self.filesize,

   141

                timestamp                  = self.timestamp,

   142

   143

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

   144

                shorturl_code              = self.shorturl_code,

   145

   146

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

   147

                series_verb                = self.series_verb,

   148

            )   

   149

   150

    def __str__ (self) :

   151

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

   152