[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"github-stars":3,"guide-nav":5,"doc-\u002Fdocs\u002Fprimitives\u002Fpaint\u002Ftone":129},{"stars":4},5505,[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":193,"categorySlug":193,"categoryTitle":439,"curated":440,"description":141,"editUrl":441,"extension":442,"group":193,"groupTitle":443,"kind":444,"meta":445,"navigation":446,"path":447,"seo":448,"sourceUrl":449,"stem":450,"wordCount":441,"__hash__":451},"primitives\u002Fdocs\u002Fprimitives\u002F6.paint\u002F9.tone.md","tone",{"type":133,"value":134,"toc":433},"minimark",[135,138,142,188,203,221,226,277,281,380,393,397,419,423,429],[136,137,131],"h1",{"id":131},[139,140,141],"p",{},"Reshapes a 0–1 field with glow, contrast and balance controls, then flips it.",[143,144,149],"pre",{"className":145,"code":146,"language":147,"meta":148,"style":148},"language-ts shiki shiki-themes github-dark","tone(\n  field: Field,\n  opts: {glow: FieldScalar; contrast: FieldScalar; balance: FieldScalar; invert: true},\n): Field\n","ts","",[10,150,151,163,169,182],{"__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","(\n",[152,164,166],{"class":154,"line":165},2,[152,167,168],{"class":161},"  field: Field,\n",[152,170,172,175,179],{"class":154,"line":171},3,[152,173,174],{"class":161},"  opts: {glow: FieldScalar; contrast: FieldScalar; balance: FieldScalar; invert: ",[152,176,178],{"class":177},"sDLfK","true",[152,180,181],{"class":161},"},\n",[152,183,185],{"class":154,"line":184},4,[152,186,187],{"class":161},"): Field\n",[139,189,190,191,194,195,198,199,202],{},"Import ",[10,192,193],{},"paint"," from ",[10,196,197],{},"shaders\u002Fstd"," and use ",[10,200,201],{},"paint.tone",".",[139,204,205,208,209,212,213,216,217,220],{},[10,206,207],{},"glow"," is a spread control: 5 leaves the field alone, lower values pull the bright parts into tight cores, higher values spread them into a wash. ",[10,210,211],{},"contrast"," scales around the middle, 1 is neutral. ",[10,214,215],{},"balance"," is 0–100 with 50 neutral. ",[10,218,219],{},"invert"," is always true: the result is flipped so the palette's first color lands where the field is high.",[222,223,225],"h2",{"id":224},"parameters","Parameters",[227,228,229,245],"table",{},[230,231,232],"thead",{},[233,234,235,239,242],"tr",{},[236,237,238],"th",{},"Name",[236,240,241],{},"Type",[236,243,244],{},"Notes",[246,247,248,263],"tbody",{},[233,249,250,256,261],{},[251,252,253],"td",{},[10,254,255],{},"field",[251,257,258],{},[10,259,260],{},"Field",[251,262],{},[233,264,265,270,275],{},[251,266,267],{},[10,268,269],{},"opts",[251,271,272],{},[10,273,274],{},"{glow: FieldScalar; contrast: FieldScalar; balance: FieldScalar; invert: true}",[251,276],{},[222,278,280],{"id":279},"example","Example",[143,282,284],{"className":145,"code":283,"language":147,"meta":148,"style":148},"paint: rampOver(tone(scaledVolume(noiseField('mx3'), {scale: p('scale')}), {glow: p('intensity'), contrast: p('contrast'), balance: p('balance'), invert: true}), stops(p('colorSpace')))\n",[10,285,286],{"__ignoreMap":148},[152,287,288,290,293,296,299,301,303,306,308,311,313,317,320,322,324,327,330,332,334,337,340,342,344,347,350,352,354,357,360,362,365,368,370,372,374,377],{"class":154,"line":155},[152,289,193],{"class":158},[152,291,292],{"class":161},": ",[152,294,295],{"class":158},"rampOver",[152,297,298],{"class":161},"(",[152,300,131],{"class":158},[152,302,298],{"class":161},[152,304,305],{"class":158},"scaledVolume",[152,307,298],{"class":161},[152,309,310],{"class":158},"noiseField",[152,312,298],{"class":161},[152,314,316],{"class":315},"sU2Wk","'mx3'",[152,318,319],{"class":161},"), {scale: ",[152,321,139],{"class":158},[152,323,298],{"class":161},[152,325,326],{"class":315},"'scale'",[152,328,329],{"class":161},")}), {glow: ",[152,331,139],{"class":158},[152,333,298],{"class":161},[152,335,336],{"class":315},"'intensity'",[152,338,339],{"class":161},"), contrast: ",[152,341,139],{"class":158},[152,343,298],{"class":161},[152,345,346],{"class":315},"'contrast'",[152,348,349],{"class":161},"), balance: ",[152,351,139],{"class":158},[152,353,298],{"class":161},[152,355,356],{"class":315},"'balance'",[152,358,359],{"class":161},"), invert: ",[152,361,178],{"class":177},[152,363,364],{"class":161},"}), ",[152,366,367],{"class":158},"stops",[152,369,298],{"class":161},[152,371,139],{"class":158},[152,373,298],{"class":161},[152,375,376],{"class":315},"'colorSpace'",[152,378,379],{"class":161},")))\n",[381,382,383],"blockquote",{},[139,384,385,389,390,392],{},[386,387,388],"strong",{},"Tip."," Raising ",[10,391,215],{}," pushes more of the canvas toward the first color.",[222,394,396],{"id":395},"see-also","See also",[398,399,400,411],"ul",{},[401,402,403,410],"li",{},[404,405,407],"a",{"href":406},"\u002Fdocs\u002Fprimitives\u002Fpaint\u002Fthreshold",[10,408,409],{},"threshold"," — Turns a signed field (−1 to 1) into a soft 0–1 mask.",[401,412,413,418],{},[404,414,416],{"href":415},"\u002Fdocs\u002Fprimitives\u002Fpaint\u002Fnoisefield",[10,417,310],{}," — A field of smooth noise in the chosen flavor.",[222,420,422],{"id":421},"used-by","Used by",[139,424,425],{},[404,426,428],{"href":427},"\u002Fdocs\u002Fcomponents\u002Fplasma","Plasma",[430,431,432],"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 pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}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 .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}",{"title":148,"searchDepth":165,"depth":165,"links":434},[435,436,437,438],{"id":224,"depth":165,"text":225},{"id":279,"depth":165,"text":280},{"id":395,"depth":165,"text":396},{"id":421,"depth":165,"text":422},"Fields, palettes & ramps",false,null,"md","Painting","function",{},true,"\u002Fdocs\u002Fprimitives\u002Fpaint\u002Ftone",{"title":131,"description":141},"https:\u002F\u002Fgithub.com\u002Fshader-effects-inc\u002Fshaders\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fsrc\u002Fstd\u002Fpaint\u002Ffields.ts#L418","docs\u002Fprimitives\u002F6.paint\u002F9.tone","Pz_Si2vHJbkU8PjcSVRfOnfm8ENAD9K2C2fzQS3WUl4"]