| 1 |
General |
| 2 |
======= |
| 3 |
|
| 4 |
'checkit_tiff' is a conformance checker for baseline TIFFs (with various |
| 5 |
extensions). It works in different way than other tools. Instead to use a |
| 6 |
hardcoded rule set with predefined values, you are able to define tags and |
| 7 |
corresponding values more fine granulary. The rulesets are human readable and |
| 8 |
could be adapted to own needs. |
| 9 |
|
| 10 |
The 'checkit_tiff' works on commandline and therefore it is embeddable in scripts |
| 11 |
|
| 12 |
The tools are developed for purposes of curation and longterm preservation |
| 13 |
|
| 14 |
In detail |
| 15 |
========= |
| 16 |
|
| 17 |
checkit_tiff: |
| 18 |
|
| 19 |
- checks a baseline TIFF against ruleset |
| 20 |
- needs a Linux or an AIX system |
| 21 |
(crosscompiling to Windows should work, too) |
| 22 |
- to compile, please read README.compile |
| 23 |
- help comes with option 'checkit_tiff -h' |
| 24 |
|
| 25 |
[TIP] |
| 26 |
==== |
| 27 |
* The program could already be used to check TIFF-files now |
| 28 |
* Remember, it is in alpha-state and needs additional rules to validate tiff files completely. |
| 29 |
* Please, if you find errors or do you have test files like |
| 30 |
** https://github.com/EasyinnovaSL/DPFManager/tree/develop/src/test/resources/ |
| 31 |
** or https://github.com/openpreserve/jhove/tree/junit_tests/examples/tiff/badfiles |
| 32 |
please do not hesitate to contact me. |
| 33 |
* to *repair* TIFFs, you could give "fixit_tiff" a try: http://andreas-romeyke.de/software.html#_fixit_tiff |
| 34 |
==== |
| 35 |
|
| 36 |
ICC Profile checking |
| 37 |
==================== |
| 38 |
|
| 39 |
checkit_tiff supports the reference implementation of ICC to fully validate ICC profiles. |
| 40 |
To compile checkit_tiff with support, you need to install IccProfLib locally. |
| 41 |
The IccProfLib is available at https://github.com/InternationalColorConsortium/DemoIccMAX/tree/master/IccProfLib[]. |
| 42 |
|
| 43 |
License |
| 44 |
======= |
| 45 |
|
| 46 |
the sourcecode is licensed under conditions of libtiff, see http://libtiff.maptools.org for details. |
| 47 |
|
| 48 |
|
| 49 |
== Compile == |
| 50 |
|
| 51 |
see file 'README.compile' for details |
| 52 |
|
| 53 |
== Run == |
| 54 |
|
| 55 |
Use the builtin help via './checkit_tiff -h' |
| 56 |
|
| 57 |
Here is an example output using |
| 58 |
|
| 59 |
[bash] |
| 60 |
---- |
| 61 |
$> checkit_tiff -q example_configs/cit_tiff6_baseline_SLUB.cfg tiffs_should_fail/invalid_date.tiff |
| 62 |
'./build/checkit_tiff' version: development |
| 63 |
revision: 393 |
| 64 |
licensed under conditions of libtiff (see http://libtiff.maptools.org/misc.html) |
| 65 |
cfg_file=example_configs/cit_tiff6_baseline_SLUB.cfg |
| 66 |
tiff file/dir=tiffs_should_fail/invalid_date.tiff |
| 67 |
file: tiffs_should_fail/invalid_date.tiff |
| 68 |
(EE) tag 306 (DateTime) --> DateTime tag should contain a valid value. DateTime tag has wrong format.; found: 04.03.2010 09:59:17 (lineno: 146) |
| 69 |
(EE)Found 1 errors |
| 70 |
(EE)No, the given tif is not valid :( |
| 71 |
---- |
| 72 |
|
| 73 |
== Deploy == |
| 74 |
|
| 75 |
See deploy/README.txt for details. |