Sprite2DMaterialOptions

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:223

Properties

alphaTest?

optional alphaTest?: number

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:226

colorTransform?

optional colorTransform?: ColorTransformFn

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:250

Color transform function for custom effects (e.g., lighting)

effectsKey?

optional effectsKey?: string

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:254

Effect configuration key for material caching/batching

effectTier?

optional effectTier?: number

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:248

Effect buffer tier size in floats. Buffers are allocated in tiers: 0, 4, 8, 16. Default is 8 (2 vec4 buffers), covering most effect combinations. Set to 0 for fully effect-free materials (no effect buffer overhead).

globalUniforms?

optional globalUniforms?: GlobalUniforms

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:252

Global uniforms for auto-applying tint, time, etc.

lit?

optional lit?: boolean

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:232

Whether sprites using this material receive lighting. Part of the material identity (batching) key — lit and unlit sprites can’t share a batch. Default false.

map?

optional map?: Texture <unknown, TextureEventMap >

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:224

premultipliedAlpha?

optional premultipliedAlpha?: boolean

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:241

Use premultiplied alpha blending. When true, the shader outputs vec4(rgb * alpha, alpha) and uses CustomBlending with OneFactor / OneMinusSrcAlphaFactor. This eliminates Discard() calls, improving performance on WebGL by preserving early-z optimization. Depth writes are disabled since transparent pixels produce (0,0,0,0) which blends to nothing.

transparent?

optional transparent?: boolean

Defined in: packages/three-flatland/src/materials/Sprite2DMaterial.ts:225

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