1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements.  See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership.  The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance
9 * with the License.  You may obtain a copy of the License at
10 *
11 *   http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing,
14 * software distributed under the License is distributed on an
15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 * KIND, either express or implied.  See the License for the
17 * specific language governing permissions and limitations
18 * under the License.
19 *
20 *************************************************************/
21
22
23#ifndef __com_sun_star_rendering_RenderingIntent_idl__
24#define __com_sun_star_rendering_RenderingIntent_idl__
25
26module com { module sun { module star { module rendering {
27
28/** The rendering intent for a color space.<p>
29
30    The rendering intent for a color space mostly determines how
31    out-of-gamut color is treated. See <a
32    href="http://en.wikipedia.org/wiki/Rendering_intent">Wikipedia</a>
33    for a thorough explanation.
34
35    @since OOo 2.0
36 */
37constants RenderingIntent
38{
39    /** Also known as the image intent, this rendering intent
40        aims to preserve the visual relationship between
41        colors in a way that is perceived as natural to the
42        human eye, although the color values themselves may
43        change. This intent is most suitable for photographic
44        images.
45    */
46    const byte PERCEPTUAL=0;
47
48	//-------------------------------------------------------------------------
49
50    /** The rendering intent for business graphics that
51        maintains vivid color at the expense of accurate
52        color. It scales the source gamut to the destination
53        gamut but preserves relative saturation instead of
54        hue, so when scaling to a smaller gamut, hues may
55        shift. This rendering intent is primarily designed for
56        business graphics, where bright saturated colors are
57        more important than the exact relationship between
58        colors (such as in a photographic image).
59    */
60    const byte SATURATION=1;
61
62    /** The rendering intent almost identical to Absolute
63        Colorimetric except for the following difference:
64        Relative Colorimetric compares the white point
65        (extreme highlight) of the source color space to that
66        of the destination color space and shifts all colors
67        accordingly.
68    */
69    const byte RELATIVE_COLORIMETRIC=2;
70
71    /** The rendering intent that leaves colors that fall
72        inside the destination gamut unchanged. Out of gamut
73        colors are clipped. No scaling of colors to
74        destination white point is performed. This intent aims
75        to maintain color accuracy at the expense of
76        preserving relationships between colors, and is useful
77        for seeing how output will look on a non-neutral
78        substrate.
79    */
80    const byte ABSOLUTE_COLORIMETRIC=3;
81};
82
83}; }; }; };
84
85#endif
86