34 |
34 |
35 To compile, simply execute |
35 To compile, simply execute |
36 |
36 |
37 make |
37 make |
38 |
38 |
39 The libpngtile.so will be placed under lib/, and the 'util' binary under bin/. |
39 The libpngtile.so will be placed under lib/, and the 'pngtile' binary under bin/. |
40 |
40 |
41 |
41 |
42 USAGE: |
42 USAGE: |
43 Store the .png data files in a directory. You must have write access to the directory when updating the caches, |
43 Store the .png data files in a directory. You must have write access to the directory when updating the caches, |
44 which are written as a .cache file alongside the .png file. |
44 which are written as a .cache file alongside the .png file. |
45 |
45 |
46 Provide any number of *.png paths as arguments to the ./bin/util command. Each will be opened, and automatically |
46 Provide any number of *.png paths as arguments to the ./bin/util command. Each will be opened, and automatically |
47 updated if the cache doesn't exist yet, or is stale: |
47 updated if the cache doesn't exist yet, or is stale: |
48 |
48 |
49 ./bin/util -v data/*.png |
49 pngtile -v data/*.png |
50 |
50 |
51 Use -v/--verbose for more detailed output. |
51 Use -v/--verbose for more detailed output. |
52 |
52 |
53 |
53 |
54 To render a tile from some image, provide appropriate -W/-H and -x/-y options to ./bin/util: |
54 To render a tile from some image, provide appropriate -W/-H and -x/-y options to pngtile: |
55 |
55 |
56 ./bin/util data/*.png -W 1024 -H 1024 -x 8000 -y 4000 |
56 pngtile data/*.png -W 1024 -H 1024 -x 8000 -y 4000 |
57 |
57 |
58 The output PNG tiles will be written to temporary files, the names of which are shown in the [INFO] output. |
58 The output PNG tiles will be written to temporary files, the names of which are shown in the [INFO] output. |
59 |
59 |
60 |
60 |
61 To force-update an image's cache, use the -U/--force-update option: |
61 To force-update an image's cache, use the -U/--force-update option: |
62 |
62 |
63 ./bin/util --force-update data/*.png |
63 pngtile --force-update data/*.png |
64 |
64 |
65 Alternatively, to not update an image's cache, use the -N/--no-update option. |
65 Alternatively, to not update an image's cache, use the -N/--no-update option. |
66 |
66 |
67 |
67 |
68 TODO/BUGS: |
68 TODO/BUGS: |