Windows Imaging Component (WIC) no XBOX

Este tópico descreve os recursos do Windows Imaging Component (WIC) disponíveis no Microsoft Game Development Kit (GDK). A maioria dos recursos do WIC está disponível para codificar, decodificar e manipular formatos de imagem comuns. Os recursos são semelhantes aos da versão ERA do WIC, com algumas melhorias em relatórios de erros e estabilidade. Os recursos do WIC no ERA e no Microsoft Game Development Kit (GDK) são ambos subconjuntos dos recursos do WIC no Windows. Para desenvolvedores familiarizados com o WIC no Windows, este tópico fornece uma breve lista de exceções de recursos no Microsoft Game Development Kit (GDK). Para os demais desenvolvedores, consulte o conjunto completo de recursos do WIC descrito nas seções a seguir.

Diferenças em relação ao WIC para Windows

Suporte interno a codecs para BMP, JPG, PNG, GIF, TIFF, ICO e DDS. Não há suporte para JPEG-XR/HD Photo.
Se você usar o formato BMP com compactação BI_BITFIELDS, somente os formatos 16bppBGR555, 16bppBGR565 e 32bppBGRA serão compatíveis.
Não há suporte para ciano-magenta-amarelo-preto (CMYK), alto alcance dinâmico, formatos de pixel de meia precisão (half-float), formatos de pixel de ponto fixo ou imagens com mais de quatro canais.
Não há suporte para os formatos de pixel 32bppRGBE, 16bppYQuantizedDctCoefficients, 16bppCbQuantizedDctCoefficients e 16bppCrQuantizedDctCoefficients.
Não há suporte para leitura ou gravação de metadados XMP nem para Photo Metadata Policies. Na transcodificação, a API tentará preservar os metadados XMP, se possível.
Não há suporte para manipulação e conversão de espaço de cores (ou seja, IWICColorTransform).
Não há suporte para pontos de entrada do Windows Runtime para o WIC (ou seja, métodos em Windows::Graphics::Imaging).
Não há suporte para os métodos de interoperabilidade com GDI, GDI+ e D2D: CreateBitmapFromHBITMAP, CreateBitmapFromHIcon e IWICImagingFactory2::CreateImageEncoder.
Não há suporte para IWICPixelFormatInfo::GetColorContext. Observe que IWICBitmapFrameDecode::GetColorContexts e IWICBitmapDecoder::GetColorContexts ainda são compatíveis.
Há algumas diferenças entre o Direct3D no XBOX One e no Windows em relação ao WIC. Os detalhes podem ser encontrados no tópico Criação e uso do Direct3D no XBOX One.

Recursos do WIC para o Microsoft Game Development Kit (GDK)

Os principais recursos do WIC são os seguintes.

Permite que os desenvolvedores de aplicativos executem operações de processamento de imagem em qualquer formato de imagem por meio de um conjunto único e consistente de interfaces comuns, sem exigir conhecimento prévio de formatos de imagem específicos
Fornece uma arquitetura extensível “plug and play” para codecs de imagem, formatos de pixel e metadados, com descoberta automática de novos formatos em tempo de execução
Oferece suporte à leitura e gravação de metadados arbitrários em arquivos de imagem, com a capacidade de preservar metadados não reconhecidos durante a edição
Preserva dados de imagem de alta profundidade de bits, até 32 bits por canal, em todo o pipeline de processamento de imagem
Fornece suporte interno para os formatos de imagem, formatos de pixel e esquemas de metadados mais populares

Codecs nativos para o Microsoft Game Development Kit (GDK)

O WIC inclui vários codecs internos. A tabela a seguir mostra os codecs padrão fornecidos com a plataforma.

Codec	Tipos MIME	Decodificadores	Codificadores
BMP (Windows Bitmap Format), especificação BMP v5.	image/bmp	Sim	Sim
GIF (Graphics Interchange Format 89a), especificação GIF 89a/89m	image/gif	Sim	Sim
ICO (Icon Format)	image/ico	Sim	Não
JPEG (Joint Photographic Experts Group), especificação JFIF 1.02	image/jpeg, image/jpe, image/jpg	Sim	Sim
PNG (Portable Network Graphics), especificação PNG 1.2	image/png	Sim	Sim
TIFF (Tagged Image File Format), especificação TIFF 6.0	image/tiff, image/tif	Sim	Sim
DDS (DirectDraw Surface)	image/vnd.ms-dds	Sim	Sim

Interfaces do WIC para o Microsoft Game Development Kit (GDK)

Tópico	Descrição
IWICBitmap	Define métodos que adicionam o conceito de capacidade de gravação e representações estáticas de bitmaps em memória a IWICBitmapSource.
IWICBitmapClipper	Expõe métodos que produzem uma versão recortada do bitmap de entrada para uma região retangular de interesse especificada.
IWICBitmapCodecInfo	Expõe métodos que fornecem informações sobre um codec específico.
IWICBitmapDecoder	Expõe métodos que representam um decodificador.
IWICBitmapDecoderInfo	Expõe métodos que fornecem informações sobre um decodificador.
IWICBitmapEncoder	Define métodos para definir as propriedades de um codificador, como miniaturas, quadros e paletas.
IWICBitmapEncoderInfo	Expõe métodos que fornecem informações sobre um codificador.
IWICBitmapFlipRotator	Expõe métodos que produzem uma fonte de bitmap invertida (horizontal ou verticalmente) e/ou girada (em incrementos de 90 graus). As rotações são feitas antes da inversão.
IWICBitmapFrameDecode	Define métodos para decodificar quadros de imagem individuais de um arquivo codificado.
IWICBitmapFrameEncode	Representa os quadros de imagem individuais de um codificador.
IWICBitmapLock	Expõe métodos que dão suporte ao método Lock.
IWICBitmapScaler	Representa uma versão redimensionada do bitmap de entrada usando um algoritmo de reamostragem ou filtragem.
IWICBitmapSource	Expõe métodos que se referem a uma fonte da qual os pixels são recuperados, mas na qual não podem ser gravados de volta.
IWICBitmapSourceTransform	Expõe métodos para transferir determinadas operações para a implementação subjacente de IWICBitmapSource.
IWICColorContext	Expõe métodos para gerenciamento de cores.
IWICComponentFactory	Expõe métodos que criam componentes usados por desenvolvedores de componentes. Isso inclui leitores e gravadores de metadados e outros serviços para uso por desenvolvedores de codecs e de manipuladores de metadados.
IWICComponentInfo	Expõe métodos que fornecem informações sobre componentes.
IWICDdsDecoder	Fornece informações e funcionalidades específicas do formato de imagem DDS.
IWICDdsEncoder	Permite gravar informações específicas do formato DDS em um codificador.
IWICDdsFrameDecode	Fornece acesso a um único quadro de dados de imagem DDS em sua forma nativa DXGI_FORMAT, bem como informações sobre os dados da imagem.
IWICEnumMetadataItem	Expõe métodos que fornecem serviços de enumeração para itens de metadados individuais.
IWICFastMetadataEncoder	Expõe métodos usados para edição de metadados no local. Um codificador rápido de metadados permite adicionar e remover metadados de uma imagem sem precisar recodificar totalmente a imagem.
IWICFormatConverter	Representa um IWICBitmapSource que converte os dados da imagem de um formato de pixel para outro, lidando com dithering e meio-tom para formatos indexados, tradução de paleta e limiarização de alfa.
IWICFormatConverterInfo	Expõe métodos que fornecem informações sobre um conversor de formato de pixel.
IWICImageEncoder	Codifica interfaces ID2D1Image para uma interface IWICBitmapEncoder.
IWICImagingFactory	Expõe métodos usados para criar componentes para o WIC, como decodificadores, codificadores e conversores de formato de pixel.
IWICImagingFactory2	Uma extensão da interface de fábrica do WIC que inclui a capacidade de criar uma interface IWICImageEncoder.
IWICJpegFrameDecode	Expõe métodos para decodificar imagens JPEG. Fornece acesso ao cabeçalho Start Of Frame (SOF), ao cabeçalho Start of Scan (SOS), às tabelas de Huffman e de quantização e aos dados JPEG compactados. Também permite a indexação para acesso aleatório eficiente.
IWICJpegFrameEncode	Expõe métodos para gravar dados de varredura JPEG compactados diretamente no fluxo de saída do codificador WIC. Também fornece acesso às tabelas de Huffman e de quantização.
IWICMetadataBlockReader	Expõe métodos que fornecem acesso a todos os blocos de metadados de nível superior do codec.
IWICMetadataBlockWriter	Expõe métodos que permitem a codificação de metadados. Essa interface é implementada pelo decodificador e seus quadros de imagem.
IWICMetadataHandlerInfo	Expõe métodos que fornecem informações básicas sobre o manipulador de metadados registrado.
IWICMetadataQueryReader	Expõe métodos para recuperar blocos e itens de metadados de um decodificador ou de seus quadros de imagem usando uma expressão de consulta de metadados.
IWICMetadataQueryWriter	Expõe métodos para definir ou remover blocos e itens de metadados em um codificador ou em seus quadros de imagem usando uma expressão de consulta de metadados.
IWICMetadataReader	Expõe métodos que fornecem acesso ao conteúdo de metadados subjacente. Essa interface é implementada por fornecedores independentes de software (ISVs) para criar novos leitores de metadados.
IWICMetadataReaderInfo	Expõe métodos que fornecem informações básicas sobre o leitor de metadados registrado.
IWICMetadataWriter	Expõe métodos que fornecem acesso à gravação de conteúdo de metadados. Isso é implementado por ISVs para criar novos gravadores de metadados.
IWICMetadataWriterInfo	Expõe métodos que fornecem informações básicas sobre o gravador de metadados registrado.
IWICPalette	Expõe métodos para acessar e criar uma tabela de cores, principalmente para formatos de pixel indexados.
IWICPersistStream	Expõe métodos que fornecem métodos adicionais de carregamento e salvamento que recebem WICPersistOptions.
IWICPixelFormatInfo	Expõe métodos que fornecem informações sobre um formato de pixel.
IWICPixelFormatInfo2	Estende IWICPixelFormatInfo fornecendo informações adicionais sobre um formato de pixel.
IWICPlanarBitmapFrameEncode	Permite que pixels de imagem de componentes planares sejam gravados em um codificador.
IWICPlanarBitmapSourceTransform	Fornece acesso a formatos de pixel Y’CbCr planares, nos quais os componentes de pixel são armazenados em planos de componentes separados.
IWICPlanarFormatConverter	Permite que um conversor de formato seja inicializado com uma fonte planar.
IWICProgressiveLevelControl	Expõe métodos para obter informações sobre a decodificação progressiva e controlá-la.
IWICStream	Representa um fluxo do WIC para referenciar conteúdo de imagens e metadados.
IWICStreamProvider	Expõe métodos para um provedor de fluxo.

Exemplos

Para ver exemplos de uso do WIC no Microsoft Game Development Kit (GDK), consulte os exemplos SimpleTexture e xtexconv.

Consulte também

Gráficos

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Diferenças em relação ao WIC para Windows

Recursos do WIC para o Microsoft Game Development Kit (GDK)

Codecs nativos para o Microsoft Game Development Kit (GDK)

Interfaces do WIC para o Microsoft Game Development Kit (GDK)

Exemplos

Consulte também

​Diferenças em relação ao WIC para Windows

​Recursos do WIC para o Microsoft Game Development Kit (GDK)

​Codecs nativos para o Microsoft Game Development Kit (GDK)

​Interfaces do WIC para o Microsoft Game Development Kit (GDK)

​Exemplos

​Consulte também

Diferenças em relação ao WIC para Windows

Recursos do WIC para o Microsoft Game Development Kit (GDK)

Codecs nativos para o Microsoft Game Development Kit (GDK)

Interfaces do WIC para o Microsoft Game Development Kit (GDK)

Exemplos

Consulte também