colour.h

/* Definitions for VIPS colour package.
 *
 * J.Cupitt, 8/4/93
 * 15/7/96 JC
 *	- C++ stuff added
 * 20/2/98 JC
 *	- new display calibration added
 * 26/9/05
 * 	- added IM_ prefix to colour temps
 */

/*

	This file is part of VIPS.

	VIPS 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 of the License, or
	(at your option) any later version.

	This program 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 this program; if not, write to the Free Software
	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
	02110-1301  USA

 */

/*

	These files are distributed with VIPS - http://www.vips.ecs.soton.ac.uk

 */

#ifndef VIPS_COLOUR_H
#define VIPS_COLOUR_H

#ifdef __cplusplus
extern "C" {
#endif /*__cplusplus*/

/* Areas under curves for Dxx. 2 degree observer.
 */
#define VIPS_D93_X0 (89.7400)
#define VIPS_D93_Y0 (100.0)
#define VIPS_D93_Z0 (130.7700)

#define VIPS_D75_X0 (94.9682)
#define VIPS_D75_Y0 (100.0)
#define VIPS_D75_Z0 (122.5710)

/* D65 temp 6504.
 */
#define VIPS_D65_X0 (95.0470)
#define VIPS_D65_Y0 (100.0)
#define VIPS_D65_Z0 (108.8827)

#define VIPS_D55_X0 (95.6831)
#define VIPS_D55_Y0 (100.0)
#define VIPS_D55_Z0 (92.0871)

#define VIPS_D50_X0 (96.4250)
#define VIPS_D50_Y0 (100.0)
#define VIPS_D50_Z0 (82.4680)

/* A temp 2856k.
 */
#define VIPS_A_X0 (109.8503)
#define VIPS_A_Y0 (100.0)
#define VIPS_A_Z0 (35.5849)

/* B temp 4874k.
 */
#define VIPS_B_X0 (99.0720)
#define VIPS_B_Y0 (100.0)
#define VIPS_B_Z0 (85.2230)

/* C temp 6774k.
 */
#define VIPS_C_X0 (98.0700)
#define VIPS_C_Y0 (100.0)
#define VIPS_C_Z0 (118.2300)

#define VIPS_E_X0 (100.0)
#define VIPS_E_Y0 (100.0)
#define VIPS_E_Z0 (100.0)

#define VIPS_D3250_X0 (105.6590)
#define VIPS_D3250_Y0 (100.0)
#define VIPS_D3250_Z0 (45.8501)

typedef enum {
	VIPS_INTENT_PERCEPTUAL = 0,
	VIPS_INTENT_RELATIVE,
	VIPS_INTENT_SATURATION,
	VIPS_INTENT_ABSOLUTE,
	VIPS_INTENT_LAST
} VipsIntent;

typedef enum {
	VIPS_PCS_LAB,
	VIPS_PCS_XYZ,
	VIPS_PCS_LAST
} VipsPCS;

VIPS_API
gboolean vips_colourspace_issupported(const VipsImage *image);
VIPS_API
int vips_colourspace(VipsImage *in, VipsImage **out,
	VipsInterpretation space, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
int vips_LabQ2sRGB(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_rad2float(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_float2rad(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_LabS2LabQ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_LabQ2LabS(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_LabQ2Lab(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Lab2LabQ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_LCh2Lab(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Lab2LCh(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Yxy2Lab(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_CMC2XYZ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Lab2XYZ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_XYZ2Lab(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
int vips_XYZ2scRGB(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_scRGB2sRGB(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_scRGB2BW(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_sRGB2scRGB(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_scRGB2XYZ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_HSV2sRGB(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_sRGB2HSV(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
int vips_LCh2CMC(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_CMC2LCh(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_XYZ2Yxy(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Yxy2XYZ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_LabS2Lab(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_Lab2LabS(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
int vips_CMYK2XYZ(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_XYZ2CMYK(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
int vips_profile_load(const char *name, VipsBlob **profile, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_icc_present(void);
VIPS_API
int vips_icc_transform(VipsImage *in, VipsImage **out,
	const char *output_profile, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_icc_import(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_icc_export(VipsImage *in, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_icc_ac2rc(VipsImage *in, VipsImage **out,
	const char *profile_filename);
VIPS_API
gboolean vips_icc_is_compatible_profile(VipsImage *image,
	const void *data, size_t data_length);

VIPS_API
int vips_dE76(VipsImage *left, VipsImage *right, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_dE00(VipsImage *left, VipsImage *right, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;
VIPS_API
int vips_dECMC(VipsImage *left, VipsImage *right, VipsImage **out, ...)
	G_GNUC_NULL_TERMINATED;

VIPS_API
void vips_col_Lab2XYZ(float L, float a, float b,
	float *X, float *Y, float *Z);
VIPS_API
void vips_col_XYZ2Lab(float X, float Y, float Z,
	float *L, float *a, float *b);
VIPS_API
double vips_col_ab2h(double a, double b);
VIPS_API
void vips_col_ab2Ch(float a, float b, float *C, float *h);
VIPS_API
void vips_col_Ch2ab(float C, float h, float *a, float *b);

VIPS_API
float vips_col_L2Lcmc(float L);
VIPS_API
float vips_col_C2Ccmc(float C);
VIPS_API
float vips_col_Ch2hcmc(float C, float h);

VIPS_API
void vips_col_make_tables_CMC(void);
VIPS_API
float vips_col_Lcmc2L(float Lcmc);
VIPS_API
float vips_col_Ccmc2C(float Ccmc);
VIPS_API
float vips_col_Chcmc2h(float C, float hcmc);

VIPS_API
int vips_col_sRGB2scRGB_8(int r, int g, int b, float *R, float *G, float *B);
VIPS_API
int vips_col_sRGB2scRGB_16(int r, int g, int b, float *R, float *G, float *B);
VIPS_API
int vips_col_sRGB2scRGB_8_noclip(int r, int g, int b,
	float *R, float *G, float *B);
VIPS_API
int vips_col_sRGB2scRGB_16_noclip(int r, int g, int b,
	float *R, float *G, float *B);

VIPS_API
int vips_col_scRGB2XYZ(float R, float G, float B,
	float *X, float *Y, float *Z);
VIPS_API
int vips_col_XYZ2scRGB(float X, float Y, float Z,
	float *R, float *G, float *B);

VIPS_API
int vips_col_scRGB2sRGB_8(float R, float G, float B,
	int *r, int *g, int *b, int *og);
VIPS_API
int vips_col_scRGB2sRGB_16(float R, float G, float B,
	int *r, int *g, int *b, int *og);
VIPS_API
int vips_col_scRGB2BW_16(float R, float G, float B, int *g, int *og);
VIPS_API
int vips_col_scRGB2BW_8(float R, float G, float B, int *g, int *og);

VIPS_API
float vips_pythagoras(float L1, float a1, float b1,
	float L2, float a2, float b2);
VIPS_API
float vips_col_dE00(
	float L1, float a1, float b1, float L2, float a2, float b2);

#ifdef __cplusplus
}
#endif /*__cplusplus*/

#endif /*VIPS_COLOUR_H*/