структура D3DX11_IMAGE_LOAD_INFO

Примечание

Библиотека служебной программы D3DX (D3DX 9, D3DX 10 и D3DX 11) является устаревшей для Windows 8 и не поддерживается для приложений Магазина Windows.

При необходимости предоставьте сведения API-интерфейсам загрузчика текстур для управления загрузкой текстур. Значение D3DX11_DEFAULT для любого из этих параметров приведет к автоматическому использованию D3DX значения из исходного файла.

Синтаксис

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;

Члены

Width

Тип: UINT

Целевая ширина текстуры. Если фактическая ширина текстуры больше или меньше этого значения, текстура будет масштабироваться вверх или вниз в соответствии с этой целевой шириной.

Height

Тип: UINT

Целевая высота текстуры. Если фактическая высота текстуры больше или меньше этого значения, текстура будет масштабироваться вверх или вниз в соответствии с этой целевой высотой.

Depth

Тип: UINT

Глубина текстуры. Это относится только к текстурам тома.

FirstMipLevel

Тип: UINT

Максимальный уровень MIP-карты текстуры. Если значение больше 0, то после загрузки текстуры FirstMipLevel будет сопоставлен с уровнем MIP-карты 0.

MipLevels

Тип: UINT

Максимальное количество уровней MIP-карты в текстуре. См. примечания в D3D11_TEX1D_SRV. Использование 0 или D3DX11_DEFAULT приведет к созданию полной цепочки MIP-карты.

Использование

Тип: D3D11_USAGE

Способ использования ресурса текстуры. См . D3D11_USAGE.

BindFlags

Тип: UINT

Этапы конвейера, к которым будет разрешена привязка текстуры. См . D3D11_BIND_FLAG.

CpuAccessFlags

Тип: UINT

Разрешения на доступ ЦП будут иметь для ресурса текстуры. См . D3D11_CPU_ACCESS_FLAG.

MiscFlags

Тип: UINT

Прочие свойства ресурса (см . D3D11_RESOURCE_MISC_FLAG).

Формат

Тип: DXGI_FORMAT

Перечисление DXGI_FORMAT , указывающее формат текстуры после загрузки.

Фильтр

Тип: UINT

Отфильтруйте текстуру с помощью указанного фильтра (только при повторной выборке). См . D3DX11_FILTER_FLAG.

MipFilter

Тип: UINT

Отфильтруйте уровни текстуры MIP с помощью указанного фильтра (только при создании MIP-карт). Допустимые значения: D3DX11_FILTER_NONE, D3DX11_FILTER_POINT, D3DX11_FILTER_LINEAR или D3DX11_FILTER_TRIANGLE. См . D3DX11_FILTER_FLAG.

pSrcInfo

Тип: D3DX11_IMAGE_INFO*

Сведения об исходном изображении. См . D3DX11_IMAGE_INFO. Можно получить с помощью D3DX11GetImageInfoFromFile, D3DX11GetImageInfoFromMemory или D3DX11GetImageInfoFromResource.

Комментарии

При инициализации структуры вы можете задать для любого члена значение D3DX11_DEFAULT и D3DX инициализирует его значением по умолчанию из исходной текстуры при загрузке текстуры.

Эту структуру могут использовать API, которые:

• Создание ресурсов, таких как D3DX11CreateTextureFromFile и D3DX11CreateShaderResourceViewFromFile.
• Создание обработчиков данных, таких как D3DX11CreateAsyncTextureInfoProcessor или D3DX11CreateAsyncShaderResourceViewProcessor.

Значения по умолчанию:

    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;

Ниже приведен краткий пример, в котором эта структура используется для предоставления формата пикселей при загрузке текстуры. Полный код см. в разделе HDRFormats10.cpp в примере HDRToneMappingCS11.

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 );

Требования

Требование	Значение
Заголовок	D3DX11tex.h

См. также раздел

Структуры D3DX