Funções ImageAttributes
O Windows GDI+ expõe uma API simples que consiste em cerca de 600 funções, que são implementadas em Gdiplus.dll e declaradas em Gdiplusflat.h. As funções na API plana GDI+ são encapsuladas por uma coleção de cerca de 40 classes C++. É recomendável que você não chame diretamente as funções na API simples. Sempre que você fizer chamadas para GDI+, deverá fazer isso chamando os métodos e as funções fornecidos pelos wrappers C++. Os Serviços de Suporte a Produtos da Microsoft não fornecerão suporte para o código que chama a API simples diretamente. Para obter mais informações sobre como usar esses métodos wrapper, consulte API Simples GDI+.
As seguintes funções de API simples são encapsuladas pela classe C++ ImageAttributes .
Funções ImageAttributes e métodos wrapper correspondentes
| Função simples | Método Wrapper | Comentários |
|---|---|---|
| GpStatus WINGDIPAPI GdipCreateImageAttributes(GpImageAttributes **imageattr) |
ImageAttributes::ImageAttributes() | Cria um objeto ImageAttributes . |
| GpStatus WINGDIPAPI GdipCloneImageAttributes(GDIPCONST GpImageAttributes *imageattr, GpImageAttributes **cloneImageattr) |
ImageAttributes* ImageAttributes::Clone() const | Faz uma cópia deste objeto ImageAttributes . |
| GpStatus WINGDIPAPI GdipDisposeImageAttributes(GpImageAttributes *imageattr) |
ImageAttributes::~ImageAttributes() | Libera recursos usados pelo objeto ImageAttributes . |
| GpStatus WINGDIPAPI GdipSetImageAttributesToIdentity(GpImageAttributes *imageattr, ColorAdjustType type) |
Status ImageAttributes::SetToIdentity( IN ColorAdjustType type = ColorAdjustTypeDefault ) | Define a matriz de ajuste de cor de uma categoria especificada como matriz de identidade. |
| GpStatus WINGDIPAPI GdipResetImageAttributes(GpImageAttributes *imageattr, colorAdjustType type) |
Status ImageAttributes::Reset( IN ColorAdjustType type = ColorAdjustTypeDefault ) | Define a matriz de ajuste de cor de uma categoria especificada como matriz de identidade. |
| GpStatus WINGDIPAPI GdipSetImageAttributesColorMatrix(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, GDIPCONST ColorMatrix* colorMatrix, GDIPCONST ColorMatrix* grayMatrix, ColorMatrixFlags flags) |
Status ImageAttributes::SetColorMatrix( IN const ColorMatrix *colorMatrix, IN ColorMatrixFlags mode = ColorMatrixFlagsDefault, IN ColorAdjustType type = ColorAdjustTypeDefault )Status ImageAttributes::ClearColorMatrix(IN ColorAdjustType type = ColorAdjustTypeDefault) | Define a matriz de ajuste de cores de uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um ajuste de cor separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetColorMatrix define enableFlag como TRUE e ImageAttributes::ClearColorMatrix define enableFlag como FALSE. Limpa a matriz de ajuste de cores de uma categoria especificada. O parâmetro grayMatrix especifica uma matriz a ser usada para ajustar tons de cinza quando o valor do parâmetro flags for ColorMatrixFlagsAltGray. |
| GpStatus WINGDIPAPI GdipSetImageAttributesThreshold(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, REAL threshold) |
Status ImageAttributes::SetThreshold( IN REAL threshold, IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearThreshold(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define o limite (intervalo de transparência) para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um limite separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetThreshold define enableFlag como TRUE e ImageAttributes::ClearThreshold define enableFlag como FALSE. Limpa o valor limite de uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesGamma(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, REAL gamma) |
Status ImageAttributes::SetGamma(IN REAL gamma, IN ColorAdjustType type = ColorAdjustTypeDefault) Status ImageAttributes::ClearGamma(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define o valor gama para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um gama separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetGamma define enableFlag como TRUE e ImageAttributes::ClearGamma define enableFlag como FALSE. Desabilita a correção gama para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesNoOp(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag) |
Status ImageAttributes::SetNoOp( IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearNoOp(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Desativa o ajuste de cores para uma categoria especificada. Você pode chamar o método ImageAttributes::ClearNoOp para restabelecer as configurações de ajuste de cor que estavam em vigor antes da chamada para o método ImageAttributes::SetNoOp . O parâmetro enableFlag na função simples é um valor booliano que especifica se um ajuste de cor está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetNoOp define enableFlag como TRUE e ImageAttributes::ClearNoOp define enableFlag como FALSE. Limpa a configuração NoOp para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesColorKeys(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, ARGB colorLow, ARGB colorHigh) |
Status ImageAttributes::SetColorKey( IN const Color colorLow& , IN const Color colorHigh& , IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearColorKey(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define a chave de cores (intervalo de transparência) para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um intervalo de transparência separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetColorKey define enableFlag como TRUE e ImageAttributes::ClearColorKey define enableFlag como FALSE. Limpa a chave de cores (intervalo de transparência) para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesOutputChannel(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, ColorChannelFlags channelFlags) |
Status ImageAttributes::SetOutputChannel( IN ColorChannelFlags channelFlags, IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearOutputChannel(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define o canal de saída CMYK (ciano-magenta-amarelo-preto) para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um canal de saída separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetOutputChannel define enableFlag como TRUE e ImageAttributes::ClearOutputChannel define enableFlag como FALSE. Limpa a configuração do canal de saída CMYK (ciano-magenta-amarelo-preto) para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesOutputChannelColorProfile(GpImageAttributes *imageattr, tipo ColorAdjustType, BOOL enableFlag, GDIPCONST WCHAR *colorProfileFilename) |
Status ImageAttributes::SetOutputChannelColorProfile( IN const WCHAR *colorProfileFilename, IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearOutputChannelColorProfile(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define o arquivo do perfil de cor do canal de saída para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se um perfil de cor de canal de saída separado está habilitado para a categoria especificada pelo parâmetro type . ImageAttributes::SetOutputChannelColorProfile define enableFlag como TRUE e ImageAttributes::ClearOutputChannelColorProfile define enableFlag como FALSE. Limpa a configuração do perfil de cor do canal de saída para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesRemapTable(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, UINT mapSize, GDIPCONST ColorMap *map) |
Status ImageAttributes::SetRemapTable( IN UINT mapSize, IN const ColorMap *map, IN ColorAdjustType type = ColorAdjustTypeDefault ) Status ImageAttributes::ClearRemapTable(IN ColorAdjustType type = ColorAdjustTypeDefault) |
Define a tabela de remapeamento de cores para uma categoria especificada. O parâmetro enableFlag na função simples é um valor booliano que especifica se uma tabela de remapeamento de cores separada está habilitada para a categoria especificada pelo parâmetro type . ImageAttributes::SetRemapTable define enableFlag como TRUE e ImageAttributes::ClearRemapTable define enableFlag como FALSE. Limpa a tabela de remapeamento de cores para uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesWrapMode(GpImageAttributes *imageAttr, WrapMode wrap, ARGB argb, BOOL clamp ) |
Status ImageAttributes::SetWrapMode(IN WrapMode wrap, IN const Color color& = Color(), IN BOOL clamp = FALSE) |
Define o modo de encapsulamento deste objeto ImageAttributes |
| GpStatus WINGDIPAPI GdipSetImageAttributesICMMode(GpImageAttributes *imageAttr, BOOL on ) |
Não chamado pelos métodos wrapper. |
Essa função define uma variável de estado interno para o valor especificado pelo parâmetro on . Se esse valor for TRUE, o ICM (Gerenciamento de Cores de Imagem) será usado para todos os ajustes de cor. Se o valor for FALSE, o ICM não será usado. |
| GpStatus WINGDIPAPI GdipGetImageAttributesAdjustedPalette(GpImageAttributes *imageAttr, ColorPalette * colorPalette, ColorAdjustType colorAdjustType ) |
Status ImageAttributes::GetAdjustedPalette(IN OUT ColorPalette* colorPalette, IN ColorAdjustType colorAdjustType) const |
Ajusta as cores em uma paleta de acordo com as configurações de ajuste de uma categoria especificada. |
| GpStatus WINGDIPAPI GdipSetImageAttributesCachedBackground(GpImageAttributes *imageattr, BOOL enableFlag) |
Não chamado pelos métodos wrapper. |
Define ou limpa o membro CachedBackground de um objeto GpImageAttributes especificado. O GDI+ não usa o membro CachedBackground, portanto, chamar essa função não tem efeito. O parâmetro imageattr especifica o objeto GpImageAttributes. O parâmetro enableFlag especifica se o membro CachedBackground está definido (TRUE) ou limpo (FALSE). |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de