Method function IGDIPlus.IGPImageAttributes.SetOutputChannelColorProfile(WideString;TGPColorAdjustType) : TGPImageAttributes

This is a Beta Read Only version of this page. Please review and send recommendations to mitov@mitov.com. We will enable the editing as soon as we are happy with the overall Wiki site.

Class: IGPImageAttributes

Syntax

Delphi:

function SetOutputChannelColorProfile( colorProfileFilename : WideString, type_ : TGPColorAdjustType ) : TGPImageAttributes;

C++ Builder:

TGPImageAttributes __fastcall SetOutputChannelColorProfile( WideString colorProfileFilename, TGPColorAdjustType type_ );

Visual C++ (MFC):

SetOutputChannelColorProfile(  colorProfileFilename,  type_ );

Summary

Sets the output channel color-profile file for a specified category.

Description

Call this method to set the output channel color-profile file for a specified category. Remarks You can use the SetOutputChannel and SetOutputChannelColorProfile methods to convert an image to a cyan-magenta-yellow-black (CMYK) color space and examine the intensities of one of the CMYK color channels. For example, suppose you write code that performs the following steps:

 1. Create an TGPImage object.
 2. Create an TGPImageAttributes object.
 3. Pass ColorChannelFlagsC to the SetOutputChannel method
    of the TGPImageAttributes object.
 4. Pass the path name of a color profile file to the
    SetOutputChannelColorProfile method of the ImageAttributes
    object.
 5. Pass the addresses of the Image and TGPImageAttributes
    objects to the TGPGraphics.DrawImage method.

Microsoft Windows GDI+ will use the color-profile file to calculate the cyan component of each pixel in the image, and each pixel in the rendered image will be a shade of gray that indicates the intensity of its cyan channel.

An TGPImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. For example, you can specify an output channel color-profile file for the default category and a different output channel color-profile file for the bitmap category.

The default color- and grayscale-adjustment settings apply to all categories that don't have adjustment settings of their own. For example, if you never specify any adjustment settings for the bitmap category, then the default settings apply to the bitmap category.

As soon as you specify a color- or grayscale-adjustment setting for a certain category, the default adjustment settings no longer apply to that category. For example, suppose you specify a collection of adjustment settings for the default category. If you set the output channel color-profile file for the bitmap category by passing ColorAdjustTypeBitmap to the SetOutputChannelColorProfile method, then none of the default adjustment settings will apply to bitmaps.