org.lwjgl.vulkan.KHRXlibSurface Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of lwjgl-vulkan Show documentation
Show all versions of lwjgl-vulkan Show documentation
A new generation graphics and compute API that provides high-efficiency, cross-platform access to modern GPUs used in a wide variety of devices from PCs and consoles to mobile phones and embedded platforms.
/*
* Copyright LWJGL. All rights reserved.
* License terms: https://www.lwjgl.org/license
* MACHINE GENERATED FILE, DO NOT EDIT
*/
package org.lwjgl.vulkan;
import javax.annotation.*;
import java.nio.*;
import org.lwjgl.system.*;
import static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryUtil.*;
/**
* The {@code VK_KHR_xlib_surface} extension is an instance extension. It provides a mechanism to create a {@code VkSurfaceKHR} object (defined by the {@link KHRSurface VK_KHR_surface} extension) that refers to an X11 {@code Window}, using the Xlib client-side library, as well as a query to determine support for rendering via Xlib.
*
*
* - Name String
* - {@code VK_KHR_xlib_surface}
* - Extension Type
* - Instance extension
* - Registered Extension Number
* - 5
* - Revision
* - 6
* - Extension and Version Dependencies
*
* - Requires Vulkan 1.0
* - Requires {@link KHRSurface VK_KHR_surface}
*
* - Contact
*
* - Jesse Hall @jessehall,Ian Elliott mailto:[email protected][[email protected]]
*
* - Last Modified Date
* - 2015-11-28
* - IP Status
* - No known IP claims.
* - Contributors
*
* - Patrick Doane, Blizzard
* - Jason Ekstrand, Intel
* - Ian Elliott, LunarG
* - Courtney Goeltzenleuchter, LunarG
* - Jesse Hall, Google
* - James Jones, NVIDIA
* - Antoine Labour, Google
* - Jon Leech, Khronos
* - David Mao, AMD
* - Norbert Nopper, Freescale
* - Alon Or-bach, Samsung
* - Daniel Rakos, AMD
* - Graham Sellers, AMD
* - Ray Smith, ARM
* - Jeff Vigil, Qualcomm
* - Chia-I Wu, LunarG
*
*
*/
public class KHRXlibSurface {
/** The extension specification version. */
public static final int VK_KHR_XLIB_SURFACE_SPEC_VERSION = 6;
/** The extension name. */
public static final String VK_KHR_XLIB_SURFACE_EXTENSION_NAME = "VK_KHR_xlib_surface";
/** Extends {@code VkStructureType}. */
public static final int VK_STRUCTURE_TYPE_XLIB_SURFACE_CREATE_INFO_KHR = 1000004000;
protected KHRXlibSurface() {
throw new UnsupportedOperationException();
}
static boolean isAvailable(VKCapabilitiesInstance caps) {
return checkFunctions(
caps.vkCreateXlibSurfaceKHR, caps.vkGetPhysicalDeviceXlibPresentationSupportKHR
);
}
// --- [ vkCreateXlibSurfaceKHR ] ---
/** Unsafe version of: {@link #vkCreateXlibSurfaceKHR CreateXlibSurfaceKHR} */
public static int nvkCreateXlibSurfaceKHR(VkInstance instance, long pCreateInfo, long pAllocator, long pSurface) {
long __functionAddress = instance.getCapabilities().vkCreateXlibSurfaceKHR;
if (CHECKS) {
check(__functionAddress);
VkXlibSurfaceCreateInfoKHR.validate(pCreateInfo);
if (pAllocator != NULL) { VkAllocationCallbacks.validate(pAllocator); }
}
return callPPPPI(__functionAddress, instance.address(), pCreateInfo, pAllocator, pSurface);
}
/**
* Create a {@code VkSurfaceKHR} object for an X11 window, using the Xlib client-side library.
*
* C Specification
*
* To create a {@code VkSurfaceKHR} object for an X11 window, using the Xlib client-side library, call:
*
*
* VkResult vkCreateXlibSurfaceKHR(
* VkInstance instance,
* const VkXlibSurfaceCreateInfoKHR* pCreateInfo,
* const VkAllocationCallbacks* pAllocator,
* VkSurfaceKHR* pSurface);
*
* Valid Usage (Implicit)
*
*
* - {@code instance} must be a valid {@code VkInstance} handle
* - {@code pCreateInfo} must be a valid pointer to a valid {@link VkXlibSurfaceCreateInfoKHR} structure
* - If {@code pAllocator} is not {@code NULL}, {@code pAllocator} must be a valid pointer to a valid {@link VkAllocationCallbacks} structure
* - {@code pSurface} must be a valid pointer to a {@code VkSurfaceKHR} handle
*
*
* Return Codes
*
*
* - On success, this command returns
*
* - {@link VK10#VK_SUCCESS SUCCESS}
*
* - On failure, this command returns
*
* - {@link VK10#VK_ERROR_OUT_OF_HOST_MEMORY ERROR_OUT_OF_HOST_MEMORY}
* - {@link VK10#VK_ERROR_OUT_OF_DEVICE_MEMORY ERROR_OUT_OF_DEVICE_MEMORY}
*
*
*
* See Also
*
* {@link VkAllocationCallbacks}, {@link VkXlibSurfaceCreateInfoKHR}
*
* @param instance the instance to associate the surface with.
* @param pCreateInfo a pointer to an instance of the {@link VkXlibSurfaceCreateInfoKHR} structure containing the parameters affecting the creation of the surface object.
* @param pAllocator the allocator used for host memory allocated for the surface object when there is no more specific allocator available (see Memory Allocation).
* @param pSurface points to a {@code VkSurfaceKHR} handle in which the created surface object is returned.
*/
@NativeType("VkResult")
public static int vkCreateXlibSurfaceKHR(VkInstance instance, @NativeType("const VkXlibSurfaceCreateInfoKHR *") VkXlibSurfaceCreateInfoKHR pCreateInfo, @Nullable @NativeType("const VkAllocationCallbacks *") VkAllocationCallbacks pAllocator, @NativeType("VkSurfaceKHR *") LongBuffer pSurface) {
if (CHECKS) {
check(pSurface, 1);
}
return nvkCreateXlibSurfaceKHR(instance, pCreateInfo.address(), memAddressSafe(pAllocator), memAddress(pSurface));
}
// --- [ vkGetPhysicalDeviceXlibPresentationSupportKHR ] ---
/**
* Query physical device for presentation to X11 server using Xlib.
*
* C Specification
*
* To determine whether a queue family of a physical device supports presentation to an X11 server, using the Xlib client-side library, call:
*
*
* VkBool32 vkGetPhysicalDeviceXlibPresentationSupportKHR(
* VkPhysicalDevice physicalDevice,
* uint32_t queueFamilyIndex,
* Display* dpy,
* VisualID visualID);
*
* Description
*
* This platform-specific function can be called prior to creating a surface.
*
* Valid Usage
*
*
* - {@code queueFamilyIndex} must be less than {@code pQueueFamilyPropertyCount} returned by {@link VK10#vkGetPhysicalDeviceQueueFamilyProperties GetPhysicalDeviceQueueFamilyProperties} for the given {@code physicalDevice}
*
*
* Valid Usage (Implicit)
*
*
* - {@code physicalDevice} must be a valid {@code VkPhysicalDevice} handle
* - {@code dpy} must be a valid pointer to a {@code Display} value
*
*
* @param physicalDevice the physical device.
* @param queueFamilyIndex the queue family index.
* @param dpy a pointer to an Xlib {@code Display} connection to the server.
* @param visualID
*/
@NativeType("VkBool32")
public static boolean vkGetPhysicalDeviceXlibPresentationSupportKHR(VkPhysicalDevice physicalDevice, @NativeType("uint32_t") int queueFamilyIndex, @NativeType("Display *") long dpy, @NativeType("VisualID") long visualID) {
long __functionAddress = physicalDevice.getCapabilities().vkGetPhysicalDeviceXlibPresentationSupportKHR;
if (CHECKS) {
check(__functionAddress);
check(dpy);
}
return callPPPI(__functionAddress, physicalDevice.address(), queueFamilyIndex, dpy, visualID) != 0;
}
/** Array version of: {@link #vkCreateXlibSurfaceKHR CreateXlibSurfaceKHR} */
@NativeType("VkResult")
public static int vkCreateXlibSurfaceKHR(VkInstance instance, @NativeType("const VkXlibSurfaceCreateInfoKHR *") VkXlibSurfaceCreateInfoKHR pCreateInfo, @Nullable @NativeType("const VkAllocationCallbacks *") VkAllocationCallbacks pAllocator, @NativeType("VkSurfaceKHR *") long[] pSurface) {
long __functionAddress = instance.getCapabilities().vkCreateXlibSurfaceKHR;
if (CHECKS) {
check(__functionAddress);
check(pSurface, 1);
VkXlibSurfaceCreateInfoKHR.validate(pCreateInfo.address());
if (pAllocator != null) { VkAllocationCallbacks.validate(pAllocator.address()); }
}
return callPPPPI(__functionAddress, instance.address(), pCreateInfo.address(), memAddressSafe(pAllocator), pSurface);
}
}