mirror of
https://git.ffmpeg.org/ffmpeg.git
synced 2024-12-30 19:32:13 +00:00
88 lines
2.9 KiB
C
88 lines
2.9 KiB
C
|
/*
|
||
|
* Copyright (c) 2022 Niklas Haas
|
||
|
* This file is part of FFmpeg.
|
||
|
*
|
||
|
* FFmpeg is free software; you can redistribute it and/or
|
||
|
* modify it under the terms of the GNU Lesser General Public
|
||
|
* License as published by the Free Software Foundation; either
|
||
|
* version 2.1 of the License, or (at your option) any later version.
|
||
|
*
|
||
|
* FFmpeg is distributed in the hope that it will be useful,
|
||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
* Lesser General Public License for more details.
|
||
|
*
|
||
|
* You should have received a copy of the GNU Lesser General Public
|
||
|
* License along with FFmpeg; if not, write to the Free Software
|
||
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @file
|
||
|
* Various functions for dealing with ICC profiles
|
||
|
*/
|
||
|
|
||
|
#ifndef AVCODEC_FFLCMS2_H
|
||
|
#define AVCODEC_FFLCMS2_H
|
||
|
|
||
|
#include "libavutil/csp.h"
|
||
|
#include "libavutil/frame.h"
|
||
|
#include "libavutil/pixfmt.h"
|
||
|
|
||
|
#include <lcms2.h>
|
||
|
|
||
|
typedef struct FFIccContext {
|
||
|
void *avctx;
|
||
|
cmsContext ctx;
|
||
|
cmsToneCurve *curves[AVCOL_TRC_NB]; /* tone curve cache */
|
||
|
} FFIccContext;
|
||
|
|
||
|
/**
|
||
|
* Initializes an FFIccContext. This must be done prior to using it.
|
||
|
*
|
||
|
* Returns 0 on success, or a negative error code.
|
||
|
*/
|
||
|
int ff_icc_context_init(FFIccContext *s, void *avctx);
|
||
|
void ff_icc_context_uninit(FFIccContext *s);
|
||
|
|
||
|
/**
|
||
|
* Generate an ICC profile for a given combination of color primaries and
|
||
|
* transfer function. Both values must be set to valid entries (not
|
||
|
* "undefined") for this function to work.
|
||
|
*
|
||
|
* Returns 0 on success, or a negative error code.
|
||
|
*/
|
||
|
int ff_icc_profile_generate(FFIccContext *s,
|
||
|
enum AVColorPrimaries color_prim,
|
||
|
enum AVColorTransferCharacteristic color_trc,
|
||
|
cmsHPROFILE *out_profile);
|
||
|
|
||
|
/**
|
||
|
* Attach an ICC profile to a frame. Helper wrapper around cmsSaveProfileToMem
|
||
|
* and av_frame_new_side_data_from_buf.
|
||
|
*
|
||
|
* Returns 0 on success, or a negative error code.
|
||
|
*/
|
||
|
int ff_icc_profile_attach(FFIccContext *s, cmsHPROFILE profile, AVFrame *frame);
|
||
|
|
||
|
/**
|
||
|
* Read the color primaries and white point coefficients encoded by an ICC
|
||
|
* profile, and return the raw values in `out_primaries`.
|
||
|
*
|
||
|
* Returns 0 on success, or a negative error code.
|
||
|
*/
|
||
|
int ff_icc_profile_read_primaries(FFIccContext *s, cmsHPROFILE profile,
|
||
|
AVColorPrimariesDesc *out_primaries);
|
||
|
|
||
|
/**
|
||
|
* Attempt detecting the transfer characteristic that best approximates the
|
||
|
* transfer function encoded by an ICC profile. Sets `out_trc` to
|
||
|
* AVCOL_TRC_UNSPECIFIED if no clear match can be identified.
|
||
|
*
|
||
|
* Returns 0 on success (including no match), or a negative error code.
|
||
|
*/
|
||
|
int ff_icc_profile_detect_transfer(FFIccContext *s, cmsHPROFILE profile,
|
||
|
enum AVColorTransferCharacteristic *out_trc);
|
||
|
|
||
|
#endif /* AVCODEC_FFLCMS2_H */
|