Функция D3DXCreateTextureFromResourceEx
Создает текстуру на основе ресурса. Это более расширенная функция, чем D3DXCreateTextureFromResource.
Синтаксис
HRESULT D3DXCreateTextureFromResourceEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_In_ DWORD Filter,
_In_ DWORD MipFilter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo,
_Out_ PALETTEENTRY *pPalette,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
Параметры
-
pDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой.
-
hSrcModule [in]
-
Тип: HMODULE
Дескриптор для модуля, в котором находится ресурс, или значение NULL для модуля, связанного с образом, используемым операционной системой для создания текущего процесса.
-
pSrcResource [in]
-
Тип: LPCTSTR
Указатель на строку, указывающую имя ресурса. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.
-
Ширина [in]
-
Тип: UINT
Ширина в пикселях. Если это значение равно нулю или D3DX_DEFAULT, измерения берутся из файла.
-
Высота [in]
-
Тип: UINT
Высота в пикселях. Если это значение равно нулю или D3DX_DEFAULT, измерения берутся из файла.
-
MipLevels [in]
-
Тип: UINT
Количество запрошенных уровней MIP. Если это значение равно нулю или D3DX_DEFAULT, создается полная цепочка MIP-карты.
-
Использование [в]
-
Тип: DWORD
0, D3DUSAGE_RENDERTARGET или D3DUSAGE_DYNAMIC. Установка этого флага D3DUSAGE_RENDERTARGET означает, что поверхность будет использоваться в качестве целевого объекта отрисовки. Затем ресурс можно передать в параметр pNewRenderTarget метода SetRenderTarget . Если указан параметр D3DUSAGE_RENDERTARGET или D3DUSAGE, для пула должно быть задано значение D3DPOOL_DEFAULT, а приложение должно проверка, что устройство поддерживает эту операцию, вызвав CheckDeviceFormat. D3DUSAGE_DYNAMIC указывает, что поверхность должна обрабатываться динамически. Дополнительные сведения об использовании динамических текстур см. в статье Оптимизация производительности (Direct3D 9)Использование динамических текстур.
-
Формат [in]
-
Тип: D3DFORMAT
Член перечисленного типа D3DFORMAT , описывающий запрошенный формат пикселей для текстуры. Возвращаемая текстура может иметь формат, отличный от формата, заданного параметром Format. Приложения должны проверка формат возвращаемой текстуры. Если D3DFMT_UNKNOWN, формат берется из файла. Если D3DFMT_FROM_FILE, формат принимается точно так же, как в файле, и вызов завершится ошибкой, если это нарушает возможности устройства.
-
Пул [в]
-
Тип: D3DPOOL
Член перечисленного типа D3DPOOL , описывающий класс памяти, в который должна быть помещена текстура.
-
Фильтр [в]
-
Тип: DWORD
Сочетание одного или нескольких D3DX_FILTER управления фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
MipFilter [in]
-
Тип: DWORD
Сочетание одного или нескольких D3DX_FILTER управления фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_BOX.
-
ColorKey [in]
-
Тип: D3DCOLOR
Значение D3DCOLOR для замены прозрачным черным цветом или значение 0 для отключения клавиши colorkey. Это всегда 32-разрядный цвет ARGB, независимо от формата исходного изображения. Альфа имеет важное значение, и для непрозрачных цветовых ключей обычно должно быть задано значение FF. Таким образом, для непрозрачного черного цвета значение будет равно 0xFF000000.
-
pSrcInfo [вход, выход]
-
Тип: D3DXIMAGE_INFO*
Указатель на D3DXIMAGE_INFO структуру, заполняемую описанием данных в исходном файле изображения или значением NULL.
-
pPalette [out]
-
Тип: PALETTEENTRY*
Указатель на структуру PALETTEENTRY , представляющую 256-цветовую палитру для заполнения или значение NULL.
-
ppTexture [out]
-
Тип: LPDIRECT3DTEXTURE9*
Адрес указателя на интерфейс IDirect3DTexture9 , представляющий созданный объект текстуры.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. В случае сбоя функции возвращается одно из следующих значений: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Комментарии
Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXCreateTextureFromResourceExW. В противном случае вызов функции разрешается в D3DXCreateTextureFromResourceExA, так как используются строки ANSI.
Загружаемый ресурс должен иметь тип RT_BITMAP или RT_RCDATA. Тип ресурса RT_RCDATA используется для загрузки форматов, отличных от растровых изображений (например, TGA, .jpg и DDS).
Эта функция поддерживает следующие форматы файлов: .bmp, DDS, DIB, HDR, .jpg, PFM, .png, PPM и TGA. См . D3DXIMAGE_FILEFORMAT.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел