Vulkan-Docs/doc/specs/vulkan/man/vkCreateGraphicsPipelines.txt

69 lines
2.0 KiB
Plaintext

// Copyright (c) 2014-2016 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/
vkCreateGraphicsPipelines(3)
============================
Name
----
vkCreateGraphicsPipelines - Create graphics pipelines.
C Specification
---------------
// refBegin vkCreateGraphicsPipelines Create graphics pipelines.
To create graphics pipelines, call:
include::../protos/vkCreateGraphicsPipelines.txt[]
Parameters
----------
* pname:device is the logical device that creates the graphics pipelines.
* pname:pipelineCache is either dlink:VK_NULL_HANDLE, indicating that
pipeline caching is disabled; or the handle of a valid
<<pipelines-cache,pipeline cache>> object, in which case use of that
cache is enabled for the duration of the command.
* pname:createInfoCount is the length of the pname:pCreateInfos and
pname:pPipelines arrays.
* pname:pCreateInfos is an array of sname:VkGraphicsPipelineCreateInfo
structures.
* pname:pAllocator controls host memory allocation as described in the
<<memory-allocation, Memory Allocation>> chapter.
* pname:pPipelines is a pointer to an array in which the resulting
graphics pipeline objects are returned.
Description
-----------
The slink:VkGraphicsPipelineCreateInfo structure includes an array of shader
create info structures containing all the desired active shader stages, as
well as creation info to define all relevant fixed-function stages, and a
pipeline layout.
include::../validity/protos/vkCreateGraphicsPipelines.txt[]
See Also
--------
slink:VkAllocationCallbacks, slink:VkDevice, slink:VkGraphicsPipelineCreateInfo, slink:VkPipeline, slink:VkPipelineCache
Document Notes
--------------
For more information, see the Vulkan Specification at URL
https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#vkCreateGraphicsPipelines
This page is extracted from the Vulkan Specification.
Fixes and changes should be made to the Specification,not directly.
include::footer.txt[]