npm - lightdrift-libraw - Versions diffs - 1.0.0-alpha.1 - Mend

lightdrift-libraw 1.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (487) hide show

package/deps/LibRaw-Win64/LibRaw-0.21.4/doc/Samples-LibRaw.html ADDED Viewed

@@ -0,0 +1,213 @@
+<html>
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=windows-1252">
+  </head>
+  <body>
+    <p>LibRaw: Usage Examples<a href="index.html">[back to Index]</a></p>
+    <h1>LibRaw: Usage Examples</h1>
+    <h2>Overview of Examples in the Distribution Package (samples/*)</h2>
+    <p>The LibRaw package contains several examples illustrating the use of this
+      library. Their source codes are located in the samples/ folder, and after
+      library build they will be in the bin/ folder:</p>
+    <ul>
+      <li><strong>raw-identify</strong> The only LibRaw call it uses is <a href="API-CXX.html#open_file">open_file()</a>;
+        further code prints the values of the fields of the imgdata structure. <strong><br>
+        </strong><strong>raw-identify -v</strong> provides extensive dump of
+        metadata/<br>
+        Command line key <strong>-u</strong> shows unpacking function name,
+        while <strong>-u -f</strong> prints function name and masked are sizes.<br>
+        <strong>raw-identify -w </strong>will print white balance tables stored
+        in RAW file.</li>
+      <li><strong>simple_dcraw</strong> A simple "emulation" of dcraw
+        reproducing the behavior of <strong>dcraw [-e] [-v] [-T]</strong>.&nbsp;
+        A simplified version of this example is <a href="#code">considered
+          below</a>. <br>
+        <strong>-B</strong> command-line switch turns on use of <a href="API-CXX.html#open_buffer">open_buffer()
+          API call</a> used via mmap() of input file (Unix only).</li>
+      <li><strong>dcraw_half</strong> Demonstrates the use of <a href="API-C.html">C
+          API</a>. The example emulates the behavior of <strong>dcraw -h</strong>
+        (no other control parameters can be specified in this example). </li>
+      <li><strong>dcraw_emu</strong> Almost complete emulation of dcraw (except for
+        keys -D -d -E -i -v -e, which are considered in other usage examples).
+        Of most interest is processing of command line keys (copied from dcraw).
+        <br>
+        <p>This sample supports additional command-line parameters absent in
+          original dcraw:</p>
+        <dl>
+          <dt><strong>-mmap</strong></dt>
+          <dd>Use <a href="API-CXX.html#open_buffer">open_buffer()</a>
+            interface. Buffer prepared by mmap() call. This option not supported
+            under Win32.</dd>
+          <dt><strong>-meme</strong></dt>
+          <dd>Use <a href="API-CXX.html#open_buffer">open_buffer()</a>
+            interface. Buffer prepared by malloc()+read() calls.</dd>
+          <dt><strong>-c float-value</strong></dt>
+          <dd>This key sets <strong>params.adjust_maximum_thr</strong>
+            parameter.<br>
+            Use -c 0 to completely disable automatic maximum calculation. <br>
+            Default value: 0.75</dd>
+          <dt><strong>-timing</strong></dt>
+          <dd>Turns on detailed timing print.</dd>
+          <dt><strong>-G</strong></dt>
+          <dd>Turns on "green_matching" mode to suppress color mazes on cameras
+            with different green channels.</dd>
+          <dt><strong>-B x y w h</strong></dt>
+          <dd>Crops output to rectangle with width w, height h and x,y
+            coordinates of left upper corner. All coordinates applied before any
+            image rotation.</dd>
+          <dt><strong>-F</strong></dt>
+          <dd>Will use FILE I/O (bigfile_datastream) instead on standard
+            LibRaw_file_datastream.</dd>
+          <dt><strong>-dcbi N</strong></dt>
+          <dd>Sets number of additional DCB-demosaic iterations (option valid
+            only for -q 4, i.e. for DCB demosaic).</dd>
+          <dt><strong>-dcbe</strong></dt>
+          <dd>Turns on DCB color enhance mode (only for DCB demosaic, -q 4).</dd>
+          <dt><strong>-aexpo e p</strong></dt>
+          <dd>Turns on exposure correction. e is exposure shift in linear scale
+            from 0.25 (darken 2 stops) to 8.0 (lighten 3 stops). p is highlights
+            preservation amount from 0.0 (no preservation, full clipping) to 1.0
+            (full preservation, S-like curve in highlights).</dd>
+          <dt><strong>-apentax4shot</strong></dt>
+          <dd>Will merge 4 frames from Pentax 4-shot RAWs</dd>
+          <dt><strong>-apentax4shotorder abce</strong></dt>
+          <dd>Order of frames in pentax 4-shot files (default is 3102)</dd>
+          <dt><strong>-mmap</strong></dt>
+          <dd>Use mmap + memory IO instead of file IO (unix only)</dd>
+          <dt><strong>-disars</strong></dt>
+          <dd>Disable RawSpeed library (if compiled with this library)</dd>
+          <dt><strong>-doutputflags N</strong></dt>
+          <dd>set imgdata.params.output_flags to N</dd>
+          <dt><strong>-disinterp</strong></dt>
+          <dd>Do not run interpolation step</dd>
+          <dt><strong>-dsrawrgb1</strong></dt>
+          <dd>Disable YCbCr to RGB conversion for sRAW (Cb/Cr interpolation
+            enabled)</dd>
+          <dt><strong>-dsrawrgb2</strong></dt>
+          <dd>Disable YCbCr to RGB conversion for sRAW (Cb/Cr interpolation
+            disabled)</dd>
+        </dl>
+      </li>
+      <li><strong>half_mt</strong> Emulation of <strong>dcraw -h</strong>. It
+        "understands" the following keys: -a (automatic white balance over the
+        entire image), -w (white balance of the camera), -T (output in the tiff
+        format), and -J n (number of parallel threads launched for image
+        processing).<br>
+        On multiprocessor/multicore computers, the speed gain is notable in the
+        case of mass processing. On a Win32 machine, the example is assembled
+        from the initial file half_mt_win32.c, since work with threads under
+        Windows is fundamentally different and it it easier to copy simple
+        source codes than write one complex code.</li>
+      <li><strong>mem_image</strong> This sample uses <a href="API-CXX.html#dcraw_make_mem_image">dcraw_make_mem_image</a>
+        and <a href="API-CXX.html#dcraw_make_mem_thumb">dcraw_make_mem_thumb</a>
+        calls, than writes data in PPM format. </li>
+      <li><strong>unprocessed_raw</strong> This sample extracts (mostly)
+        unaltered RAW data including masked pixels data (on supported cameras).
+        If black frame exists and black frame extraction is supported for given
+        format, masked pixels data is added to resulting .TIFF file. Command
+        line options: <strong>-q</strong> - be quiet, <strong>-A</strong> -
+        autoscale data (integer multiplier), <strong>-g</strong>
+        gamma-correction (gamma 2.2) for data (instead of precise linear one), <strong>-B</strong>
+        turns on black level subtraction</li>
+      <li><strong>4channnels</strong> - splits RAW-file into four separate
+        16-bit grayscale TIFFs (per RAW channel).<br>
+        Command line switches:
+        <ul>
+          <li><strong>-s N</strong> selects N-th image from RAW with multiple
+            images</li>
+          <li><strong>-g</strong> gamma correction (gamma 2.2)</li>
+          <li><strong>-A</strong> values autoscale by auto-calculated integer
+            factor</li>
+          <li><strong>-B</strong> turn off black subtraction</li>
+          <li><strong>-N</strong> no RAW curve</li>
+        </ul>
+      </li>
+      <li><strong>multirender_test</strong> - very simple example of multiple
+        rendering on one file without reopen.</li>
+      <li><strong>postprocessing_benchmark</strong> - will print timings of RAW
+        processing steps</li>
+    </ul>
+    <h2>Example of docmode</h2>
+    <p>Below we consider the samples/simple_dcraw.cpp example, which emulates
+      the behavior of <strong>dcraw [-e][-v][-t]</strong>. To save space, let
+      us assume that keys -t -v are always specified (to avoid comments on
+      command line parsing) and there is always one parameter (name of file),
+      which is the only one and always passed to the program.</p>
+    <pre>int main(int ac, char *av[])
+{
+ int i, ret, verbose=0, output_thumbs=0;
+ char outfn[1024],thumbfn[1024];
+ // Creation of image processing object
+ LibRaw RawProcessor;
+ // The date in TIFF is written in the local format; let us specify the timezone for compatibility with dcraw
+ putenv ((char*)"TZ=UTC");
+// Let us define variables for convenient access to fields of RawProcessor
+#define P1 RawProcessor.imgdata.idata
+#define S RawProcessor.imgdata.sizes
+#define C RawProcessor.imgdata.color
+#define T RawProcessor.imgdata.thumbnail
+#define P2 RawProcessor.imgdata.other
+#define OUT RawProcessor.imgdata.params
+ OUT.output_tiff = 1; // Let us output TIFF
+ // Let us open the file
+ if( (ret = RawProcessor.open_file(av[1])) != LIBRAW_SUCCESS)
+ {
+ fprintf(stderr,"Cannot open %s: %s\n",av[i],libraw_strerror(ret));
+ // recycle() is needed only if we want to free the resources right now.
+ // If we process files in a cycle, the next open_file()
+ // will also call recycle(). If a fatal error has happened, it means that recycle()
+ // has already been called (repeated call will not cause any harm either).
+ RawProcessor.recycle();
+ goto end;
+ }
+ // Let us unpack the image
+ if( (ret = RawProcessor.unpack() ) != LIBRAW_SUCCESS)
+ {
+ fprintf(stderr,"Cannot unpack_thumb %s: %s\n",av[i],libraw_strerror(ret));
+ if(LIBRAW_FATAL_ERROR(ret))
+ goto end;
+ // if there has been a non-fatal error, we will try to continue
+ }
+ // Let us unpack the thumbnail
+ if( (ret = RawProcessor.unpack_thumb() ) != LIBRAW_SUCCESS)
+ {
+ // error processing is completely similar to the previous case
+ fprintf(stderr,"Cannot unpack_thumb %s: %s\n",av[i],libraw_strerror(ret));
+ if(LIBRAW_FATAL_ERROR(ret))
+ goto end;
+ }
+ else // We have successfully unpacked the thumbnail, now let us write it to a file
+ {
+ snprintf(thumbfn,sizeof(thumbfn),"%s.%s",av[i],T.tformat == LIBRAW_THUMBNAIL_JPEG ? "thumb.jpg" : "thumb.ppm");
+ if( LIBRAW_SUCCESS != (ret = RawProcessor.dcraw_thumb_writer(thumbfn)))
+ {
+ fprintf(stderr,"Cannot write %s: %s\n",thumbfn,libraw_strerror(ret));
+ // in the case of fatal error, we should terminate processing of the current file
+ if(LIBRAW_FATAL_ERROR(ret))
+ goto end;
+ }
+ }
+ // Data unpacking
+ ret = RawProcessor.dcraw_process();
+ if(LIBRAW_SUCCESS != ret ) // error at the previous step
+ {
+ fprintf(stderr,"Cannot do postprocessing on %s: %s\n",av[i],libraw_strerror(ret));
+ if(LIBRAW_FATAL_ERROR(ret))
+ goto end;
+ }
+ else // Successful document processing
+ {
+ snprintf(outfn,sizeof(outfn),"%s.%s", av[i], "tiff");
+ if( LIBRAW_SUCCESS != (ret = RawProcessor.dcraw_ppm_tiff_writer(outfn)))
+ fprintf(stderr,"Cannot write %s: error %d\n",outfn,ret);
+ }
+ // we don't evoke recycle() or call the destructor; C++ will do everything for us
+ return 0;
+end:
+ // got here after an error
+ return 1;
+}
+</pre>
+    <p><a href="index.html">[back to Index]</a></p>
+  </body>
+</html>

package/deps/LibRaw-Win64/LibRaw-0.21.4/doc/Why-LibRaw.html ADDED Viewed

@@ -0,0 +1,65 @@
+<html>
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=windows-1252">
+  </head>
+  <body>
+    <p>Purpose and Objectives<a href="index.html">[back to Index]</a></p>
+    <h1>LibRaw Project Goals and Objectives</h1>
+    <h2>Who May Be Interested in This Project</h2>
+    <p>The proposed project and the software products generated within this project are intended for:</p>
+    <ul>
+      <li>Developers of RAW converters, including current and new developments</li>
+      <li>Developers of applications that need access to decoded RAW data (for pre-processing, stitching, stacking, color profiling, etc.)</li>
+      <li>Those willing to write their own graphic interface for RAW file processing</li>
+      <li>Developers and enthusiasts creating their own primary and auxiliary data processing algorithms, including
+        <ul>
+          <li>Interpolation (demosaic),</li>
+          <li>Noise reduction</li>
+          <li>White balance</li>
+          <li>Correction of aberrations and distortions</li>
+          <li>RAW data analysis</li>
+          <li>Comparison of cameras and lenses</li>
+          <li>and so on...</li>
+        </ul>
+      </li>
+    </ul>
+    <h2>Some History</h2>
+    <p>The LibRaw project started in 2008. At that time <a href="https://www.cybercom.net/%7Edcoffin/dcraw/">dcraw</a> was very popular as a method of accessing RAW data. It was hard to find a more or less popular camera that was not supported by this utility; while the implementation of RAW data extraction in <strong>dcraw</strong> was of a very high quality.</p>
+    <p>However, developers and enthusiasts were experiencing a number of difficulties when using <strong>dcraw</strong>. First, the author of <strong>dcraw</strong> refused to turn his product into a handy library. Besides, <strong>dcraw</strong> contains a number of questionable features that may hinder its use without modifications, as well as instances of distortions in the photographic sense of it. As a result, once every several months, with each new release of <strong>dcraw</strong>, virtually all developers, part of them listed on the <a
+        href="https://www.cybercom.net/%7Edcoffin/dcraw/">dcraw Web site</a>, were to check the differences, figure out the patches, and apply those patches to their dcraw-based code and libraries.</p>
+    <p>As for enthusiasts, the "entry cost" of verifying their own ideas and implementing their own algorithms in such an environment is often unreasonably high: they have to either use the dcraw command line, thus being forced to use the unavoidable early processing stages, or understand the source code and maintain their own library based on it.</p>
+    <p>Thus, the inconveniences of <strong>dcraw</strong> make the developers' community quite small and halt further evolution and improvement of RAW format converters.</p>
+    <p>Our project started with the idea to <em>get a library based on dcraw, only better</em>. Today we are well past that initial goal, not in the least because <strong>dcraw</strong> is not actively supported since 2015, and the latest release was published nearly 2 years ago, in May 2016. Since then several distinctly different RAW formats (introduced by Fujifilm, Nikon, Pentax, Samsung, Sigma, Sony) emerged, none of which is supported by <strong>dcraw</strong>. Additionally, we see it necessary to extract more metadata to help better interpretation of RAW data and to add flexibility to the RAW conversion process.</p>
+    <h2>Goals and Objectives</h2>
+    <p>We are maintaining LibRaw as a library providing access to decoded raw data and metadata useful for correct interpretation of the said data. Thus:</p>
+    <ol>
+      <li>To keep on adding RAW decoding for new and previously unsupported cameras</li>
+      <li>To continue the development of a stable and consistent API suitable for other applications (RAW converters, data analyzers, panorama stitchers, etc.)</li>
+      <li>To have RAW processing as separate independent parts (groups of API calls)
+        <ul>
+          <li>Reading, decoding, and unpacking of RAW data: <em><strong>this is the main functionality of LibRaw</strong></em></li>
+          <li>Data conversions: interpolation, white balance, etc.: <em><strong>this part of LibRaw is frozen: we ported dcraw functionality, but expect that library users will create own postprocessing code.</strong></em></li>
+          <li>File output of the processing results. <em><strong>This part is very primitive, only tiff and ppm output is supported.</strong></em></li>
+        </ul>
+      </li>
+    </ol>
+    <p style="margin-left:.5in;">The latter two groups of functions are maintained to provide some postprocessing/saving ability from scratch, without writing own code. We do not have any plans to extend/improve this code.</p>
+    <ol>
+      <li value="4">To improve the procedures of RAW data retrieval and decoding.</li>
+      <li>To supply other developers with a "framework" (freeware and open-source), e.g., for experimenting with their own methods of RAW data processing (interpolation, noise reduction, white balance, etc.; some directions of the possible efforts are <a>listed above</a>), so that they could create their own GUI programs and interfaces without developing the entire RAW converter.</li>
+    </ol>
+    <h2>LibRaw Release Schedule</h2>
+    <ol>
+      <li><strong>Production releases</strong> will be published at intervals of 1-1.5 years. Production releases will be maintained through bugfixes. New cameras will not be added to production releases, but only to snapshots and non-stable/beta releases.<em> Patch </em>(bugfix) releases of production releases should provide API/ABI consistency (so, version 0.21.5 should be binary compatible with 0.21.0).</li>
+      <li><strong>Snapshots</strong> are planned to be released every 2-3 quarters. Snapshots will include support for new cameras, stable and tested in our own applications. API calls and internal routines may be changed. No binary compatibility maintained, to upgrade to newer snapshot one need to recompile application that uses it.</li>
+      <li><strong>Non-stable/beta releases</strong> with new features, like initial support for some new RAW format that needs extensive testing by the community.&nbsp; No exact schedule, to be published as needed.</li>
+    </ol>
+    <h2>How You Can Help/Participate</h2>
+    <p><strong>We welcome any help</strong>, however:</p>
+    <ol>
+      <li>If you are submitting any core functionality extensions/improvements, that is, something that has to do with the decoding of RAW and/or metadata, that would be highly valuable and we will maintain your submission on our own, if necessary; you don�t need to be committed.</li>
+      <li>If your contribution adds to post-processing, please be committed to supporting and maintaining such a contribution. Our previous experience with such contributions has been less than positive, exactly because of the lack of maintenance on the part of the contributors. We are unable to maintain such contributions on our own, because our primary goal is to maintain RAW and metadata decoding.</li>
+    </ol>
+    <p><a href="index.html">[back to Index]</a></p>
+  </body>
+</html>

package/deps/LibRaw-Win64/LibRaw-0.21.4/doc/index.html ADDED Viewed

@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=windows-1252">
+    <title>LibRaw: better dcraw (library)</title>
+  </head>
+  <body>
+    <h1>LibRaw: RAW image decoding/processing library</h1>
+    <p>LibRaw is a library for reading RAW files from digital photo cameras (CRW/CR2, NEF, RAF, DNG, MOS, KDC, DCR, etc.; virtually all RAW formats are supported). It pays special attention to correct retrieval of data required for subsequent RAW conversion.</p>
+    <p>The library is intended for embedding in RAW converters, data analyzers, and other programs using RAW files as the initial data.</p>
+    <p> Contents </p>
+    <ol>
+      <li><a href="#copyright">Copyright</a></li>
+      <li><a href="Why-LibRaw.html">Purpose and Objectives</a></li>
+      <li><a href="API-overview.html">Overview of LibRaw API (C++)</a></li>
+      <li><a href="Install-LibRaw.html">Compilation and Installation</a></li>
+      <li><a href="API-datastruct.html">Data Structures, Error Codes, and Constants</a> </li>
+      <li><a href="API-CXX.html">C++ API</a> </li>
+      <li><a href="API-C.html">C API</a></li>
+      <li><a href="API-notes.html">Notes on API (error code conventions, memory usage)</a></li>
+      <li><a href="Samples-LibRaw.html">Examples</a> </li>
+    </ol>
+    <a name="copyright"></a>
+    <h2>Copyright</h2>
+    <p> LibRaw library, Copyright (C) 2008-2021 LibRaw LLC (info@libraw.org)<br>
+      The library includes source code from<br>
+      <i>dcraw.c, Dave Coffin's raw photo decoder<br>
+        Copyright 1997-2016 by Dave Coffin, dcoffin a cybercom o net<br>
+      </i> </p>
+    <p> LibRaw is distributed for free under two different licenses: </p>
+    <ul>
+      <li><a href="http://www.gnu.org/licenses/lgpl-2.1.html">GNU Lesser General Public License, version 2.1</a></li>
+      <li><a href="http://www.opensource.org/licenses/cddl1.txt">COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0</a></li>
+    </ul>
+    You may use one of these licensing modes and switch between them.
+    <p></p>
+  </body>
+</html>