Эффект "Атлас"
Этот эффект можно использовать для вывода части изображения, но сохранить область за пределами части для использования в последующих операциях.
CLSID для этого эффекта CLSID_D2D1Atlas.
Эффект атласа полезен, если требуется загрузить большое изображение, состоящее из множества небольших изображений, таких как различные кадры спрайта.
Чтобы создать результат, выполните следующие действия:
- Обрезает входные данные для заданного свойства InputRect .
- Преобразует источник результата в (0,0).
Примечание
Свойство InputPaddingRect должно быть больше, только если пиксели между двумя прямоугольниками являются прозрачными черными на входе. Это может привести к более оптимальному выполнению графа в Direct2D.
Ниже приведен пример эффекта. Это изображение небольшое и простое в целях иллюстрации.
Предыдущее изображение является входным элементом для эффекта. Код здесь создает эффект атласа, задает входные данные, задает входной прямоугольник, а затем рисует выходные данные.
ComPtr<ID2D1Effect> atlasEffect;
// Create the Atlas Effect.
DX::ThrowIfFailed(m_d2dContext->CreateEffect(CLSID_D2D1Atlas, &atlasEffect));
// Set the input.
atlasEffect->SetInputEffect(0, inputImage.Get());
// The images here are 150 x 150 pixels.
float size = 150.0f;
// Compensate for the padding between images.
float padding = 10.0f;
// The input rectangle. 150 x 150 pixels with 10 pixel padding
D2D1_Vector_4F inputRect = D2D1::Vector4F(size + (padding * 2), padding, size, size);
DX::ThrowIfFailed(atlasEffect->SetValue(D2D1_ATLAS_PROP_INPUT_RECT, inputRect));
// Draw the image
m_d2dContext->DrawImage(atlasEffect.Get());
В приведенном выше коде выбирается прямоугольник, который находится вокруг второго треугольника. Заполнение вокруг нее игнорируется. Вот результирующее изображение.
Примечание
Это ситуация, когда вы можете указать InputPaddingRect , так как заполнение является прозрачным черным. Прямоугольник будет иметь значение D2D1::Vector4F(size + (padding * 2), 0, size + padding, size + padding);
.
Отображаемое перечисление имен и индексов | Описание |
---|---|
InputRect D2D1_ATLAS_PROP_INPUT_RECT |
Часть изображения, переданная следующему эффекту. Тип D2D1_VECTOR_4F. Значение по умолчанию — (-FLT_MAX, -FLT_MAX, FLT_MAX, FLT_MAX). |
InputPaddingRect D2D1_ATLAS_PROP_INPUT_PADDING_RECT |
Максимальный размер выборки для выходного прямоугольника. Тип D2D1_VECTOR_4F. Значение по умолчанию — (-FLT_MAX, -FLT_MAX, FLT_MAX, FLT_MAX). |
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения Магазина Windows] |
Минимальная версия сервера | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения Магазина Windows] |
Заголовок | d2d1effects.h |
Библиотека | d2d1.lib, dxguid.lib |