Sprite2DOptions

Defined in: packages/three-flatland/src/sprites/types.ts:61

Options for creating a Sprite2D.

Properties

alpha?

optional alpha?: number

Defined in: packages/three-flatland/src/sprites/types.ts:71

Opacity 0-1, default 1

anchor?

optional anchor?: [number, number] | Vector2

Defined in: packages/three-flatland/src/sprites/types.ts:67

Anchor/pivot point (0-1), default [0.5, 0.5] (center)

castsShadow?

optional castsShadow?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:87

Whether this sprite contributes to the shadow-caster occlusion pre-pass (default: false — opt in)

flipX?

optional flipX?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:73

Flip horizontally

flipY?

optional flipY?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:75

Flip vertically

frame?

optional frame?: SpriteFrame

Defined in: packages/three-flatland/src/sprites/types.ts:65

Initial frame (optional, defaults to full texture)

lit?

optional lit?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:83

Whether this sprite receives lighting from Flatland’s LightEffect (default: true)

material?

optional material?: Sprite2DMaterial

Defined in: packages/three-flatland/src/sprites/types.ts:99

Custom material (sprites with same material instance batch together)

pixelPerfect?

optional pixelPerfect?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:81

Snap final projected translation to physical pixels (default: true)

receiveShadows?

optional receiveShadows?: boolean

Defined in: packages/three-flatland/src/sprites/types.ts:85

Whether this sprite receives shadows from the SDF shadow pipeline (default: true)

shadowRadius?

optional shadowRadius?: number

Defined in: packages/three-flatland/src/sprites/types.ts:97

Per-sprite occluder radius in world units. Consumed by shadow- casting LightEffects (e.g., the SDF sphere-tracer uses it as the self-silhouette escape distance). When omitted (default), the batch layer auto-resolves to max(scale.x, scale.y) each frame, which tracks scale changes and animation frame size swaps. Set explicitly to override — useful when the visible body is tighter than the quad bounds.

sortLayer?

optional sortLayer?: SortLayerValue

Defined in: packages/three-flatland/src/sprites/types.ts:77

Sort layer — registered name or numeric order

texture?

optional texture?: Texture <unknown, TextureEventMap >

Defined in: packages/three-flatland/src/sprites/types.ts:63

Texture to use (can be set later via texture property for R3F compatibility)

tint?

optional tint?: string | number | [number, number, number] | Color

Defined in: packages/three-flatland/src/sprites/types.ts:69

Tint color, default white. Accepts Color, hex string, hex number, or [r, g, b] array (0-1)

zIndex?

optional zIndex?: number

Defined in: packages/three-flatland/src/sprites/types.ts:79

Z-index within sortLayer

Getting Started

Introduction Installation Quick Start

Concepts

The Flatland Pipeline Batch Rendering 2D Lighting Shadows & Occlusion Devtools Architecture

Guides

Sprites Set up a Flatland scene Alpha API Migration Pixel-Perfect Rendering Animation Loaders Tilemaps Hit Testing Lighting Shadows Baking TSL Nodes Pass Effects Skia Slug Text Devtools

Resources

API Reference

nodes/src

Interfaces

CRTOptions DissolveOptions Light2DResult LitSpriteOptions OutlineOptions

Type Aliases

ColorInput FloatInput Vec2Input Vec3Input Vec4Input

Functions

afterimage afterimageGlow afterimageTinted alphaMask alphaMaskInvert alphaMaskValue alphaTest alphaTestOpaque ambientLight2D analogGlitch bayerDither bayerDither2x2 bayerDither4x4 bayerDither8x8 bloom bloomAnamorphic bloomSimple bloomThreshold blurBox blurBox3x3 blurBoxDirectional blurBoxSmooth blurFocus blurGaussian blurGaussian2Pass blurGaussian9 blurKawase blurKawaseDown blurKawaseMulti blurKawaseSimple blurKawaseUp blurMotion blurMotionObject blurMotionVelocity blurRadial blurRadialDistance blurShake blurSpin brightness brightnessClamped brightnessMultiply c64Palette cgaPalette chromaticAberration chromaticAberrationCustom chromaticAberrationPulse chromaticAberrationRadial colorBleeding colorRemap colorRemapCustom colorReplace colorReplaceHard colorReplaceMultiple contrast contrastSCurve crtBloom crtColorBleed crtComplete crtConvergence crtCurvature crtCurvatureWithCorners crtVignette directionalLight2D dissolve dissolveDirectional dissolvePixelated dissolveSimple distortBarrel distortBulge distortDisplace distortNoise distortPerlin distortPinch distortPixelate distortPixelateCount distortShatter distortSimplex distortSpherize distortTurbulence distortTwirl dmgPalette dotMatrix eagle fadeEdge fadeEdgeHorizontal fadeEdgeRadial fadeEdgeVertical filmGrain flash flashAdditive flashAlpha flashDamage flashHeal flashPowerUp flashSmooth gbcPalette ghost ghostSpeed ghostTrail glowSelective grayscale hq2x hq3x hq4x hueShift hueShiftNormalized interlacing lcdBacklightBleed lcdGBC lcdGhosting lcdGrid lcdMotionGhost lcdPocket linearRgbToOklab linearRgbToOklch litCelShaded litDiffuse litRim litSpecular litSprite litSpriteMulti md9bitPalette normalFromHeight normalFromHeightSmooth ntscComposite oklabLerp oklabToLinearRgb oklabToRgb oklchHueShift oklchLerp oklchLightness oklchSaturate oklchToLinearRgb oklchToRgb outline outline8 palettize palettizeDithered palettizeNearest phosphorApertureGrille phosphorMask phosphorShadowMask phosphorSimple phosphorSlotMask pixelate pixelateBySize pocketPalette pointLight2D posterize posterizeGamma ppuPalette pulse pulseGlow pulseHeartbeat pulseRadial pulseRainbow quantize quantizeRGB rgbToOklab rgbToOklch sai2x sampleSprite saturate scale2x scale3x scanlines scanlinesGlow scanlinesGrid scanlinesInterlaced scanlinesSmooth shadow2D shadowDrop shadowDropSoft shadowSDF2D shadowSoft2D shimmer shimmerHolographic shimmerMetallic shimmerWave signalInterference snesPalette sparkle sparkleRainbow sparkleStar speedLines spotLight2D spriteUV staticNoise superEagle tint tintAdditive trail trailAdditive trailBlur trailVelocity uvFlip uvOffset uvRotate uvScale vbPalette vhsDistortion vignette waveHorizontal waveRadial waveRipple waveVertical waveWater

presets/src

Variables

DefaultLightEffect NormalMapProvider

three-flatland/src

Classes

AlphaMap AnimatedSprite2D AnimationController BatchQueryView EffectMaterial Flatland FlatlandConfig ForwardPlusLighting GlobalUniforms LDtkLoader Light2D LightEffect MaterialEffect PassEffect PixelPerfectCamera RenderingConfig SortLayer SortLayerGroup Sprite2D Sprite2DMaterial SpriteGroup SpriteSheetLoader TextureConfig TextureLoader TiledLoader TileLayer TileMap2D Tileset

Interfaces

AnimatedSprite2DOptions Animation AnimationFrame AnimationSetDefinition AnimationState AtlasJson BatchKey BatchQueryTag ChannelNodeContext ChannelNodeMap ChunkCoord ColorTransformContext DevtoolsProviderHandle EffectField EffectMaterialOptions EffectNodeContext FlatlandConfigOptions FlatlandOptions InstanceAttributeConfig LDtkLoaderOptions Light2DOptions Light2DUniforms LightEffectBuildContext LightEffectRuntimeContext NormalRegion NormalSourceDescriptor ObjectLayerData OcclusionPassOptions Oklab Oklch PassEffectContext PixelPerfectCameraOptions PlayOptions RayPlaneHit RemoteBridgeHandle RenderingOptions RenderStats ResolveAlphaMapOptions SortLayerConfig SortLayerDescriptor SortLayerRegistry Sprite2DMaterialOptions Sprite2DOptions SpriteFrame SpriteFrameRect SpriteGroupOptions SpriteSheet SpriteSheetJSONArray SpriteSheetJSONHash SpriteSheetLoaderOptions TextureLoaderOptions TextureOptions TileAnimationFrame TileDefinition TiledLoaderOptions TileInstance TileLayerData TileLayerOptions TileMap2DOptions TileMapData TileMapObject TileNormalCustomData TilesetCell TilesetData TilesetGrid TilesetGridOptions WebSocketLike

Type Aliases

BlendMode BuiltInSortLayer ChannelName ClipRect CollisionShape ColorTransformFn EffectConstants EffectSchema EffectSchemaValue EffectValues FlatlandPreset FlatlandSetting HitTestMode InstanceAttributeType Light2DType LightEffectClass MaterialEffectClass NormalBump NormalDirection ObservableStrategy PassEffectClass PassEffectFn PixelScale RenderingPreset RenderingSetting Snapshot SortLayerName SortLayerValue SortMode SpriteSortFunction TexturePreset TileLookupFn UniformKeys WithRequiredChannels

Variables

ALL_HIT_TEST_MODES ALPHA_SIDECAR_DESCRIPTOR channelDefaults EFFECT_BIT_OFFSET FLATLAND_PRESETS IsAlphaBlendedBatch IsAlphaTestedBatch IsLitBatch IsUnlitBatch LIT_FLAG_MASK MAX_LIGHTS_PER_TILE observable RECEIVE_SHADOWS_MASK RENDERING_PRESETS SortLayers TEXTURE_PRESETS TILE_SIZE VERSION

Functions

analogous applyHierarchicalPresets applyTextureOptions buildTilesetGrid clampOklch colorToOklab colorToOklch complementary computeTier concatAnimations contrastRatio createAnimation createAnimationFromPattern createAnimationsFromNaming createConsumerRemoteBridge createDevtoolsProvider createIntersection createLightEffect createMaterialEffect createPassEffect createProviderRemoteBridge declareSortLayer decodeAlphaPng decodeDebugMessage decodeSortKey deltaEOklab encodeDebugMessage encodeSortKey equallySpacedHues framesToRegions gamutMapOklch getPackedComponent getSortLayer gradientOklch isDevtoolsActive isInGamut isLight2D lerpOklab lerpOklch linearRgbToOklab linearToSrgb monochromaticPalette oklabToColor oklabToLinearRgb oklabToOklch oklchToColor oklchToOklab rayPlaneZ0 readCastShadowFlag readEnableBits readFlip readLitFlag readReceiveShadowsFlag readShadowRadius readSystemFlags registerDebugArray registerDebugTexture relativeLuminance resolveAlphaMap resolveHitTestMode resolvePixelPerfect resolveRenderingOptions resolveSortLayer resolveTextureOptions reverseAnimation shallowEqual splitComplementary srgbToLinear tetradic tilesetCellAt tilesetToRegions tileToRegions touchDebugArray touchDebugTexture triadic unregisterDebugArray unregisterDebugTexture uvToWorld wcagLevel wholeTextureRegion worldToUV wrapWithLightFlags

three-flatland/src/react

Interfaces

UsePixelPerfectCameraBindingOptions UsePixelPerfectCameraOptions

Type Aliases

EffectElement LightEffectElement

Functions

attachEffect attachLighting createFlatlandCompute usePixelPerfectCamera usePixelPerfectCameraBinding