Lines Matching refs:queries
5 [[queries]] anchor
13 <<queries-pools, Query Pool>>.
14 The state of these queries can: be read back on the host, or copied to a
17 The supported query types are <<queries-occlusion,Occlusion Queries>>,
18 <<queries-pipestats,Pipeline Statistics Queries>>,
20 <<queries-result-status-only, Result Status Queries>>,
23 <<queries-video-encode-feedback, Video Encode Feedback Queries>>
25 and <<queries-timestamps, Timestamp Queries>>.
27 <<queries-performance, Performance Queries>> are supported if the associated
31 <<queries-transform-feedback, Transform Feedback Queries>> are supported if
35 <<queries-performance-intel>> are supported if the associated extension is
39 <<queries-mesh-shader, Mesh Shader Queries>> are supported if the associated
44 Several additional queries with specific purposes associated with ray
50 [[queries-pools]]
56 Each query pool is a collection of a specific number of queries of a
77 structure containing the number and type of queries to be managed by the
107 queries managed by the pool.
108 * pname:queryCount is the number of queries managed by the pool.
111 returned in queries on the new pool, as described below in
112 <<queries-pipestats>>.
255 queries that are used in command buffers submitted for execution.
263 [open,refpage='VkQueryType',desc='Specify the type of queries managed by a query pool',type='enums']
266 the type of queries managed by the pool, are:
270 * ename:VK_QUERY_TYPE_OCCLUSION specifies an <<queries-occlusion,
272 * ename:VK_QUERY_TYPE_PIPELINE_STATISTICS specifies a <<queries-pipestats,
274 * ename:VK_QUERY_TYPE_TIMESTAMP specifies a <<queries-timestamps,
278 <<queries-performance, performance query>>.
282 <<queries-transform-feedback, transform feedback query>>.
286 <<queries-primitives-generated, primitives generated query>>.
313 <<queries-performance-intel, Intel performance query>>.
317 <<queries-result-status-only, result status query>>.
321 <<queries-video-encode-feedback, video encode feedback query>>.
325 <<queries-mesh-shader, generated mesh primitives query>>.
330 [[queries-operation]]
333 The operation of queries is controlled by the commands
382 [open,refpage='vkCmdResetQueryPool',desc='Reset queries in a query pool',type='protos']
384 To reset a range of queries in a query pool on a queue, call:
390 * pname:queryPool is the handle of the query pool managing the queries
393 * pname:queryCount is the number of queries to reset.
403 includes all commands which reference the queries in pname:queryPool
408 includes all commands which reference the queries in pname:queryPool
427 queries, applications must not record a fname:vkCmdResetQueryPool command
431 Otherwise applications will never be able to complete the recorded queries.
439 pname:firstQuery must: be less than the number of queries in
443 equal to the number of queries in pname:queryPool
445 All queries used by the command must: not be active
452 of queries [eq]#[pname:firstQuery, pname:firstQuery {plus}
461 [open,refpage='vkResetQueryPool',desc='Reset queries in a query pool',type='protos',alias='vkResetQ…
463 To reset a range of queries in a query pool on the host, call:
476 * pname:queryPool is the handle of the query pool managing the queries
479 * pname:queryCount is the number of queries to reset.
496 pname:firstQuery must: be less than the number of queries in
500 equal to the number of queries in pname:queryPool
505 The range of queries specified by pname:firstQuery and pname:queryCount
514 Once queries are reset and ready for use, query commands can: be issued to a
516 Occlusion queries and pipeline statistics queries count events - drawn
521 Timestamp queries write timestamps to a query pool.
523 Performance queries record performance counters to a query pool.
541 If queries are used while executing a render pass instance that has
545 How the numerical results of the query are distributed among the queries is
549 the first query and write zero to the other queries.
550 However, the sum of the results in all the queries must: accurately reflect
552 Applications can: sum the results from all the queries to compute the total
581 constraints on the types of queries that can: be performed.
586 This is described in more detail in <<queries-occlusion,Occlusion Queries>>.
593 [[queries-operation-active]]
603 * [[queries-operation-active-query-index]] The _active_query_index_ is set
605 * [[queries-operation-last-activatable-query-index]] The _last activatable
628 includes all commands which reference the queries in pname:queryPool
633 includes all commands which reference the queries in pname:queryPool
645 differs from that of any queries that are
646 <<queries-operation-active,active>> within pname:commandBuffer
700 constraints on the types of queries that can: be performed.
716 includes all commands which reference the queries in pname:queryPool
721 includes all commands which reference the queries in pname:queryPool
733 of another <<queries-operation-active,active>> query within
796 constraints on the types of queries that can: be performed, are:
801 <<queries-occlusion, occlusion queries>>.
835 includes all commands which reference the queries in pname:queryPool
851 All queries used by the command must: be
852 <<queries-operation-active,active>>
854 pname:query must: be less than the number of queries in pname:queryPool
863 mask must: be less than or equal to the number of queries in
916 includes all commands which reference the queries in pname:queryPool
926 All queries used by the command must: be
927 <<queries-operation-active,active>>
929 pname:query must: be less than the number of queries in pname:queryPool
939 queries in pname:queryPool
970 [[queries-operation-memorylayout]]
979 * Occlusion queries, pipeline statistics queries,
981 transform feedback queries,
984 primitives generated queries,
987 mesh shader queries,
990 video encode feedback queries,
992 and timestamp queries store results in a tightly packed array of
997 * Performance queries store results in a tightly packed array whose type
1014 * Occlusion queries write one integer value - the number of samples
1016 Pipeline statistics queries write one integer value for each bit that is
1020 Timestamp queries write one integer value.
1022 Performance queries write one slink:VkPerformanceCounterResultKHR value
1026 Transform feedback queries write two integers; the first integer is the
1038 Primitives generated queries write the number of primitives output to
1043 queries if transform feedback is active.
1046 Mesh shader queries write a single integer.
1049 Video encode feedback queries write one or more integer values for each
1054 <<queries-video-encode-feedback,here>>.
1060 [open,refpage='vkGetQueryPoolResults',desc='Copy results of queries in a query pool to a host memor…
1064 To retrieve status and results for a set of queries, call:
1069 * pname:queryPool is the query pool managing the queries containing the
1072 * pname:queryCount is the number of queries to read.
1078 queries within pname:pData.
1083 <<queries-operation-memorylayout,a layout dependent on the query type>>.
1085 If no bits are set in pname:flags, and all requested queries are in the
1088 Behavior when not all queries are available is described
1089 <<queries-wait-bit-not-set, below>>.
1092 queries in pname:queryPool identified by pname:firstQuery and
1105 If ename:VK_QUERY_RESULT_WITH_STATUS_BIT_KHR is set, results for all queries
1140 values for all queries are written as an array of 64-bit values.
1161 queries.
1175 [[queries-wait-bit-not-set]]
1177 may: return ename:VK_NOT_READY if there are queries in the unavailable
1218 reset queries at the end of the frame in which they are read.
1226 All queries used by the command must: not be uninitialized
1228 pname:firstQuery must: be less than the number of queries in
1262 equal to the number of queries in pname:queryPool
1265 query, as described <<queries-operation-memorylayout,here>>
1320 See <<queries-result-status-only, result status query>> for information
1357 [open,refpage='vkCmdCopyQueryPoolResults',desc='Copy the results of queries in a query pool to a bu…
1366 * pname:queryPool is the query pool managing the queries containing the
1369 * pname:queryCount is the number of queries.
1371 queries.
1376 queries within pname:dstBuffer.
1383 <<queries-operation-memorylayout,a layout dependent on the query type>>.
1389 queries in pname:queryPool identified by pname:firstQuery and
1397 If ename:VK_QUERY_RESULT_WITH_STATUS_BIT_KHR is set, results for all queries
1420 values for all queries are written as an array of 64-bit values.
1443 includes all commands which reference the queries in pname:queryPool
1457 includes all commands which reference the queries in pname:queryPool
1472 All queries used by the command must: not be uninitialized when the
1477 pname:firstQuery must: be less than the number of queries in
1481 equal to the number of queries in pname:queryPool
1491 <<queries-operation-memorylayout,here>>
1538 All queries used by the command must: not be active
1540 All queries used by the command must: have been made _available_ by
1547 [[queries-operation-undefined]]
1549 operations, and blits may: count towards the results of queries.
1556 [[queries-occlusion]]
1559 Occlusion queries track the number of samples that pass the per-fragment
1561 As such, occlusion queries are only available on queue families supporting
1608 [[queries-pipestats]]
1611 Pipeline statistics queries allow the application to sample a specified set
1615 As such, pipeline statistics queries are available on queue families
1617 The availability of pipeline statistics queries is indicated by the
1645 that queries managed by the pool will count the number of vertices
1650 specifies that queries managed by the pool will count the number of
1656 specifies that queries managed by the pool will count the number of
1661 specifies that queries managed by the pool will count the number of
1669 specifies that queries managed by the pool will count the number of
1677 that queries managed by the pool will count the number of primitives
1683 queries managed by the pool will count the number of primitives output
1695 specifies that queries managed by the pool will count the number of
1700 specifies that queries managed by the pool will count the number of
1706 specifies that queries managed by the pool will count the number of
1711 specifies that queries managed by the pool will count the number of
1721 specifies that queries managed by the pool will count the number of task
1726 specifies that queries managed by the pool will count the number of mesh
1736 <<queries-operation-undefined,Query Operation>>.
1773 [[queries-timestamps]]
1779 Unlike other queries, timestamps do not operate over a range, and so do not
1783 <<queries-pools,query pool>> and then either read timestamp values on the
1891 the view mask) zero is written to the remaining queries.
1895 * All [eq]#N# queries are timestamp values.
1898 difference between corresponding queries written by each command.
1899 The difference between corresponding queries may: be the execution time
1903 queries to determine the total execution time.
1927 pname:query must: be less than the number of queries in pname:queryPool
1929 All queries used by the command must: be _unavailable_
1934 subpass's view mask must: be less than or equal to the number of queries
2023 the view mask) zero is written to the remaining queries.
2027 * All [eq]#N# queries are timestamp values.
2030 difference between corresponding queries written by each command.
2031 The difference between corresponding queries may: be the execution time
2035 queries to determine the total execution time.
2049 pname:query must: be less than the number of queries in pname:queryPool
2051 All queries used by the command must: be _unavailable_
2056 subpass's view mask must: be less than or equal to the number of queries
2070 [[queries-transform-feedback]]
2073 Transform feedback queries track the number of primitives attempted to be
2087 used to begin and end transform feedback queries for any supported vertex
2104 [[queries-primitives-generated]]
2115 used to begin and end primitives generated queries for any supported vertex
2141 [[queries-mesh-shader]]
2150 Mesh and task shader pipeline statistics queries function the same way that
2151 invocation queries work for other shader stages, counting the number of
2157 include::{chapters}/VK_INTEL_performance_query/queries.adoc[]
2162 [[queries-result-status-only]]
2165 Result status queries serve a single purpose: allowing the application to
2171 Unlike other query types, result status queries do not track or maintain any
2175 Support for result status queries is indicated by
2183 [[queries-video-encode-feedback]]
2186 Video encode feedback queries allow the application to capture feedback
2188 As such, video encode feedback queries are available on queue families
2194 <<video-profiles,video profile>> the queries are intended to be used with.
2213 enabled video encode feedback values captured by queries of the new
2228 that queries managed by the pool will capture the byte offset of the
2234 that queries managed by the pool will capture the number of bytes
2238 that queries managed by the pool will capture a boolean value indicating
2243 When retrieving the results of video encode feedback queries, the values