offapi/com/sun/star/rendering/RenderingIntent.idl

   1 /*************************************************************************
   2  *
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * Copyright 2000, 2010 Oracle and/or its affiliates.
   6  *
   7  * OpenOffice.org - a multi-platform office productivity suite
   8  *
   9  * This file is part of OpenOffice.org.
  10  *
  11  * OpenOffice.org is free software: you can redistribute it and/or modify
  12  * it under the terms of the GNU Lesser General Public License version 3
  13  * only, as published by the Free Software Foundation.
  14  *
  15  * OpenOffice.org is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU Lesser General Public License version 3 for more details
  19  * (a copy is included in the LICENSE file that accompanied this code).
  20  *
  21  * You should have received a copy of the GNU Lesser General Public License
  22  * version 3 along with OpenOffice.org.  If not, see
  23  * <http://www.openoffice.org/license.html>
  24  * for a copy of the LGPLv3 License.
  25  *
  26  ************************************************************************/
  27 #ifndef __com_sun_star_rendering_RenderingIntent_idl__
  28 #define __com_sun_star_rendering_RenderingIntent_idl__
  29
  30 module com { module sun { module star { module rendering {
  31
  32 /** The rendering intent for a color space.<p>
  33
  34     The rendering intent for a color space mostly determines how
  35     out-of-gamut color is treated. See <a
  36     href="http://en.wikipedia.org/wiki/Rendering_intent">Wikipedia</a>
  37     for a thorough explanation.
  38
  39     @since OOo 2.0.0
  40  */
  41 constants RenderingIntent
  42 {
  43     /** Also known as the image intent, this rendering intent
  44         aims to preserve the visual relationship between
  45         colors in a way that is perceived as natural to the
  46         human eye, although the color values themselves may
  47         change. This intent is most suitable for photographic
  48         images.
  49     */
  50     const byte PERCEPTUAL=0;
  51
  52     //-------------------------------------------------------------------------
  53
  54     /** The rendering intent for business graphics that
  55         maintains vivid color at the expense of accurate
  56         color. It scales the source gamut to the destination
  57         gamut but preserves relative saturation instead of
  58         hue, so when scaling to a smaller gamut, hues may
  59         shift. This rendering intent is primarily designed for
  60         business graphics, where bright saturated colors are
  61         more important than the exact relationship between
  62         colors (such as in a photographic image).
  63     */
  64     const byte SATURATION=1;
  65
  66     /** The rendering intent almost identical to Absolute
  67         Colorimetric except for the following difference:
  68         Relative Colorimetric compares the white point
  69         (extreme highlight) of the source color space to that
  70         of the destination color space and shifts all colors
  71         accordingly.
  72     */
  73     const byte RELATIVE_COLORIMETRIC=2;
  74
  75     /** The rendering intent that leaves colors that fall
  76         inside the destination gamut unchanged. Out of gamut
  77         colors are clipped. No scaling of colors to
  78         destination white point is performed. This intent aims
  79         to maintain color accuracy at the expense of
  80         preserving relationships between colors, and is useful
  81         for seeing how output will look on a non-neutral
  82         substrate.
  83     */
  84     const byte ABSOLUTE_COLORIMETRIC=3;
  85 };
  86
  87 }; }; }; };
  88
  89 #endif