diff options
| -rw-r--r-- | BugReporting.mdwn | 6 | ||||
| -rw-r--r-- | Building.mdwn | 15 | ||||
| -rw-r--r-- | Canon_CR2.mdwn | 50 | ||||
| -rw-r--r-- | Canon_CRW.mdwn | 22 | ||||
| -rw-r--r-- | Demosaicing.mdwn | 4 | ||||
| -rw-r--r-- | Epson_ERF.mdwn | 17 | ||||
| -rw-r--r-- | Exempi.mdwn | 67 | ||||
| -rw-r--r-- | FAQ.mdwn | 8 | ||||
| -rw-r--r-- | FileFormats.mdwn | 47 | ||||
| -rw-r--r-- | Foveon_X3F.mdwn | 6 | ||||
| -rw-r--r-- | Fuji_RAF.mdwn | 49 | ||||
| -rw-r--r-- | GettingTheCode.mdwn | 14 | ||||
| -rw-r--r-- | Kodak_DCR.mdwn | 22 | ||||
| -rw-r--r-- | Lens_Types.mdwn | 28 | ||||
| -rw-r--r-- | LinkToDocumentation.mdwn | 22 | ||||
| -rw-r--r-- | Minolta_MRW.mdwn | 7 | ||||
| -rw-r--r-- | Nikon_NEF.mdwn | 36 | ||||
| -rw-r--r-- | Olympus_ORF.mdwn | 21 | ||||
| -rw-r--r-- | Packages.mdwn | 17 | ||||
| -rw-r--r-- | Panasonic_RAW.mdwn | 21 | ||||
| -rw-r--r-- | PlannedFeatures.mdwn | 29 | ||||
| -rw-r--r-- | RawThumbnailer.mdwn | 20 | ||||
| -rw-r--r-- | Sony_SRF.mdwn | 12 | ||||
| -rw-r--r-- | conversion.mdwn | 9 | ||||
| -rw-r--r-- | index.mdwn | 56 |
25 files changed, 605 insertions, 0 deletions
diff --git a/BugReporting.mdwn b/BugReporting.mdwn new file mode 100644 index 0000000..dc410d5 --- /dev/null +++ b/BugReporting.mdwn @@ -0,0 +1,6 @@ + +How to report a bug: + +Use bugzilla: [[https://bugs.freedesktop.org/enter_bug.cgi?product=libopenraw|https://bugs.freedesktop.org/enter_bug.cgi?product=libopenraw]] + +Depending on the cases it might be usefull to provide the offending file. diff --git a/Building.mdwn b/Building.mdwn new file mode 100644 index 0000000..61b7417 --- /dev/null +++ b/Building.mdwn @@ -0,0 +1,15 @@ + +Start by [[GettingTheCode|GettingTheCode]]. + + +# Dependencies + +* a C++ compiler with the standard library +* boost +* libjpeg +There build system is based on Automake. + + +# Using automake: + +` $ ./autogen.sh ; make ` diff --git a/Canon_CR2.mdwn b/Canon_CR2.mdwn new file mode 100644 index 0000000..47e6747 --- /dev/null +++ b/Canon_CR2.mdwn @@ -0,0 +1,50 @@ + +CR2 files are generated by Canon cameras, starting the 20D, 350D/Digital Rebel Xt and 1D. They supersede the older [[Canon CRW|CRW]]. + + +# MIME type + +image/x-canon-cr2 +# Organisation + +Canon CR2 files are TIFF files. All is organised in a TIFF / IFD file. + +On of the differenciation with the CR2 files is that they have a header before the IFD0. This does not violate the TIFF spec. +[[!table header="no" class="mointable" data=""" + **offset** | **length** | **description** + 0 | 8 | TIFF header + 8 | 2 | litteral 'CR' + 10 | 1 | major version (2) + 11 | 1 | minor version (0) + 12 | 4 | (long) for the offset of the IFD3 that contain the RAW data. (in the TIFF byte order) +"""]] + +Exif is attached to the ExifIFD of IFD0. The CFA data is in IFD3. + + +# Compression + +Canon CR2 files use the old original [[Lossless_JPEG|Lossless_JPEG]] standard for the RAW data. The same used by [[Adobe DNG|Adobe DNG]]. + +Source: [[http://www.adobeforums.com/cgi-bin/webx/.3bc36454/0|http://www.adobeforums.com/cgi-bin/webx/.3bc36454/0]] (Dead link) + +The width dimension specified in the JPEG stream is actually half the reality because it takes into account 2 channels per sample (the dimension of the CFA pattern). + +350D, 5D and 30D files have a different layout. IFD3 (where the CFA is located) has the tag 0xc640 that contains 3 SHORT. 1, x, y. x is the number of column of the first "slice" of the image, y is for the second "slice".** I don't know what the 1 mean.** + +The slicing means that the output scanlines have to be reorganised as they are shorter to have a top -> bottom then left -> right, a bit like columns of text. (TODO: do a nice diagram) + + +# Modified files + +Apparently Canon's proprietary software modifies the RAW file. Other proprietary software seems to choke on said modified files ([[http://www.prophotohome.com/forum/raw-photo-processing-software-technique/62864-cr2-raws-converted-dpp-wont-open-aperture.html|http://www.prophotohome.com/forum/raw-photo-processing-software-technique/62864-cr2-raws-converted-dpp-wont-open-aperture.html]]). + +[[ExifTool|ExifTool]] has some info: + +* [[http://www.cpanforum.com/threads/1055|http://www.cpanforum.com/threads/1055]] +* [[http://www.cpanforum.com/threads/5170|http://www.cpanforum.com/threads/5170]] + +# References + +* [[http://lclevy.free.fr/cr2/|http://lclevy.free.fr/cr2/]] +* [[http://web.archive.org/web/20061125031802/http://crousseau.free.fr/imgfmt_raw.htm|http://web.archive.org/web/20061125031802/http://crousseau.free.fr/imgfmt_raw.htm]] (in French, by one of the developers of DxO)
\ No newline at end of file diff --git a/Canon_CRW.mdwn b/Canon_CRW.mdwn new file mode 100644 index 0000000..1826cf4 --- /dev/null +++ b/Canon_CRW.mdwn @@ -0,0 +1,22 @@ + +Canon CRW is the original Canon RAW file, based on CIFF, a Canon image file format. They are generated by all DSLR camera up to the 10D and Digital Rebel/300D as well as the Canon G1 to G5. + + +# MIME type + +image/x-canon-crw + + +# Organisation + +There is a complete specification for the CIFF file format. + + +# Compression + +It use a lossless huffman compression. + + +# Other + +Some camera with a "hacked" generate CRW files that are nothing like CIFF. diff --git a/Demosaicing.mdwn b/Demosaicing.mdwn new file mode 100644 index 0000000..ed240a9 --- /dev/null +++ b/Demosaicing.mdwn @@ -0,0 +1,4 @@ + +Some notes on Demosaicing. + +* [[Pixel Grouping|http://web.cecs.pdx.edu/~cklin/demosaic/]] diff --git a/Epson_ERF.mdwn b/Epson_ERF.mdwn new file mode 100644 index 0000000..75442e9 --- /dev/null +++ b/Epson_ERF.mdwn @@ -0,0 +1,17 @@ + +ERF files are generated by the Epson R-D1 and R-D1s digital rangefinder cameras. + + +# MIME Type + +image/x-epson-erf + + +# Organisation + +Epson ERF files are TIFF/EP files. CFA data is in the _primary_ subIFD from IFD0. Thumbnail is 8RGB in IFD0. Exif is attached to the ExifIFD of IFD0. + + +# Compression + +The CFA image data is "compressed", bit packed. The _Compression_ value in the CFA subIFD is set to 32769. diff --git a/Exempi.mdwn b/Exempi.mdwn new file mode 100644 index 0000000..1aee525 --- /dev/null +++ b/Exempi.mdwn @@ -0,0 +1,67 @@ + +Exempi is an implementation of XMP. Version 2.x is based on Adobe XMP SDK and released under a BSD-style license like Adobe's. The 3 clause BSD (aka New-BSD) license is compatible with GPL. The licensing is kept identical in order to allow two-way merging of the code (ie sending our change to the XMP SDK to Adobe for integration). + +The API is C based and means to be used from any language and be easier to maintain ABI stability. + +The overall changes include: + +* STABLE C API/ABI for the library, instead of a C++ template based version. +* GNU friendly build system based on automake. +* Code changes for UN*X systems compatibility. +* Architecture support for 64-bits (x86_64) and others. +* Test suite. +There is also a work in progress "exempi" command line tool starting in 2.2.0 + + +# Download Exempi + + +## 2.x series + +* version 2.2.0 [[.tar.bz2|http://libopenraw.freedesktop.org/download/exempi-2.2.0.tar.bz2]] - [[GPG signature|http://libopenraw.freedesktop.org/download/exempi-2.2.0.tar.bz2.asc]] +* [[older releases|http://libopenraw.freedesktop.org/download/]] + +## Binary packages + +* check your favorite distribution. + +## Obsolete 1.0 series + +* version 0.5.1 [[.tar.gz|http://download.gna.org/niepce/exempi-0.5.1.tar.gz]] - [[GPG signature|http://download.gna.org/niepce/exempi-0.5.1.tar.gz.asc]] +* version 0.5.0 [[.tar.gz|http://download.gna.org/niepce/exempi-0.5.0.tar.gz]] - [[GPG signature|http://download.gna.org/niepce/exempi-0.5.0.tar.gz.sig]] + +# Bugs reporting + +Bugs can be reported in freedesktop.org bugzilla. + +[[Report a bug|https://bugs.freedesktop.org/enter_bug.cgi?product=exempi]] + + +# Mailing list + +There is a mailing list exempi-devel to discuss of exempi development and exempi use (as a developer). + +[[http://lists.freedesktop.org/mailman/listinfo/exempi-devel|http://lists.freedesktop.org/mailman/listinfo/exempi-devel]] + + +# Source Code repository + +Version 2.x is hosted on freedesktop.org in git. + +`git://anongit.freedesktop.org/git/exempi.git` + +For push access: + +`git+ssh://git.freedesktop.org/git/exempi.git` + +To get the 2.0 branch, use the following for the initial checkout after `git clone`: + +`git checkout --track -b exempi-2.0-branch origin/exempi-2.0-branch` + +This create a lock branch exempi-2.0-branch that track the remote one. + + +# Links + +* [[CC XMP page|http://wiki.creativecommons.org/XMP]] +* [[Adobe release XMP sdk under BSD license|http://blogs.adobe.com/gunar/2007/05/xmp_411_sdk_available_under_bsd_license.html]]
\ No newline at end of file diff --git a/FAQ.mdwn b/FAQ.mdwn new file mode 100644 index 0000000..91711c1 --- /dev/null +++ b/FAQ.mdwn @@ -0,0 +1,8 @@ + +**Q: Does libopenraw works on Windows?** + +A: it should, but the developers do not have the will or the mean to even try out. libopenraw is written using standard C++ and portable libraries (boot, libjpeg) so it shouldn't be a problem. + +**Q: What APIs does libopenraw provide?** + +A: Currently only APIs to extract thumbnails or previews, and to extrace the CFA data, decompressed or not (notable exception is NEF). More is to come. diff --git a/FileFormats.mdwn b/FileFormats.mdwn new file mode 100644 index 0000000..17a5165 --- /dev/null +++ b/FileFormats.mdwn @@ -0,0 +1,47 @@ + + +# Supported + +The file format libopenraw supports even partially: + +* [[Adobe_DNG|Adobe_DNG]] +* [[Canon_CR2|Canon_CR2]] +* [[Canon_CRW|Canon_CRW]] +* [[Epson_ERF|Epson_ERF]] +* [[Fuji_RAF|Fuji_RAF]] +* [[Minolta_MRW|Minolta_MRW]] +* [[Nikon_NEF|Nikon_NEF]] and NRW +* [[Olympus_ORF|Olympus_ORF]] +* [[Panasonic_RAW|Panasonic_RAW]] and RW2 +* [[Pentax_PEF|Pentax_PEF]] +* [[Sony_ARW|Sony_ARW]] + +# Not Supported + +The file format that are not supported due to lack of documentation, sample or resources. There is a plan to support them in the long term. Any help is welcome. + +* [[Foveon_X3F|Foveon_X3F]] +* [[Kodak_DCR|Kodak_DCR]] +* [[Kodak KDC|Kodak KDC]] +* [[Mamiya MEF|Mamiya MEF]] +* [[Sony_SRF|Sony_SRF]] +* [[Sony SR2|Sony SR2]] + +# Metadata + +* [[Lens_Types|Lens_Types]] + +# Other references + +* [[http://crousseau.free.fr/imgfmt_raw.htm|http://crousseau.free.fr/imgfmt_raw.htm]] (in French, by one of the developers of DxO) +* The excellent [[File Format|http://fileformats.archiveteam.org/wiki/Cameras_and_Digital_Image_Sensors]] section from the archive team wiki + +# Sample Files + +The internet is somewhat rich in sample files. The manufacturers however don't provide any. Some sources: + +* [[http://raw.fotosite.pl/|http://raw.fotosite.pl/]] has a public repository of RAW files from various camera. +* [[http://www.rawsamples.ch/|http://www.rawsamples.ch/]] has different RAW samples. +* [[http://www.glasslantern.com/RAWpository/|http://www.glasslantern.com/RAWpository/]] is a third source. +* [[http://digikam3rdparty.free.fr/TEST_IMAGES/RAW/|http://digikam3rdparty.free.fr/TEST_IMAGES/RAW/]] from the Digikam team. +* [[Imaging Resource|http://www.imaging-resource.com/]] has a lot of sample files attached to their reviews.
\ No newline at end of file diff --git a/Foveon_X3F.mdwn b/Foveon_X3F.mdwn new file mode 100644 index 0000000..ef01ae7 --- /dev/null +++ b/Foveon_X3F.mdwn @@ -0,0 +1,6 @@ + +Format used my Sigma SD9 and SD10 digital camera. + +Official spec: [[http://www.photofo.com/downloads/x3f-raw-format.pdf|http://www.photofo.com/downloads/x3f-raw-format.pdf]] + +But the RAW data is "encrypted". dcraw has code in GPL but no documentation per see. [[http://www.photofo.com/x3f-raw-format/|http://www.photofo.com/x3f-raw-format/]] is a project to try to document this. diff --git a/Fuji_RAF.mdwn b/Fuji_RAF.mdwn new file mode 100644 index 0000000..dd2b994 --- /dev/null +++ b/Fuji_RAF.mdwn @@ -0,0 +1,49 @@ + +RAF is the RAW file format used by [[FujiFilm|FujiFilm]] camera. It looks like a simple table with embedded JPEG some data and uncompressed CFA. + + +# MIME type + +image/x-fuji-raf +# Organisation + +Byte order is Motorola (Big Endian) + +* 16 bytes string to identify the file (magic) + * `FUJIFILMCCD-RAW ` +* 4 bytes + * `0201` +* 8 bytes + * `FF389501` +* 32 bytes for the camera string, \0 terminated +* offset directory + * Version (4 bytes) for the directory + * `0100` + * `0159` + * 20 bytes "unknown" + * Jpeg image offset (4 bytes) + * Jpeg Image length (4 bytes) + * CFA Header Offset (4 bytes) + * CFA Header Length (4 bytes) + * CFA Offset (4 bytes) + * CFA Length (4 bytes) + * rest unused +* Jpeg image offset + * Exif JFIF with thumbnail + preview +* CFA Header offset - Big Endian + * 4 bytes: count of records + * Records, one after the other + * 2 bytes: tag ID + * 2 bytes: size of record (N) + * N bytes: data +* CFA Offset + * Uncompressed RAW + +# Compression + +Apparently no compression is applied. + + +# Links + +* [[http://crousseau.free.fr/imgfmt_raw.htm|http://crousseau.free.fr/imgfmt_raw.htm]]
\ No newline at end of file diff --git a/GettingTheCode.mdwn b/GettingTheCode.mdwn new file mode 100644 index 0000000..63894b5 --- /dev/null +++ b/GettingTheCode.mdwn @@ -0,0 +1,14 @@ + +The source code management system is Git (Cogito). + + +# Anonymous git + +* Check out the tree: + * `git clone git://anongit.freedesktop.org/git/libopenraw.git` + +# For developers (needs authorization) + +* Get a username if you don't have one: See [[http://www.freedesktop.org/wiki/AccountRequests|http://www.freedesktop.org/wiki/AccountRequests]] for details. +* Check out the tree: + * `git clone git+ssh://git.freedesktop.org/git/libopenraw.git`
\ No newline at end of file diff --git a/Kodak_DCR.mdwn b/Kodak_DCR.mdwn new file mode 100644 index 0000000..aa7afc6 --- /dev/null +++ b/Kodak_DCR.mdwn @@ -0,0 +1,22 @@ + +Kodak DCR is generated by Kodak DCS Pro camera (DSLR and backs). + +Kodak has a set of samples available for download on their [[developer website|http://www.kodak.com/global/en/professional/member/private/developers/07kproD2.jhtml]] (login required) + + +# MIME type + +image/x-kodak-dcr +# Organisation + +.DCR files are TIFF based. + + +# Compression + +The RAW data is known to be compressed using [[Lossless_JPEG|Lossless_JPEG]] like in [[Canon_CR2|Canon_CR2]] and [[Adobe DNG|Adobe DNG]]. + + +# Known issues + +Some of the files have a .TIF extension. diff --git a/Lens_Types.mdwn b/Lens_Types.mdwn new file mode 100644 index 0000000..78ef252 --- /dev/null +++ b/Lens_Types.mdwn @@ -0,0 +1,28 @@ + +Makernotes usually store the lens type in some way. Sometime as a string, sometime as an numerical ID, or something else. There is not standard and it is mostly per vendor. + + +# References + + +## Nikon + +* [[Nikkor Lens ID|http://www.rottmerhusen.com/objektives/lensid/nikkor.html]] +* [[Nikkor Extended Lens ID|http://www.rottmerhusen.com/objektives/lensid/thirdparty.html]] + +## Pentax + +* [[Pentax Lens ID|http://homepage2.nifty.com/mak_kawa/digicam/lens/lensid/lens_id.htm]] + +## Canon + +* [[Canon LensType from ExifTool|http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Canon.html#LensType]] +Canon cameras do not have a reliable "[[LensType|LensType]]" field. For example my 20D does not and put 0xffff, while some later Rebel model does. + +So there are two ways: if you have a consistent [[CameraSettings|CameraSettings]].[[LensType|LensType]], use it. + +If you don't (0xffff for example) you have other lens info that should allow to reduce the list to a bunch and require some user selection for the few last cases. For that there are a few fields in the makernotes: + +First the [[FocalLength|FocalLength]].[[FocalType|FocalType]] to see if it is a zoom or a prime. + +Second [[CameraSettings|CameraSettings]].[[LongFocal|LongFocal]] and [[ShortFocal|ShortFocal]], and [[MaxAperture|MaxAperture]] + [[MinAperture|MinAperture]]. diff --git a/LinkToDocumentation.mdwn b/LinkToDocumentation.mdwn new file mode 100644 index 0000000..95a7cd3 --- /dev/null +++ b/LinkToDocumentation.mdwn @@ -0,0 +1,22 @@ + +Given how manufacturer document these formats, we have to reverse-engineer or use documentation issued from reverse engineering. + + +# Implementation + +* [[dcraw|http://www.cybercom.net/~dcoffin/dcraw/]] the current reference implementation for RAW decoding. +* [[jrawio|http://www.tidalwave.it/infoglueDeliverLive/ViewPage.action?siteNodeId=180&languageId=1&contentId=206]] a Java library that implements RAW image decoding +* [[exifprobe|http://www.virtual-cafe.com/~dhh/tools.d/exifprobe.d/exifprobe.html]] and [[Exiv2|http://www.exiv2.org/]] that decode several raw files + +# Processing + +* [[rawness, digital photography science|http://www.rawness.es/?lang=en]] explain the science of raw processing and other. Very informative. (also in Spanish) + +# File format + +* [[RAW file standards|http://www.rags-int-inc.com/PhotoTechStuff/RawStandards/]] try to match current standard with currently undocumented file formats and its [[summary|http://www.rags-int-inc.com/PhotoTechStuff/RawStandards/RawSummary.html]]. +* [[TIFF|http://partners.adobe.com/public/developer/tiff/index.html]] on which DNG and apparently other RAW format are based on. +* [[Adobe DNG|http://www.adobe.com/products/dng/main.html]] a "standard" format that Adobe tries to push. +* [[X3F Foveon|http://www.x3f.info/spp/v2_1/english.html#Format]], the Foveon partial documentation. +* [[MRW Minolta RAW|http://www.dalibor.cz/minolta/raw_file_format.htm]] +* [[RAWpository|http://www.glasslantern.com/RAWpository/]] archive of sample image data in RAW formats
\ No newline at end of file diff --git a/Minolta_MRW.mdwn b/Minolta_MRW.mdwn new file mode 100644 index 0000000..42d9435 --- /dev/null +++ b/Minolta_MRW.mdwn @@ -0,0 +1,7 @@ + +Minolta MRW + +* [[Dalibor Jelinek's documentation|http://www.dalibor.cz/minolta/raw_file_format.htm]] +* [[ImageCooker|http://www.focalplane.net/imagecooker/]] +* [[Stephane Chauveau documentation|http://www.chauveau-central.net/mrw-format/mrw-format.txt]] +* [[Cedric Rousseau documentation|http://crousseau.free.fr/imgfmt_raw.htm]] from one of the developers of DxO
\ No newline at end of file diff --git a/Nikon_NEF.mdwn b/Nikon_NEF.mdwn new file mode 100644 index 0000000..6890ad8 --- /dev/null +++ b/Nikon_NEF.mdwn @@ -0,0 +1,36 @@ + +NEF files are generated by Nikon cameras. + +NRW is a variant, generated by some Coolpix like the P6000 and P7000. Some differences notable in the RAW data storage that is not "standard". The use of .nrw extension is probably to differentiate them since Nikon committed "support" in Windows (like a marketing gimmick). + + +# MIME type + +image/x-nikon-nef + + +# Organisation + +It is a TIFF file. close to TIFF/EP or DNG. + + +# Thumbnails + +NEF files have a large JPEG preview. It is either in a subIF of the main IFD (type == thumbail) or for the older, in the [[MakerNote|MakerNote]] IFD. + + +# Compression + +D1 files are not compressed. + +D1x files are not compressed but have a weird shape: they have a pixel ratio of 0.5, ie 2 row for one. + +Some files are packed (Compression = 32769). It is a standard packing with some padding: if col % 10 == 9, then an extra 8 bits must be skipped. + +Compression (Compression = 34713) is a Huffman tree and a quantization table. The quantization tables are at 0x8c and 0x96 tag from the [[MakerNote|MakerNote]]. Strangely dcraw seems to only use the later as it override the value reading the tags in sequence. See nikon_compressed_load_raw(). + +[[http://www.majid.info/mylos/weblog/2004/05/02-1.html|http://www.majid.info/mylos/weblog/2004/05/02-1.html]] has a very insightful article about NEF decoding. + +The D100 has a bug that tag uncompressed image as compressed, but not always. See nikon_is_compressed() in dcraw.c. It appear that most D100 will just use uncompressed (packed) as the compression _froze the camera for 20s_ + +NRW are not compressed, but the RAW data organisation is not standard. (TBD) diff --git a/Olympus_ORF.mdwn b/Olympus_ORF.mdwn new file mode 100644 index 0000000..632a079 --- /dev/null +++ b/Olympus_ORF.mdwn @@ -0,0 +1,21 @@ + +ORF file are generated by Olympus cameras. + + +# MIME type + +image/x-olympus-orf + + +# Organisation + +It if a TIFF file with a custom magic at the beginning: MMOR, IIRO or IIRS instead of the TIFF magic. + +IFD 0 contain the main image. IFD 1 contain the 160x120 preview. Some file don't have the preview outside the [[MakerNotes|MakerNotes]]. + +Another peculiarity is that [[StripOffsets|StripOffsets]] and [[StripByteCounts|StripByteCounts]] are arrays for the E10 files, unlike the others. Still consistent with the TIFF/EP standard. + + +# Compression + +Sometime the CFA does not look like it is compressed but seems to be organised weirdly. E400 has uncompressed CFA. diff --git a/Packages.mdwn b/Packages.mdwn new file mode 100644 index 0000000..b62d63c --- /dev/null +++ b/Packages.mdwn @@ -0,0 +1,17 @@ + +There are a set a pre-built packages for libopenraw if it is not in your distribution. + + +# SuSE + +Packages for various SUSE versions (i386 and x86_64) are available in the openSUSE build service. + +* [[SUSE Linux 10.1|http://download.opensuse.org/repositories/home:/hfiguiere/SUSE_Linux_10.1]] +* [[SLED 10|http://download.opensuse.org/repositories/home:/hfiguiere/SLE_10]] +* [[openSUSE 10.2|http://download.opensuse.org/repositories/home:/hfiguiere/openSUSE_10.2]] +* [[openSUSE 10.3|http://download.opensuse.org/repositories/home:/hfiguiere/openSUSE_10.3]] +* [[SUSE Factory|http://download.opensuse.org/repositories/home:/hfiguiere/openSUSE_Factory]] + +# Ubuntu + +Package for Ubuntu Feisty and Ubuntu Gutsy (i386 and amd64 only) are in the PPA. See [[https://launchpad.net/%7Ehub/+archive|https://launchpad.net/%7Ehub/+archive]] for the source to add to apt. diff --git a/Panasonic_RAW.mdwn b/Panasonic_RAW.mdwn new file mode 100644 index 0000000..c0fa934 --- /dev/null +++ b/Panasonic_RAW.mdwn @@ -0,0 +1,21 @@ + +Panasonic cameras create RAW files with the RAW or RW2 extension. RW2 is the latest. + + +# MIME Type + +image/x-panasonic-raw and image/x-panasonic-rw2 + + +# Organisation + +TIFF but with a different version in the magic: IIU\x00\x08\x00\x00\x00. Also the tags are uncommon. The CFA is in the mainIFD that also reference an Exif IFD. + +Old RAW files don't have a preview. Newer one (some RAW and all RW2) have a complete JPEG with Exif embedded. + +The RAW data is compressed (proprietary). The CFA bayer layout is BGGR. + + +# Links + +* [[http://thinkfat.blogspot.com/2009/02/dissecting-panasonic-rw2-files.html|http://thinkfat.blogspot.com/2009/02/dissecting-panasonic-rw2-files.html]] diff --git a/PlannedFeatures.mdwn b/PlannedFeatures.mdwn new file mode 100644 index 0000000..606e9db --- /dev/null +++ b/PlannedFeatures.mdwn @@ -0,0 +1,29 @@ + + +# Implemented + +* NEF, CRW, CR2, PEF, ARW, ORF, MRW (Minolta), RAF (Fuji), RAW (Panasonic), RW2 and DNG parsing +* Modular low level API that allow: + * Parse the file + * Extract previews +* High level API that allow: + * Provide and standard thumbnail - **Done** + +# To Implement + +* Support for as much file format as possible. +* Modular low level API that allow: + * Identify the file by content + * Extract the meta-data + * Allow processing the RAW data in different way, including having them extracted for an application custom processor. +* High level API that allow: + * Preprocess the file using standard parameters + * Extract the metadata as EXIF (and XMP) + * Convert to a DNG file + +# Development Plans + +* Get a basic thumbnail extractor - **Done 0.0.1** +* Get a basic metadata extractor - Done +* Get a basic RAW processor - Done, but need work. +* Implementing a new file format means implementing its parsing on top of the existing internal API and support all the high-level features that the other support.
\ No newline at end of file diff --git a/RawThumbnailer.mdwn b/RawThumbnailer.mdwn new file mode 100644 index 0000000..6cadeb7 --- /dev/null +++ b/RawThumbnailer.mdwn @@ -0,0 +1,20 @@ + +RawThumbnailer is a thumbnailer for RAW files that works with the Gnome Nautilus file manager. It is released under the GPL. + + +# Known limitations + +Not enough format are supported. + + +# Download + +* 3.0.0: [[.tar.bz2|http://libopenraw.freedesktop.org/download/raw-thumbnailer-3.0.0.tar.bz2]] - [[GPG signature|http://libopenraw.freedesktop.org/download/raw-thumbnailer-3.0.0.tar.bz2.asc]] +* 0.99.1: [[.tar.gz|http://libopenraw.freedesktop.org/download/raw-thumbnailer-0.99.1.tar.gz]] - [[GPG signature|http://libopenraw.freedesktop.org/download/raw-thumbnailer-0.99.1.tar.gz.asc]] +* 0.99: [[.tar.gz|http://libopenraw.freedesktop.org/download/raw-thumbnailer-0.99.tar.gz]] - [[GPG signature|http://libopenraw.freedesktop.org/download/raw-thumbnailer-0.99.tar.gz.asc]] + +# Source code + +Because this program is really for Gnome the source code is hosted in GNOME git repository: + +git clone git://git.gnome.org/gnome-raw-thumbnailer diff --git a/Sony_SRF.mdwn b/Sony_SRF.mdwn new file mode 100644 index 0000000..12ae2fb --- /dev/null +++ b/Sony_SRF.mdwn @@ -0,0 +1,12 @@ + +This format is generated by these camera : + +* Sony DSC-F828 +* Sony DSC-R1 + +# MIME type + +image/x-sony-srf +# Organisation + +No sample available. diff --git a/conversion.mdwn b/conversion.mdwn new file mode 100644 index 0000000..01d9f7f --- /dev/null +++ b/conversion.mdwn @@ -0,0 +1,9 @@ +# MoinMoin to Ikiwiki conversion + +If you have an account on Annarchy, you can help out with the conversion of this wiki. + +You can follow the [[page conversion|http://wiki.freedesktop.org/sitewranglers/wiki/moin2iki_page_selection/]] instructions using `PROJECT="libopenraw"`. + +Here is a list of broken links, which should be a starting place for what needs converting: + +[[!brokenlinks]] diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..87ed37c --- /dev/null +++ b/index.mdwn @@ -0,0 +1,56 @@ +# libopenraw + +libopenraw is an ongoing project to provide a free software implementation for camera RAW files decoding. One of the main reason is that [[dcraw|http://www.cybercom.net/~dcoffin/dcraw/]] is not suited for easy integration into applications, and there is a need for an easy to use API to build free software digital image processing application. + +It also has the goal to address missing feature from [[dcraw|http://www.cybercom.net/~dcoffin/dcraw/]] like meta-data decoding and easy thumbnail extraction. + + +## Status + +This is currently a work in progress. The currently unreleased code is available in git. See [[GettingTheCode]]. + +* version 0.0.9 [[tar.bz2|http://libopenraw.freedesktop.org/download/libopenraw-0.0.9.tar.bz2]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.8.tar.bz2.asc]] - 13 Nov 2011 +* version 0.0.8 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.8.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.8.tar.gz.asc]] - 15 May 2009 +* version 0.0.7 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.7.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.7.tar.gz.asc]] - 28 Apr 2009 +* version 0.0.6 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.6.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.6.tar.gz.asc]] - 21 Feb 2009 +* version 0.0.5 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.5.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.5.tar.gz.asc]] - 26 Feb 2008 +* version 0.0.4 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.4.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.4.tar.gz.asc]] - 12 Jan 2008 +* version 0.0.3 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.3.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.3.tar.gz.asc]] - 25 Nov 2007 +* version 0.0.2 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.2.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.2.tar.gz.sig]] - 25 Jan 2007 +* version 0.0.1 [[tar.gz|http://libopenraw.freedesktop.org/download/libopenraw-0.0.1.tar.gz]] [[GPG sig|http://libopenraw.freedesktop.org/download/libopenraw-0.0.1.tar.gz.sig]] - 9 Dec 2006 + + +## Where to go + +* [[PlannedFeatures]]: what are the plan +* [[GettingTheCode]]: downloading the source +* [[Packages]]: pre-built packages +* [[Building]]: building the library +* [[Library Documentation|http://libopenraw.freedesktop.org/doxygen]] (Doxygen generated) +* [[BugReporting]]: how to report a bug +* [[FAQ]]: frequent questions +* [[FileFormats]]: our documentation on file formats +* [[LinkToDocumentation]]: external documentation +* [[Demosaicing]] + +## Getting in touch + + +### Mailing lists + +There is mailing list for developers available now. Visit <http://lists.freedesktop.org/mailman/listinfo/libopenraw-dev> to subscribe. You can also access the archive: <http://lists.freedesktop.org/archives/libopenraw-dev/> + + +### IRC + +Join us on #libopenraw on the [[FreeNode]] irc network (irc.freenode.net). + + +## Satellite Projects + +* [[Exempi]], a library to parse XMP metadata. +* [[RawThumbnailer]] a thumbnailer for Gnome Nautilus that use libopenraw. +-- [[HubertFiguiere]] + + +This wiki is undergoing [[conversion]]. If you have a fd.o shell account, you can help! |