1

#!/usr/bin/env python

     2

     3

"""

     4

    Python clone of the pngtile binary.

     5

"""

     6

     8

     9

import pypngtile as pt

    10

    11

# CLI options

    12

options = None

    13

    17

def log_debug (fmt, *args) :

    18

    if options.debug or options.verbose :

    20

    21

def log_info (fmt, *args) :

    22

    if not options.quiet :

    24

    25

def log_warn (fmt, *args) :

    27

    28

    29

def parse_hex (hex) :

    30

    """

    31

        Parse a 0xHH.. style string as a raw bytestring

    32

    """

    33

    34

    if not hex.startswith("0x") :

    35

        raise ValueError(hex)

    36

    37

    return hex[2:].decode("hex")

    38

    39

def parse_args (args) :

    40

    """

    41

        Parse given argv[1:]

    42

    """

    43

    44

    global options

    45

    46

    parser = optparse.OptionParser(

    47

            usage   = "Usage: %prog [options] <image file> [...]",

    48

    )

    49

    50

    # build opts list

    51

    parser.add_option('-q', "--quiet",          help="Supress informational output",                        action='store_true')

    52

    parser.add_option('-v', "--verbose",        help="Display more output",                                 action='store_true')

    53

    parser.add_option('-D', "--debug",          help="Equivalent to -v",                                    action='store_true')

    54

    parser.add_option('-U', "--force-update",   help="Unconditionally update the image caches",             action='store_true')

    55

    parser.add_option('-N', "--no-update",      help="Do not update the image caches, even if unusable",    action='store_true')

    56

    parser.add_option('-B', "--background",     help="Background pattern for sparse cache file",            metavar="0xHH..")

    64

    # parse

    65

    options, args = parser.parse_args(args=args)

    66

    67

    # decode

    68

    if options.background :

    69

        try :

    70

            options.background = parse_hex(options.background)

    71

    72

        except ValueError :

    73

            raise ValueError("Invalid value for --background: %s" % options.background)

    74

    75

    return args

    76

    77

   104

def process_image (image) :

   105

    """

   106

        Process given image

   107

    """

   108

   109

    # check cache status

   110

    status = image.status()

   111

   112

    # update if stale?

   113

    if status != pt.CACHE_FRESH or options.force_update :

   114

        # decode status

   115

        if status == pt.CACHE_NONE :

   116

            log_info("\tImage cache is missing")

   117

   118

        elif status == pt.CACHE_STALE :

   119

            log_info("\tImage cache is stale")

   120

   121

        elif status == pt.CACHE_INCOMPAT :

   122

            log_info("\tImage cache is incompatible")

   123

   124

        elif status == pt.CACHE_FRESH :

   125

            log_info("\tImage cache is fresh")

   126

   127

        else :

   128

            log_warn("\tImage cache status unknown: %d", status)

   129

   130

   131

        # update unless supressed

   132

        if not options.no_update :

   133

            log_info("\tUpdating image cache...")

   134

   135

            # update with optional background color

   136

            image.update(background_color=options.background)

   137

   138

            log_debug("\tUpdated image cache")

   139

   140

        else :

   141

            # warn

   142

            log_warn("\tSupressing cache update even though it is needed")

   143

   144

    else: 

   145

        log_debug("\tImage cache is fresh")

   146

   150

    # show info

   151

    info = image.info()

   152

   153

    log_info("\tImage dimensions: %d x %d (%d bpp)", info['img_width'], info['img_height'], info['img_bpp'])

   154

    log_info("\tImage mtime=%d, bytes=%d", info['image_mtime'], info['image_bytes'])

   155

    log_info("\tCache mtime=%d, bytes=%d, blocks=%d (%d bytes), version=%d", 

   156

            info['cache_mtime'], info['cache_bytes'], info['cache_blocks'], info['cache_blocks'] * 512, info['cache_version']

   157

    )

   159

   168

   169

def process_images (image_paths) :

   170

    """

   171

        Open up each image_path and process using process_image

   172

    """

   173

   174

    for image_path in image_paths :

   175

        log_debug("Loading image: %s", image_path)

   176

   177

        # open up

   178

        image = pt.Image(image_path, pt.OPEN_UPDATE)

   179

   180

        log_info("Opened image: %s", image_path);

   181

   182

        # process

   183

        process_image(image)

   184

   185

   186

def main (args) :

   187

    """

   188

        Operate on given argv[1:]

   189

    """

   190

   191

    # parse opts/args

   192

    args = parse_args(args)

   193

   194

    # handle each image

   195

    process_images(args)

   196

   197

   198

if __name__ == '__main__' :

   199

    from sys import argv

   200

   201

    main(argv[1:])

   202