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