README.md
1Unless otherwise noted, the \*.gz files were generated by the gzip command line
2tool and the \*.deflate and \*.zlib versions were then generated by
3script/extract-deflate-offsets.go. Similarly, the \*.giflzw files were
4generated by script/extract-giflzw.go and the \*.palette and \*.indexes files
5were generated by script/extract-palette-indexes.go
6
7The \*.jpeg files are usually the canonical versions of the test/data images,
8and other versions (\*.bmp, \*.gif, \*.png, \*.tiff) were generated by
9ImageMagick's convert command line tool. The \*.webp versions were generated by
10the cwebp command line tool.
11
12
13
14The artificial directory holds artificially generated test data, often to
15explicitly test corner cases of various file formats. The files there usually
16come in families whose names have a common prefix, such as three files
17"foo.bar", "foo.bar.qux", "foo.bar.commentary.txt" all prefixed by "foo.bar".
18The file whose name is that prefix is usually the canonical (typically
19hand-crafted) file, and the other files are then derived from that. Outside of
20the artificial directory, the other files in this directory are typically real
21world examples of various file formats, or deriviations of them.
22
23
24
25animated-red-blue.gif is an original animation by Nigel Tao
26<nigeltao@golang.org>.
27
28bricks-\* are various encodings of an original photo by Nigel Tao
29<nigeltao@golang.org>.
30
31crude-flag.\* is an original animation by Nigel Tao
32<nigeltao@golang.org>. See the `lib/nie` documentation.
33
34gifplayer-muybridge.gif is an original animation by Nigel Tao
35<nigeltao@golang.org>.
36
37harvesters.\* are various encodings of a photo of "The Harvesters" by Pieter
38Bruegel the Elder, held by the Metropolitan Museum of Art.
39`http://www.metmuseum.org/art/collection/search/435809` lists that image as in
40the public domain.
41
42hat.\* are various encodings of a photo of "Self-Portrait with a Straw Hat
43(obverse: The Potato Peeler)" by Vincent van Gogh, held by the Metropolitan
44Museum of art. `http://www.metmuseum.org/art/collection/search/436532` lists
45that image as in the public domain.
46
47hibiscus.regular.\* are various encodings of a photo of "Hibiscus and Parrots"
48by Louis Comfort Tiffany, held by the Metropolitan Museum of Art.
49`http://www.metmuseum.org/art/collection/search/13503` lists that image as in
50the public domain.
51
52hibiscus.primitive.\* is the result of running the hibiscus.regular.png image
53through `github.com/fogleman/primitive` and other programs:
54 - `primitive -i hibiscus.regular.png -o hibiscus.primitive.svg -s 442 -n 32`
55 - `inkscape -z -e hibiscus.primitive.png hibiscus.primitive.svg`
56 - Various invocations of `convert` and `cwebp`
57
58hippopotamus.\* are various encodings of a cropping of a photo of "Hippopotamus
59(William)", held by the Metropolitan Museum of Art.
60`http://www.metmuseum.org/art/collection/search/544227` lists that image as in
61the public domain.
62
63`http://www.metmuseum.org/about-the-met/policies-and-documents/image-resources`
64says that "You are welcome to use images of artworks in The Met collection that
65the Museum believes to be in the public domain, or those to which the Museum
66waives any copyright it might have, for any purpose, including commercial and
67noncommercial use, free of charge and without requiring permission from the
68Museum."
69
70midsummer.txt is an excerpt of Shakespeare's "A Midsummer Night's Dream",
71copied from `http://shakespeare.mit.edu/midsummer/midsummer.1.1.html`
72
73muybridge.gif is derived from
74`https://en.wikipedia.org/wiki/File:Muybridge_race_horse_animated.gif` which is
75in the public domain.
76
77pi.txt contains the digits of pi.
78
79pjw-thumbnail.\* are various encodings of an image derived from an iconic,
80original photo of Peter J. Weinberger by Rob Pike <r@golang.org>.
81
82romeo.txt is an excerpt of Shakespeare's "Romeo and Juliet", copied from
83`http://shakespeare.mit.edu/romeo_juliet/romeo_juliet.2.2.html`
84
85romeo.txt.fixed-huff.deflate was derived from romeo.txt by a custom program to
86use fixed (not dynamic) Huffman tables for the deflate encoding.
87