Оверлейные функции
Поддержка оверлеев в DirectDrawSurface представлена следующими функциями:
- AddOverlayDirtyRect()
- EnumOverlayZOrder()
- GetOverlayPosition()
- SetOverlayPosition()
- UpdateOverlay()
- UpdateOverlayDisplay()
- UpdateOverlayZOrder()
Функции GetOverlayPosition() и SetOverlayPosition() управляют положением оверлеев. Функция UpdateOverlay() изменяет параметры оверлея; в частности, она определяет, должен ли оверлей отображаться на экране и следует ли применять для него альфа-наложение или копирование с цветовым ключом.
Функция UpdateOverlayDisplay() обновляет изображение с учетом новых значений параметров. Данная функция может обновить все изображение оверлея или ограничиться его прямоугольными областями, заданными функцией AddOverlayDirtyRect(). Наконец, функция EnumOverlayZOrders() используется для перебора оверлеев в порядке их Z-координаты (Z-координата определяет, какие оверлеи выводятся поверх других). Возможен перебор как в прямом порядке (от передних оверлеев к задним), так и в обратном (от задних — к передним).