Lines Matching +full:set +full:- +full:image
8 * http://www.apache.org/licenses/LICENSE-2.0
61 * -------------- -------------- -------------
96 /*!\brief List of supported image formats */
98 UHDR_IMG_FMT_UNSPECIFIED = -1, /**< Unspecified */
99 UHDR_IMG_FMT_24bppYCbCrP010 = 0, /**< 10-bit-per component 4:2:0 YCbCr semiplanar format.
101 little-endian configuration with 10 MSB of actual data.*/
102 UHDR_IMG_FMT_12bppYCbCr420 = 1, /**< 8-bit-per component 4:2:0 YCbCr planar format */
103 UHDR_IMG_FMT_8bppYCbCr400 = 2, /**< 8-bit-per component Monochrome format */
105 3, /**< 32 bits per pixel RGBA color format, with 8-bit red, green, blue
106 and alpha components. Using 32-bit little-endian representation,
109 4, /**< 64 bits per pixel, 16 bits per channel, half-precision floating point RGBA color
113 UHDR_IMG_FMT_32bppRGBA1010102 = 5, /**< 32 bits per pixel RGBA color format, with 10-bit red,
114 green, blue, and 2-bit alpha components. Using 32-bit
115 little-endian representation, colors stored as Red 9:0, Green
117 UHDR_IMG_FMT_24bppYCbCr444 = 6, /**< 8-bit-per component 4:4:4 YCbCr planar format */
118 UHDR_IMG_FMT_16bppYCbCr422 = 7, /**< 8-bit-per component 4:2:2 YCbCr planar format */
119 UHDR_IMG_FMT_16bppYCbCr440 = 8, /**< 8-bit-per component 4:4:0 YCbCr planar format */
120 UHDR_IMG_FMT_12bppYCbCr411 = 9, /**< 8-bit-per component 4:1:1 YCbCr planar format */
121 UHDR_IMG_FMT_10bppYCbCr410 = 10, /**< 8-bit-per component 4:1:0 YCbCr planar format */
122 UHDR_IMG_FMT_24bppRGB888 = 11, /**< 8-bit-per component RGB interleaved format */
123 UHDR_IMG_FMT_30bppYCbCr444 = 12, /**< 10-bit-per component 4:4:4 YCbCr planar format */
128 UHDR_CG_UNSPECIFIED = -1, /**< Unspecified */
136 UHDR_CT_UNSPECIFIED = -1, /**< Unspecified */
145 UHDR_CR_UNSPECIFIED = -1, /**< Unspecified */
146 UHDR_CR_LIMITED_RANGE = 0, /**< Y {[16..235], UV [16..240]} * pow(2, (bpc - 8)) */
147 UHDR_CR_FULL_RANGE = 1, /**< YUV/RGB {[0..255]} * pow(2, (bpc - 8)) */
157 /*!\brief Image identifiers in gain map technology */
159 UHDR_HDR_IMG, /**< Hdr rendition image */
160 UHDR_SDR_IMG, /**< Sdr rendition image */
161 UHDR_BASE_IMG, /**< Base rendition image */
162 UHDR_GAIN_MAP_IMG, /**< Gain map image */
183 /*!\brief An application-supplied parameter is not valid. */
189 /*!\brief An application-invoked operation is not valid */
202 UHDR_MIRROR_VERTICAL, /**< flip image over x axis */
203 UHDR_MIRROR_HORIZONTAL, /**< flip image over y axis */
213 int has_detail; /**< has detailed error logs. 0 - no, else - yes */
217 /**\brief Raw Image Descriptor */
220 uhdr_img_fmt_t fmt; /**< Image Format */
225 /* Image storage dimensions */
226 unsigned int w; /**< Stored image width */
227 unsigned int h; /**< Stored image height */
229 /* Image data pointers. */
239 /**\brief Compressed Image Descriptor */
258 float max_content_boost[3]; /**< Value to control how much brighter an image can get, when shown
260 a given image. Value MUST be in linear scale. */
261 float min_content_boost[3]; /**< Value to control how much darker an image can get, when shown on
263 given image. Value MUST be in linear scale. */
264 float gamma[3]; /**< Encoding Gamma of the gainmap image. */
273 int use_base_cg; /**< Is gainmap application space same as base image color space */
303 /*!\brief Add raw image descriptor to encoder context. The function goes through all the fields of
304 * the image descriptor and checks for their sanity. If no anomalies are seen then the image is
309 * \param[in] img image descriptor.
319 /*!\brief Add compressed image descriptor to encoder context. The function goes through all the
320 * fields of the image descriptor and checks for their sanity. If no anomalies are seen then the
321 * image is added to internal list. Repeated calls to this function will replace the old entry with
325 * for the same intent, it is assumed that raw image descriptor and compressed image descriptor are
326 * relatable via compress <-> decompress process.
328 * The compressed image descriptors has fields cg, ct and range. Certain media formats are capable
332 * of the image, #UHDR_CG_UNSPECIFIED, #UHDR_CT_UNSPECIFIED, #UHDR_CR_UNSPECIFIED can be used. If
337 * \param[in] img image descriptor.
340 * UHDR_BASE_IMG for base image intent
349 /*!\brief Add gain map image descriptor and gainmap metadata info that was used to generate the
350 * aforth gainmap image to encoder context. The function internally goes through all the fields of
351 * the image descriptor and checks for their sanity. If no anomalies are seen then the image is
358 * immutable and used as-is in encoding scenario where gainmap computations are intended to be
359 * by-passed.
362 * \param[in] img gain map image desciptor.
372 /*!\brief Set quality factor for compressing base image and/or gainmap image. Default configured
373 * quality factor of base image and gainmap image are 95 and 95 respectively.
376 * \param[in] quality quality factor. Any integer in range [0 - 100].
377 * \param[in] intent #UHDR_BASE_IMG for base image and #UHDR_GAIN_MAP_IMG for gain map image.
385 /*!\brief Set Exif data that needs to be inserted in the output compressed stream. This function
398 /*!\brief Enable/Disable multi-channel gainmap. By default multi-channel gainmap is enabled.
402 * 0 - single-channel gainmap is enabled,
403 * otherwise - multi-channel gainmap is enabled.
411 /*!\brief Set gain map scaling factor. The encoding process allows signalling a downscaled gainmap
412 * image instead of full resolution. This setting controls the factor by which the renditions are
414 * primary_image_width / 2 and gainmap image height = primary_image_height / 2.
416 * NOTE: This has no effect on base image rendition. Base image is signalled in full resolution
428 /*!\brief Set encoding gamma of gainmap image. For multi-channel gainmap image, set gamma is used
432 * \param[in] gamma gamma of gainmap image. Any positive real number.
439 /*!\brief Set min max content boost. This configuration is treated as a recommendation by the
440 * library. It is entirely possible for the library to use a different set of values. Value MUST be
453 /*!\brief Set target display peak brightness in nits. This is used for configuring #hdr_capacity_max
469 /*!\brief Set encoding preset. Tunes the encoder configurations for performance or quality. Default
473 * \param[in] preset encoding preset. #UHDR_USAGE_REALTIME - Tune settings for best performance
474 * #UHDR_USAGE_BEST_QUALITY - Tune settings for best quality
482 /*!\brief Set output image compression format. Selects the compression format for encoding base
483 * image and gainmap image. Default configuration is #UHDR_CODEC_JPG
486 * \param[in] media_type output image compression format. Supported values are #UHDR_CODEC_JPG
500 * - The program creates an instance of an encoder using,
501 * - uhdr_create_encoder().
502 * - The program registers input images to the encoder using,
503 * - uhdr_enc_set_raw_image(ctxt, img, UHDR_HDR_IMG)
504 * - uhdr_enc_set_raw_image(ctxt, img, UHDR_SDR_IMG)
505 * - The program overrides the default settings using uhdr_enc_set_*() functions
506 * - If the application wants to control the compression level
507 * - uhdr_enc_set_quality()
508 * - If the application wants to insert exif data
509 * - uhdr_enc_set_exif_data()
510 * - If the application wants to set gainmap scale factor
511 * - uhdr_enc_set_gainmap_scale_factor()
512 * - If the application wants to enable multi channel gain map
513 * - uhdr_enc_set_using_multi_channel_gainmap()
514 * - If the application wants to set gainmap image gamma
515 * - uhdr_enc_set_gainmap_gamma()
516 * - If the application wants to recommend min max content boost
517 * - uhdr_enc_set_min_max_content_boost()
518 * - If the application wants to set target display peak brightness
519 * - uhdr_enc_set_target_display_peak_brightness()
520 * - If the application wants to set encoding preset
521 * - uhdr_enc_set_preset()
522 * - If the application wants to control target compression format
523 * - uhdr_enc_set_output_format()
524 * - The program calls uhdr_encode() to encode data. This call would initiate the process of
525 * computing gain map from hdr intent and sdr intent. The sdr intent and gain map image are
526 * compressed at the set quality using the codec of choice.
527 * - On success, the program can access the encoded output with uhdr_get_encoded_stream().
528 * - The program finishes the encoding with uhdr_release_encoder().
531 * - uhdr_enc_set_compressed_image(ctxt, img, UHDR_HDR_IMG)
532 * - uhdr_enc_set_compressed_image(ctxt, img, UHDR_SDR_IMG)
533 * In this mode, the compressed image(s) are first decoded to raw image(s). These raw image(s) go
536 * - uhdr_create_encoder()
537 * - uhdr_enc_set_compressed_image(ctxt, img, UHDR_HDR_IMG)
538 * - uhdr_enc_set_compressed_image(ctxt, img, UHDR_SDR_IMG)
539 * - uhdr_encode()
540 * - uhdr_get_encoded_stream()
541 * - uhdr_release_encoder()
542 * If the set compressed image media type of intent UHDR_SDR_IMG and output media type are
543 * identical, then this image is directly used for primary image. No re-encode of raw image is done.
544 * This implies base image quality setting is un-used. Only gain map image is encoded at the set
545 * quality using codec of choice. On the other hand, if the set compressed image media type and
548 * The library also allows directly setting base and gain map image in compressed format,
549 * - uhdr_enc_set_compressed_image(ctxt, img, UHDR_BASE_IMG)
550 * - uhdr_enc_set_gainmap_image(ctxt, img, metadata)
551 * In this mode, gain map computation is by-passed. The input images are transcoded (if necessary),
554 * It is possible to create a uhdr image solely from Hdr intent. In this case, the usage shall look
556 * - uhdr_create_encoder()
557 * - uhdr_enc_set_raw_image(ctxt, img, UHDR_HDR_IMG)
558 * - uhdr_enc_set_quality() // optional
559 * - uhdr_enc_set_exif_data() // optional
560 * - uhdr_enc_set_output_format() // optional
561 * - uhdr_enc_set_gainmap_scale_factor() // optional
562 * - uhdr_enc_set_using_multi_channel_gainmap() // optional
563 * - uhdr_enc_set_gainmap_gamma() // optional
564 * - uhdr_enc_set_min_max_content_boost() // optional
565 * - uhdr_enc_set_target_display_peak_brightness() // optional
566 * - uhdr_encode()
567 * - uhdr_get_encoded_stream()
568 * - uhdr_release_encoder()
569 * In this mode, the Sdr rendition is created from Hdr intent by tone-mapping. The tone-mapped sdr
570 * image and hdr image go through the aforth mentioned gain map computation and encoding process to
571 * create uhdr image.
585 * \return nullptr if encode process call is unsuccessful, uhdr image descriptor otherwise
590 * Clears all previous settings and resets to default state and ready for re-initialization and
603 /*!\brief check if it is a valid ultrahdr image.
608 * @returns 1 if the input data has a primary image, gain map image and gain map metadata. 0 if any
609 * errors are encountered during parsing process or if the image does not have primary
610 * image or gainmap image or gainmap metadata
630 /*!\brief Add compressed image descriptor to decoder context. The function goes through all the
631 * fields of the image descriptor and checks for their sanity. If no anomalies are seen then the
632 * image is added to internal list. Repeated calls to this function will replace the old entry with
636 * \param[in] img image descriptor.
644 /*!\brief Set output image color format
647 * \param[in] fmt output image color format. Supported values are
657 /*!\brief Set output image color transfer characteristics. It should be noted that not all
672 /*!\brief Set output display's HDR capacity. Value MUST be in linear scale. This value determines
674 * applied to gainmap image.
686 * image information available to the client via uhdr_dec_get_() functions. It does not decompress
687 * the image. That is done by uhdr_decode().
695 /*!\brief Get base image width
699 * \return -1 if probe call is unsuccessful, base image width otherwise
703 /*!\brief Get base image height
707 * \return -1 if probe call is unsuccessful, base image height otherwise
711 /*!\brief Get gainmap image width
715 * \return -1 if probe call is unsuccessful, gain map image width otherwise
719 /*!\brief Get gainmap image height
723 * \return -1 if probe call is unsuccessful, gain map image height otherwise
743 /*!\brief Get base image (compressed)
747 * \return nullptr if probe process call is unsuccessful, memory block with base image data
752 /*!\brief Get gain map image (compressed)
756 * \return nullptr if probe process call is unsuccessful, memory block with gainmap image data
775 * - The program creates an instance of a decoder using,
776 * - uhdr_create_decoder().
777 * - The program registers input images to the decoder using,
778 * - uhdr_dec_set_image(ctxt, img)
779 * - The program overrides the default settings using uhdr_dec_set_*() functions.
780 * - If the application wants to control the output image format,
781 * - uhdr_dec_set_out_img_format()
782 * - If the application wants to control the output transfer characteristics,
783 * - uhdr_dec_set_out_color_transfer()
784 * - If the application wants to control the output display boost,
785 * - uhdr_dec_set_out_max_display_boost()
786 * - If the application wants to enable/disable gpu acceleration,
787 * - uhdr_enable_gpu_acceleration()
788 * - The program calls uhdr_decode() to decode uhdr stream. This call would initiate the process
789 * of decoding base image and gain map image. These two are combined to give the final rendition
790 * image.
791 * - The program can access the decoded output with uhdr_get_decoded_image().
792 * - The program finishes the decoding with uhdr_release_decoder().
800 /*!\brief Get final rendition image
804 * \return nullptr if decoded process call is unsuccessful, raw image descriptor otherwise
808 /*!\brief Get gain map image
812 * \return nullptr if decoded process call is unsuccessful, raw image descriptor otherwise
817 * Clears all previous settings and resets to default state and ready for re-initialization and
842 /*!\brief Add image editing operations (pre-encode or post-decode).
843 * Below functions list the set of edits supported. Program can set any combination of these during
863 * \param[in] degrees clockwise degrees. 90 - rotate clockwise by 90 degrees
864 * 180 - rotate clockwise by 180 degrees
865 * 270 - rotate clockwise by 270 degrees