< Flutter UIKit />

UTD Video Effects Kit

Echtzeit-Beauty-Filter, LUT-Farbkorrektur und Gesichtseffekte.

Version 0.5.0Auf pub.dev

Android (minSdk 24)iOS

video_effects_kit.dart

import 'package:utd_video_effects_kit/utd_video_effects_kit.dart';

final fx = VideoEffectsProcessor.create();
final track = await LocalVideoTrack.createCameraTrack(
  CameraCaptureOptions(processor: fx),
);

await fx.setSmoothing(0.6);
await fx.setFilter('teal_orange', intensity: 0.8);
await fx.setBackgroundBlur(0.4);
await fx.setEyeColor('#3366CC', opacity: 0.6);
await fx.setLipstick('#CC2244');

// Or use the built-in UI:
VideoEffectsSheet.show(context, processor: fx);

46+

LUT-Filter

Accessoires

Make-up-Looks

GPU

Echtzeit

< utd_video_effects_kit />

Wichtigste Funktionen

Echtzeit-Videoeffekte und Beauty-Filter für LiveKit-basierte Flutter-Apps. Die Effekte laufen über einen TrackProcessor auf nativen GPU-Pipelines (Android/iOS) und bündeln 46+ LUT-Farbfilter, Hautglättung/-aufhellung, Hintergrundunschärfe sowie MediaPipe-gestützte Gesichtseffekte (Augenfarbe, Make-up, Accessoires). Inklusive integrierter VideoEffectsSheet-UI mit den Tabs Beauty/Filters/Makeup/Accessories.

46+ LUT-Farbfilter (kuratierte + eigene Looks)

Beauty-Effekte: Hautglättung (Frequenztrennung), Aufhellung, Hintergrundunschärfe

Gesichtseffekte via MediaPipe: Augenfarbe, Make-up (Lippenstift/Lidschatten/Rouge), 9 Accessoires

Farb-Nachbearbeitung: Glow/Bloom (Orton), Filmkorn, Vignette

Haut-Retusche: Texturdetails, Klarheit, selektives Aufhellen

Gesichts-Reshaping: Landmark-gesteuerte Verzerrung (Augen vergrößern, Gesicht schmaler, Nase schmaler, …)

Sofort einsatzbereite VideoEffectsSheet-UI (Tabs Beauty/Filters/Makeup/Accessories)

Kuratierte Make-up-Looks und Hautton-Presets

Adaptives Frame-Budget-Management mit Geräte-Performance-Stufen

Glue-freie Anbindung des LiveKit TrackProcessor an LocalVideoTrack

< utd_video_effects_kit />

Erste Schritte

Installieren

pubspec.yaml

dependencies:
  utd_video_effects_kit: ^0.5.0

Auf pub.dev ansehen

Echtzeit-Beauty-Filter, LUT-Farbkorrektur und Gesichtseffekte.

Auf pub.dev ansehen

< utd_video_effects_kit />

API-Referenz

Main processor

The single public entry point: a LiveKit TrackProcessor that applies GPU beauty/filter effects natively.

VideoEffectsProcessorclass

abstract class VideoEffectsProcessor extends TrackProcessor<VideoProcessorOptions>

LiveKit-compatible video processor that applies GPU beauty/filter effects natively and exposes the result via processedTrack. Has no per-frame process() hook; pixel work runs natively.

VideoEffectsProcessor.createconstructor

factory VideoEffectsProcessor.create({EffectsState initial = const EffectsState()})

Builds the default native-backed implementation. The only way to construct a processor.

Parameter

initialEffectsStateStandard = const EffectsState()
Initial effect settings the processor starts with.

Rückgabewert: VideoEffectsProcessor — A native-backed processor instance.

stategetter

ValueListenable<EffectsState> get state

Live, read-only snapshot of current effect settings. Bind UI to this.

Rückgabewert: ValueListenable<EffectsState> — Listenable of the current immutable EffectsState.

isSupportedgetter

bool get isSupported

Whether this device/platform can actually process pixels. False means processedTrack is a passthrough (original camera frames flow unmodified).

Rückgabewert: bool — True if native pixel processing is available.

disposemethod

void dispose()

Final teardown: releases the effect-state listenable. Call when the live session ends. Distinct from LiveKit's per-capture destroy().

Rückgabewert: void — Nothing.

Adaptive performance & telemetry

Frame-budget signals and on-device measurement/parity harness.

budgetExceededgetter

ValueListenable<bool> get budgetExceeded

True while the native pipeline sheds work to hold the frame budget (degrade level > 0). Emits only on change. Always false on unsupported platforms.

Rückgabewert: ValueListenable<bool> — Listenable performance-mode flag.

degradeLevelgetter

ValueListenable<int> get degradeLevel

Current adaptive frame-budget degrade level: 0 (full quality) .. 4 (max shedding). 0 on unsupported platforms.

Rückgabewert: ValueListenable<int> — Listenable degrade level 0..4.

deviceTiergetter

ValueListenable<int> get deviceTier

Static device performance tier classified natively at attach: 0 Budget, 1 Low, 2 Mid, 3 Flagship. 3 on unsupported platforms or before first attach.

Rückgabewert: ValueListenable<int> — Listenable device tier 0..3.

perfStatsmethodasync

Future<EffectsPerfStats?> perfStats({bool reset = false})

Pulls a snapshot of native frame-budget telemetry (over-budget rate + frame-time distribution). Returns null on web/unsupported or with no native session.

Parameter

resetboolStandard = false
Clear counters after reading so the next call measures a fresh window.

Rückgabewert: Future<EffectsPerfStats?> — Telemetry snapshot, or null if unavailable.

renderTestFramemethodasync

Future<EffectsTestFrame?> renderTestFrame(Uint8List rgba, {required int width, required int height})

Runs an RGBA8888 image through the native COLOR grade with current settings and returns the processed RGBA8888 (CPU-vs-GPU parity harness). Call with effects disabled. Returns null if unavailable.

Parameter

rgbaUint8Listerforderlich
RGBA8888 row-major input, width*height*4 bytes.
widthinterforderlich
Input image width in pixels.
heightinterforderlich
Input image height in pixels.

Rückgabewert: Future<EffectsTestFrame?> — Graded output frame, or null if unavailable.

Beauty & color setters

Skin smoothing, whitening, LUT filters, and the color-post (glow/grain/vignette) tail.

setEnabledmethodasync

Future<void> setEnabled(bool enabled)

Master on/off switch. When off the native pipeline is a 1:1 passthrough.

Parameter

enabledboolerforderlich
Whether effects are applied.

Rückgabewert: Future<void> — Completes when applied.

setSmoothingmethodasync

Future<void> setSmoothing(double amount)

Skin-smoothing strength, 0.0..1.0 (frequency-separation / bilateral).

Parameter

amountdoubleerforderlich
Smoothing strength, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setWhiteningmethodasync

Future<void> setWhitening(double amount)

Whitening / brightness strength, 0.0..1.0.

Parameter

amountdoubleerforderlich
Whitening strength, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setFiltermethodasync

Future<void> setFilter(String? lutAssetKey, {double intensity = 1.0})

Apply a LUT color filter by key (null clears it). See VideoEffectsFilters.

Parameter

lutAssetKeyString?erforderlich
Filter key (e.g. 'warm'), or null to clear.
intensitydoubleStandard = 1.0
Blend amount, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setBackgroundBlurmethodasync

Future<void> setBackgroundBlur(double amount)

Background-blur strength, 0.0..1.0 (selfie segmentation + blur).

Parameter

amountdoubleerforderlich
Blur strength, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setGlowmethodasync

Future<void> setGlow(double amount)

Soft glow / bloom (Orton) strength, 0.0..1.0. The highest-impact beauty color post effect.

Parameter

amountdoubleerforderlich
Glow strength, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setGrainmethodasync

Future<void> setGrain(double amount)

Film-grain amount, 0.0..1.0 (animated per frame).

Parameter

amountdoubleerforderlich
Grain amount, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setVignettemethodasync

Future<void> setVignette(double amount)

Vignette strength, 0.0..1.0 (darkens frame corners).

Parameter

amountdoubleerforderlich
Vignette strength, 0.0..1.0 (0 = off).

Rückgabewert: Future<void> — Completes when applied.

setTextureDetailmethodasync

Future<void> setTextureDetail(double amount)

Pore/texture retained by frequency-separation smoothing, 0.0..1.0 (0 = plastic, 1 = full texture). Only affects skin when smoothing > 0.

Parameter

amountdoubleerforderlich
Texture retention, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setClaritymethodasync

Future<void> setClarity(double amount)

Local-contrast clarity, signed -1.0..1.0. Positive = punchy/pop, negative = soft dreamy skin. 0 = off.

Parameter

amountdoubleerforderlich
Signed clarity, -1.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

Skin retouch & tone

Selective brightening (teeth/eye/under-eye) and skin-tone presets/shift.

setTeethWhiteningmethodasync

Future<void> setTeethWhitening(double amount)

Teeth-whitening strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Teeth-whitening strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setEyeBrighteningmethodasync

Future<void> setEyeBrightening(double amount)

Eye-white (sclera) brightening, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Eye-white brightening strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setUnderEyeBrighteningmethodasync

Future<void> setUnderEyeBrightening(double amount)

Under-eye (tear-trough) brightening, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Under-eye brightening strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setSkinColormethodasync

Future<void> setSkinColor(String? presetKey)

Apply a skin-tone preset by key (null clears it). See VideoEffectsSkinTones.

Parameter

presetKeyString?erforderlich
Skin-tone preset key (e.g. 'nuanbai'), or null to clear.

Rückgabewert: Future<void> — Completes when applied.

setSkinToneShiftmethodasync

Future<void> setSkinToneShift(double amount)

Skin-tone shift, signed -1.0..1.0: warms (+) or cools (-) skin via hue rotation gated by the adaptive skin mask. 0 = off.

Parameter

amountdoubleerforderlich
Signed skin-tone shift, -1.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setSegmentationSkinmethodasync

Future<void> setSegmentationSkin(bool enabled)

Use multiclass segmentation to refine the skin region so skin effects apply to actual skin. Loads a larger/slower model. Default off.

Parameter

enabledboolerforderlich
Whether segmentation-refined skin masking is on.

Rückgabewert: Future<void> — Completes when applied.

Makeup, sculpt & reshape setters

Landmark-driven makeup recolor, dodge/burn sculpt, and liquify reshape.

setEyeColormethodasync

Future<void> setEyeColor(String? hex, {double opacity = 0.5})

Recolor the iris with hex (e.g. '#3366CC', null clears it).

Parameter

hexString?erforderlich
Iris color hex, or null to clear.
opacitydoubleStandard = 0.5
Recolor strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setLipstickmethodasync

Future<void> setLipstick(String? hex, {double opacity = 0.6, String finish = 'satin', String style = 'full'})

Apply lipstick in hex (null clears it). finish: matte/satin/gloss. style: full/ombre/blurred.

Parameter

hexString?erforderlich
Lipstick color hex, or null to clear.
opacitydoubleStandard = 0.6
Strength, 0.0..1.0.
finishStringStandard = 'satin'
matte, satin, or gloss.
styleStringStandard = 'full'
full, ombre, or blurred.

Rückgabewert: Future<void> — Completes when applied.

setEyeshadowmethodasync

Future<void> setEyeshadow(String? hex, {double opacity = 0.45, String? color2, double shimmer = 0})

Apply eyeshadow in hex (null clears it). color2 gives a two-tone gradient; shimmer adds sparkle.

Parameter

hexString?erforderlich
Eyeshadow color hex, or null to clear.
opacitydoubleStandard = 0.45
Strength, 0.0..1.0.
color2String?Standard = null
Second hex for a two-tone (darker lash-line) gradient.
shimmerdoubleStandard = 0
Sparkle amount, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setBlushmethodasync

Future<void> setBlush(String? hex, {double opacity = 0.4})

Apply blush in hex (null clears it).

Parameter

hexString?erforderlich
Blush color hex, or null to clear.
opacitydoubleStandard = 0.4
Strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setEyelinermethodasync

Future<void> setEyeliner(String? hex, {double opacity = 0.7, String style = 'classic'})

Apply eyeliner in hex (null clears it). style: classic or wing (adds an outer flick).

Parameter

hexString?erforderlich
Eyeliner color hex, or null to clear.
opacitydoubleStandard = 0.7
Strength, 0.0..1.0.
styleStringStandard = 'classic'
classic or wing.

Rückgabewert: Future<void> — Completes when applied.

setMakeupLookmethodasync

Future<void> setMakeupLook(MakeupLook? look)

Apply a coordinated MakeupLook in one call (lipstick + finish, eyeshadow, blush, eye color). Null clears all makeup regions. See VideoEffectsMakeup.looks.

Parameter

lookMakeupLook?erforderlich
The look to apply, or null to clear all makeup.

Rückgabewert: Future<void> — Completes when applied.

setContourmethodasync

Future<void> setContour(double amount)

Contour (cool-gray cheek/nose burn) strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Contour strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setHighlightmethodasync

Future<void> setHighlight(double amount)

Highlight (warm-white dodge on high points) strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Highlight strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setEyeEnlargemethodasync

Future<void> setEyeEnlarge(double amount)

Eye-enlarge reshape strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Eye-enlarge strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setFaceSlimmethodasync

Future<void> setFaceSlim(double amount)

Face-slim reshape strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Face-slim strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setNoseNarrowmethodasync

Future<void> setNoseNarrow(double amount)

Nose-narrow reshape strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Nose-narrow strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setLipPlumpmethodasync

Future<void> setLipPlump(double amount)

Lip-plump reshape strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Lip-plump strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

setChinShortenmethodasync

Future<void> setChinShorten(double amount)

Chin-shorten reshape strength, 0.0..1.0 (0 = off).

Parameter

amountdoubleerforderlich
Chin-shorten strength, 0.0..1.0.

Rückgabewert: Future<void> — Completes when applied.

Accessories setters

Toggle landmark-positioned PNG overlays. One toggle per accessory.

setGlassesmethodasync

Future<void> setGlasses(bool enabled)

Toggle the glasses accessory overlay.

Parameter

enabledboolerforderlich
Whether the glasses overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setSunglassesmethodasync

Future<void> setSunglasses(bool enabled)

Toggle the sunglasses accessory overlay.

Parameter

enabledboolerforderlich
Whether the sunglasses overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setCrownmethodasync

Future<void> setCrown(bool enabled)

Toggle the crown accessory overlay.

Parameter

enabledboolerforderlich
Whether the crown overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setCatEarsmethodasync

Future<void> setCatEars(bool enabled)

Toggle the cat-ears accessory overlay.

Parameter

enabledboolerforderlich
Whether the cat-ears overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setFlowerCrownmethodasync

Future<void> setFlowerCrown(bool enabled)

Toggle the flower-crown accessory overlay.

Parameter

enabledboolerforderlich
Whether the flower-crown overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setPartyHatmethodasync

Future<void> setPartyHat(bool enabled)

Toggle the party-hat accessory overlay.

Parameter

enabledboolerforderlich
Whether the party-hat overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setBunnyEarsmethodasync

Future<void> setBunnyEars(bool enabled)

Toggle the bunny-ears accessory overlay.

Parameter

enabledboolerforderlich
Whether the bunny-ears overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setMustachemethodasync

Future<void> setMustache(bool enabled)

Toggle the mustache accessory overlay.

Parameter

enabledboolerforderlich
Whether the mustache overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

setHalomethodasync

Future<void> setHalo(bool enabled)

Toggle the halo accessory overlay.

Parameter

enabledboolerforderlich
Whether the halo overlay is shown.

Rückgabewert: Future<void> — Completes when applied.

Built-in UI

Drop-in bottom sheet that drives a processor with Beauty/Filters/Makeup/Accessories tabs.

VideoEffectsSheetclass

class VideoEffectsSheet

Self-contained beauty & filters bottom sheet (Beauty / Filters / Makeup / Accessories tabs) that drives a VideoEffectsProcessor. Dark over-video styling; accent from theme primary; auto Arabic labels.

VideoEffectsSheet.showmethodasync

static Future<void> show(BuildContext context, {required VideoEffectsProcessor processor, double heightFactor = defaultHeightFactor})

Opens the beauty & filters sheet for processor. Turns the master switch on (idempotent), then shows a modal bottom sheet. Returns when dismissed.

Parameter

contextBuildContexterforderlich
Build context to show the modal in.
processorVideoEffectsProcessorerforderlich
The processor the sheet controls.
heightFactordoubleStandard = defaultHeightFactor (0.25)
Sheet height as a fraction of screen height.

Rückgabewert: Future<void> — Completes when the sheet is dismissed.

defaultHeightFactorproperty

static const double defaultHeightFactor = 0.25

Default sheet height as a fraction of the screen height (1/4).

Rückgabewert: double — 0.25

Catalogs (filters, skin tones, accessories, makeup)

Pure-data catalogs of bundled LUT filters, skin-tone presets, accessories, and makeup shades/looks.

VideoEffectsFiltersclass

class VideoEffectsFilters

Catalog of bundled LUT color filters (45+ entries). Static-only (private constructor).

VideoEffectsFilters.allproperty

static const List<VideoEffectFilter> all

All bundled LUT filters, in display order (fresh, night, autumn, clean_girl, teal_orange, etc.).

Rückgabewert: List<VideoEffectFilter> — Bundled filter catalog.

VideoEffectsFilters.assetFormethod

static String? assetFor(String? key)

The LUT asset path for a filter key, or null for an unknown/cleared key.

Parameter

keyString?erforderlich
Filter key to resolve.

Rückgabewert: String? — Asset path or null.

VideoEffectsFilters.previewFormethod

static String previewFor(String? key)

Preview thumbnail asset path for a filter key (portrait with filter applied). Null gives the unfiltered 'none' preview.

Parameter

keyString?erforderlich
Filter key, or null for the 'none' preview.

Rückgabewert: String — Preview asset path.

VideoEffectsFilters.skinPreviewFormethod

static String skinPreviewFor(String? key)

Preview thumbnail asset path for a skin-tone preset (same portrait, skin LUT grade).

Parameter

keyString?erforderlich
Skin-tone key, or null for the 'none' preview.

Rückgabewert: String — Preview asset path.

VideoEffectFilterclass

class VideoEffectFilter { const VideoEffectFilter(this.key, this.label, this.asset); }

A bundled LUT color filter: stable key, human label, and 512x512 LUT PNG asset path.

Parameter

keyStringerforderlich
Stable key passed to setFilter, e.g. 'fresh'.
labelStringerforderlich
Human-readable label, e.g. 'Fresh'.
assetStringerforderlich
Packaged asset path of the LUT PNG.

VideoEffectsSkinTonesclass

class VideoEffectsSkinTones

Catalog of bundled skin-tone presets (Warm/Cool/Pink/Wheat/Tan). Static-only. Has all (List<VideoEffectSkinTone>) and byKey(String?).

VideoEffectsSkinTones.byKeymethod

static VideoEffectSkinTone? byKey(String? key)

Look up a skin-tone preset by key, or null for unknown/null.

Parameter

keyString?erforderlich
Skin-tone preset key.

Rückgabewert: VideoEffectSkinTone? — Preset or null.

VideoEffectsAccessoriesclass

class VideoEffectsAccessories

Catalog of bundled PNG accessories (glasses, crown, catEars, sunglasses, flowerCrown, partyHat, bunnyEars, mustache, halo). Static-only.

VideoEffectsAccessories.allproperty

static const List<VideoEffectAccessory> all

All bundled accessories, each with a key matching the EffectsState toggle.

Rückgabewert: List<VideoEffectAccessory> — Accessory catalog.

VideoEffectsAccessories.assetFormethod

static String? assetFor(String? key)

The PNG asset path for an accessory key, or null for an unknown key.

Parameter

keyString?erforderlich
Accessory key to resolve.

Rückgabewert: String? — Asset path or null.

VideoEffectsMakeupclass

class VideoEffectsMakeup

Curated makeup shades + full looks. Static-only. Exposes lipstick, eyeshadow, blush, eyeColor (List<MakeupShade>) and looks (List<MakeupLook>).

VideoEffectsMakeup.looksproperty

static const List<MakeupLook> looks

Coordinated full looks (lip + eyeshadow + blush [+ eye color]): natural, glam, soft_rose, bold_berry, sunkissed, smoky_night.

Rückgabewert: List<MakeupLook> — Curated full looks.

VideoEffectsMakeup.lookByKeymethod

static MakeupLook? lookByKey(String? key)

Look up a coordinated MakeupLook by key, or null for unknown/null.

Parameter

keyString?erforderlich
Look key.

Rückgabewert: MakeupLook? — Look or null.

Models & data types

Immutable state snapshot, catalog item types, and telemetry/parity result types.

EffectsStateclass

class EffectsState { const EffectsState({bool enabled = false, double smoothing = 0, ... bool halo = false}); }

Immutable snapshot of active video-effect settings (~50 fields: enabled, smoothing, whitening, filterKey/filterIntensity, makeup hex+opacity, sculpt/reshape scalars, accessory bools). All intensities normalized 0.0..1.0.

Parameter

enabledboolStandard = false
Master switch.
smoothingdoubleStandard = 0
Skin-smoothing strength.
filterKeyString?Standard = null
Active LUT filter key, or null.
filterIntensitydoubleStandard = 1.0
Blend amount for filterKey.
……
Plus whitening, glow, grain, vignette, clarity, makeup hex/opacity fields, reshape/sculpt scalars, and accessory bools.

copyWithmethod

EffectsState copyWith({bool? enabled, double? smoothing, Object? filterKey = _unset, ...})

Returns a copy with the given fields changed. Nullable fields use an _unset sentinel so passing null clears (vs leaving unchanged).

Parameter

……
Any subset of EffectsState fields to override.

Rückgabewert: EffectsState — A new modified state.

toMapmethod

Map<String, dynamic> toMap()

Serialized form sent to the native pipeline over the method channel.

Rückgabewert: Map<String, dynamic> — All effect fields as a map.

VideoEffectSkinToneclass

const VideoEffectSkinTone(this.key, this.label, this.skinAsset, this.bgAsset)

A skin-tone preset (dual-LUT grade): a skin LUT over skin regions plus a background LUT elsewhere.

Parameter

keyStringerforderlich
Stable preset key, e.g. 'nuanbai'.
labelStringerforderlich
Human label, e.g. 'Warm'.
skinAssetStringerforderlich
Skin-region LUT asset path.
bgAssetStringerforderlich
Background LUT asset path.

VideoEffectAccessoryclass

const VideoEffectAccessory(this.key, this.label, this.asset)

A landmark-positioned PNG accessory overlay.

Parameter

keyStringerforderlich
Stable key matching the EffectsState toggle, e.g. 'glasses'.
labelStringerforderlich
Human-readable label.
assetStringerforderlich
Packaged transparent PNG asset path.

MakeupShadeclass

const MakeupShade(this.key, this.label, this.hex, this.opacity)

A curated makeup shade: a hex color plus recommended opacity for one region. Feed hex+opacity into the matching setter.

Parameter

keyStringerforderlich
Stable key, e.g. 'classic_red'.
labelStringerforderlich
Human label, e.g. 'Classic Red'.
hexStringerforderlich
#RRGGBB color.
opacitydoubleerforderlich
Recommended strength, 0.0..1.0.

MakeupLookclass

const MakeupLook(this.key, this.label, {String? lipstick, double lipstickOpacity = 0.6, String lipFinish = 'satin', String? eyeshadow, ...})

A full makeup look bundling coordinated shades across regions. Apply with setMakeupLook. Has a preview getter for the thumbnail asset path.

Parameter

keyStringerforderlich
Stable look key.
labelStringerforderlich
Human label.
lipstickString?Standard = null
Lipstick hex.
lipFinishStringStandard = 'satin'
matte, satin, or gloss.
eyeshadowString?Standard = null
Eyeshadow hex (plus blush, eyeColor, and per-region opacities).

EffectsPerfStatsclass

class EffectsPerfStats { const EffectsPerfStats({required int frames, ... required double frameMs}); }

Immutable snapshot of native frame-budget telemetry: frame counts, over-budget/over-frame counts, raise/lower events, per-level frames, mean/p50/p95/p99/max ms, histogram bins, device tier, and budget/frame thresholds.

Parameter

framesinterforderlich
Total frames timed since last reset.
overBudgetinterforderlich
Frames slower than budgetMs.
……
Plus overFrame, raiseEvents, lowerEvents, levelFrames, meanMs, maxMs, p50/p95/p99Ms, binMs, bins, tier, budgetMs, frameMs.

overBudgetRategetter

double get overBudgetRate

Fraction of frames slower than budgetMs (0.0..1.0). The primary perf signal.

Rückgabewert: double — Over-budget fraction.

overFrameRategetter

double get overFrameRate

Fraction of frames slower than frameMs — i.e. frames that actually dropped.

Rückgabewert: double — Dropped-frame fraction.

EffectsPerfStats.fromMapmethod

static EffectsPerfStats? fromMap(Map<String, dynamic>? m)

Builds a snapshot from the native channel map; null for a null/empty map.

Parameter

mMap<String, dynamic>?erforderlich
Native telemetry map.

Rückgabewert: EffectsPerfStats? — Snapshot or null.

EffectsTestFrameclass

const EffectsTestFrame({required Uint8List rgba, required int width, required int height})

Result of renderTestFrame: an RGBA8888 image produced by running a known input through the native color grade with current settings.

Parameter

rgbaUint8Listerforderlich
Graded pixels, RGBA8888 row-major, alpha opaque.
widthinterforderlich
Image width in pixels.
heightinterforderlich
Image height in pixels.

FrameDiffclass

class FrameDiff { const FrameDiff({required int maxDelta, required double meanDelta, required int pixels, required int diffPixels, required int threshold}); }

A per-channel difference summary between two RGBA8888 buffers (pure Dart, offline-testable). Has diffFraction getter and a static compare().

Parameter

maxDeltainterforderlich
Largest absolute per-channel delta (0..255).
meanDeltadoubleerforderlich
Mean absolute per-channel delta over RGB.
pixelsinterforderlich
Total pixels compared.
diffPixelsinterforderlich
Pixels differing by more than threshold.
thresholdinterforderlich
Per-channel delta counted as different.

FrameDiff.comparemethod

static FrameDiff compare(Uint8List a, Uint8List b, {int threshold = 2})

Compares two RGBA8888 buffers on RGB channels (alpha ignored). Returns a zeroed diff when sizes mismatch or are empty.

Parameter

aUint8Listerforderlich
First RGBA8888 buffer.
bUint8Listerforderlich
Second RGBA8888 buffer.
thresholdintStandard = 2
Per-channel delta above which a pixel counts as different.

Rückgabewert: FrameDiff — The difference summary.

Bereit, mit UTD zu entwickeln?

Erstellen Sie Ihr Konto, laden Sie Ihre Master-Wallet auf und aktivieren Sie die Dienste, die Sie brauchen.

Kostenloses Konto erstellen