Метод IDirect3DDevice9::SetPaletteEntries (d3d9helper.h)

Статья
08/23/2023

Задает записи палитры.

Синтаксис

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

Параметры

[in] PaletteNumber

Тип: UINT

Порядковое значение, определяющее конкретную палитру, на которой должна выполняться операция.

[in] pEntries

Тип: const PALETTEENTRY*

Указатель на структуру PALETTEENTRY , представляющую элементы палитры для задания. Предполагается, что число структур PALETTEENTRY , на которые указывает pEntries, составляет 256. См. заметки.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL.

Для приложений Direct3D 9 любая палитра, отправляемая в этот метод, должна соответствовать D3DPTEXTURECAPS_ALPHAPALETTE биту возможностей структуры D3DCAPS9 . Если D3DPTEXTURECAPS_ALPHAPALETTE не задан, для каждой записи в палитре должна быть задана альфа-версия 1.0, иначе этот метод завершится ошибкой с D3DERR_INVALIDCALL. Если задано D3DPTEXTURECAPS_ALPHAPALETTE, разрешен любой набор альфа-значений. Обратите внимание, что среда выполнения отладки выведет предупреждающее сообщение, если для всех записей палитры задано значение 0.

Одна логическая палитра связана с устройством и используется всеми этапами текстуры.