summaryrefslogtreecommitdiffstats
path: root/docs/html/tools/help/etc1tool.jd
blob: a7f76f5cadb612f85f7dcfb941885e1d7f330062 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
page.title=etc1tool
parent.title=Tools
parent.link=index.html
@jd:body


 <p><code>etc1tool</code> is a command line utility that lets you encode PNG
 images to the ETC1 compression standard and decode ETC1 compressed images back to PNG.</p>

  <p>The usage for <code>etc1tool</code> is:</p>
<pre>etc1tool infile [--help | --encode | --encodeNoHeader | --decode] [--showDifference
diff-file] [-o outfile]</pre>

  <table>
    <tr>
      <th>Option</th>

      <th>Description</th>
    </tr>

    <tr>
      <td><code>infile</code></td>

      <td>The input file to compress</td>
    </tr>

    <tr>
      <td><code>--help</code></td>

      <td>Print usage information</td>
    </tr>

    <tr>
      <td><code>--encode</code></td>

      <td>Create an ETC1 file from a PNG file.
      This is the default mode for the tool if nothing is specified.</td>
    </tr>

    <tr>
      <td><code>--encodeNoHeader</code></td>

      <td>Create a raw ETC1 data file (without a header) from a PNG file.</td>
    </tr>

    <tr>
      <td><code>--decode</code></td>

      <td>Create a PNG file from an ETC1 file</td>
    </tr>

    <tr>
      <td><code>--showDifference <em>diff-file</em></code></td>

      <td>Write the difference between the original and encoded image to
      <code><em>diff-file</em></code> (only valid when encoding).</td>
    </tr>

    <tr>
      <td><code>-o <em>outfile</em></code></td>

      <td>Specify the name of the output file.
      If <code><em>outfile</em></code> is not specified, the output file is constructed
      from the input filename with the appropriate suffix (<code>.pkm</code> or <code>.png</code>).
      </td>
    </tr>

  </table>