Imported Upstream version 1.1.11
[platform/upstream/cdrkit.git] / doc / wodim / README.DiskT@2
1 New driveropts= option "tattoofile=". Use together with -checkdrive 
2 to write an image of the right size to disk.
3
4         DiskT@2 hints:
5
6         In order to have "DISKTATTOO" listed in the "Driver flags",
7         the disk currently inserted must be usable for the DiskT@2 feature.
8         This means that there needs to be enough space on it.
9
10         You need an B&W image with 3744 pixels per line
11
12         Best start with a 3744 x 320 pixel image.
13         The correct size may be retrieved with
14                 wodim driveropts=tattooinfo -checkdrive
15
16         To get RAW image data:
17
18         -       Take 'xv' and save the image in PBM/PGM/PPM (raw) mode
19
20         -       use a binary aware (must support unlimited linelength)
21                 editor such as 'ved' and remove the header lines.
22                 These lines look like:
23
24                 P5
25                 # CREATOR: XV Version 3.10a  Rev: 12/29/94 (PNG patch 1.2)
26                 # CREATOR: XV Version 3.10a  Rev: 12/29/94 (PNG patch 1.2)
27                 3744 144
28                 255
29
30                 Now you should have (in case of the file above) a file that
31                 has exactly 539136 Bytes.
32
33         -       Note that the tattoo image must be left to right flipped
34                 (a mirror image).
35
36 From a hint from "E. Robert Bogusta" <rob23@tmr.com>: 
37
38 Take an image, and do:
39
40   djpeg myface.jpg | ppmtopgm | pnmflip -lr | 
41     pnmscale -xsi 3744 -ysi 320 | sed '1,/255/d' >myface.tattoo 
42  
43 So: 
44   djpeg extracts ppm from a jpeg. Use your favorite other way of getting 
45 this far is you wish. 
46  
47   ppmtopgm changes color to grey scale 
48  
49   pnmflip -lr flips left to right, the small image is faster 
50  
51   pnmscale makes it 3644x320 regardless of starting size. This may make it 
52 look really odd on the CD if it doesn't start off the right size. More on 
53 this after I try it. 
54  
55   sed strips from the first line to the line containing 255, which is the 
56 last header line. 
57  
58 Note that it would be better to use the actual height of the applicable image instead
59 of the maximum value of 320 and it would be even more correct to create an
60 image that has the right width/height ratio for the target on CD in order
61 get an undistorted view of the image on CD.
62
63 For best visibility, use black text on light background.
64
65 Source: README.cdtext from cdrtools package
66 Edited for cdrkit by Christian Fromme <kaner@strace.org>
67