sergiotarxz/libvips
sergiotarxz/libvips
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

docs for heifload autorotate

Browse Source
This commit is contained in:
John Cupitt 2019-03-07 08:12:14 +00:00
parent 533ddbc8b3
commit 3d889d9395
2 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
libvips/foreign/heifload.c
View File

@ -589,8 +589,8 @@ vips_foreign_load_heif_generate( VipsRegion *or,
* FIXME What will this do for RGBA? Or is alpha always * FIXME What will this do for RGBA? Or is alpha always
* separate? * separate?
* *
* Only disable transforms if we have something to fetch the * Only disable transforms if we have been able to fetch the
* untransformed size. * untransformed dimensions.
*/ */
options = heif_decoding_options_alloc(); options = heif_decoding_options_alloc();
#ifdef HAVE_HEIF_IMAGE_HANDLE_GET_ISPE_WIDTH #ifdef HAVE_HEIF_IMAGE_HANDLE_GET_ISPE_WIDTH
@ -932,6 +932,7 @@ vips_foreign_load_heif_buffer_init( VipsForeignLoadHeifBuffer *buffer )
* * @page: %gint, page (top-level image number) to read * * @page: %gint, page (top-level image number) to read
* * @n: %gint, load this many pages * * @n: %gint, load this many pages
* * @thumbnail: %gboolean, fetch thumbnail instead of image * * @thumbnail: %gboolean, fetch thumbnail instead of image
* * @autorotate: %gboolean, rotate image upright during load
* *
* Read a HEIF image file into a VIPS image. * Read a HEIF image file into a VIPS image.
* *
@ -948,6 +949,17 @@ vips_foreign_load_heif_buffer_init( VipsForeignLoadHeifBuffer *buffer )
* If @thumbnail is %TRUE, then fetch a stored thumbnail rather than the * If @thumbnail is %TRUE, then fetch a stored thumbnail rather than the
* image. * image.
* *
* Setting @autorotate to %TRUE will make the loader interpret the
* orientation tag and automatically rotate the image appropriately during
* load.
*
* If @autorotate is %FALSE, the metadata field #VIPS_META_ORIENTATION is set
* to the value of the orientation tag. Applications may read and interpret
* this field
* as they wish later in processing. See vips_autorot(). Save
* operations will use #VIPS_META_ORIENTATION, if present, to set the
* orientation of output images.
*
* See also: vips_image_new_from_file(). * See also: vips_image_new_from_file().
* *
* Returns: 0 on success, -1 on error. * Returns: 0 on success, -1 on error.
@ -977,6 +989,7 @@ vips_heifload( const char *filename, VipsImage **out, ... )
* * @page: %gint, page (top-level image number) to read * * @page: %gint, page (top-level image number) to read
* * @n: %gint, load this many pages * * @n: %gint, load this many pages
* * @thumbnail: %gboolean, fetch thumbnail instead of image * * @thumbnail: %gboolean, fetch thumbnail instead of image
* * @autorotate: %gboolean, rotate image upright during load
* *
* Read a HEIF image file into a VIPS image. * Read a HEIF image file into a VIPS image.
* Exactly as vips_heifload(), but read from a memory buffer. * Exactly as vips_heifload(), but read from a memory buffer.

3
libvips/foreign/jpegload.c
View File

@ -327,8 +327,7 @@ vips_foreign_load_jpeg_buffer_init( VipsForeignLoadJpegBuffer *buffer )
* *
* * @shrink: %gint, shrink by this much on load * * @shrink: %gint, shrink by this much on load
* * @fail: %gboolean, fail on errors * * @fail: %gboolean, fail on errors
* * @autorotate: %gboolean, use exif Orientation tag to rotate the image * * @autorotate: %gboolean, rotate image upright during load
* during load
* *
* Read a JPEG file into a VIPS image. It can read most 8-bit JPEG images, * Read a JPEG file into a VIPS image. It can read most 8-bit JPEG images,
* including CMYK and YCbCr. * including CMYK and YCbCr.