> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência do XG (conteúdo da API) (família XBOX One)

> O XG é uma biblioteca gráfica auxiliar usada para preparar recursos e para outras tarefas relacionadas a gráficos realizadas fora dos limites do runtime do Direct3D.

O XG é uma biblioteca gráfica auxiliar usada para preparar recursos e para outras tarefas relacionadas a gráficos realizadas fora dos limites das interfaces do runtime do Direct3D. Cabeçalho: `xg.h`.

<Warning>
  Esta seção pode não estar atualizada com o Microsoft Game Development Kit (GDK) e será atualizada em uma versão futura. O D3D11 não tem suporte no Microsoft Game Development Kit (GDK).
</Warning>

## Interfaces

| Interface | Descrição |
| - | - |
| [XGTextureAddressComputer](/pt-BR/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/xgtextureaddresscomputer) | Contém um layout de textura calculado para um recurso de textura especificado. Também contém o estado adicional que permite ao usuário executar microtiling e macrotiling de elementos de textura. |

## Funções

| Função | Descrição |
| - | - |
| [XGComputeBankRotationAddress](/pt-BR/reference/graphics/xg__NR/functions/xgcomputebankrotationaddress) | Calcula um endereço com rotação de banco para uma superfície 2D em blocos. |
| [XGComputeBufferLayout](/pt-BR/reference/graphics/xg__NR/functions/xgcomputebufferlayout) | Calcula o alinhamento de hardware para um buffer. |
| [XGComputeOptimalDepthStencilTileModes](/pt-BR/reference/graphics/xg__NR/functions/xgcomputeoptimaldepthstenciltilemodes) | Calcula os modos de bloco corretos para a configuração de estêncil de profundidade especificada. |
| [XGComputeOptimalTileMode](/pt-BR/reference/graphics/xg__NR/functions/xgcomputeoptimaltilemode) | Calcula o modo de bloco ideal em termos de largura de banda para a configuração de textura especificada. |
| [XGComputeTexture1DLayout](/pt-BR/reference/graphics/xg__NR/functions/xgcomputetexture1dlayout) | Calcula o layout de hardware para uma textura 1D. |
| [XGComputeTexture2DLayout](/pt-BR/reference/graphics/xg__NR/functions/xgcomputetexture2dlayout) | Calcula o layout de hardware para uma textura 2D. |
| [XGComputeTexture3DLayout](/pt-BR/reference/graphics/xg__NR/functions/xgcomputetexture3dlayout) | Calcula o layout de hardware para uma textura 3D. |
| [XGComputeTileShape](/pt-BR/reference/graphics/xg__NR/functions/xgcomputetileshape) | Retorna a forma de um bloco de recurso em bloco único para o formato especificado. |
| [XGCreateTexture1DComputer](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexture1dcomputer) | Cria um objeto de computador de endereço de textura para a descrição especificada de uma textura 1D. |
| [XGCreateTexture2DComputer](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexture2dcomputer) | Cria um objeto de computador de endereço de textura para a descrição especificada de uma textura 2D. |
| [XGCreateTexture3DComputer](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexture3dcomputer) | Cria um objeto de computador de endereço de textura para a descrição de textura 3D especificada. |
| [XGCreateTextureComputer](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexturecomputer) | Cria um objeto de computador de endereço de textura para a descrição de recurso no estilo D3D12 especificada. |
| [XGCreateTextureComputerFromDescriptor](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexturecomputerfromdescriptor) | Cria um objeto de computador de endereço de textura para o descritor de textura especificado. |
| [XGCreateTextureComputerWithPitch](/pt-BR/reference/graphics/xg__NR/functions/xgcreatetexturecomputerwithpitch) | Cria um objeto de computador de endereço de textura para uma descrição de recurso no estilo Direct3D12. |
| [XGDecodeDCC](/pt-BR/reference/graphics/xg__NR/functions/xgdecodedcc) | Decodifica (descompacta) uma superfície compactada com compactação delta de cores. |
| [XGEnableExclusiveLocking](/pt-BR/reference/graphics/xg__NR/functions/xgenableexclusivelocking) | Habilita ou desabilita o bloqueio exclusivo das APIs de cálculo de endereço de textura. |
| [XGEncodeDCC](/pt-BR/reference/graphics/xg__NR/functions/xgencodedcc) | Codifica (compacta) uma superfície usando DCC (Delta Color Compression). |
| [XGEnterExclusiveLock](/pt-BR/reference/graphics/xg__NR/functions/xgenterexclusivelock) | Entra em um bloqueio exclusivo usado para sincronizar chamadas para XGSetHardwareVersion com a criação do computador de textura XG. |
| [XGLeaveExclusiveLock](/pt-BR/reference/graphics/xg__NR/functions/xgleaveexclusivelock) | Sai de um bloqueio exclusivo usado para sincronizar chamadas para XGSetHardwareVersion com a criação do computador de textura XG. |
| [XGSetHardwareVersion](/pt-BR/reference/graphics/xg__NR/functions/xgsethardwareversion) | Configura o XG para a versão de hardware especificada. |
| [XGValidateDepthStencilTileMode](/pt-BR/reference/graphics/xg__NR/functions/xgvalidatedepthstenciltilemode) | Verifica se o modo de bloco especificado é válido para o formato de estêncil de profundidade e a contagem de amostras. |
| [XGValidateJpegFile](/pt-BR/reference/graphics/xg__NR/functions/xgvalidatejpegfile) | Valida um arquivo JPEG para decodificação por hardware. |

## Estruturas

| Estrutura | Descrição | |
| - | - | - |
| [XG\_BUFFER\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_buffer_desc) | Descreve um recurso de buffer. | |
| [XG\_DCC\_OPTIONS](/pt-BR/reference/graphics/xg__NR/structs/xg_dcc_options) | Estabelece as opções de configuração da DCC (Delta Color Compression). | |
|  | [XG\_DESCRIPTOR\_TEXTURE\_VIEW](/pt-BR/reference/graphics/xg__NR/structs/xg_descriptor_texture_view) | Representa um descritor de associação nativo para uma textura. |
| [XG\_MIPLEVEL\_LAYOUT](/pt-BR/reference/graphics/xg__NR/structs/xg_miplevel_layout) | Descreve um único nível de mip no layout de hardware de uma textura. | |
| [XG\_PACKED\_MIP\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_packed_mip_desc) | Descreve a estrutura de blocos de um recurso em blocos com mipmaps. | |
| [XG\_PLANE\_LAYOUT](/pt-BR/reference/graphics/xg__NR/structs/xg_plane_layout) | Descreve uma cadeia de mips no layout de hardware de uma textura. | |
| [XG\_RESOURCE\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_resource_desc) | Descreve um recurso XG. | |
| [XG\_RESOURCE\_LAYOUT](/pt-BR/reference/graphics/xg__NR/structs/xg_resource_layout) | Descreve todo o layout de hardware de um único recurso. | |
| [XG\_SAMPLE\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_sample_desc) | Descreve os parâmetros de multiamostragem de um recurso. | |
| [XG\_SUBRESOURCE\_TILING](/pt-BR/reference/graphics/xg__NR/structs/xg_subresource_tiling) | Controla o tiling de sub-recursos. | |
| [XG\_TEXTURE1D\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_texture1d_desc) | Descreve uma textura 1D para as APIs de layout de textura do XG. | |
| [XG\_TEXTURE2D\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_texture2d_desc) | Descreve uma textura 2D para as APIs de layout de textura do XG. | |
| [XG\_TEXTURE3D\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_texture3d_desc) | Descreve uma textura 3D para as APIs de layout de textura do XG. | |
| [XG\_TILE\_SHAPE\_ELEMENTS](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape_elements) | Armazena a largura, a altura e a profundidade de um bloco, em elementos. | |
| [XG\_TILE\_SHAPE](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape) | Armazena a largura, a altura e a profundidade de um bloco, em texels. | |
| [XG\_VALIDATED\_JPEG\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_validated_jpeg_desc) | Contém os resultados da validação de um fluxo de arquivo JPEG. | |

## Enumerações

| Enumeração | Descrição |
| - | - |
| [XG\_BIND\_FLAG](/pt-BR/reference/graphics/xg__NR/enums/xg_bind_flag) | Especifica como um recurso deve ser associado ao pipeline. |
| [XG\_CPU\_ACCESS\_FLAG](/pt-BR/reference/graphics/xg__NR/enums/xg_cpu_access_flag) | Especifica os tipos de acesso da CPU permitidos para um recurso. |
| [XG\_DCC\_COLOR\_TRANSFORM](/pt-BR/reference/graphics/xg__NR/enums/xg_dcc_color_transform) | Estabelece a transformação de cor realizada antes da DCC (Delta Color Compression). |
| [XG\_DCC\_COMPRESSION\_LEVEL](/pt-BR/reference/graphics/xg__NR/enums/xg_dcc_compression_level) | Estabelece o tamanho máximo da unidade de DCC (Delta Color Compression). |
| [XG\_FORMAT](/pt-BR/reference/graphics/xg__NR/enums/xg_format) | Formatos de dados de recursos, que incluem formatos totalmente tipados e sem tipo. |
| [XG\_HARDWARE\_VERSION](/pt-BR/reference/graphics/xg__NR/enums/xg_hardware_version) | Representa as diferentes versões de hardware na família de dispositivos XBOX One. |
| [XG\_PLANE\_USAGE](/pt-BR/reference/graphics/xg__NR/enums/xg_plane_usage) | Representa o uso pretendido de um plano em um recurso de textura. |
| [XG\_RESOURCE\_DIMENSION](/pt-BR/reference/graphics/xg__NR/enums/xg_resource_dimension) | Identifica o tipo de um recurso. |
| [XG\_RESOURCE\_MISC\_FLAG](/pt-BR/reference/graphics/xg__NR/enums/xg_resource_misc_flag) | Identifica opções para recursos. |
| [XG\_TEXTURE\_LAYOUT](/pt-BR/reference/graphics/xg__NR/enums/xg_texture_layout) | Especifica as opções para um layout de textura. No XBOX, essa enumeração inclui membros de extensão do XBOX. |
| [XG\_TILE\_MODE](/pt-BR/reference/graphics/xg__NR/enums/xg_tile_mode) | Representa o modo de bloco usado por uma textura 1D, 2D ou 3D. Usos especiais de texturas, como buffers de profundidade, de estêncil e apresentáveis, exigem o uso de índices de modo de bloco específicos. |
| [XG\_USAGE](/pt-BR/reference/graphics/xg__NR/enums/xg_usage) | Identifica o uso esperado de recursos durante a renderização. O uso reflete diretamente se um recurso é acessível pela CPU e/ou pela GPU. |
| [XG12\_RESOURCE\_MISC\_FLAG](/pt-BR/reference/graphics/xg__NR/enums/xg12_resource_misc_flag) | Identifica opções para recursos. |


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [Índice de temas de NDA para el desarrollo de consolas con el GDK de XBOX](/es/nda/nda-overview.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [XR-052 Estado do usuário e local de salvamento do título, roaming e dependências](/pt-BR/publishing/certification/xr/xr-052.md)
