Debian Codegraph @

README.1st_checkit

raw
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.