1

"""

     2

    State for thumbnails; derivates of Images

     3

"""

     4

     5

import filesystem

     6

     7

import PIL.Image

     8

     9

class Thumbnail (filesystem.File) :

    10

    """

    11

        A Thumbnail is a derivate of an Image, usually resized to some other size.

    12

    """

    13

    14

    def __init__ (self, image, subdir, target_size) :

    15

        """

    16

            Initialize to link against the given `image`.

    17

    18

            `subdir` specifies the directory to store this thumbnail in.

    19

            `target_size` determines the target resolution of the output thumbnail.

    20

        """

    21

    22

        # our file path, image name inside of the given subdir

    23

        super(Thumbnail, self).__init__(subdir, image.fsname)

    24

    25

        # store

    26

        self.image = image

    27

        self.target_size = target_size

    28

    29

    def stale (self) :

    30

        """

    31

            Tests if this thumbnail is stale

    32

        """

    33

    34

        if self.image.older_than(self) :

    35

            # both exist and this is newer

    36

            return False

    37

    38

        else :

    39

            # this thumb doesn't exist or is older

    40

            return True

    41

    42

    @property

    43

    def size (self) :

    44

        """

    45

            Compute the *real* size of this thumbnail, from the image's actual size and our target size.

    46

    47

            Preserves the aspect ratio etc.

    48

        """

    49

    50

        # real image size

    51

        img_width, img_height = self.image.img_size

    52

    53

        # target size

    54

        thumb_width, thumb_height = self.target_size

    55

    56

        # calc new size, preserving aspect ratio

    57

        if img_width > thumb_width : 

    58

            height = max(img_height * thumb_width / img_width, 1)

    59

            width = thumb_width

    60

    61

        elif img_height > thumb_height :

    62

            width = max(img_width * thumb_height / img_height, 1)

    63

            height = thumb_height

    64

    65

        return width, height 

    68

    def resize (self, img) :

    69

        """

    70

            Resize the give image as needed.

    71

        """

    72

    73

        return img.resize(self.size, resample=PIL.Image.ANTIALIAS)

    74

    75

    def auto_orient (self, img, orient_info) :

    76

        """

    77

            Automatically orient the image using the given orientation info.

    78

        """

    79

    80

        # unpack

    81

        mirroring, rotation = orient_info

    82

    83

        if mirroring :

    85

            pass

    86

    87

        if rotation :

    88

            # since these are in steps of 90 degrees, it should keep the right size

    89

            # but gah, PIL wants these as counter-clockwise!

    90

            img = img.rotate(360 - rotation)

    91

    92

        # ok

    93

        return img

    94

    95

    def update (self) :

    96

        """

    97

            Render new output thumbnail.

    98

        """

    99

   100

        # start with origional image

   101

        img = self.image.img

   102

   103

        # create resized copy of main image, using our size

   104

        img = self.resize(img)

   105

   106

        # got orientation info?

   107

        if self.image.orientation :

   108

            img = self.auto_orient(img, self.image.orientation)

   109

   110

        # write it out

   111

        img.save(self.path)

   112