---
title: "p"
description: "Reference one of the definition's props by name, wherever a word asks for a value."
group: "define"
groupTitle: "Defining a shader"
categoryId: "values"
categorySlug: "values"
categoryTitle: "Props & values"
kind: "function"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/std/values.ts#L35"
---

# p

Reference one of the definition's props by name, wherever a word asks for a value.

```ts
p(name: string): PropRef
```

Import `p` from `shaders/std`.

Pass it where a std word takes a color, a position or a number and the word reads that prop live on the GPU. The name must be one of the definition's `props`; a wrong name throws when the shader is built.

## Parameters

| Name | Type | Notes |
|---|---|---|
| `name` | `string` |  |

## Example

```ts
effect: tintToward(p('color'), {amount: p('intensity')})
```

> **Tip.** A prop ref is a binding, not a snapshot: changing the prop later needs no rebuild.

## See also

- [`Scalar`](/docs/primitives/values/scalar) — A number built from props: what `radialMask(…)`, `motion.oscillating(…)` and `.times()` return.
- [`uniformOf`](/docs/primitives/invoke/uniformof) — The live GPU value of a prop, for a hand-written builder: `uniformOf(p('radius'), params)`.
- [`ctx`](/docs/primitives/invoke/ctx) — The context values as tokens: `ctx.uv`, `ctx.time`, `ctx.aspect`, `ctx.pointer`, `ctx.viewportSize`, `ctx.logicalViewportSize`.

## Used by

[AngularBlur](/docs/components/angularblur), [Ascii](/docs/components/ascii), [Aurora](/docs/components/aurora), [BarShift](/docs/components/barshift), [BarnDoors](/docs/components/barndoors), [Beam](/docs/components/beam), [Bend](/docs/components/bend), [Blob](/docs/components/blob), [BlockDissolve](/docs/components/blockdissolve), [BlockNoise](/docs/components/blocknoise), [BlueNoise](/docs/components/bluenoise), [Blur](/docs/components/blur), [BokehBlur](/docs/components/bokehblur), [BrickPattern](/docs/components/brickpattern), [BrightnessContrast](/docs/components/brightnesscontrast), [Bulge](/docs/components/bulge), [CRTScreen](/docs/components/crtscreen), [Chalkboard](/docs/components/chalkboard), [ChannelBlur](/docs/components/channelblur), [CheckerWipe](/docs/components/checkerwipe), [Checkerboard](/docs/components/checkerboard), [Chevron](/docs/components/chevron), [ChromaticAberration](/docs/components/chromaticaberration), [ColorWheel](/docs/components/colorwheel), [CompressionArtifacts](/docs/components/compressionartifacts), [ConcentricSpin](/docs/components/concentricspin), [ConicGradient](/docs/components/conicgradient), [ContourLines](/docs/components/contourlines), [CornerPin](/docs/components/cornerpin), [CurlNoise](/docs/components/curlnoise), [CursorRipples](/docs/components/cursorripples), [DiamondGradient](/docs/components/diamondgradient), [DiamondWipe](/docs/components/diamondwipe), [DiffuseBlur](/docs/components/diffuseblur), [DisplacementMap](/docs/components/displacementmap), [Dither](/docs/components/dither), [DotGrid](/docs/components/dotgrid), [DropShadow](/docs/components/dropshadow), [Duotone](/docs/components/duotone), [Engraving](/docs/components/engraving), [ErosionNoise](/docs/components/erosionnoise), [Exposure](/docs/components/exposure), [FallingLines](/docs/components/fallinglines), [FilmGrain](/docs/components/filmgrain), [FilmStock](/docs/components/filmstock), [Flip](/docs/components/flip), [FlowField](/docs/components/flowfield), [FlowingGradient](/docs/components/flowinggradient), [FlutedGlass](/docs/components/flutedglass), [FractalNoise](/docs/components/fractalnoise), [GaborNoise](/docs/components/gabornoise), [GlassTiles](/docs/components/glasstiles), [Glitch](/docs/components/glitch), [Glow](/docs/components/glow), [Godrays](/docs/components/godrays), [GradientMap](/docs/components/gradientmap), [Grid](/docs/components/grid), [GridDistortion](/docs/components/griddistortion), [Halftone](/docs/components/halftone), [HexGrid](/docs/components/hexgrid), [HueShift](/docs/components/hueshift), [ImageTexture](/docs/components/imagetexture), [IrisWipe](/docs/components/iriswipe), [IsometricCubes](/docs/components/isometriccubes), [Kaleidoscope](/docs/components/kaleidoscope), [KeyFrames](/docs/components/keyframes), [LensDistortion](/docs/components/lensdistortion), [LensFlare](/docs/components/lensflare), [LightLeak](/docs/components/lightleak), [Line](/docs/components/line), [LinearBlur](/docs/components/linearblur), [LinearGradient](/docs/components/lineargradient), [LinearWipe](/docs/components/linearwipe), [Liquify](/docs/components/liquify), [Marble](/docs/components/marble), [MeshGradient](/docs/components/meshgradient), [Mirror](/docs/components/mirror), [MultiPointGradient](/docs/components/multipointgradient), [NoiseDissolve](/docs/components/noisedissolve), [ObjectTracker](/docs/components/objecttracker), [Obsidian](/docs/components/obsidian), [PagePeel](/docs/components/pagepeel), [PerlinNoise](/docs/components/perlinnoise), [Perspective](/docs/components/perspective), [Pixelate](/docs/components/pixelate), [Plasma](/docs/components/plasma), [PolarCoordinates](/docs/components/polarcoordinates), [Posterize](/docs/components/posterize), [Prism](/docs/components/prism), [ProgressiveBlur](/docs/components/progressiveblur), [RadialGradient](/docs/components/radialgradient), [RadialWipe](/docs/components/radialwipe), [RandomBars](/docs/components/randombars), [RectangularCoordinates](/docs/components/rectangularcoordinates), [ReflectivePlane](/docs/components/reflectiveplane), [Repeater](/docs/components/repeater), [RippleWipe](/docs/components/ripplewipe), [Ripples](/docs/components/ripples), [Satin](/docs/components/satin), [Saturation](/docs/components/saturation), [Scratches](/docs/components/scratches), [Sharpness](/docs/components/sharpness), [SimplexNoise](/docs/components/simplexnoise), [SineWave](/docs/components/sinewave), [SliceWipe](/docs/components/slicewipe), [Solarize](/docs/components/solarize), [SolidColor](/docs/components/solidcolor), [Spherize](/docs/components/spherize), [Spiral](/docs/components/spiral), [Strands](/docs/components/strands), [Stretch](/docs/components/stretch), [Stripes](/docs/components/stripes), [StudioBackground](/docs/components/studiobackground), [SunBurst](/docs/components/sunburst), [Swirl](/docs/components/swirl), [TiltShift](/docs/components/tiltshift), [Tint](/docs/components/tint), [TriangularGrid](/docs/components/triangulargrid), [Tritone](/docs/components/tritone), [Truchet](/docs/components/truchet), [Twirl](/docs/components/twirl), [VHS](/docs/components/vhs), [VenetianBlinds](/docs/components/venetianblinds), [Vibrance](/docs/components/vibrance), [VideoTexture](/docs/components/videotexture), [Vignette](/docs/components/vignette), [Voronoi](/docs/components/voronoi), [Voxels](/docs/components/voxels), [Watercolor](/docs/components/watercolor), [WaveDistortion](/docs/components/wavedistortion), [Waveform](/docs/components/waveform), [WaveletNoise](/docs/components/waveletnoise), [Weave](/docs/components/weave), [WebcamTexture](/docs/components/webcamtexture), [WorleyNoise](/docs/components/worleynoise), [ZoomBlur](/docs/components/zoomblur)