Funções de imagem
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++ image .
Funções HatchBrush e métodos wrapper correspondentes
| Função simples | Método Wrapper | Comentários |
|---|---|---|
| GpStatus WINGDIPAPI GdipLoadImageFromStream(IStream* stream, GpImage **image) |
Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement) | Cria um objeto Image com base em um fluxo. Essa função simples não usa o ICM (Gerenciamento de Cores de Imagem). |
| GpStatus WINGDIPAPI GdipLoadImageFromFile(GDIPCONST WCHAR* filename, GpImage **image) |
Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement) | Cria um objeto Image com base em um arquivo. Essa função simples não usa ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromStreamICM(IStream* stream, GpImage **image) |
Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement) | Cria um objeto Image com base em um fluxo. Essa função simples não usa ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromFileICM(GDIPCONST WCHAR* filename, GpImage **image) |
Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement) | Cria um objeto Image com base em um arquivo. Essa função simples não usa ICM. |
| GpStatus WINGDIPAPI GdipCloneImage(GpImage *image, GpImage **cloneImage) |
Image* Image::Clone() | Cria um novo objeto Image e o inicializa com o conteúdo deste objeto Image . |
| GpStatus WINGDIPAPI GdipDisposeImage(GpImage *image) |
Image::~Image() |
Libera recursos usados pelo objeto Image . |
| GpStatus WINGDIPAPI GdipSaveImageToFile(GpImage *image, GDIPCONST WCHAR* filename, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams) |
Status Image::Save( IN const WCHAR* filename, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams ) | Salva essa imagem em um arquivo. |
| GpStatus WINGDIPAPI GdipSaveImageToStream(GpImage *image, IStream* stream, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams) |
Status Image::Save( IN IStream* stream, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams ) | Salva essa imagem em um fluxo. |
| GpStatus WINGDIPAPI GdipSaveAdd(GpImage *image, GDIPCONST EncoderParameters* encoderParams) |
Status Image::SaveAdd( IN const EncoderParameters *encoderParams ) | Adiciona um quadro a um arquivo ou fluxo especificado em uma chamada anterior ao método Save. Use esse método para salvar quadros selecionados de uma imagem de vários quadros em outra imagem de vários quadros. |
| GpStatus WINGDIPAPI GdipSaveAddImage(GpImage *image, GpImage* newImage, GDIPCONST EncoderParameters* encoderParams) |
Status Image::SaveAdd( IN Image* newImage, IN const EncoderParameters *encoderParams ) | Adiciona um quadro a um arquivo ou fluxo especificado em uma chamada anterior ao método Save. |
| GpStatus WINGDIPAPI GdipGetImageGraphicsContext(GpImage *image, GpGraphics **graphics) |
Graphics::Graphics(IN Image* image) | Cria um objeto Graphics associado a um objeto Image. |
| GpStatus WINGDIPAPI GdipGetImageBounds(GpImage *image, GpRectF *srcRect, GpUnit *srcUnit) |
Status Image::GetBounds( OUT RectF *srcRect, OUT Unit *srcUnit ) | Obtém o retângulo delimitador para esta imagem. |
| GpStatus WINGDIPAPI GdipGetImageDimension(GpImage *image, REAL *width, REAL *height) |
Status Image::GetPhysicalDimension( OUT SizeF* size ) | Obtém a largura e a altura dessa imagem. Na função simples, os parâmetros de largura e altura correspondem ao parâmetro size no método wrapper. |
| GpStatus WINGDIPAPI GdipGetImageType(GpImage *image, ImageType *type) |
ImageType Image::GetType() const | Obtém o tipo (bitmap ou metarquivo) deste objeto Image. |
| GpStatus WINGDIPAPI GdipGetImageWidth(GpImage *image, UINT *width) |
Imagem UINT::GetWidth() | Obtém a largura, em pixels, dessa imagem. |
| GpStatus WINGDIPAPI GdipGetImageHeight(GpImage *image, UINT *height) |
Imagem UINT::GetHeight() | Obtém a altura da imagem, em pixels, dessa imagem. |
| GpStatus WINGDIPAPI GdipGetImageHorizontalResolution(GpImage *image, REAL *resolution) |
REAL Image::GetHorizontalResolution() | Obtém a resolução horizontal, em pontos por polegada, dessa imagem. |
| GpStatus WINGDIPAPI GdipGetImageVerticalResolution(GpImage *image, REAL *resolution) |
REAL Image::GetVerticalResolution() | Obtém a resolução vertical, em pontos por polegada, dessa imagem. |
| GpStatus WINGDIPAPI GdipGetImageFlags(GpImage *image, UINT *flags) |
Imagem UINT::GetFlags() | Obtém um conjunto de sinalizadores que indicam determinados atributos desse objeto Image . |
| GpStatus WINGDIPAPI GdipGetImageRawFormat(GpImage *image, GUID *format) |
Imagem de Status::GetRawFormat(OUT GUID *format) | Obtém um GUID (identificador global exclusivo) que identifica o formato desse objeto Image. GUIDs que identificam vários formatos de arquivo são definidos em Gdiplusimaging.h. |
| GpStatus WINGDIPAPI GdipGetImagePixelFormat(GpImage *image, PixelFormat *format) |
Imagem PixelFormat::GetPixelFormat() | Obtém o formato de pixel deste objeto Image. |
| GpStatus WINGDIPAPI GdipGetImageThumbnail(GpImage *image, UINT thumbWidth, UINT thumbHeight, GpImage **thumbImage, GetThumbnailImageAbort callback, VOID * callbackData) |
Image* Image::GetThumbnailImage( IN UINT thumbWidth, IN UINT thumbHeight, IN GetThumbnailImageAbort callback, IN VOID* callbackData ) | Obtém uma imagem em miniatura deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetEncoderParameterListSize(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT* size) |
Imagem UINT::GetEncoderParameterListSize( IN const CLSID* clsidEncoder ) | Obtém o tamanho, em bytes, da lista de parâmetros para um codificador de imagem especificado. |
| GpStatus WINGDIPAPI GdipGetEncoderParameterList(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT size, EncoderParameters* buffer) |
Status Image::GetEncoderParameterList( IN const CLSID* clsidEncoder, IN UINT size, OUT EncoderParameters* buffer ) | Obtém uma lista dos parâmetros compatíveis com um codificador de imagem especificado. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsCount(GpImage* image, UINT* count) |
Imagem UINT::GetFrameDimensionsCount() | Obtém o número de dimensões de quadro neste objeto Image. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsList(GpImage* image, GUID* dimensionIDs, UINT count) |
Status Image::GetFrameDimensionsList( OUT GUID* dimensionIDs, IN UINT count ) | Obtém os identificadores para as dimensões de quadro deste objeto Image. |
| GpStatus WINGDIPAPI GdipImageGetFrameCount(GpImage *image, GDIPCONST GUID* dimensionID, UINT* count) |
UINT Image::GetFrameCount( IN const GUID* dimensionID ) | Obtém o número de quadros em uma dimensão especificada deste objeto Image. |
| GpStatus WINGDIPAPI GdipImageSelectActiveFrame(GpImage *image, GDIPCONST GUID* dimensionID, UINT frameIndex) |
Status Image::SelectActiveFrame( IN const GUID *dimensionID, IN UINT frameIndex ) | Seleciona o quadro neste objeto Image especificado por uma dimensão e um índice. |
| GpStatus WINGDIPAPI GdipImageRotateFlip(GpImage *image, RotateFlipType rfType) |
Status Image::RotateFlip( IN RotateFlipType rotateFlipType ) | Gira e inverte essa imagem. |
| GpStatus WINGDIPAPI GdipGetImagePalette(GpImage *image, ColorPalette *palette, INT size) |
Status Image::GetPalette( OUT ColorPalette *palette, IN INT size ) | Obtém o ColorPalette deste objeto Image. |
| GpStatus WINGDIPAPI GdipSetImagePalette(GpImage *image, GDIPCONST ColorPalette *palette) |
Status Image::SetPalette( IN const ColorPalette *palette ) | Define a paleta de cores deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetImagePaletteSize(GpImage *image, INT *size) |
Imagem INT::GetPaletteSize() | Obtém o tamanho, em bytes, da paleta de cores deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyCount(GpImage *image, UINT* numOfProperty) |
Imagem UINT::GetPropertyCount() | Obtém o formato de pixel deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyIdList(GpImage *image, UINT numOfProperty, PROPID* list) |
Status Image::GetPropertyIdList( IN UINT numOfProperty, OUT PROPID* list ) | Obtém uma lista dos identificadores de propriedade usados nos metadados deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyItemSize(GpImage *image, PROPID propId, UINT* size) |
Imagem UINT::GetPropertyItemSize( IN PROPID propId ) | Obtém o tamanho, em bytes, de um item de propriedade especificado deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyItem(GpImage *image, PROPID propId,UINT propSize, PropertyItem* buffer) |
Status Image::GetPropertyItem( IN PROPID propId, IN UINT propSize, OUT PropertyItem* buffer ) | Obtém um item de propriedade especificado (parte dos metadados) deste objeto Image . |
| GpStatus WINGDIPAPI GdipGetPropertySize(GpImage *image, UINT* totalBufferSize, UINT* numProperties) |
Status Image::GetPropertySize( OUT UINT* totalBufferSize, OUT UINT* numProperties ) | Obtém o tamanho total, em bytes, de todos os itens de propriedade armazenados neste objeto Image . Esse método também obtém o número de itens de propriedade armazenados neste objeto Image . |
| GpStatus WINGDIPAPI GdipGetAllPropertyItems(GpImage *image, UINT totalBufferSize, UINT numProperties, PropertyItem* allItems) |
Status Image::GetAllPropertyItems( IN UINT totalBufferSize, IN UINT numProperties, OUT PropertyItem* allItems ) | Obtém todos os itens de propriedade (metadados) armazenados neste objeto Image . |
| GpStatus WINGDIPAPI GdipRemovePropertyItem(GpImage *image, PROPID propId) |
Status Image::RemovePropertyItem( IN PROPID propId ) | Remove um item de propriedade (parte dos metadados) deste objeto Image . |
| GpStatus WINGDIPAPI GdipSetPropertyItem(GpImage *image, GDIPCONST PropertyItem* item) |
Imagem de status::SetPropertyItem | Define um item de propriedade (parte dos metadados) para este objeto Image . Se o item já existir, seu conteúdo será atualizado; caso contrário, um novo item será adicionado. |
| GpStatus WINGDIPAPI GdipFindFirstImageItem(GpImage *image, ImageItemData* item) |
Status Image::FindFirstItem( IN ImageItemData* item ) | Recupera a descrição e o tamanho dos dados do primeiro item de metadados neste objeto Image . |
| GpStatus WINGDIPAPI GdipFindNextImageItem(GpImage *image, ImageItemData* item) |
Status Image::FindNextItem( IN ImageItemData* item ) | Recupera a descrição e o tamanho dos dados do próximo item de metadados neste objeto Image . Esse método é usado junto com o método Image::FindFirstItem para enumerar os itens de metadados armazenados neste objeto de idadeIm Image. |
| GpStatus WINGDIPAPI GdipGetImageItemData(GpImage *image, ImageItemData* item) |
Status Image::GetItemData( IN ImageItemData* item ) | Obtém uma parte dos metadados deste objeto Image . |
| GpStatus WINGDIPAPI GdipImageSetAbort(GpImage *pImage, GdiplusAbort *pIAbort) |
Status Image::SetAbort( GdiplusAbort *pIAbort ) | Define o objeto cujo método Abort é chamado periodicamente durante a operação de renderização demorada. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlus(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte esse objeto Metafile no formato EMF+. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToFile(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, const WCHAR* filename, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, const WCHAR* filename, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte esse objeto Metafile no formato EMF+. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToStream(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, IStream* stream, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, IStream* stream, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte esse objeto Metafile no formato EMF+. |
| GpStatus WINGDIPAPI GdipImageForceValidation(GpImage *image) |
Não chamado pelos métodos wrapper. |
Essa função força a validação da imagem. |
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