File: README

package info (click to toggle)
libopenraw 0.1.2-0.4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 3,484 kB
  • sloc: cpp: 13,907; sh: 4,090; ansic: 1,922; xml: 769; makefile: 676; perl: 42
file content (358 lines) | stat: -rw-r--r-- 10,149 bytes parent folder | download | duplicates (2)
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
Copyright
=========

libopenraw is Copyright (c) 2005-2016 Hubert Figuiere and
other contributors. See the respective files.
It is licensed under LGPLv3 or later. See files COPYING
and COPYING.LESSER

Prerequistes to build:
======================

    - a C++ 11 compiler (tested on gcc 4.7 and up)
    - libboost 1.33.1 (Boost.String, Boost.Test, Boost.Variant)
    - libjpeg
    - libxml > 2.5.0 (for the test suite)
    - libcurl (option for the test suite bootstrap)

If building from the git tree you also need:

    - automake/autoconf
    - pkg-config for the associated m4 macros

Optional Gnome support

    - gdkpixbuf

Supported file format:
======================

Here are the supported file formats. For details per-camera, see
below:

    - Canon CR2
    - Canon CRW (not those coming from CHDK firmware like A610)
    - Nikon NEF
    - Olympus ORF
    - Pentax PEF
    - Epson ERF
    - DNG
    - Sony ARW
    - Minolta MRW
    - Panasonic RAW and RW2
    - Fujifilm RAF

How to build:
=============

  Using automake/autoconf:

    $ ./autogen.sh
    $ ./configure --prefix=...
    $ make
    $ make install DESTDIR=...


Support table:
==============

  T  Tested and proven to work. (I have a sample.)
  Y  Yes, it is there. (Untested as I do not have a sample but the format
     is known to be similar.) Yes, it is for the whole format.
  N  Not supported.
  B  Known to be Broken. (Needs to be fixed. I have a sample but further
     work is required.)
  X  Not needed.
  #  Sample file needed.

                          ThNail
                         /  CFA compressed (as is)
                         | /  CFA decompress
                         | | /  Orientation Tag
                         | | | /  Bayer Type
                         | | | | /  Type ID
                         | | | | | /  Active Area (ROI)
                         | | | | | | /  Color Matrices
                         | | | | | | | /
                         | | | | | | | |
Canon CR2                Y Y Y Y Y Y Y Y
 1000D/Rebel XS          T T T T T T T
 1100D/Rebel T3          T T T T T T T
 20D                     T T T T T T T
 30D                     T T T T T T T
 350D/Rebel XT           T T T T T T T
 40D                     T T T T T T T
 400D                    T T T T T T T
 450D                    T T T T T T T
 50D                     T T T T T T T
 500D                    T T T T T T T
 550D                    T T T T T T T
 5D                      T T T     T T
 5DMarkII                T T T T   T T
 5DMarkIII               T T T T   T T
 6D
 60D                     T T T T T T T
 600D                    T T T T T T T
 650D/T4i
 7D                      T T T     T T
 1DMarkII                T T T     T T
 1DMarkIII
 1DMarkIV                T T T T T T T
 1D X
 EOS-M
 G9                                T T
 G10                               T T
 G11                     T T T     T T
 G12                     T T T T T T T
 G15
 G1X
 SX1 IS                  # # # # # # #
 S90                     T T T T T T T
 S95                     T T T T T T T
 S100

Canon CRW                Y Y Y Y Y Y N Y
 300D                    T T T T T T
 10D                     T T T   T T
 D60                     T T T   T T
 G1                      T T T   T T
 G2                      T T T   T T
 G5                      T T T   T T
 Pro1                    T T T   T T

Canon CRW CHDK           N N N N N N N N
(unofficial firmware)
 A610                    N N N N N N N

Nikon NEF                Y Y Y Y Y Y N Y
 D1                      T T X X T T
 D1H                     # # # # # # # #
 D1X                     T T X X T T
 D100                    T T T X T T
 D2H                     T T Y T T T
 D2X                     T T X T T T
 D200                              T
 D3
 D3S                     T   B     T
 D3X                     T   B     T
 D300                    T T T     T
 D300S                   T   B     T
 D3000                   T B B T T T
 D3100                   T T T T T T
 D3200                   T   B     T
 D4
 D40                     T T Y T T T
 D40X                    T T Y T T T
 D50                               T
 D5000                   T   B     T
 D5100                   T   B     T
 D5200
 D60
 D600
 D70                     T T Y T T T
 D70s                    T T Y T T T
 D700                              T
 D7000                   T T T T T T
 D7100
 D80                               T
 D800                              T
 D800E                             T
 D90                         B     T
 J1                      T T B Y Y T
 J2
 J3
 S1
 V1                      T T B Y Y T
 V2
 Coolpix A

Nikon NRW                Y         Y N Y
 P6000                   T         T   T
 P7000                   T         T   T
 P7100                   T             T
 P7700

Olympus ORF              Y Y B Y Y Y N Y
 E-1                     T T T   T T
 E-10                    T B B     T
 E-3                     T T T   T T
 E-300                   T T B T T T
 E-330                   T T N     T
 E-400                   T B T T T T
 E-410                   T T T T T T
 E-500                   T T B T   T
 E-510                   B T T T T T
 E-620                   B T T   T T
 SP-350                  B B X T T T
 SP-500                  B B X T T T
 SP-510                  B B X T T T
 SP-550                  B B X T T T
 E-P1                    T T T   T T
 E-P2                    B T T   T T
 E-P3                    B T T   T T
 E-PL1                   B T T   T T
 E-PL2                   B T T   T T
 E-PL3                   B T T   T T
 E-PL5
 E-PM1                   B T T   T T
 E-PM2
 E-M5                    B       T T
 XZ-1                    B T T   T T
 XZ-2

Adobe DNG                Y Y B Y Y Y Y Y
 Leica DMR               T T X T T T
 Leica M8                T T X T T T
 Leica M9                T T X T T T
 Leica M-Monochrom       T T X T T T
 Leica X1                T T T T T T
 Leica X2
 Leica S2                T T B T T T
 Adobe DNG converter     T T B T T T
 Pentax K10D             T T X T T T T
 Pentax K200D            T T   T T T T
 Pentax K30
 Pentax K-r              T T   T T T T
 Pentax K-x              T T   T T T T
 Pentax 645D             T T X T T T T
 Pentax Q                T T X T T T T
 Samsung GX-10           T T X T T T
 Samsung Pro815          T T X T T T
 Ricoh GR-2              T T X T T T
 Ricoh GRX               T T X T T T
 Ricoh GX100

Sony ARW                 Y Y N Y N Y N Y
 A-100                   T N   T   T
 A-200                   # # # # # T #
 A-550                   T T       T
 A-580
 A-700                   T T   T   T
 A-380                   T T       T
 A-390                   T T       T
 A-560
 A-850
 A-900
 SLT-A33
 SLT-A35
 SLT-A55                 T T       T
 SLT-A57
 SLT-A65                 T T       T
 SLT-A77                 T T       T
 SLT-A99
 Nex-3                   T T   T   T
 Nex-5                   T T       T
 Nex-5N                  T T       T
 Nex-6
 Nex-C3                  T T       T
 Nex-F3
 Nex-7
 RX-1
 RX-100

Pentax PEF               Y Y N Y Y Y N Y
 *-ist D                 T T X X T T
 *-ist DL                T T N     T
 K10D                    T T N T T T
 K100D                   # # # # # T #
 K100D Super             T T N     T
 K20D                    T T N T   T
 K-r                               T   T
 K-x                               T   T
 K-5                               T   T
 K-7                               T   T
 645D                              T   T

Epson ERF                Y Y Y Y Y Y N Y
 Epson RD1               T T T T T T   Y
 Epson RD1s                            Y

Minolta MRW              Y Y B N Y Y N Y
 A1                      T T T X T     Y
 A2                      T T T X T     Y
 Dimage 5                T T X X T T   Y
 Dimage 7i               T T X X T T   Y
 Dimage 7Hi              T T X X T T   Y
 Maxxum 5D               T T T N T     Y
 Maxxum 7D               T T T N T     Y
 A200

Sony SRF                 N N N N N N N N

Sony SR2                 N N N N N N N N
 Sony R1

Kodak DCR                N N N N N N N N

Kodak KDC                N N N N N N N N

FujiFilm RAF             Y Y B N N Y N T
 Finepix S2Pro           T         T
 Finepix S3Pro           T         T
 Finepix S5Pro           T         T
 Finepix S6500Fd         T         T
 Finepix S5600           T         T
 Finepix S9500           T         T
 Finepix X100            T T T     T
 Finepix F700            T         T
 Finepix E900            T         T
 X10                     T         T
 X100S
 X20
 X-Pro1                  T       Y T   N
 X-E1
 X-S1                    T         T   N
 XF1
 Finepix S200 EXR        T         T

Foveon X3F               N N N N N N N N

Panasonic RAW            Y Y N Y Y Y Y N
 FZ30                    N T X T   T T
 FZ50                    N T X T   T T
 FZ8                     N T B T   T T
 FZ18                    T T B T   T T
 L1                      N T X T   T T
 L10                     T T N T   T T
 LX2                     N T X T   T T
 Leica Digilux 2         N T X T   T T
 Leica DLUX 3            N T X T   T T
 Leica VLUX 1            N T X T   T T

Panasonic RW2            Y Y N Y Y Y Y N
 GF1                     T T       T T
 GF2                     T T       T T
 GF3
 GF5
 GF6
 GH1                     T T       T T
 GH2                     T T N     T T
 GH3
 G1                      T T       T T
 G2                      T T       T T
 G3
 G5
 G10                     T T       T T
 LX3                     T T B     T T
 LX5                     T T B     T T
 LX7
 FZ200
 FZ28                    T T B     T T

Mamiya MEF               N N N N N N N N
 Mamiya ZD

Samsung SRW              N N N N N N N N


Test suite
==========

There is a test suite driven by an XML file. It require you to provide
your own RAW files and configure it.  testsuite/testsuite.xml is an
example of valid XML configuration file that works on my local
machine.

TODO2: provide a better description of the test file.

TODO3: fix ordiag to allow outputting a test case in XML.