estructura de D3DX11_IMAGE_LOAD_INFO

Nota:

La biblioteca de utilidades D3DX (D3DX 9, D3DX 10 y D3DX 11) está en desuso para Windows 8 y no es compatible con las aplicaciones de la Tienda Windows.

Opcionalmente, proporcione información a las API del cargador de texturas para controlar cómo se cargan las texturas. Un valor de D3DX11_DEFAULT para cualquiera de estos parámetros hará que D3DX use automáticamente el valor del archivo de origen.

Sintaxis

typedef struct D3DX11_IMAGE_LOAD_INFO {
  UINT              Width;
  UINT              Height;
  UINT              Depth;
  UINT              FirstMipLevel;
  UINT              MipLevels;
  D3D11_USAGE       Usage;
  UINT              BindFlags;
  UINT              CpuAccessFlags;
  UINT              MiscFlags;
  DXGI_FORMAT       Format;
  UINT              Filter;
  UINT              MipFilter;
  D3DX11_IMAGE_INFO *pSrcInfo;
} D3DX11_IMAGE_LOAD_INFO, *LPD3DX11_IMAGE_LOAD_INFO;

Miembros

Width

Tipo: UINT

Ancho de destino de la textura. Si el ancho real de la textura es mayor o menor que este valor, la textura se escalará o reducirá verticalmente para ajustarse a este ancho de destino.

Height

Tipo: UINT

Alto de destino de la textura. Si el alto real de la textura es mayor o menor que este valor, la textura se escalará o reducirá verticalmente para ajustarse a esta altura de destino.

Profundidad

Tipo: UINT

Profundidad de la textura. Esto solo se aplica a las texturas de volumen.

FirstMipLevel

Tipo: UINT

Nivel de mapa mip de resolución más alto de la textura. Si es mayor que 0, después de cargar la textura FirstMipLevel se asignará al nivel de mapa mip 0.

MipLevels

Tipo: UINT

Número máximo de niveles de mapa mip en la textura. Vea los comentarios en D3D11_TEX1D_SRV. El uso de 0 o D3DX11_DEFAULT hará que se cree una cadena de mapas MIP completa.

Uso

Tipo: D3D11_USAGE

La forma en que se va a usar el recurso de textura. Consulte D3D11_USAGE.

BindFlags

Tipo: UINT

Las fases de canalización a las que se podrá enlazar la textura. Consulte D3D11_BIND_FLAG.

CpuAccessFlags

Tipo: UINT

Los permisos de acceso que tendrá la CPU para el recurso de textura. Consulte D3D11_CPU_ACCESS_FLAG.

MiscFlags

Tipo: UINT

Propiedades de recursos varios (consulte D3D11_RESOURCE_MISC_FLAG).

Formato

Tipo: DXGI_FORMAT

Enumeración DXGI_FORMAT que indica el formato en el que se encontrará la textura después de cargarla.

Filter

Tipo: UINT

Filtre la textura mediante el filtro especificado (solo cuando se vuelva a muestrear). Consulte D3DX11_FILTER_FLAG.

MipFilter

Tipo: UINT

Filtre los niveles mip de textura mediante el filtro especificado (solo si genera mapas MIP). Los valores válidos son D3DX11_FILTER_NONE, D3DX11_FILTER_POINT, D3DX11_FILTER_LINEAR o D3DX11_FILTER_TRIANGLE. Consulte D3DX11_FILTER_FLAG.

pSrcInfo

Tipo: D3DX11_IMAGE_INFO*

Información sobre la imagen original. Consulte D3DX11_IMAGE_INFO. Se puede obtener con D3DX11GetImageInfoFromFile, D3DX11GetImageInfoFromMemory o D3DX11GetImageInfoFromResource.

Comentarios

Al inicializar la estructura, puede establecer cualquier miembro en D3DX11_DEFAULT y D3DX lo inicializará con un valor predeterminado de la textura de origen cuando se cargue la textura.

Esta estructura se puede usar en las API que:

• Cree recursos, como D3DX11CreateTextureFromFile y D3DX11CreateShaderResourceViewFromFile.
• Cree procesadores de datos, como D3DX11CreateAsyncTextureInfoProcessor o D3DX11CreateAsyncShaderResourceViewProcessor.

Los valores predeterminados son:

    Width = D3DX11_DEFAULT;
    Height = D3DX11_DEFAULT;
    Depth = D3DX11_DEFAULT;
    FirstMipLevel = D3DX11_DEFAULT;
    MipLevels = D3DX11_DEFAULT;
    Usage = (D3D11_USAGE) D3DX11_DEFAULT;
    BindFlags = D3DX11_DEFAULT;
    CpuAccessFlags = D3DX11_DEFAULT;
    MiscFlags = D3DX11_DEFAULT;
    Format = DXGI_FORMAT_FROM_FILE;
    Filter = D3DX11_DEFAULT;
    MipFilter = D3DX11_DEFAULT;
    pSrcInfo = NULL;

Este es un breve ejemplo que usa esta estructura para proporcionar el formato de píxel al cargar una textura. Para obtener el código completo, consulta HDRFormats10.cpp en HDRToneMappingCS11 Sample.

ID3D11ShaderResourceView* pCubeRV = NULL;
WCHAR strPath[MAX_PATH];
D3DX11_IMAGE_LOAD_INFO LoadInfo;

    DXUTFindDXSDKMediaFileCch( strPath, MAX_PATH, 
        L"Light Probes\\uffizi_cross.dds" );

    LoadInfo.Format = DXGI_FORMAT_R16G16B16A16_FLOAT;

    hr = D3DX11CreateShaderResourceViewFromFile( pd3dDevice, strPath, 
        &LoadInfo, NULL, &pCubeRV, NULL );

Requisitos

Requisito	Value
Encabezado	D3DX11tex.h

Consulte también

Estructuras D3DX