n8th8n8el / raw

Raw image file reader, written in Java, as part of an ongoing personal study project.

raw

This is not a production ready raw reader, just a personal project I started while studying digital image processing. If you need a complete, fully functional library, check dcraw out.

Currently the only format supported is uncompressed, linear (demosaiced) Adobe DNG. Reading TIFF metadata is also supported.

I decided to support DNG first because, unlike proprietary formats such as Canon's CR2 or Nikon's .NEF, DNG is open and has its specification publicly available. Also, virtually all widely used raw formats are TIFF-based, like DNG, so if you can read it, you are more than halfway done reading any raw file format.

You can use Adobe Camera Raw and DNG Converter to convert your raw files to DNG.

I am looking for contributors willing to help me implement support for reading nonlinear compressed data. While uncompressed linear is specific to DNG, nonlinear compressed is the same format used by Canon and Nikon.

Before you begin

Keep in mind TIFF is a decades old file format that has been receiving extensions for as long as has existed. It's full of idiosyncrasies and I strongly encourage you to read the following specifications before proceeding:

• TIFF Revision 6.0 Final - June 3, 1992
• TIFF Technical Note 1: TIFF Trees
• ISO 12234-2:2001, Electronic still-picture imaging – Removable memory – Part 2: TIFF/EP image data format
• Digital Negative Specification Version 1.4.0.0

Supported color spaces

• CIE 1931 XYZ
• CIE 1976 (L*, u*, v*)
• CIE LCHuv
• sRGB
• LSH (CIE LCHuv, with chroma C replaced with saturation S = C/L)

The Code

com.github.gasrios.raw.processor.TiffProcessorEngine
	uses com.github.gasrios.raw.processor.TiffProcessor
		implemented by com.github.gasrios.raw.processor.AbstractTiffProcessor
			extended by com.github.gasrios.raw.processor.DngProcessor
				extended by com.github.gasrios.raw.editor.CommandLineInvoker
					uses com.github.gasrios.raw.editor.Editor

com.github.gasrios.raw.editor.Library

com.github.gasrios.raw.processor.TiffProcessorEngine

Bridges the gap between (1) reading a TIFF file (see com.github.gasrios.raw.data.ImageFileDirectoryLoader and com.github.gasrios.raw.io.TiffInputStream) and making its information available in an easy to use fashion (see com.github.gasrios.raw.data.ImageFileDirectory) and (2) writing code that actually processes this information.

com.github.gasrios.raw.processor.TiffProcessor

This interface provides consumer methods called by TiffProcessorEngine when content is available and ready to be processed. By implementing this interface you can manipulate TIFF images as you see fit.

com.github.gasrios.raw.processor.AbstractTiffProcessor

Provides empty implementations of com.github.gasrios.raw.processor.TiffProcessor methods you do not care about, so you can only focus on the stuff you need.

com.github.gasrios.raw.processor.DngProcessor

This class makes all transformations deemed too complex to be at com.github.gasrios.raw.data.ImageFileDirectoryLoader when processing the high resolution image IFD:

1. Reads image strips and converts them to a width X height pixel matrix;
2. Converts camera coordinates to XYZ D50 values;

This pretty much ends all the dirty work needed to read the TIFF file, and makes its information available to people whose business is doing actual photo editing.

com.github.gasrios.raw.editor.CommandLineEditorInvoker

com.github.gasrios.raw.processor.DngProcessor subclass that provides an easy to use command line caller for image editors.

Usage: java com.github.gasrios.raw.CommandLineEditorInvoker <AnEditor implements com.github.gasrios.raw.editor.Editor> image.dng

com.github.gasrios.raw.editor.Editor

A simple interface called from com.github.gasrios.raw.editor.CommandLineEditorInvoker. The point is to make image editing as simple as possible.

com.github.gasrios.raw.editor.Library

Utility methods to save, display and manipulate images.

Examples

See raw-examples.

Copyright & License

© 2016 Guilherme Rios All Rights Reserved

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Additional Licenses

This software uses Adobe XMP Toolkit for Java, licensed under the BSD license.

Copyright (c) 2009, Adobe Systems Incorporated All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

• Neither the name of Adobe Systems Incorporated, nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANT ABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.