SARAW

SARAW

SARAW is an ImgSource extension library which allows you to read the various "Raw" image files that are generated by digital cameras. It is available as both a DLL and a set of C++ static libraries (for VC6, Visual Studio 2003, VS2005 and VS2008). Native x64 libraries are available, also.

Features

• Reading:
  • Read raw images from over 100 different cameras.
  • Read images to 24 or 48 bit RGB
  • Read directly to DIB (for 24-bit only)
  • Correct color balance, gamma, brightness, as well as quick preview and high-quality options.

Integration

Because SARAW is tightly integrated into ImgSource's source and destination manager system, reading and "Raw" images is as easy as reading any of the formats that ImgSource supports natively. Here's a sample:

      // init
      SARAW_Initialize(your key);

      // get ImgSource extension hook
      HISEXTHK hHk = IS3GetExtHook(0);

      // set the hook in SARAW
      SARAW_SetImgSourceHooks(hHk);

      // clean up
      GlobalFree(hHk);

      // open RAW file via ImgSource
      HISSRC hSrc = IS3OpenFileSource("DSC_0286.NEF");

      // read the image to RGB-24
      UINT32 w, h;
      UINT32 uReadFlags = 0;
      HGLOBAL hImg = SARAW_ReadRAW(hSrc, &w, &h, 24, 1,1,1,1,1, 0,0,uReadFlags);

      // check for error
      if (hImg == NULL)
      {
        // test the error code.
        UINT error = IS3GetLastError();
      }

      // close the file
      IS3CloseSource(hSrc);               

      ...

      // clean up
      GlobalFree(hImg);
      SARAW_Exit();

What's Included?

The download package includes

• _SARAW.DLL - the image library
• _SARAW.H - the main header file
• _SARAW.LIB - the library file, used for static linking of the DLL
• The SARAW source code (VC 6.0 / VS.Net) is not included but a 6-month source code subscription can be purchased seperately.

The static library is available separately.

Download SARAW

Version 2.1
v.2.2.3.6

Win32 and x64 Libraries

• DLL for 32-bit Windows
  
  
  SARAW22.zip
  
  
• DLL for 64-bit Windows
  
  
  SARAW22_x64.zip

C++ Static Libraries	Multi-threaded Static CRT (linking with LIBCMT/D) Win32	Multi-threaded Dynamic CRT (linking with MSVCRT/D) Win32	Multi-threaded Static CRT (linking with LIBCMT/D) x64	Multi-threaded Dynamic CRT (linking with MSVCRT/D) x64
Visual C++ 6 (with SP5 or 6)	sarawlib_22d.zip	sarawlib_22s.zip	---	---
Visual Studio 2003	sarawlib_22d_vs03.zip	sarawlib_22s_vs03.zip	---	---
Visual Studio 2005	sarawlib_22d_vs05.zip	sarawlib_22s_vs05.zip	sarawlib_22d_vs05_x64.zip*	sarawlib_22s_vs05_x64.zip*
Visual Studio 2008	sarawlib_22d_vs08.zip	sarawlib_22s_vs08.zip	sarawlib_22d_vs08_x64.zip*	sarawlib_22s_vs08_x64.zip*
			* - Use of the x64 libraries requires a $15 upgrade to a standard ImgSource license.

Registration

The DLL you download is a full, working version. However, to use it properly, you will need an access key, which you will use when you initialize the DLL. The access key is what you get when you register. Without the key, all images will have a big red "X" drawn on them.
Once registered, you are free to use SARAW however you wish, with the following restrictions :

1. You may not use SARAW in a product which directly competes with SARAW
2. You may not explicitly distribute SARAW access keys to persons who are not registered SARAW users. Specifically, this applies to companies who wish to distribute the source of their applications to users. SARAW access keys must not be included in this source.
3. Each team that uses SARAW within a company or organization should acquire their own SARAW license.
4. There are no royalties associated with SARAW.
5. If there is opportunity for you to credit Smaller Animals Software with writing SARAW, you should feel free to mention us.

Registration cost: $25.00 U.S.

• Credit card ordering from RegSoft (usually less than an hour):
  
  
  This is a secure site.
• For phone and fax orders, SARAW's RegSoft product ID is : 68335
• By phone with a credit card @ 1-877-734-7638
• By fax with a credit card at 1-770-497-9234
• Register by mail
  
  

RegSoft usually fills orders in less than an hour. If you do not receive your registration information, please contact RegSoft. Smaller Animals Software does not process the credit cards.

Warning:
Using SARAW in a commercial product without obtaining a license is a serious violation of the terms of use for this product. Companies found to be using SARAW without a license will be prosecuted.

Contact & Bug Reports

Disclaimer
Use at your own risk. There are no guarantees as to the suitablility of this software for any particular use. We cannot anticipate all uses to which people might try to put this. Any bugs, if reported , will be fixed as soon as possible. Smaller Animals Software can not be held responsible for any bugs or the consequences of any bugs which were not reported.

Tech Support
We know Visual C++. We don't know Visual BASIC or Borland's C++. But, we will try to help you as much as we can. You should always search the discussion board to see if your question has been answered there.

Please do not send question about SARAW to anyone who's code is included as part of SARAW; they have provided their code with no obligations to support what we do with it.

• Use the ImgSource discussion board.

Other Platforms
If you use this package with a platform other than VC++, and would like to tell us how you did it, please do. If you have any hints or tips or code snippets that could help others, please feel free to share this on the ImgSource discussion board.

Note : Borland C++ Builder uses a different object file format than MicroSoft. You will have to use IMPLIB to create a static .LIB, if you want to statically link to the SARAW package. See your complier's manual for help with this.

Suggestions
If you have ideas about functionality that you'd like but don't see here, let us know. Many of the features included are the result of people asking if we could figure out how to do it.
Credit
Much credit to Dave Coffin, for the super-human feat of reversing all of these formats, and for making the fruits of his labors free for all to use.

---

Copyright © 2008, Smaller Animals Software, Inc.