ImageAttributes.SetOutputChannelColorProfile Método

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Define o arquivo do perfil de cor do canal de saída.

Sobrecargas

SetOutputChannelColorProfile(String, ColorAdjustType)	Define o arquivo do perfil de cor do canal de saída para uma categoria especificada.
SetOutputChannelColorProfile(String)	Define o arquivo do perfil de cor do canal de saída para a categoria padrão.

SetOutputChannelColorProfile(String, ColorAdjustType)

Origem:

ImageAttributes.cs

Define o arquivo do perfil de cor do canal de saída para uma categoria especificada.

public:
 void SetOutputChannelColorProfile(System::String ^ colorProfileFilename, System::Drawing::Imaging::ColorAdjustType type);

public void SetOutputChannelColorProfile (string colorProfileFilename, System.Drawing.Imaging.ColorAdjustType type);

member this.SetOutputChannelColorProfile : string * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetOutputChannelColorProfile (colorProfileFilename As String, type As ColorAdjustType)

Parâmetros

colorProfileFilename

String

O nome do caminho de um arquivo de perfil de cor. Se o arquivo de perfil de cor está no diretório %SystemRoot%\System32\Spool\Drivers\Color, esse parâmetro pode ser o nome do arquivo. Caso contrário, esse parâmetro deve ser o nome de caminho totalmente qualificado.

type

ColorAdjustType

Um elemento de ColorAdjustType que especifica a categoria para a qual o arquivo de perfil de cor do canal de saída é definido.

Comentários

Você pode usar os SetOutputChannel métodos e SetOutputChannelColorProfile para converter uma imagem em um espaço de cores CMYK (ciano-magenta-amarelo-preto) e examinar as intensidades de um dos canais de cores CMYK. Por exemplo, suponha que você escreva um código que execute as seguintes etapas:

1. Create um Image.

2. Crie um objeto ImageAttributes.

3. Passe ColorChannelC para o SetOutputChannel método do ImageAttributes objeto .

4. Passe o nome do caminho de um arquivo de perfil de cor para o SetOutputChannelColorProfile método do ImageAttributes objeto .

5. Passe os caminhos dos Image objetos e ImageAttributes para o DrawImage método .

O GDI+ usará o arquivo de perfil de cor para calcular o componente ciano de cada pixel na imagem, e cada pixel na imagem renderizada será um tom de cinza que indica a intensidade de seu canal ciano.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um arquivo de perfil de cor do canal de saída para a categoria padrão e um arquivo de perfil de cor de canal de saída diferente para a categoria bitmap.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de bitmap, as configurações padrão se aplicarão à categoria bitmap.

Assim que você especificar uma configuração de ajuste de cor ou ajuste de escala de cinza para uma determinada categoria, as configurações de ajuste padrão não se aplicam mais a essa categoria. Por exemplo, suponha que você especifique uma coleção de configurações de ajuste para a categoria padrão. Se você definir o arquivo de perfil de cor do canal de saída para a categoria bitmap passando Bitmap para o SetOutputChannelColorProfile método , nenhuma das configurações de ajuste padrão será aplicada a bitmaps.

SetOutputChannelColorProfile(String)

Origem:

ImageAttributes.cs

Define o arquivo do perfil de cor do canal de saída para a categoria padrão.

public:
 void SetOutputChannelColorProfile(System::String ^ colorProfileFilename);

public void SetOutputChannelColorProfile (string colorProfileFilename);

member this.SetOutputChannelColorProfile : string -> unit

Public Sub SetOutputChannelColorProfile (colorProfileFilename As String)

Parâmetros

colorProfileFilename

String

O nome do caminho de um arquivo de perfil de cor. Se o arquivo de perfil de cor está no diretório %SystemRoot%\System32\Spool\Drivers\Color, esse parâmetro pode ser o nome do arquivo. Caso contrário, esse parâmetro deve ser o nome de caminho totalmente qualificado.

Comentários

Você pode usar os SetOutputChannel métodos e SetOutputChannelColorProfile para converter uma imagem em um espaço de cores CMYK (ciano-magenta-amarelo-preto) e examinar as intensidades de um dos canais de cores CMYK. Por exemplo, suponha que você escreva um código que execute as seguintes etapas:

1. Create um Image.

2. Crie um objeto ImageAttributes.

3. Passe ColorChannelC para o SetOutputChannel método do ImageAttributes objeto .

4. Passe o nome do caminho de um arquivo de perfil de cor para o SetOutputChannelColorProfile método do ImageAttributes objeto .

5. Passe os caminhos dos Image objetos e ImageAttributes para o DrawImage método .

O GDI+ usará o arquivo de perfil de cor para calcular o componente ciano de cada pixel na imagem, e cada pixel na imagem renderizada será um tom de cinza que indica a intensidade de seu canal ciano.

Um ImageAttributes objeto mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um arquivo de perfil de cor do canal de saída para a categoria padrão e um arquivo de perfil de cor de canal de saída diferente para a categoria bitmap.

As configurações padrão de ajuste de cor e ajuste de escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de bitmap, as configurações padrão se aplicarão à categoria bitmap.