VkPresentGravityFlagBitsEXT(3)

# VkPresentGravityFlagBitsEXT(3) Manual Page

## Name

VkPresentGravityFlagBitsEXT - Bitmask specifying presentation pixel gravity on either the x or y axis

Loading… please wait.

## C Specification

Bits which may be set in the VkSurfacePresentScalingCapabilitiesEXT::`supportedPresentGravityX` or `supportedPresentGravityY` fields, specifying the gravity of presented pixels supported by the surface, are:

    // Provided by VK_EXT_surface_maintenance1
    typedef enum VkPresentGravityFlagBitsEXT {
        VK_PRESENT_GRAVITY_MIN_BIT_EXT = 0x00000001,
        VK_PRESENT_GRAVITY_MAX_BIT_EXT = 0x00000002,
        VK_PRESENT_GRAVITY_CENTERED_BIT_EXT = 0x00000004,
    } VkPresentGravityFlagBitsEXT;

## Description

- `VK_PRESENT_GRAVITY_MIN_BIT_EXT` means that the pixels will gravitate towards the top or left side of the surface.

- `VK_PRESENT_GRAVITY_MAX_BIT_EXT` means that the pixels will gravitate towards the bottom or right side of the surface.

- `VK_PRESENT_GRAVITY_CENTERED_BIT_EXT` means that the pixels will be centered in the surface.

If the value in VkSurfaceCapabilitiesKHR::`currentTransform` is not `VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR`, it is implementation-defined whether the gravity configuration applies to the presented image before or after transformation.

## See Also

VK_EXT_surface_maintenance1, VkPresentGravityFlagsEXT

## Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0