Quelle  compressed_icc.h   Sprache: C

/* Copyright (c) the JPEG XL Project Authors. All rights reserved.
 *
 * Use of this source code is governed by a BSD-style
 * license that can be found in the LICENSE file.
 */

/** @addtogroup libjxl_metadata
 * @{
 * @file compressed_icc.h
 * @brief Utility functions to compress and decompress ICC streams.
 */

#ifndef JXL_COMPRESSED_ICC_H_
#define JXL_COMPRESSED_ICC_H_

#include <jxl/jxl_export.h>
#include <jxl/memory_manager.h>
#include <jxl/types.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * Allocates a buffer using the memory manager, fills it with a compressed
 * representation of an ICC profile, returns the result through @c output_buffer
 * and indicates its size through @c output_size.
 *
 * The result must be freed using the memory manager once it is not of any more
 * use.
 *
 * @param[in] memory_manager Pointer to a JxlMemoryManager.
 * @param[in] icc Pointer to a buffer containing the uncompressed ICC profile.
 * @param[in] icc_size Size of the buffer containing the ICC profile.
 * @param[out] compressed_icc Will be set to a pointer to the buffer containing
 * the result.
 * @param[out] compressed_icc_size Will be set to the size of the buffer
 * containing the result.
 * @return Whether compressing the profile was successful.
 */
JXL_EXPORT JXL_BOOL JxlICCProfileEncode(const JxlMemoryManager* memory_manager,
                                        const uint8_t* icc, size_t icc_size,
                                        uint8_t** compressed_icc,
                                        size_t* compressed_icc_size);

/**
 * Allocates a buffer using the memory manager, fills it with the decompressed
 * version of the ICC profile in @c compressed_icc, returns the result through
 * @c output_buffer and indicates its size through @c output_size.
 *
 * The result must be freed using the memory manager once it is not of any more
 * use.
 *
 * @param[in] memory_manager Pointer to a JxlMemoryManager.
 * @param[in] compressed_icc Pointer to a buffer containing the compressed ICC
 * profile.
 * @param[in] compressed_icc_size Size of the buffer containing the compressed
 * ICC profile.
 * @param[out] icc Will be set to a pointer to the buffer containing the result.
 * @param[out] icc_size Will be set to the size of the buffer containing the
 * result.
 * @return Whether decompressing the profile was successful.
 */
JXL_EXPORT JXL_BOOL JxlICCProfileDecode(const JxlMemoryManager* memory_manager,
                                        const uint8_t* compressed_icc,
                                        size_t compressed_icc_size,
                                        uint8_t** icc, size_t* icc_size);

#ifdef __cplusplus
}
#endif

#endif /* JXL_COMPRESSED_ICC_H_ */

/** @} */