[{"data":1,"prerenderedAt":416},["ShallowReactive",2],{"RkHqZz0UUx":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":415,"_id":4},"VkPresentRegionKHR","Structure containing rectangular region changed by vkQueuePresentKHR for a given VkImage","VK_KHR_incremental_present","structs",[],{"type":10,"children":11,"toc":413},"root",[12,28,225,339,407],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,26],{"type":18,"value":19},"text","For a given image and swapchain, the region to present is specified by the\n",{"type":13,"tag":21,"props":22,"children":24},"code",{"className":23},[],[25],{"type":18,"value":4},{"type":18,"value":27}," structure, which is defined as:",{"type":13,"tag":29,"props":30,"children":31},"code-group",{},[32,114],{"type":13,"tag":33,"props":34,"children":40},"pre",{"className":35,"code":36,"filename":37,"language":38,"meta":39,"style":39},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkPresentRegionKHR {\n    uint32_t rectangleCount;\n    const VkRectLayerKHR* pRectangles;\n} VkPresentRegionKHR;\n","C","c","",[41],{"type":13,"tag":21,"props":42,"children":43},{"__ignoreMap":39},[44,67,81,105],{"type":13,"tag":45,"props":46,"children":49},"span",{"class":47,"line":48},"line",1,[50,56,61],{"type":13,"tag":45,"props":51,"children":53},{"style":52},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[54],{"type":18,"value":55},"typedef",{"type":13,"tag":45,"props":57,"children":58},{"style":52},[59],{"type":18,"value":60}," struct",{"type":13,"tag":45,"props":62,"children":64},{"style":63},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[65],{"type":18,"value":66}," VkPresentRegionKHR {\n",{"type":13,"tag":45,"props":68,"children":70},{"class":47,"line":69},2,[71,76],{"type":13,"tag":45,"props":72,"children":73},{"style":52},[74],{"type":18,"value":75},"    uint32_t",{"type":13,"tag":45,"props":77,"children":78},{"style":63},[79],{"type":18,"value":80}," rectangleCount;\n",{"type":13,"tag":45,"props":82,"children":84},{"class":47,"line":83},3,[85,90,95,100],{"type":13,"tag":45,"props":86,"children":87},{"style":52},[88],{"type":18,"value":89},"    const",{"type":13,"tag":45,"props":91,"children":92},{"style":63},[93],{"type":18,"value":94}," VkRectLayerKHR",{"type":13,"tag":45,"props":96,"children":97},{"style":52},[98],{"type":18,"value":99},"*",{"type":13,"tag":45,"props":101,"children":102},{"style":63},[103],{"type":18,"value":104}," pRectangles;\n",{"type":13,"tag":45,"props":106,"children":108},{"class":47,"line":107},4,[109],{"type":13,"tag":45,"props":110,"children":111},{"style":63},[112],{"type":18,"value":113},"} VkPresentRegionKHR;\n",{"type":13,"tag":33,"props":115,"children":120},{"className":116,"code":117,"filename":118,"language":119,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct PresentRegionKHR {\n    rectangle_count: u32, // Number of rectangles in pRectangles\n    p_rectangles: *const vk::RectLayerKHR, // Array of rectangles that have changed in a swapchain's image(s)\n}\n","Rust","rs",[121],{"type":13,"tag":21,"props":122,"children":123},{"__ignoreMap":39},[124,147,176,217],{"type":13,"tag":45,"props":125,"children":126},{"class":47,"line":48},[127,132,136,142],{"type":13,"tag":45,"props":128,"children":129},{"style":52},[130],{"type":18,"value":131},"pub",{"type":13,"tag":45,"props":133,"children":134},{"style":52},[135],{"type":18,"value":60},{"type":13,"tag":45,"props":137,"children":139},{"style":138},"--shiki-default:#953800;--shiki-dark:#FFA657",[140],{"type":18,"value":141}," PresentRegionKHR",{"type":13,"tag":45,"props":143,"children":144},{"style":63},[145],{"type":18,"value":146}," {\n",{"type":13,"tag":45,"props":148,"children":149},{"class":47,"line":69},[150,155,160,165,170],{"type":13,"tag":45,"props":151,"children":152},{"style":63},[153],{"type":18,"value":154},"    rectangle_count",{"type":13,"tag":45,"props":156,"children":157},{"style":52},[158],{"type":18,"value":159},":",{"type":13,"tag":45,"props":161,"children":162},{"style":138},[163],{"type":18,"value":164}," u32",{"type":13,"tag":45,"props":166,"children":167},{"style":63},[168],{"type":18,"value":169},", ",{"type":13,"tag":45,"props":171,"children":173},{"style":172},"--shiki-default:#6E7781;--shiki-dark:#8B949E",[174],{"type":18,"value":175},"// Number of rectangles in pRectangles\n",{"type":13,"tag":45,"props":177,"children":178},{"class":47,"line":83},[179,184,188,193,198,203,208,212],{"type":13,"tag":45,"props":180,"children":181},{"style":63},[182],{"type":18,"value":183},"    p_rectangles",{"type":13,"tag":45,"props":185,"children":186},{"style":52},[187],{"type":18,"value":159},{"type":13,"tag":45,"props":189,"children":190},{"style":52},[191],{"type":18,"value":192}," *const",{"type":13,"tag":45,"props":194,"children":195},{"style":138},[196],{"type":18,"value":197}," vk",{"type":13,"tag":45,"props":199,"children":200},{"style":52},[201],{"type":18,"value":202},"::",{"type":13,"tag":45,"props":204,"children":205},{"style":138},[206],{"type":18,"value":207},"RectLayerKHR",{"type":13,"tag":45,"props":209,"children":210},{"style":63},[211],{"type":18,"value":169},{"type":13,"tag":45,"props":213,"children":214},{"style":172},[215],{"type":18,"value":216},"// Array of rectangles that have changed in a swapchain's image(s)\n",{"type":13,"tag":45,"props":218,"children":219},{"class":47,"line":107},[220],{"type":13,"tag":45,"props":221,"children":222},{"style":63},[223],{"type":18,"value":224},"}\n",{"type":13,"tag":226,"props":227,"children":228},"ul",{},[229,249],{"type":13,"tag":230,"props":231,"children":232},"li",{},[233,239,241,247],{"type":13,"tag":21,"props":234,"children":236},{"className":235},[],[237],{"type":18,"value":238},"rectangleCount",{"type":18,"value":240}," is the number of rectangles in ",{"type":13,"tag":21,"props":242,"children":244},{"className":243},[],[245],{"type":18,"value":246},"pRectangles",{"type":18,"value":248},",\nor zero if the entire image has changed and should be presented.",{"type":13,"tag":230,"props":250,"children":251},{},[252,257,259,265,267,273,275,280,282,287,289,294,296,301,303,306,308,315,316,322,324,330,332,337],{"type":13,"tag":21,"props":253,"children":255},{"className":254},[],[256],{"type":18,"value":246},{"type":18,"value":258}," is either ",{"type":13,"tag":21,"props":260,"children":262},{"className":261},[],[263],{"type":18,"value":264},"NULL",{"type":18,"value":266}," or a pointer to an array of\n",{"type":13,"tag":21,"props":268,"children":270},{"className":269},[],[271],{"type":18,"value":272},"VkRectLayerKHR",{"type":18,"value":274}," structures.\nThe ",{"type":13,"tag":21,"props":276,"children":278},{"className":277},[],[279],{"type":18,"value":272},{"type":18,"value":281}," structure is the framebuffer coordinates, plus\nlayer, of a portion of a presentable image that has changed and ",{"type":13,"tag":283,"props":284,"children":286},"normative",{"type":285},"must",[],{"type":18,"value":288}," be\npresented.\nIf non-",{"type":13,"tag":21,"props":290,"children":292},{"className":291},[],[293],{"type":18,"value":264},{"type":18,"value":295},", each entry in ",{"type":13,"tag":21,"props":297,"children":299},{"className":298},[],[300],{"type":18,"value":246},{"type":18,"value":302}," is a rectangle of the\ngiven image that has changed since the last image was presented to the\ngiven swapchain.\nThe rectangles ",{"type":13,"tag":283,"props":304,"children":305},{"type":285},[],{"type":18,"value":307}," be specified relative to\n",{"type":13,"tag":309,"props":310,"children":312},"a",{"href":311},"/man/VkSurfaceCapabilitiesKHR",[313],{"type":18,"value":314},"VkSurfaceCapabilitiesKHR",{"type":18,"value":202},{"type":13,"tag":21,"props":317,"children":319},{"className":318},[],[320],{"type":18,"value":321},"currentTransform",{"type":18,"value":323},", regardless of\nthe swapchain’s ",{"type":13,"tag":21,"props":325,"children":327},{"className":326},[],[328],{"type":18,"value":329},"preTransform",{"type":18,"value":331},".\nThe presentation engine will apply the ",{"type":13,"tag":21,"props":333,"children":335},{"className":334},[],[336],{"type":18,"value":329},{"type":18,"value":338}," transformation\nto the rectangles, along with any further transformation it applies to\nthe image content.",{"type":13,"tag":340,"props":341,"children":343},"validity-group",{"name":342},"Valid Usage (Implicit)",[344],{"type":13,"tag":345,"props":346,"children":348},"validity-field",{"name":347},"VUID-VkPresentRegionKHR-pRectangles-parameter",[349],{"type":13,"tag":14,"props":350,"children":351},{},[352,354,359,361,367,369,374,375,380,381,386,388,391,393,398,400,405],{"type":18,"value":353},"If ",{"type":13,"tag":21,"props":355,"children":357},{"className":356},[],[358],{"type":18,"value":238},{"type":18,"value":360}," is not ",{"type":13,"tag":21,"props":362,"children":364},{"className":363},[],[365],{"type":18,"value":366},"0",{"type":18,"value":368},", and ",{"type":13,"tag":21,"props":370,"children":372},{"className":371},[],[373],{"type":18,"value":246},{"type":18,"value":360},{"type":13,"tag":21,"props":376,"children":378},{"className":377},[],[379],{"type":18,"value":264},{"type":18,"value":169},{"type":13,"tag":21,"props":382,"children":384},{"className":383},[],[385],{"type":18,"value":246},{"type":18,"value":387}," ",{"type":13,"tag":283,"props":389,"children":390},{"type":285},[],{"type":18,"value":392}," be a valid pointer to an array of ",{"type":13,"tag":21,"props":394,"children":396},{"className":395},[],[397],{"type":18,"value":238},{"type":18,"value":399}," valid ",{"type":13,"tag":309,"props":401,"children":403},{"href":402},"/man/VkRectLayerKHR",[404],{"type":18,"value":272},{"type":18,"value":406}," structures",{"type":13,"tag":408,"props":409,"children":410},"style",{},[411],{"type":18,"value":412},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":39,"searchDepth":69,"depth":69,"links":414},[],"markdown",1729612474884]