| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <title>Overview of LibRaw API (C++)</title> |
| </head> |
| |
| <body> |
| <a href=index.html>[back to Index]</a> |
| <h1>Overview of LibRaw API (C++)</h1> |
| <h2>General Remarks</h2> |
| <ol> |
| <li>The entire processing is carried out by an instance of the LibRaw class, which is an image processor.</li> |
| <li>One image processor can simultaneously process only one data source file, but consecutive processing of any number of files |
| is possible.</li> |
| <li>There may be several simultaneously working image processors in a software program (e.g., in different threads), although one |
| should remember that each image processor may require much memory.</li> |
| <li>Reading of source data from the RAW file requires virtually no customization (see <a |
| href="API-notes.html">API Notes</a> for exceptions to this rule).</li> |
| <li>All data extracted from the RAW file are accessible through data fields of the image processor (LibRaw class instance).</li> |
| <li>Although LibRaw <b>is not intended for RAW data postprocessing</b>, the library includes calls that enable complete |
| emulation of the <b>dcraw</b> utility. |
| <li>All customization for the processing is performed via data fields of the LibRaw class.</li> |
| </ol> |
| |
| <h2>Brief Demonstration</h2> |
| <p> |
| The example below contains no error processing for the sake of brevity. |
| </p> |
| <pre> |
| #include "libraw/libraw.h" |
| int process_image(char *file) |
| { |
| // Let us create an image processor |
| LibRaw iProcessor; |
| |
| // Open the file and read the metadata |
| iProcessor.open_file(file); |
| |
| // The metadata are accessible through <a href="API-datastruct.html">data fields of the class</a> |
| printf("Image size: %d x %d\n",iProcessor.imgdata.sizes.width,iProcessor.imgdata.sizes.height); |
| |
| // Let us unpack the image |
| iProcessor.unpack(); |
| |
| // Convert from imgdata.rawdata to imgdata.image: |
| iProcessor.raw2image(); |
| |
| // And let us print its dump; the data are accessible through <a href="API-datastruct.html">data fields of the class</a> |
| for(i = 0;i lt; iProcessor.imgdata.sizes.iwidth * iProcessor.imgdata.sizes.iheight; i++) |
| printf("i=%d R=%d G=%d B=%d G2=%d\n", |
| i, |
| iProcessor.imgdata.image[i][0], |
| iProcessor.imgdata.image[i][1], |
| iProcessor.imgdata.image[i][2], |
| iProcessor.imgdata.image[i][3] |
| ); |
| |
| // Finally, let us free the image processor for work with the next image |
| iProcessor.recycle(); |
| } |
| </pre> |
| |
| |
| <a href=index.html>[back to Index]</a> |
| </body> |
| </html> |
