Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
Copyright 2007 Sun Microsystems


1. Introduction
   1.1. Project/Component Working Name:
	dcraw

   1.2. Name of Document Author/Supplier:
	Dermot McCluskey

   1.3. Date of This Document:
	01/24/08
	
	1.3.1. Date this project was conceived:
		11/08/07

   1.4. Name of Major Document Customer(s)/Consumer(s):
	1.4.1. The PAC or CPT you expect to review your project:
		Solaris PAC
	1.4.2. The ARC(s) you expect to review your project:
		LSARC
	1.4.3. The Director/VP who is "Sponsoring" this project:
		robert.odea@sun.com
	1.4.4. The name of your business unit:
		OPG / OpenSource.

   1.5. Email Aliases:
	1.5.1. Responsible Manager:
		tom.garland@sun.com
	1.5.2. Responsible Engineer:
		brian.nitz@sun.com
	1.5.3. Marketing Manager:
		dan.roberts@sun.com
	1.5.4. Interest List:
		desktop-discuss@opensolaris.org

4. Technical Description:
    4.1. Details:
	dcraw (pronounced "dee-see-raw"), is a simple, open-source,
	command-line program that converts RAW format photo images,
	typically produced by mid- and high-end digital cameras,
	into PPM or TIFF images.

	RAW format is not a specific file format, but a term commonly
	used to describe the uncompressed, "raw" images produced by
	digital cameras. Each manufacturer has their own RAW formats and
	dcraw includes code to support a large number of these formats.
	The maintainer of dcraw regularly releases new versions which
	add support for new cameras.

	The package consists of a single installed binary,
	/usr/bin/dcraw, a manpage and localized message files.  There
	are no plans to add a GUI at this time.

        This proposal adds version 8.81, the latest stable release.

	The dcraw program supports the following options:
		Usage:  dcraw [OPTION]... [FILE]...

		-v        Print verbose messages
		-c        Write image data to standard output
		-e        Extract embedded thumbnail image
		-i        Identify files without decoding them
		-i -v     Identify files and show metadata
		-z        Change file dates to camera timestamp
		-w        Use camera white balance, if possible
		-a        Average the whole image for white balance
		-A <x y w h> Average a grey box for white balance
		-r <r g b g> Set custom white balance
		+M/-M     Use/don't use an embedded color matrix
		-C <r b>  Correct chromatic aberration
		-n <num>  Set threshold for wavelet denoising
		-k <num>  Set the black level
		-K <file> Subtract dark frame (16-bit raw PGM)
		-H [0-9]  Highlight mode (0=clip, 1=unclip, 2=blend, 3+=rebuild)
		-t [0-7]  Flip image (0=none, 3=180, 5=90CCW, 6=90CW)
		-o [0-5]  Output colorspace (raw,sRGB,Adobe,Wide,ProPhoto,XYZ)
		-o <file> Apply output ICC profile from file
		-p <file> Apply camera ICC profile from file or "embed"
		-d        Document mode (no color, no interpolation)
		-D        Document mode without scaling (totally raw)
		-j        Don't stretch or rotate raw pixels
		-W        Don't automatically brighten the image
		-b <num>  Adjust brightness (default = 1.0)
		-q [0-3]  Set the interpolation quality
		-h        Half-size color image (twice as fast as "-q 0")
		-f        Interpolate RGGB as four colors
		-m <num>  Apply a 3x3 median filter to R-G and B-G
		-s [0..N-1] Select one raw image or "all" from each file
		-4        Write 16-bit linear instead of 8-bit with gamma
		-T        Write TIFF instead of PPM

	Some further details, including a FAQ and a list of supported
	camera models, are available at the dcraw website (see Reference
	Documents, below).

    4.2. Bug/RFE Number(s):
	None.

    4.3. In Scope:
	See above.

    4.4. Out of Scope:
	See above.

    4.5. Interfaces:

	--------------------------------------------------------------------
	Exported			Stability	Comments
	--------------------------------------------------------------------
	SUNWdcraw			Volatile	Package name
	/usr/bin/dcraw			Volatile	CLI
	/usr/share/man/man1/dcraw.1	Volatile	Manpage


	--------------------------------------------------------------------
	Imported			Stability	Comments
	--------------------------------------------------------------------
	libjpeg				Committed
	liblcms				Volatile	*NEW*


    4.6. Doc Impact:
	New manpage, dcraw.1.

    4.7. Admin/Config Impact:
	None.

    4.8. HA Impact:
	None.

    4.9. I18N/L10N Impact:
	The package includes localized message files for a number of locales:
	cs de eo es fr hu it nl pl pt ru zh_CN zh_TW.
	There is no additional impact for I18N/L10N.

    4.10. Packaging & Delivery:
	Adds new package, SUNWdcraw, approx 440 KB.
	Package will only go into SUNWCall and SUNWCXall clusters.

    4.11. Security Impact:
	None.

    4.12. Dependencies:
	Depends on integration of lcms (Little Color Management System).

5. Reference Documents:
	dcraw website: http://cybercom.net/~dcoffin/dcraw/
	dcraw.1 manpage to be included with proposal