Merge commit '4c61b7d3c3eb8d474ab54a2221eeb1a059dcd67d' into libraw-copylib

Upgrade LibRaw to snapshot 202403.
This commit is contained in:
Lawrence Lee
2024-04-13 22:47:37 -07:00
133 changed files with 4307 additions and 1939 deletions

View File

@@ -127,7 +127,8 @@
when raw2image() or dcraw_process() is called.</dd>
<dt><strong> libraw_output_params_t params; </strong></dt>
<dd>Data structure intended for management of image postprocessing (using
the dcraw emulator). Fields of this structure are described in detail <a
the dcraw emulator). Fields of this structure are described in detail <a
href="#libraw_iparams_t"> below </a> .</dd>
<dt>libraw_callbacks_t callbacks;</dt>
<dd><a href="#libraw_callbacks_t">user-settable callbacks</a> </dd>
@@ -427,12 +428,12 @@
</dl>
</dd>
</dl>
</dl>
<p>
Note: even if no thumbnails were found in TIFF/CR3 structure, the
thumbcount field will be initialized to 1 and thumblist[0] will be
initialized to thumbnail data from the thumbnail data, so
LibRaw::unpack_thumb_ex(0) will do the same as LibRaw::unpack_thumb().
<p>
Note: even if no thumbnails were found in TIFF/CR3 structure, the
thumbcount field will be initialized to 1 and thumblist[0] will be
initialized to thumbnail data from the thumbnail data, so
LibRaw::unpack_thumb_ex(0) will do the same as LibRaw::unpack_thumb().
</p>
<p><a name="libraw_lensinfo_t"></a></p>
<h3>Structure libraw_lensinfo_t: parsed lens data</h3>
<p>The following parameters are extracted from Makernotes and EXIF, to help
@@ -794,15 +795,19 @@
interpolation callback call.</dd>
<dt><strong> int no_interpolation; </strong></dt>
<dd>Disables call to demosaic code in LibRaw::dcraw_process()</dd>
<dt><strong> int use_p1_correction;</strong></dt>
<dd>If set to non-zero (default): PhaseOne compressed files will be corrected (linearization; defect mapping)
based on metadata contained in file.</dd>
</dl>
<p><a name="libraw_callbacks_t"></a></p>
<h3>Structure libraw_callbacks_t: user-settable callbacks</h3>
<dl>
<dt>data_callback data_cb</dt>
<dt>data_callback data_cb</dt>
<dd>Called on data error, settable via set_dataerror_handler. See <a href="API-CXX.html#callbacks">C++
API</a> for details.</dd>
<dt>progress_callback progress_cb</dt>
<dt>progress_callback progress_cb</dt>
<dd>Called on process callback, settable via set_progress_handler. See <a
href="API-CXX.html#callbacks">C++ API</a> for details.</dd>
<dt>exif_parser_callback exif_cb, params: (void *context, int tag, int
type, int len, unsigned int ord, void *ifp)</dt>
@@ -978,7 +983,8 @@
<dt><strong> LIBRAW_BAD_CROP </strong></dt>
<dd>The incorrect cropping coordinates are set via params.cropbox[]: the
left-top corner of cropping rectangle is outside the image. The
<dd>The incorrect cropping coordinates are set via params.cropbox[]: the
processing will be cancelled, all allocated resources will be freed, <a
<dt=""><strong> LIBRAW_TOO_BIG</strong> </a></dd>
<dd><a <dt="">Raw data size exceeds data limit.</a></dd>
<a <dt=""> </a>
@@ -1000,10 +1006,12 @@
file (only for formats supporting storage of several images in a
file).</dd>
<dt><strong> LIBRAW_OUT_OF_ORDER_CALL </strong></dt>
file (only for formats supporting storage of several images in a
</a><dd><a <dt="">API functions have been called in wrong order (e.g., </a><a
href="API-CXX.html#unpack"> unpack() </a> before <a href="API-CXX.html#open_file">
open_file() </a> ) or the previous stage has ended with an error
</a><dd><a <dt="">API functions have been called in wrong order (e.g., </a><a
(e.g., <a href="API-CXX.html#unpack"> unpack() </a> is called after <a
href="API-CXX.html#open_file"> open_file() </a> has returned an
error).</dd>
<dt><strong> LIBRAW_NO_THUMBNAIL </strong></dt>
@@ -1145,7 +1153,7 @@
triplet.</dd>
<dt><strong>LIBRAW_THUMBNAIL_BITMAP16</strong></dt>
<dd>The thumbnail buffer contains the gamma-adjusted 16-bit RGB bitmap. To
settings). <br>
get this format instead of <strong> LIBRAW_THUMBNAIL_BITMAP </strong>you
need to set <strong>LIBRAW_PROCESSING_USE_PPM16_THUMBS</strong> in
processing options.</dd>
<dt><strong> LIBRAW_THUMBNAIL_LAYER </strong></dt>
@@ -1157,7 +1165,10 @@
<dt><strong>LIBRAW_THUMBNAIL_H265</strong></dt>
<dd>The thumbnail buffer contains a H.265 data frame (read from RAW file
as is, no manipulations performed on it).</dd>
<dd>Data format is presently recognized upon opening of RAW file but not
<dt><strong>LIBRAW_THUMBNAIL_JPEGXL</strong></dt>
<dd>The thumbnail buffer contains a JPEG-XL data frame (read from RAW file
as is, no manipulations performed on it).</dd>
</dl>
<p><a name="warnings"></a></p>
<h3>Nonstandard Situations (Warnings) during RAW Data Processing</h3>
<p>Some suspicious situations emerging during image processing are not fatal
@@ -1210,6 +1221,10 @@
<dd>DNG Stage2 conversion was performed</dd>
<dt><strong> LIBRAW_DNG_STAGE3_APPLIED</strong></dt>
<dd>DNG Stage3 conversion was performed</dd>
<dt><strong>LIBRAW_WARN_VENDOR_CROP_SUGGESTED</strong></dt>
<dd> If set: unknown/untested RAW image frame size passed to LibRaw, cropping may be incorrect.
<p></p>It is suggested to use LibRaw::adjust_to_raw_inset_crop(1) for vendor specified crop.
</dd>
</dl>
<dl>
</dl>
@@ -1301,9 +1316,14 @@
plus data size is beyond filecontents. This flag enforces size+offset
checks for files from known vendors (this will result into correct but
smaller thumbnail selected).</li>
<li><strong>LIBRAW_RAWOPTIONS_CHECK_THUMBNAILS_KNOWN_VENDORS</strong> -
<li><strong>LIBRAW_RAWOPTIONS_CHECK_THUMBNAILS_ALL_VENDORS</strong> - same
is above, but check is performed regardless of vendor (Make tag).</li>
plus data size is beyond filecontents. This flag enforces size+offset
<li><strong>LIBRAW_RAWOPTIONS_ALLOW_JPEGXL_PREVIEWS</strong> -
if set, LibRaw will perceive such previews in the same way as JPEG onesgest preview is
selected by default, etc).<p>
tformat field for such preview is set to LIBRAW_THUMBNAIL_JPEGXL. Image metadata (width/height/channels count) is not parsed for JPEG-XL previews
</p></li>
</ul>
<ul>
</ul>
<p> <a name="LibRaw_rawspecial_t"></a></p>