Funções ImageAttributes

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 GDI+ API simples 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 fizer chamadas para GDI+, você deve fazer isso chamando os métodos e funções fornecidos pelos wrappers C++. Os Serviços de Suporte ao Produto 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 de wrapper, consulte GDI+ API Simples.

As funções de API simples a seguir são encapsuladas pela classe ImageAttributes C++.

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, tipo ColorAdjustType)
Status ImageAttributes::SetToIdentity( IN ColorAdjustType type = ColorAdjustTypeDefault ) Define a matriz de ajuste de cores de uma categoria especificada como matriz de identidade.
GpStatus WINGDIPAPI GdipResetImageAttributes(GpImageAttributes *imageattr, tipo ColorAdjustType)
Status ImageAttributes::Reset( IN ColorAdjustType type = ColorAdjustTypeDefault ) Define a matriz de ajuste de cores de uma categoria especificada como matriz de identidade.
GpStatus WINGDIPAPI GdipSetImageAttributesColorMatrix(GpImageAttributes *imageattr, tipo ColorAdjustType, 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 de tipo . 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 sinalizadores for ColorMatrixFlagsAltGray.
GpStatus WINGDIPAPI GdipSetImageAttributesThreshold(GpImageAttributes *imageattr, tipo ColorAdjustType, BOOL enableFlag, LIMITE REAL)
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 de tipo . 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, tipo ColorAdjustType, BOOL enableFlag, REAL gamma)
Status ImageAttributes::SetGamma(IN REAL gamma, IN ColorAdjustType type = ColorAdjustTypeDefault)
Status ImageAttributes::ClearGamma(tipo IN ColorAdjustType = 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 de tipo . ImageAttributes::SetGamma sets enableFlag to TRUE, and ImageAttributes::ClearGamma sets enableFlag to FALSE.
Desabilita a correção gama para uma categoria especificada.
GpStatus WINGDIPAPI GdipSetImageAttributesNoOp(GpImageAttributes *imageattr, tipo ColorAdjustType, 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 ao 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 de tipo . 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, tipo ColorAdjustType, 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 de tipo . 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, tipo ColorAdjustType, 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 de tipo . 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 de tipo . 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, tipo ColorAdjustType, 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 de tipo . ImageAttributes::SetRemapTable sets enableFlag to TRUE, and ImageAttributes::ClearRemapTable sets enableFlag to FALSE.
Limpa a tabela de remapeamento de cores para uma categoria especificada.
GpStatus WINGDIPAPI GdipSetImageAttributesWrapMode(GpImageAttributes *imageAttr, WrapMode wrap, ARGB argb, grampo BOOL )
Status ImageAttributes::SetWrapMode(IN WrapMode wrap, IN const Color& color = Color(), IN BOOL clamp = FALSE)
Define o modo wrap deste objeto ImageAttributes
GpStatus WINGDIPAPI GdipSetImageAttributesICMMode(GpImageAttributes *imageAttr, BOOL on )
Não chamado por métodos wrapper.
Essa função define uma variável de estado interna 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 por métodos wrapper.
Define ou limpa o membro CachedBackground de um objeto GpImageAttributes especificado. 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).