[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"github-stars":3,"guide-nav":5,"doc-\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop":129},{"stars":4},5507,[6,11,15,19,23,27,31,35,39,43,47,51,55,59,63,67,72,76,80,84,88,93,97,101,105,109,113,117,121,125],{"path":7,"title":8,"description":9,"category":10},"\u002Fdocs\u002Fguide","Getting started","Shaders is a library of GPU effect components for Vue, React, Svelte, Solid, JavaScript and Framer, with a design editor for building with them.","code",{"path":12,"title":13,"description":14,"category":10},"\u002Fdocs\u002Fguide\u002Fquickstart","Quickstart","Install Shaders, render your first effect, and drive a prop from state.",{"path":16,"title":17,"description":18,"category":10},"\u002Fdocs\u002Fguide\u002Fcomposing-effects","Composing effects","Stack components as layers and nest them to control which layers an effect touches.",{"path":20,"title":21,"description":22,"category":10},"\u002Fdocs\u002Fguide\u002Fblending-masking","Blending and masking","Control how a layer mixes with the layers below it, and reveal one layer through another.",{"path":24,"title":25,"description":26,"category":10},"\u002Fdocs\u002Fguide\u002Fprops-reactivity","Props and reactivity","Bind props to your framework's state so effects update when it changes, and animate props with an animation library.",{"path":28,"title":29,"description":30,"category":10},"\u002Fdocs\u002Fguide\u002Fdynamic-props","Dynamic props","Drive any numeric or position prop from time, the cursor, or another layer, without writing animation code.",{"path":32,"title":33,"description":34,"category":10},"\u002Fdocs\u002Fguide\u002Flayout-positioning","Layout and positioning","Size and place a shader in your page with CSS, as a background, a fill, or an inline block.",{"path":36,"title":37,"description":38,"category":10},"\u002Fdocs\u002Fguide\u002Fsizing-and-units","Sizing and units","Size and place layers in CSS units (px, %, vw, rem, and canvas units) that stay correct as the canvas and window resize.",{"path":40,"title":41,"description":42,"category":10},"\u002Fdocs\u002Fguide\u002Ftransforms","Transforms","Position, size, and rotate any layer inside the canvas with a bounding box, in any CSS unit.",{"path":44,"title":45,"description":46,"category":10},"\u002Fdocs\u002Fguide\u002Fshape-effects","Shape effects","Pick the 2D, 3D or custom SVG shape that Glass, Neon, Emboss and other shape effects draw inside.",{"path":48,"title":49,"description":50,"category":10},"\u002Fdocs\u002Fguide\u002Fcolor-space","Color space","Match colors to your design tool with the output color space, and keep bright layers from clipping with tone mapping.",{"path":52,"title":53,"description":54,"category":10},"\u002Fdocs\u002Fguide\u002Fhooks-events","Hooks and events","Run code when an effect is ready to show, and show a fallback when the GPU can't run it.",{"path":56,"title":57,"description":58,"category":10},"\u002Fdocs\u002Fguide\u002Fperformance","Performance","Learn what makes an effect expensive on the GPU and how to keep it inside the frame budget.",{"path":60,"title":61,"description":62,"category":10},"\u002Fdocs\u002Fguide\u002Fcustom-shaders","Custom components","Write your own component in TypeScript, use it like any component in the library, and write WGSL by hand when you need to.",{"path":64,"title":65,"description":66,"category":10},"\u002Fdocs\u002Fguide\u002Ftelemetry","Telemetry","The `\u003CShader>` component occasionally sends an anonymous performance report to help us improve the engine over time.",{"path":68,"title":69,"description":70,"category":71},"\u002Fdocs\u002Fguide\u002Fmcp","Shaders MCP","Connect your AI coding agent to Shaders so it can find, install and edit effects in your codebase.","workflows",{"path":73,"title":74,"description":75,"category":71},"\u002Fdocs\u002Fguide\u002Fcli","Shaders CLI","Install your own shaders and Pro shaders into your codebase as component files, and keep them in sync with the design editor.",{"path":77,"title":78,"description":79,"category":71},"\u002Fdocs\u002Fguide\u002Fagent-skill","Agent skill","Give your coding agent a skill that teaches it to build with Shaders components, the CLI and Pro shaders.",{"path":81,"title":82,"description":83,"category":10},"\u002Fdocs\u002Fguide\u002Fvideo-rendering","Rendering to video","Turn a shader effect into a video file, from the design editor or from a frame-by-frame pipeline such as Remotion, Hyperframes or Puppeteer.",{"path":85,"title":86,"description":87,"category":10},"\u002Fdocs\u002Fguide\u002Fssr","Server rendering","Render Shaders in Next.js, Nuxt, SvelteKit, SolidStart and other SSR apps by keeping each shader on the client.",{"path":89,"title":90,"description":91,"category":92},"\u002Fdocs\u002Fguide\u002Fquick-tour-of-the-design-editor","Quick tour of the design editor","A short walkthrough of the full Shaders workflow, from designing on the infinite canvas to exporting code.","editor",{"path":94,"title":95,"description":96,"category":92},"\u002Fdocs\u002Fguide\u002Fintro-to-the-interface","Intro to the interface","A tour of the design editor interface: the canvas, layers, the Properties panel, and the ways to share and export.",{"path":98,"title":99,"description":100,"category":92},"\u002Fdocs\u002Fguide\u002Fcomposing-your-first-shader-effect","Composing your first shader effect","Building a first shader effect in the design editor by stacking and nesting components as layers.",{"path":102,"title":103,"description":104,"category":92},"\u002Fdocs\u002Fguide\u002Fmasking-and-blending","Masking and blending","How blend modes and masks combine components in the design editor.",{"path":106,"title":107,"description":108,"category":92},"\u002Fdocs\u002Fguide\u002Fdynamic-prop-mapping","Dynamic prop mapping","Turning static props into dynamic ones in the design editor: mapping one layer's output into another's prop, following the cursor, or animating automatically.",{"path":110,"title":111,"description":112,"category":92},"\u002Fdocs\u002Fguide\u002Fcustom-media-and-transformations","Custom media and transformations","Uploading images, videos, and SVG files to the media gallery, adding them to a composition, and placing them with transformations.",{"path":114,"title":115,"description":116,"category":92},"\u002Fdocs\u002Fguide\u002Finstalling-a-shader-via-mcp","Installing a shader via MCP","Installing a shader from the design editor into a hero section with the Shaders MCP.",{"path":118,"title":119,"description":120,"category":92},"\u002Fdocs\u002Fguide\u002Fexploring-shape-effects","Exploring shape effects","Applying shape effects such as liquid glass, liquid metal, and glowing edges to built-in shapes and your own SVG.",{"path":122,"title":123,"description":124,"category":92},"\u002Fdocs\u002Fguide\u002Fglass-component-spotlight","Component spotlight: Glass","A short look at the Glass component and the liquid-glass look it creates.",{"path":126,"title":127,"description":128,"category":92},"\u002Fdocs\u002Fguide\u002Fdigital-looks-component-spotlight","Component spotlight: Digital looks","A look at the digital stylization components for glitchy, futuristic, or technical effects.",{"id":130,"title":131,"body":132,"categoryId":544,"categorySlug":545,"categoryTitle":546,"curated":547,"description":141,"editUrl":548,"extension":549,"group":550,"groupTitle":551,"kind":552,"meta":553,"navigation":554,"path":555,"seo":556,"sourceUrl":557,"stem":558,"wordCount":548,"__hash__":559},"primitives\u002Fdocs\u002Fprimitives\u002F37.sim-grids\u002F2.op.md","op",{"type":133,"value":134,"toc":537},"minimark",[135,138,142,163,178,185,228,233,367,380,384,504,508,519,523,533],[136,137,131],"h1",{"id":131},[139,140,141],"p",{},"The stages a grid frame is built from.",[143,144,149],"pre",{"className":145,"code":146,"language":147,"meta":148,"style":148},"language-ts shiki shiki-themes github-dark","op: { host, values, settle, readyWhen, pass, cache, publish, seedOnce, iterate, sortPass }\n","ts","",[10,150,151],{"__ignoreMap":148},[152,153,156,159],"span",{"class":154,"line":155},"line",1,[152,157,131],{"class":158},"svObZ",[152,160,162],{"class":161},"s95oV",": { host, values, settle, readyWhen, pass, cache, publish, seedOnce, iterate, sortPass }\n",[139,164,165,166,169,170,173,174,177],{},"Import ",[10,167,168],{},"sim"," from ",[10,171,172],{},"shaders\u002Fstd"," and use ",[10,175,176],{},"sim.grids.op",".",[139,179,180,181,184],{},"List them in ",[10,182,183],{},"stages"," in the order they should run.",[139,186,187,188,191,192,195,196,199,200,203,204,207,208,211,212,215,216,219,220,223,224,227],{},"Bookkeeping: ",[10,189,190],{},"host"," (before any gate), ",[10,193,194],{},"values"," (write this frame's values), ",[10,197,198],{},"readyWhen"," (wait for an input), ",[10,201,202],{},"settle"," (sleep once the field is still). Work: ",[10,205,206],{},"pass"," (one GPU pass), ",[10,209,210],{},"cache"," (a pass picked per frame), ",[10,213,214],{},"seedOnce"," (a one-shot reset), ",[10,217,218],{},"iterate"," (a pass N times), ",[10,221,222],{},"sortPass"," (a compare-swap chain), ",[10,225,226],{},"publish"," (write the result the layer samples).",[229,230,232],"h2",{"id":231},"example","Example",[143,234,236],{"className":145,"code":235,"language":147,"meta":148,"style":148},"stages: [op.readyWhen(() => ready), op.values('write', (f) => paramsU.write({dt: f.dt})), op.iterate({count: () => 8, step: (i, nodes) => nodes.push(react.with(i % 2 ? groupBA : groupAB))}), op.publish(() => output)]\n",[10,237,238],{"__ignoreMap":148},[152,239,240,242,245,247,250,254,257,259,262,266,269,273,276,278,281,284,287,289,292,295,298,300,304,307,310,313,316,318,321,323,325,328,331,334,337,340,343,346,349,352,355,358,360,362,364],{"class":154,"line":155},[152,241,183],{"class":158},[152,243,244],{"class":161},": [op.",[152,246,198],{"class":158},[152,248,249],{"class":161},"(() ",[152,251,253],{"class":252},"snl16","=>",[152,255,256],{"class":161}," ready), op.",[152,258,194],{"class":158},[152,260,261],{"class":161},"(",[152,263,265],{"class":264},"sU2Wk","'write'",[152,267,268],{"class":161},", (",[152,270,272],{"class":271},"s9osk","f",[152,274,275],{"class":161},") ",[152,277,253],{"class":252},[152,279,280],{"class":161}," paramsU.",[152,282,283],{"class":158},"write",[152,285,286],{"class":161},"({dt: f.dt})), op.",[152,288,218],{"class":158},[152,290,291],{"class":161},"({",[152,293,294],{"class":158},"count",[152,296,297],{"class":161},": () ",[152,299,253],{"class":252},[152,301,303],{"class":302},"sDLfK"," 8",[152,305,306],{"class":161},", ",[152,308,309],{"class":158},"step",[152,311,312],{"class":161},": (",[152,314,315],{"class":271},"i",[152,317,306],{"class":161},[152,319,320],{"class":271},"nodes",[152,322,275],{"class":161},[152,324,253],{"class":252},[152,326,327],{"class":161}," nodes.",[152,329,330],{"class":158},"push",[152,332,333],{"class":161},"(react.",[152,335,336],{"class":158},"with",[152,338,339],{"class":161},"(i ",[152,341,342],{"class":252},"%",[152,344,345],{"class":302}," 2",[152,347,348],{"class":252}," ?",[152,350,351],{"class":161}," groupBA ",[152,353,354],{"class":252},":",[152,356,357],{"class":161}," groupAB))}), op.",[152,359,226],{"class":158},[152,361,249],{"class":161},[152,363,253],{"class":252},[152,365,366],{"class":161}," output)]\n",[368,369,370],"blockquote",{},[139,371,372,376,377,379],{},[373,374,375],"strong",{},"Tip."," A ",[10,378,194],{}," stage sits before the passes that read it. Stages run in list order.",[229,381,383],{"id":382},"members","Members",[385,386,387,401,410,423,439,448,457,466,479,491],"ul",{},[388,389,390,397,398,400],"li",{},[391,392,394],"a",{"href":393},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-host",[10,395,396],{},"op.host"," — A named step that runs before any gate: pointer smoothing, activity flags, anything a later ",[10,399,202],{}," needs to know.",[388,402,403,409],{},[391,404,406],{"href":405},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-values",[10,407,408],{},"op.values"," — A named step that writes this frame's values for the passes after it.",[388,411,412,418,419,422],{},[391,413,415],{"href":414},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-settle",[10,416,417],{},"op.settle"," — Sleep the simulation once nothing has driven it for ",[10,420,421],{},"settleMs"," of simulated time.",[388,424,425,431,432,435,436,177],{},[391,426,428],{"href":427},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-readywhen",[10,429,430],{},"op.readyWhen"," — Run nothing until ",[10,433,434],{},"fn"," returns true, typically once the child's picture has arrived through ",[10,437,438],{},"bindInputs",[388,440,441,447],{},[391,442,444],{"href":443},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-pass",[10,445,446],{},"op.pass"," — One GPU pass, the same every frame.",[388,449,450,456],{},[391,451,453],{"href":452},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-cache",[10,454,455],{},"op.cache"," — A GPU pass chosen per frame, for a pass whose input is rebound after the frame starts.",[388,458,459,465],{},[391,460,462],{"href":461},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-publish",[10,463,464],{},"op.publish"," — The last stage: write the state into the texture the layer samples.",[388,467,468,474,475,478],{},[391,469,471],{"href":470},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-seedonce",[10,472,473],{},"op.seedOnce"," — A one-shot reset run before the rest of the frame whenever ",[10,476,477],{},"staleWhen"," says the state is stale: on the first frame, or when a seed prop changes.",[388,480,481,487,488,490],{},[391,482,484],{"href":483},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-iterate",[10,485,486],{},"op.iterate"," — Run a step ",[10,489,294],{}," times this frame.",[388,492,493,499,500,503],{},[391,494,496],{"href":495},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop-sortpass",[10,497,498],{},"op.sortPass"," — A compare-and-swap sort that converges a little more every frame: ",[10,501,502],{},"passes"," swaps per frame, alternating odd and even pairs and the two buffers.",[229,505,507],{"id":506},"see-also","See also",[385,509,510],{},[388,511,512,518],{},[391,513,515],{"href":514},"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fgridsim",[10,516,517],{},"gridSim"," — A field of cells advanced every frame by an ordered list of stages.",[229,520,522],{"id":521},"used-by","Used by",[139,524,525,306,529],{},[391,526,528],{"href":527},"\u002Fdocs\u002Fcomponents\u002Fpixelsort","PixelSort",[391,530,532],{"href":531},"\u002Fdocs\u002Fcomponents\u002Freactiondiffusion","ReactionDiffusion",[534,535,536],"style",{},"html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}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 pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}",{"title":148,"searchDepth":538,"depth":538,"links":539},2,[540,541,542,543],{"id":231,"depth":538,"text":232},{"id":382,"depth":538,"text":383},{"id":506,"depth":538,"text":507},{"id":521,"depth":538,"text":522},"sim.grids","sim-grids","Grid programs",false,null,"md","simulation","Simulation","object",{},true,"\u002Fdocs\u002Fprimitives\u002Fsim-grids\u002Fop",{"title":131,"description":141},"https:\u002F\u002Fgithub.com\u002Fshader-effects-inc\u002Fshaders\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fsrc\u002Fstd\u002Fsim\u002Fgrids.ts#L185","docs\u002Fprimitives\u002F37.sim-grids\u002F2.op","IGMvgZ5dB0wKqazyhZ2rvVDnQ7ro_vtpt2QVZ2j8X3Y"]