[{"data":1,"prerenderedAt":702},["ShallowReactive",2],{"UuOS3hLMsB":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":13,"type":15,"xrefs":16,"body":17,"_type":701,"_id":4},"vkCmdSetLineStippleKHR","Set line stipple dynamically for a command buffer","VK_KHR_line_rasterization",[8,9],"primary","secondary","both",[12],"graphics",[14],"state","protos",[],{"type":18,"children":19,"toc":699},"root",[20,37,249,254,424,461,523,550,647,693],{"type":21,"tag":22,"props":23,"children":24},"element","p",{},[25,28,35],{"type":26,"value":27},"text","To ",{"type":21,"tag":29,"props":30,"children":32},"a",{"href":31},"/chapters/pipelines#pipelines-dynamic-state",[33],{"type":26,"value":34},"dynamically set",{"type":26,"value":36}," the line stipple state,\ncall:",{"type":21,"tag":38,"props":39,"children":40},"code-group",{},[41,135],{"type":21,"tag":42,"props":43,"children":49},"pre",{"className":44,"code":45,"filename":46,"language":47,"meta":48,"style":48},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdSetLineStippleKHR(\n    VkCommandBuffer commandBuffer,\n    uint32_t lineStippleFactor,\n    uint16_t lineStipplePattern);\n","C","c","",[50],{"type":21,"tag":51,"props":52,"children":53},"code",{"__ignoreMap":48},[54,78,98,116],{"type":21,"tag":55,"props":56,"children":59},"span",{"class":57,"line":58},"line",1,[60,66,72],{"type":21,"tag":55,"props":61,"children":63},{"style":62},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[64],{"type":26,"value":65},"void",{"type":21,"tag":55,"props":67,"children":69},{"style":68},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[70],{"type":26,"value":71}," vkCmdSetLineStippleKHR",{"type":21,"tag":55,"props":73,"children":75},{"style":74},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[76],{"type":26,"value":77},"(\n",{"type":21,"tag":55,"props":79,"children":81},{"class":57,"line":80},2,[82,87,93],{"type":21,"tag":55,"props":83,"children":84},{"style":74},[85],{"type":26,"value":86},"    VkCommandBuffer ",{"type":21,"tag":55,"props":88,"children":90},{"style":89},"--shiki-default:#953800;--shiki-dark:#FFA657",[91],{"type":26,"value":92},"commandBuffer",{"type":21,"tag":55,"props":94,"children":95},{"style":74},[96],{"type":26,"value":97},",\n",{"type":21,"tag":55,"props":99,"children":101},{"class":57,"line":100},3,[102,107,112],{"type":21,"tag":55,"props":103,"children":104},{"style":62},[105],{"type":26,"value":106},"    uint32_t",{"type":21,"tag":55,"props":108,"children":109},{"style":89},[110],{"type":26,"value":111}," lineStippleFactor",{"type":21,"tag":55,"props":113,"children":114},{"style":74},[115],{"type":26,"value":97},{"type":21,"tag":55,"props":117,"children":119},{"class":57,"line":118},4,[120,125,130],{"type":21,"tag":55,"props":121,"children":122},{"style":62},[123],{"type":26,"value":124},"    uint16_t",{"type":21,"tag":55,"props":126,"children":127},{"style":89},[128],{"type":26,"value":129}," lineStipplePattern",{"type":21,"tag":55,"props":131,"children":132},{"style":74},[133],{"type":26,"value":134},");\n",{"type":21,"tag":42,"props":136,"children":141},{"className":137,"code":138,"filename":139,"language":140,"meta":48,"style":48},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_line_stipple_khr(\n    command_buffer: vk::CommandBuffer,\n    line_stipple_factor: u32,\n    line_stipple_pattern: u16,\n);\n","Rust","rs",[142],{"type":21,"tag":51,"props":143,"children":144},{"__ignoreMap":48},[145,167,199,220,241],{"type":21,"tag":55,"props":146,"children":147},{"class":57,"line":58},[148,153,158,163],{"type":21,"tag":55,"props":149,"children":150},{"style":62},[151],{"type":26,"value":152},"pub",{"type":21,"tag":55,"props":154,"children":155},{"style":62},[156],{"type":26,"value":157}," fn",{"type":21,"tag":55,"props":159,"children":160},{"style":68},[161],{"type":26,"value":162}," cmd_set_line_stipple_khr",{"type":21,"tag":55,"props":164,"children":165},{"style":74},[166],{"type":26,"value":77},{"type":21,"tag":55,"props":168,"children":169},{"class":57,"line":80},[170,175,180,185,190,195],{"type":21,"tag":55,"props":171,"children":172},{"style":74},[173],{"type":26,"value":174},"    command_buffer",{"type":21,"tag":55,"props":176,"children":177},{"style":62},[178],{"type":26,"value":179},":",{"type":21,"tag":55,"props":181,"children":182},{"style":89},[183],{"type":26,"value":184}," vk",{"type":21,"tag":55,"props":186,"children":187},{"style":62},[188],{"type":26,"value":189},"::",{"type":21,"tag":55,"props":191,"children":192},{"style":89},[193],{"type":26,"value":194},"CommandBuffer",{"type":21,"tag":55,"props":196,"children":197},{"style":74},[198],{"type":26,"value":97},{"type":21,"tag":55,"props":200,"children":201},{"class":57,"line":100},[202,207,211,216],{"type":21,"tag":55,"props":203,"children":204},{"style":74},[205],{"type":26,"value":206},"    line_stipple_factor",{"type":21,"tag":55,"props":208,"children":209},{"style":62},[210],{"type":26,"value":179},{"type":21,"tag":55,"props":212,"children":213},{"style":89},[214],{"type":26,"value":215}," u32",{"type":21,"tag":55,"props":217,"children":218},{"style":74},[219],{"type":26,"value":97},{"type":21,"tag":55,"props":221,"children":222},{"class":57,"line":118},[223,228,232,237],{"type":21,"tag":55,"props":224,"children":225},{"style":74},[226],{"type":26,"value":227},"    line_stipple_pattern",{"type":21,"tag":55,"props":229,"children":230},{"style":62},[231],{"type":26,"value":179},{"type":21,"tag":55,"props":233,"children":234},{"style":89},[235],{"type":26,"value":236}," u16",{"type":21,"tag":55,"props":238,"children":239},{"style":74},[240],{"type":26,"value":97},{"type":21,"tag":55,"props":242,"children":244},{"class":57,"line":243},5,[245],{"type":21,"tag":55,"props":246,"children":247},{"style":74},[248],{"type":26,"value":134},{"type":21,"tag":22,"props":250,"children":251},{},[252],{"type":26,"value":253},"or the equivalent command",{"type":21,"tag":38,"props":255,"children":256},{},[257,325],{"type":21,"tag":42,"props":258,"children":260},{"className":44,"code":259,"filename":46,"language":47,"meta":48,"style":48},"void vkCmdSetLineStippleEXT(\n    VkCommandBuffer commandBuffer,\n    uint32_t lineStippleFactor,\n    uint16_t lineStipplePattern);\n",[261],{"type":21,"tag":51,"props":262,"children":263},{"__ignoreMap":48},[264,280,295,310],{"type":21,"tag":55,"props":265,"children":266},{"class":57,"line":58},[267,271,276],{"type":21,"tag":55,"props":268,"children":269},{"style":62},[270],{"type":26,"value":65},{"type":21,"tag":55,"props":272,"children":273},{"style":68},[274],{"type":26,"value":275}," vkCmdSetLineStippleEXT",{"type":21,"tag":55,"props":277,"children":278},{"style":74},[279],{"type":26,"value":77},{"type":21,"tag":55,"props":281,"children":282},{"class":57,"line":80},[283,287,291],{"type":21,"tag":55,"props":284,"children":285},{"style":74},[286],{"type":26,"value":86},{"type":21,"tag":55,"props":288,"children":289},{"style":89},[290],{"type":26,"value":92},{"type":21,"tag":55,"props":292,"children":293},{"style":74},[294],{"type":26,"value":97},{"type":21,"tag":55,"props":296,"children":297},{"class":57,"line":100},[298,302,306],{"type":21,"tag":55,"props":299,"children":300},{"style":62},[301],{"type":26,"value":106},{"type":21,"tag":55,"props":303,"children":304},{"style":89},[305],{"type":26,"value":111},{"type":21,"tag":55,"props":307,"children":308},{"style":74},[309],{"type":26,"value":97},{"type":21,"tag":55,"props":311,"children":312},{"class":57,"line":118},[313,317,321],{"type":21,"tag":55,"props":314,"children":315},{"style":62},[316],{"type":26,"value":124},{"type":21,"tag":55,"props":318,"children":319},{"style":89},[320],{"type":26,"value":129},{"type":21,"tag":55,"props":322,"children":323},{"style":74},[324],{"type":26,"value":134},{"type":21,"tag":42,"props":326,"children":328},{"className":137,"code":327,"filename":139,"language":140,"meta":48,"style":48},"pub fn cmd_set_line_stipple_ext(\n    command_buffer: vk::CommandBuffer,\n    line_stipple_factor: u32,\n    line_stipple_pattern: u16,\n);\n",[329],{"type":21,"tag":51,"props":330,"children":331},{"__ignoreMap":48},[332,352,379,398,417],{"type":21,"tag":55,"props":333,"children":334},{"class":57,"line":58},[335,339,343,348],{"type":21,"tag":55,"props":336,"children":337},{"style":62},[338],{"type":26,"value":152},{"type":21,"tag":55,"props":340,"children":341},{"style":62},[342],{"type":26,"value":157},{"type":21,"tag":55,"props":344,"children":345},{"style":68},[346],{"type":26,"value":347}," cmd_set_line_stipple_ext",{"type":21,"tag":55,"props":349,"children":350},{"style":74},[351],{"type":26,"value":77},{"type":21,"tag":55,"props":353,"children":354},{"class":57,"line":80},[355,359,363,367,371,375],{"type":21,"tag":55,"props":356,"children":357},{"style":74},[358],{"type":26,"value":174},{"type":21,"tag":55,"props":360,"children":361},{"style":62},[362],{"type":26,"value":179},{"type":21,"tag":55,"props":364,"children":365},{"style":89},[366],{"type":26,"value":184},{"type":21,"tag":55,"props":368,"children":369},{"style":62},[370],{"type":26,"value":189},{"type":21,"tag":55,"props":372,"children":373},{"style":89},[374],{"type":26,"value":194},{"type":21,"tag":55,"props":376,"children":377},{"style":74},[378],{"type":26,"value":97},{"type":21,"tag":55,"props":380,"children":381},{"class":57,"line":100},[382,386,390,394],{"type":21,"tag":55,"props":383,"children":384},{"style":74},[385],{"type":26,"value":206},{"type":21,"tag":55,"props":387,"children":388},{"style":62},[389],{"type":26,"value":179},{"type":21,"tag":55,"props":391,"children":392},{"style":89},[393],{"type":26,"value":215},{"type":21,"tag":55,"props":395,"children":396},{"style":74},[397],{"type":26,"value":97},{"type":21,"tag":55,"props":399,"children":400},{"class":57,"line":118},[401,405,409,413],{"type":21,"tag":55,"props":402,"children":403},{"style":74},[404],{"type":26,"value":227},{"type":21,"tag":55,"props":406,"children":407},{"style":62},[408],{"type":26,"value":179},{"type":21,"tag":55,"props":410,"children":411},{"style":89},[412],{"type":26,"value":236},{"type":21,"tag":55,"props":414,"children":415},{"style":74},[416],{"type":26,"value":97},{"type":21,"tag":55,"props":418,"children":419},{"class":57,"line":243},[420],{"type":21,"tag":55,"props":421,"children":422},{"style":74},[423],{"type":26,"value":134},{"type":21,"tag":425,"props":426,"children":427},"ul",{},[428,439,450],{"type":21,"tag":429,"props":430,"children":431},"li",{},[432,437],{"type":21,"tag":51,"props":433,"children":435},{"className":434},[],[436],{"type":26,"value":92},{"type":26,"value":438}," is the command buffer into which the command will be\nrecorded.",{"type":21,"tag":429,"props":440,"children":441},{},[442,448],{"type":21,"tag":51,"props":443,"children":445},{"className":444},[],[446],{"type":26,"value":447},"lineStippleFactor",{"type":26,"value":449}," is the repeat factor used in stippled line\nrasterization.",{"type":21,"tag":429,"props":451,"children":452},{},[453,459],{"type":21,"tag":51,"props":454,"children":456},{"className":455},[],[457],{"type":26,"value":458},"lineStipplePattern",{"type":26,"value":460}," is the bit pattern used in stippled line\nrasterization.",{"type":21,"tag":22,"props":462,"children":463},{},[464,466,472,474,480,482,488,489,495,497,503,504,509,511,515,516,521],{"type":26,"value":465},"This command sets the line stipple state for subsequent drawing commands\nwhen drawing using ",{"type":21,"tag":29,"props":467,"children":469},{"href":468},"/chapters/shaders#shaders-objects",[470],{"type":26,"value":471},"shader objects",{"type":26,"value":473},", or\nwhen the graphics pipeline is created with\n",{"type":21,"tag":51,"props":475,"children":477},{"className":476},[],[478],{"type":26,"value":479},"VK_DYNAMIC_STATE_LINE_STIPPLE_EXT",{"type":26,"value":481}," set in\n",{"type":21,"tag":29,"props":483,"children":485},{"href":484},"/man/VkPipelineDynamicStateCreateInfo",[486],{"type":26,"value":487},"VkPipelineDynamicStateCreateInfo",{"type":26,"value":189},{"type":21,"tag":51,"props":490,"children":492},{"className":491},[],[493],{"type":26,"value":494},"pDynamicStates",{"type":26,"value":496},".\nOtherwise, this state is specified by the\n",{"type":21,"tag":29,"props":498,"children":500},{"href":499},"/man/VkPipelineRasterizationLineStateCreateInfoKHR",[501],{"type":26,"value":502},"VkPipelineRasterizationLineStateCreateInfoKHR",{"type":26,"value":189},{"type":21,"tag":51,"props":505,"children":507},{"className":506},[],[508],{"type":26,"value":447},{"type":26,"value":510},"\nand\n",{"type":21,"tag":29,"props":512,"children":513},{"href":499},[514],{"type":26,"value":502},{"type":26,"value":189},{"type":21,"tag":51,"props":517,"children":519},{"className":518},[],[520],{"type":26,"value":458},{"type":26,"value":522},"\nvalues used to create the currently active pipeline.",{"type":21,"tag":524,"props":525,"children":527},"validity-group",{"name":526},"Valid Usage",[528],{"type":21,"tag":529,"props":530,"children":532},"validity-field",{"name":531},"VUID-vkCmdSetLineStippleKHR-lineStippleFactor-02776",[533],{"type":21,"tag":22,"props":534,"children":535},{},[536,541,543,548],{"type":21,"tag":51,"props":537,"children":539},{"className":538},[],[540],{"type":26,"value":447},{"type":26,"value":542}," ",{"type":21,"tag":544,"props":545,"children":547},"normative",{"type":546},"must",[],{"type":26,"value":549}," be in the range [1,256]",{"type":21,"tag":524,"props":551,"children":553},{"name":552},"Valid Usage (Implicit)",[554,580,604,633],{"type":21,"tag":529,"props":555,"children":557},{"name":556},"VUID-vkCmdSetLineStippleKHR-commandBuffer-parameter",[558],{"type":21,"tag":22,"props":559,"children":560},{},[561,566,567,570,572,578],{"type":21,"tag":51,"props":562,"children":564},{"className":563},[],[565],{"type":26,"value":92},{"type":26,"value":542},{"type":21,"tag":544,"props":568,"children":569},{"type":546},[],{"type":26,"value":571}," be a valid ",{"type":21,"tag":29,"props":573,"children":575},{"href":574},"/man/VkCommandBuffer",[576],{"type":26,"value":577},"VkCommandBuffer",{"type":26,"value":579}," handle",{"type":21,"tag":529,"props":581,"children":583},{"name":582},"VUID-vkCmdSetLineStippleKHR-commandBuffer-recording",[584],{"type":21,"tag":22,"props":585,"children":586},{},[587,592,593,596,598],{"type":21,"tag":51,"props":588,"children":590},{"className":589},[],[591],{"type":26,"value":92},{"type":26,"value":542},{"type":21,"tag":544,"props":594,"children":595},{"type":546},[],{"type":26,"value":597}," be in the ",{"type":21,"tag":29,"props":599,"children":601},{"href":600},"/chapters/commandbuffers#commandbuffers-lifecycle",[602],{"type":26,"value":603},"recording state",{"type":21,"tag":529,"props":605,"children":607},{"name":606},"VUID-vkCmdSetLineStippleKHR-commandBuffer-cmdpool",[608],{"type":21,"tag":22,"props":609,"children":610},{},[611,613,619,621,626,628,631],{"type":26,"value":612},"The ",{"type":21,"tag":51,"props":614,"children":616},{"className":615},[],[617],{"type":26,"value":618},"VkCommandPool",{"type":26,"value":620}," that ",{"type":21,"tag":51,"props":622,"children":624},{"className":623},[],[625],{"type":26,"value":92},{"type":26,"value":627}," was allocated from ",{"type":21,"tag":544,"props":629,"children":630},{"type":546},[],{"type":26,"value":632}," support graphics operations",{"type":21,"tag":529,"props":634,"children":636},{"name":635},"VUID-vkCmdSetLineStippleKHR-videocoding",[637],{"type":21,"tag":22,"props":638,"children":639},{},[640,642,645],{"type":26,"value":641},"This command ",{"type":21,"tag":544,"props":643,"children":644},{"type":546},[],{"type":26,"value":646}," only be called outside of a video coding scope",{"type":21,"tag":648,"props":649,"children":651},"validity-box",{"name":650},"Host Synchronization",[652],{"type":21,"tag":425,"props":653,"children":654},{},[655,671],{"type":21,"tag":429,"props":656,"children":657},{},[658,660,665,666,669],{"type":26,"value":659},"Host access to ",{"type":21,"tag":51,"props":661,"children":663},{"className":662},[],[664],{"type":26,"value":92},{"type":26,"value":542},{"type":21,"tag":544,"props":667,"children":668},{"type":546},[],{"type":26,"value":670}," be externally synchronized",{"type":21,"tag":429,"props":672,"children":673},{},[674,676,681,682,687,688,691],{"type":26,"value":675},"Host access to the ",{"type":21,"tag":51,"props":677,"children":679},{"className":678},[],[680],{"type":26,"value":618},{"type":26,"value":620},{"type":21,"tag":51,"props":683,"children":685},{"className":684},[],[686],{"type":26,"value":92},{"type":26,"value":627},{"type":21,"tag":544,"props":689,"children":690},{"type":546},[],{"type":26,"value":692}," be externally synchronized\n::",{"type":21,"tag":694,"props":695,"children":696},"style",{},[697],{"type":26,"value":698},"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":48,"searchDepth":80,"depth":80,"links":700},[],"markdown",1725732609266]