@vincentt-xr/sdk 2.0.0-alpha.7 → 2.0.0-alpha.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/GROUNDING.md +5651 -82
- package/README.md +1 -0
- package/dist/CanonicalHeadFrame-BHcWyaiK.js +1506 -0
- package/dist/CanonicalHeadFrame-D-_T1OMU.cjs +1 -0
- package/dist/DebuggerUI-7ngnJsBe.js +275 -0
- package/dist/DebuggerUI-CoglgKdO.cjs +1 -0
- package/dist/FaceRetouch-CLoTfrcs.js +1071 -0
- package/dist/FaceRetouch-J1lC1WbS.cjs +134 -0
- package/dist/FaceSurface-CHAMEeG1.cjs +1 -0
- package/dist/FaceSurface-DmP9AEeC.js +27 -0
- package/dist/SegmentationOverlay-D_FWkcyP.cjs +35 -0
- package/dist/SegmentationOverlay-vn5x_knv.js +6237 -0
- package/dist/SkeletonUtils-C2r90MtN.js +21 -0
- package/dist/SkeletonUtils-CddIup1F.cjs +1 -0
- package/dist/TextLabel-XE0rQSDn.cjs +2 -0
- package/dist/TextLabel-c9BCucOI.js +961 -0
- package/dist/assets/cache.d.ts +99 -0
- package/dist/assets/estimate.d.ts +11 -0
- package/dist/assets/gltfLoader.d.ts +16 -0
- package/dist/assets/index.d.ts +7 -0
- package/dist/assets/loaders.d.ts +43 -0
- package/dist/assets/react.d.ts +33 -0
- package/dist/body-pose/index.d.ts +521 -0
- package/dist/body-trigger/__fixtures__/syntheticBody.d.ts +83 -0
- package/dist/body-trigger/frame.d.ts +88 -0
- package/dist/body-trigger/index.d.ts +6 -0
- package/dist/body-trigger/moves.d.ts +235 -0
- package/dist/body-trigger/trigger.d.ts +75 -0
- package/dist/calibration/calibration.d.ts +75 -0
- package/dist/calibration/index.d.ts +6 -0
- package/dist/calibration/storage.d.ts +13 -0
- package/dist/calibration/types.d.ts +53 -0
- package/dist/calibration/useXRCalibration.d.ts +46 -0
- package/dist/camera/CameraPermissionGate.d.ts +26 -0
- package/dist/camera/devices.d.ts +26 -0
- package/dist/camera/index.d.ts +8 -0
- package/dist/camera/permission.d.ts +86 -0
- package/dist/camera/useCameraPermission.d.ts +35 -0
- package/dist/canonicalFace-BHwyCx1c.js +9 -0
- package/dist/canonicalFace-C83I225R.cjs +1 -0
- package/dist/capabilities/detect.d.ts +45 -0
- package/dist/capabilities/index.d.ts +5 -0
- package/dist/capabilities/types.d.ts +120 -0
- package/dist/capabilities/useXRCapabilities.d.ts +18 -0
- package/dist/compat/environment.d.ts +5 -0
- package/dist/compat/index.d.ts +4 -0
- package/dist/compat/run.d.ts +18 -0
- package/dist/compat/scenarios.d.ts +10 -0
- package/dist/compat/types.d.ts +101 -0
- package/dist/components/BodyInstruction/BodyPoseHint.d.ts +63 -0
- package/dist/components/BodyInstruction/index.d.ts +69 -0
- package/dist/components/BodyInstruction/useBodyPose.d.ts +23 -0
- package/dist/components/BodyTracker/index.d.ts +17 -0
- package/dist/components/BodyTrigger/index.d.ts +49 -0
- package/dist/components/Debugger/DebuggerProvider.d.ts +14 -1
- package/dist/components/Debugger/DebuggerUI.d.ts +3 -1
- package/dist/components/FaceAtlas/FaceAtlasLayer.d.ts +114 -0
- package/dist/components/FaceAtlas/MadeUpCamera.d.ts +80 -0
- package/dist/components/FaceAtlas/constants.d.ts +8 -0
- package/dist/components/FaceAtlas/index.d.ts +7 -0
- package/dist/components/FaceAtlas/useFaceAtlasSurface.d.ts +84 -0
- package/dist/components/FaceAtlas/useFaceSkin.d.ts +84 -0
- package/dist/components/FaceCharacter/ExternalFaceMesh.d.ts +109 -0
- package/dist/components/FaceCharacter/FaceExpressionController.d.ts +53 -0
- package/dist/components/FaceCharacter/FaceMorph.d.ts +71 -0
- package/dist/components/FaceCharacter/FacePiercing.d.ts +65 -0
- package/dist/components/FaceCharacter/FaceReprojection.d.ts +85 -0
- package/dist/components/FaceCharacter/FaceRig.d.ts +38 -0
- package/dist/components/FaceCharacter/FaceSurface.d.ts +49 -0
- package/dist/components/FaceCharacter/FaceSurfaceOccluder.d.ts +39 -0
- package/dist/components/FaceCharacter/PinToFaceMesh.d.ts +68 -0
- package/dist/components/FaceCharacter/index.d.ts +18 -0
- package/dist/components/FaceCharacter/useFaceReprojector.d.ts +10 -0
- package/dist/components/FaceInset/FaceInset.d.ts +68 -0
- package/dist/components/FaceInset/frame.d.ts +94 -0
- package/dist/components/FaceInset/index.d.ts +6 -0
- package/dist/components/FaceInset/material.d.ts +40 -0
- package/dist/components/FaceInset/useFaceInsetTexture.d.ts +37 -0
- package/dist/components/FaceInstruction/FaceExpressionHint.d.ts +43 -0
- package/dist/components/FaceInstruction/index.d.ts +56 -0
- package/dist/components/FaceInstruction/useFaceExpression.d.ts +20 -0
- package/dist/components/FaceLiquify/FaceLiquify.d.ts +49 -0
- package/dist/components/FaceLiquify/debug.d.ts +37 -0
- package/dist/components/FaceLiquify/frame.d.ts +55 -0
- package/dist/components/FaceLiquify/index.d.ts +10 -0
- package/dist/components/FaceLiquify/material.d.ts +39 -0
- package/dist/components/FaceLiquify/pass.d.ts +49 -0
- package/dist/components/FaceLiquify/presence.d.ts +25 -0
- package/dist/components/FaceLiquify/presets.d.ts +82 -0
- package/dist/components/FaceLiquify/selfTest.d.ts +66 -0
- package/dist/components/FaceLiquify/target.d.ts +85 -0
- package/dist/components/FaceLiquify/warp.d.ts +72 -0
- package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts +37 -5
- package/dist/components/FaceMesh/canonical/geometryGroups.d.ts +21 -0
- package/dist/components/FaceMesh/canonical/parseCanonicalFaceModel.d.ts +21 -0
- package/dist/components/FaceMesh/canonical/shaders.d.ts +1 -1
- package/dist/components/FaceMesh/index.d.ts +2 -2
- package/dist/components/FaceRetouch/Background.d.ts +3 -1
- package/dist/components/FaceRetouch/FaceRetouch.d.ts +5 -0
- package/dist/components/FaceRetouch/renderState.d.ts +19 -0
- package/dist/components/FaceSwap/FaceMirror.d.ts +46 -0
- package/dist/components/FaceSwap/FaceSwap.d.ts +58 -0
- package/dist/components/FaceSwap/FaceTextureLayer.d.ts +72 -0
- package/dist/components/FaceSwap/faceSwapPlan.d.ts +91 -0
- package/dist/components/FaceSwap/index.d.ts +13 -0
- package/dist/components/FaceSwap/settings.d.ts +300 -0
- package/dist/components/FaceSwap/useFaceTexture.d.ts +35 -0
- package/dist/components/FaceSwap/useLiveFace.d.ts +38 -0
- package/dist/components/FaceSwap/useLiveFaceTexture.d.ts +31 -0
- package/dist/components/FaceWarp3D/FaceWarp3D.d.ts +50 -0
- package/dist/components/FaceWarp3D/index.d.ts +2 -3
- package/dist/components/Faceless/Faceless.d.ts +51 -0
- package/dist/components/Faceless/index.d.ts +2 -0
- package/dist/components/GestureListener/index.d.ts +11 -0
- package/dist/components/HairLock/HairLock.d.ts +39 -0
- package/dist/components/HairLock/index.d.ts +2 -0
- package/dist/components/HairLock/lockGeometry.d.ts +15 -0
- package/dist/components/HandCutout/index.d.ts +35 -0
- package/dist/components/HandInstruction/HandGestureHint.d.ts +70 -0
- package/dist/components/HandInstruction/index.d.ts +74 -0
- package/dist/components/HandInstruction/useHandGesture.d.ts +22 -0
- package/dist/components/HandRig/ForearmOccluder.d.ts +29 -0
- package/dist/components/HandRig/HandAttachment.d.ts +34 -0
- package/dist/components/HandRig/HandOccluder.d.ts +55 -0
- package/dist/components/HandRig/HandTattoo.d.ts +61 -0
- package/dist/components/HandRig/WristAttachment.d.ts +34 -0
- package/dist/components/HandRig/index.d.ts +101 -0
- package/dist/components/HandRig/useArmMask.d.ts +29 -0
- package/dist/components/HandRig/wristSolve.d.ts +69 -0
- package/dist/components/HandTouch/HandTouch.d.ts +62 -0
- package/dist/components/HandTouch/Touchable.d.ts +36 -0
- package/dist/components/HandTouch/index.d.ts +2 -0
- package/dist/components/HandTracker/index.d.ts +10 -0
- package/dist/components/HeadBinding/index.d.ts +14 -0
- package/dist/components/HeadOccluder/CanonicalHeadFrame.d.ts +22 -0
- package/dist/components/HeadOccluder/Earrings.d.ts +55 -0
- package/dist/components/HeadOccluder/HeadAttachment.d.ts +38 -0
- package/dist/components/HeadOccluder/NeckOccluder.d.ts +64 -0
- package/dist/components/HeadOccluder/earringPlacement.d.ts +31 -0
- package/dist/components/HeadOccluder/headAttachmentPoints.d.ts +69 -0
- package/dist/components/HeadOccluder/index.d.ts +57 -3
- package/dist/components/HeadOccluder/useCanonicalHeadFit.d.ts +36 -0
- package/dist/components/HeadOccluder/useLandmarkPoseFit.d.ts +80 -0
- package/dist/components/HolisticTracker/index.d.ts +69 -0
- package/dist/components/HolisticTracker/settings.d.ts +58 -0
- package/dist/components/HolisticTracker/signals.d.ts +49 -0
- package/dist/components/Instruction/HintStage.d.ts +29 -0
- package/dist/components/Instruction/InstructionCue.d.ts +126 -0
- package/dist/components/Instruction/gestureHold.d.ts +20 -0
- package/dist/components/Instruction/ghost.d.ts +129 -0
- package/dist/components/Instruction/hintBlend.d.ts +19 -0
- package/dist/components/Instruction/hintLook.d.ts +81 -0
- package/dist/components/Instruction/hintLoop.d.ts +36 -0
- package/dist/components/Instruction/index.d.ts +41 -0
- package/dist/components/Instruction/useGhostModel.d.ts +33 -0
- package/dist/components/Instruction/useInstructionHold.d.ts +72 -0
- package/dist/components/IrisEffect/IrisMaterial.d.ts +73 -0
- package/dist/components/IrisEffect/index.d.ts +51 -0
- package/dist/components/IrisEffect/settings.d.ts +117 -0
- package/dist/components/LipEffect/LipEffect.d.ts +27 -1
- package/dist/components/LipEffect/LipEffectMaterial.d.ts +95 -7
- package/dist/components/LipEffect/LipEffects.d.ts +12 -0
- package/dist/components/LipEffect/defaults.d.ts +46 -4
- package/dist/components/LipEffect/index.d.ts +11 -3
- package/dist/components/LipEffect/lipShading.d.ts +73 -0
- package/dist/components/LipEffect/settings.d.ts +375 -0
- package/dist/components/LipEffect/shader.d.ts +39 -0
- package/dist/components/LipEffect/types.d.ts +128 -9
- package/dist/components/LipEffect/useLipDesignTextures.d.ts +17 -0
- package/dist/components/LipEffect/uvGuide.d.ts +74 -0
- package/dist/components/Makeup/Blush.d.ts +18 -0
- package/dist/components/Makeup/Brows.d.ts +20 -0
- package/dist/components/Makeup/Contour.d.ts +17 -0
- package/dist/components/Makeup/Eyeliner.d.ts +20 -0
- package/dist/components/Makeup/Eyeshadow.d.ts +20 -0
- package/dist/components/Makeup/Highlighter.d.ts +18 -0
- package/dist/components/Makeup/MakeupDesign.d.ts +37 -0
- package/dist/components/Makeup/MakeupRegion.d.ts +132 -0
- package/dist/components/Makeup/constants.d.ts +44 -0
- package/dist/components/Makeup/design.d.ts +106 -0
- package/dist/components/Makeup/designSamples.d.ts +42 -0
- package/dist/components/Makeup/eyes.d.ts +114 -0
- package/dist/components/Makeup/fields.d.ts +10 -0
- package/dist/components/Makeup/geometry.d.ts +106 -0
- package/dist/components/Makeup/index.d.ts +26 -0
- package/dist/components/Makeup/looks.d.ts +28 -0
- package/dist/components/Makeup/material.d.ts +239 -0
- package/dist/components/Makeup/settings.d.ts +54 -0
- package/dist/components/Makeup/shades.d.ts +143 -0
- package/dist/components/Makeup/shapes.d.ts +27 -0
- package/dist/components/Makeup/skinTone.d.ts +135 -0
- package/dist/components/Makeup/types.d.ts +110 -0
- package/dist/components/Makeup/useMakeupSkinTone.d.ts +40 -0
- package/dist/components/Necklace/Necklace.d.ts +44 -0
- package/dist/components/Necklace/index.d.ts +1 -0
- package/dist/components/ParticleEmitter/ParticleEmitter.d.ts +69 -0
- package/dist/components/ParticleEmitter/index.d.ts +1 -0
- package/dist/components/PersonCutout/index.d.ts +50 -0
- package/dist/components/PersonCutout/personCutout.d.ts +16 -0
- package/dist/components/ScreenImage/components/ScreenImageBody.d.ts +1 -1
- package/dist/components/ScreenImage/index.d.ts +3 -1
- package/dist/components/ScreenImage/materials/ScreenImageBlendMaterial.d.ts +1 -1
- package/dist/components/ScreenImage/materials/ScreenImageMaskMaterial.d.ts +11 -0
- package/dist/components/ScreenImage/source.d.ts +6 -0
- package/dist/components/ScreenImage/types.d.ts +18 -0
- package/dist/components/SegmentationOverlay/SegmentationOverlay.d.ts +37 -0
- package/dist/components/SegmentationOverlay/SegmentationOverlayMaterial.d.ts +31 -0
- package/dist/components/SegmentationOverlay/index.d.ts +9 -0
- package/dist/components/SegmentationOverlay/maskTexture.d.ts +23 -0
- package/dist/components/SegmentationOverlay/providers.d.ts +72 -0
- package/dist/components/SegmentationOverlay/settings.d.ts +65 -0
- package/dist/components/ShoulderOccluder/index.d.ts +43 -0
- package/dist/components/ShoulderOccluder/useCanonicalTorsoFit.d.ts +24 -0
- package/dist/components/SpringSwing/SpringSwing.d.ts +22 -0
- package/dist/components/SpringSwing/index.d.ts +1 -0
- package/dist/components/XRProvider/index.d.ts +16 -2
- package/dist/components/XRScene/renderOutputTarget.d.ts +12 -0
- package/dist/components/XRViewport/hooks/useViewportExternalFaces.d.ts +1 -1
- package/dist/components/XRViewport/hooks/useViewportMediaSource.d.ts +1 -1
- package/dist/components/XRViewport/hooks/useViewportPipeline.d.ts +1 -1
- package/dist/components/index.d.ts +11 -0
- package/dist/config/index.d.ts +0 -1
- package/dist/constants/index.d.ts +4 -1
- package/dist/context-DTxSQvp4.js +13 -0
- package/dist/context-hA0Rb2Xa.cjs +1 -0
- package/dist/contexts-BH7PdKFS.cjs +1 -0
- package/dist/contexts-jak8-tND.js +667 -0
- package/dist/coordinates/feed.d.ts +52 -0
- package/dist/coordinates/index.d.ts +7 -0
- package/dist/coordinates/side.d.ts +40 -0
- package/dist/coordinates/spaces.d.ts +49 -0
- package/dist/coordinates/viewport.d.ts +22 -0
- package/dist/coordinates/world.d.ts +15 -0
- package/dist/debug-ui/default-setting.cjs +2 -2
- package/dist/debug-ui/face-swap-settings/index.d.ts +22 -0
- package/dist/debug-ui/gesture-settings/index.d.ts +14 -0
- package/dist/debug-ui/hierarchy-panel/index.d.ts +3 -2
- package/dist/debug-ui/holistic-tracker-settings/index.d.ts +16 -0
- package/dist/debug-ui/index.d.ts +18 -3
- package/dist/debug-ui/iris-effect-settings/index.d.ts +12 -0
- package/dist/debug-ui/lip-effect-settings/index.d.ts +15 -0
- package/dist/debug-ui/media-source/index.d.ts +1 -1
- package/dist/debug-ui/media-source/session.d.ts +30 -2
- package/dist/debug-ui/media-source.cjs +1 -1
- package/dist/debug-ui/media-source.js +1 -1
- package/dist/debug-ui/object-inspector-panel/index.d.ts +3 -2
- package/dist/debug-ui/product-hotspots/index.d.ts +25 -0
- package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts +3 -1
- package/dist/debug-ui/scene-editor/inspector-panel.d.ts +3 -1
- package/dist/debug-ui/screen-image-settings/index.d.ts +3 -1
- package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts +1 -1
- package/dist/debug-ui/screen-text-settings/types.d.ts +2 -0
- package/dist/debug-ui/segmentation-overlay-settings/index.d.ts +12 -0
- package/dist/debug-ui/settings-panel/index.d.ts +6 -1
- package/dist/debug-ui/shared/debugWindow.d.ts +51 -0
- package/dist/debug-ui/xr-diagnostics/index.d.ts +26 -0
- package/dist/debug-ui.cjs +3 -3
- package/dist/debug-ui.js +2695 -2547
- package/dist/detector-K8aej4MB.js +59 -0
- package/dist/detector-ijypGtse.cjs +1 -0
- package/dist/entries/all.d.ts +3 -1
- package/dist/entries/core.d.ts +20 -2
- package/dist/entries/face-effects.d.ts +123 -9
- package/dist/entries/instructions.d.ts +48 -0
- package/dist/entries/internal.d.ts +2 -1
- package/dist/entries/low-level.d.ts +49 -3
- package/dist/entries/particles.d.ts +11 -0
- package/dist/entries/product.d.ts +11 -0
- package/dist/entries/tracking.d.ts +60 -2
- package/dist/face-atlas/attributes.d.ts +30 -0
- package/dist/face-atlas/eyes.d.ts +272 -0
- package/dist/face-atlas/faceAtlas.generated.d.ts +46 -0
- package/dist/face-atlas/glsl/atlasVertex.d.ts +46 -0
- package/dist/face-atlas/glsl/common.d.ts +55 -0
- package/dist/face-atlas/glsl/design.d.ts +49 -0
- package/dist/face-atlas/glsl/eyes.d.ts +73 -0
- package/dist/face-atlas/glsl/finish.d.ts +24 -0
- package/dist/face-atlas/glsl/format.d.ts +4 -0
- package/dist/face-atlas/glsl/index.d.ts +59 -0
- package/dist/face-atlas/glsl/shading.d.ts +15 -0
- package/dist/face-atlas/glsl/shapes.d.ts +66 -0
- package/dist/face-atlas/glsl/sparkle.d.ts +19 -0
- package/dist/face-atlas/glsl/uniforms.d.ts +106 -0
- package/dist/face-atlas/guide.d.ts +51 -0
- package/dist/face-atlas/index.d.ts +25 -0
- package/dist/face-atlas/lead.d.ts +117 -0
- package/dist/face-atlas/madeUpCamera.d.ts +125 -0
- package/dist/face-atlas/masks.d.ts +53 -0
- package/dist/face-atlas/obj.d.ts +69 -0
- package/dist/face-atlas/polylines.d.ts +63 -0
- package/dist/face-atlas/probe/FaceSkinProbe.d.ts +208 -0
- package/dist/face-atlas/probe/__fixtures__/emulate.d.ts +9 -0
- package/dist/face-atlas/probe/__fixtures__/face.d.ts +24 -0
- package/dist/face-atlas/probe/constants.d.ts +137 -0
- package/dist/face-atlas/probe/glsl.d.ts +43 -0
- package/dist/face-atlas/probe/lightFit.d.ts +108 -0
- package/dist/face-atlas/probe/schedule.d.ts +44 -0
- package/dist/face-atlas/probe/selfTest.d.ts +87 -0
- package/dist/face-atlas/probe/stats.d.ts +143 -0
- package/dist/face-atlas/probe/targets.d.ts +70 -0
- package/dist/face-atlas/probe/unwrap.d.ts +76 -0
- package/dist/face-atlas/quality.d.ts +28 -0
- package/dist/face-atlas/regions.d.ts +31 -0
- package/dist/face-atlas/registry.d.ts +252 -0
- package/dist/face-atlas/renderState.d.ts +86 -0
- package/dist/face-atlas/selfOcclusion.d.ts +62 -0
- package/dist/face-atlas/shading.d.ts +406 -0
- package/dist/face-atlas/shapes.d.ts +86 -0
- package/dist/face-atlas/sides.d.ts +41 -0
- package/dist/face-atlas/skinMask.d.ts +35 -0
- package/dist/face-atlas/surface.d.ts +155 -0
- package/dist/face-atlas/topology.d.ts +44 -0
- package/dist/face-character/__fixtures__/faceImageDetections.d.ts +25 -0
- package/dist/face-character/__fixtures__/faceNode.d.ts +22 -0
- package/dist/face-character/bindFaceModel.d.ts +106 -0
- package/dist/face-character/canonicalFace.d.ts +17 -0
- package/dist/face-character/canonicalFaceGeometry.d.ts +11 -0
- package/dist/face-character/canonicalFacePositions.d.ts +7 -0
- package/dist/face-character/driveFaceModel.d.ts +57 -0
- package/dist/face-character/expressionOutputs.d.ts +45 -0
- package/dist/face-character/faceExpressions.d.ts +104 -0
- package/dist/face-character/faceImageLandmarker.d.ts +93 -0
- package/dist/face-character/faceMeshBinding.d.ts +62 -0
- package/dist/face-character/faceMorph.d.ts +77 -0
- package/dist/face-character/faceMorphs.d.ts +46 -0
- package/dist/face-character/facePhoto.d.ts +138 -0
- package/dist/face-character/facePiercings.d.ts +116 -0
- package/dist/face-character/facePin.d.ts +131 -0
- package/dist/face-character/faceReprojection.d.ts +273 -0
- package/dist/face-character/faceReprojector.d.ts +171 -0
- package/dist/face-character/faceRig.d.ts +176 -0
- package/dist/face-character/faceSwapPresence.d.ts +85 -0
- package/dist/face-character/faceTexture.d.ts +169 -0
- package/dist/face-character/faceTextureBaker.d.ts +86 -0
- package/dist/face-character/faceTextureGuide.d.ts +106 -0
- package/dist/face-character/faceTextureStats.d.ts +298 -0
- package/dist/face-character/faceTransfer.d.ts +396 -0
- package/dist/face-character/faceTransferGeometry.d.ts +109 -0
- package/dist/face-character/faceTransferSelfTest.d.ts +94 -0
- package/dist/face-character/faceWarp3D.d.ts +101 -0
- package/dist/face-character/faceless.d.ts +79 -0
- package/dist/face-character/featureWarp.d.ts +28 -0
- package/dist/face-character/liveFaceRegistry.d.ts +370 -0
- package/dist/face-character/liveValue.d.ts +12 -0
- package/dist/face-character/memo.d.ts +15 -0
- package/dist/face-effects.cjs +2324 -1
- package/dist/face-effects.js +14208 -2268
- package/dist/face-expression/index.d.ts +182 -0
- package/dist/face-info/landmarks.d.ts +17 -3
- package/dist/face-info/types.d.ts +20 -3
- package/dist/gestures/definitions.d.ts +98 -0
- package/dist/gestures/detector.d.ts +87 -0
- package/dist/gestures/index.d.ts +8 -0
- package/dist/gestures/measures.d.ts +114 -0
- package/dist/gestures/settings.d.ts +49 -0
- package/dist/getFaceInfo-B1otSDMX.cjs +1 -0
- package/dist/getFaceInfo-Cu4xDWiL.js +62 -0
- package/dist/hand/armFit.d.ts +46 -0
- package/dist/hand/armMask.d.ts +178 -0
- package/dist/hand/handCutout.d.ts +23 -0
- package/dist/hand/handCutoutRegistry.d.ts +7 -0
- package/dist/hand/handGestures.d.ts +524 -0
- package/dist/hand/handPose.d.ts +98 -0
- package/dist/hand/handRigSolver.d.ts +159 -0
- package/dist/hand/handTattoo.d.ts +81 -0
- package/dist/hand/handTouch.d.ts +240 -0
- package/dist/hand/wrist.d.ts +44 -0
- package/dist/hand/wristFilter.d.ts +44 -0
- package/dist/hooks/selectors.d.ts +76 -1
- package/dist/hooks/useCalibrationFaceTracker.d.ts +1 -1
- package/dist/hooks/useFaceInfo.d.ts +13 -1
- package/dist/hooks/useFaceInfos.d.ts +1 -1
- package/dist/hooks/useFaceModelAcquisition.d.ts +38 -0
- package/dist/hooks/useGesture.d.ts +32 -0
- package/dist/hooks/useIrisTracking.d.ts +45 -0
- package/dist/hooks/useTrackerContext.d.ts +6 -0
- package/dist/hooks/useXRDiagnostics.d.ts +81 -0
- package/dist/hooks/useXRModel.d.ts +7 -0
- package/dist/hooks/useXRSession/facade.d.ts +42 -2
- package/dist/hooks/useXRSession/index.d.ts +2 -2
- package/dist/hooks/useXRSession/reason.d.ts +3 -1
- package/dist/hooks/useXRSession/registry.d.ts +14 -0
- package/dist/hooks/useXRSession/store.d.ts +52 -3
- package/dist/index-B1_TzJaI.js +1104 -0
- package/dist/index-BavF06C6.js +190 -0
- package/dist/index-BfFmpddl.cjs +21 -0
- package/dist/index-BuBzneeW.cjs +46 -0
- package/dist/index-CGsQWodV.cjs +1 -0
- package/dist/index-CIe7eCMH.js +3200 -0
- package/dist/index-CfSF8LXa.cjs +1 -0
- package/dist/index-D5GTzOzD.cjs +1 -0
- package/dist/index-DBhQzvVa.js +314 -0
- package/dist/index-DE17y0ZI.cjs +1 -0
- package/dist/index-JII7huPk.js +442 -0
- package/dist/index-tpCr9CLj.cjs +1 -0
- package/dist/index-w1S7fI2B.js +1432 -0
- package/dist/index-zGaqrz_K.js +188 -0
- package/dist/instructions.cjs +30 -0
- package/dist/instructions.js +1507 -0
- package/dist/{internal-Dmk1cTXq.js → internal-B90P-clC.js} +138 -119
- package/dist/internal-Cjinca64.cjs +1 -0
- package/dist/internal.cjs +1 -1
- package/dist/internal.js +15 -10
- package/dist/iris/compute.d.ts +27 -0
- package/dist/iris/index.d.ts +4 -0
- package/dist/iris/lead.d.ts +19 -0
- package/dist/iris/types.d.ts +89 -0
- package/dist/landmarkMask-BFDyBnKM.js +224 -0
- package/dist/landmarkMask-u7es2k4X.cjs +1 -0
- package/dist/landmarks-BlUqf5MZ.cjs +1 -0
- package/dist/landmarks-bftdwq6Z.js +76 -0
- package/dist/loaders-BGAUACsd.js +363 -0
- package/dist/loaders-BJ1_QCHt.cjs +1 -0
- package/dist/low-level.cjs +1 -1
- package/dist/low-level.js +1190 -675
- package/dist/main.cjs +1 -1
- package/dist/main.js +1190 -452
- package/dist/models/Base/index.d.ts +49 -0
- package/dist/models/Body/index.d.ts +3 -1
- package/dist/models/Face/constants.d.ts +8 -0
- package/dist/models/Face/index.d.ts +4 -12
- package/dist/models/Face/rotation.d.ts +18 -3
- package/dist/models/Hand/GestureTracking.d.ts +1 -1
- package/dist/models/Hand/HandTracking.d.ts +17 -1
- package/dist/models/Holistic/index.d.ts +49 -0
- package/dist/models/Holistic/result.d.ts +68 -0
- package/dist/models/Segmentation/index.d.ts +2 -0
- package/dist/models/SemanticSegmentation/index.d.ts +31 -0
- package/dist/models/SemanticSegmentation/presets.d.ts +28 -0
- package/dist/models/index.d.ts +2 -0
- package/dist/models/nodeSource.d.ts +9 -0
- package/dist/particles/emission.d.ts +24 -0
- package/dist/particles/eyes.d.ts +24 -0
- package/dist/particles/glsl.d.ts +14 -0
- package/dist/particles/index.d.ts +10 -0
- package/dist/particles/motion.d.ts +42 -0
- package/dist/particles/presets.d.ts +12 -0
- package/dist/particles/ring.d.ts +58 -0
- package/dist/particles/selfTest.d.ts +53 -0
- package/dist/particles/settings.d.ts +127 -0
- package/dist/particles/shapes.d.ts +29 -0
- package/dist/particles/spawner.d.ts +60 -0
- package/dist/particles/system.d.ts +64 -0
- package/dist/particles.cjs +122 -0
- package/dist/particles.js +774 -0
- package/dist/product/ProductDimensions.d.ts +16 -0
- package/dist/product/ProductHotspot.d.ts +16 -0
- package/dist/product/ProductViewer.d.ts +9 -0
- package/dist/product/details.d.ts +53 -0
- package/dist/product/index.d.ts +14 -0
- package/dist/product/loadModelViewer.d.ts +4 -0
- package/dist/product/types.d.ts +71 -0
- package/dist/product/useProductAr.d.ts +37 -0
- package/dist/product/useProductDetails.d.ts +60 -0
- package/dist/product.cjs +1 -0
- package/dist/product.js +414 -0
- package/dist/providers-C8rE26Uf.js +366 -0
- package/dist/providers-DHsrhDI2.cjs +62 -0
- package/dist/quality/XRQualityController.d.ts +25 -0
- package/dist/quality/controller.d.ts +33 -0
- package/dist/quality/index.d.ts +6 -0
- package/dist/quality/types.d.ts +100 -0
- package/dist/quality/useXRQuality.d.ts +28 -0
- package/dist/render/renderPasses.d.ts +8 -0
- package/dist/render/sceneBeforeRender.d.ts +12 -0
- package/dist/{renderGroups-KZk6eRiY.js → renderGroups-B38pUaX2.js} +1 -1
- package/dist/{renderGroups-80H3DpTl.cjs → renderGroups-Cb_4Ar1Q.cjs} +1 -1
- package/dist/renderPasses-B6l8IpJv.js +1290 -0
- package/dist/renderPasses-dqmkft4P.cjs +158 -0
- package/dist/renderState-CJNmj5jz.js +39 -0
- package/dist/renderState-apSfg4eR.cjs +1 -0
- package/dist/scene-object.cjs +1 -1
- package/dist/scene-object.js +2 -2
- package/dist/segmentation-Cb3ouK6Z.js +1758 -0
- package/dist/segmentation-D9pYO6aR.cjs +1 -0
- package/dist/segmentation2d/faceMemory.d.ts +28 -0
- package/dist/segmentation2d/faceRegions.d.ts +24 -0
- package/dist/segmentation2d/index.d.ts +9 -0
- package/dist/segmentation2d/maskUv.d.ts +23 -0
- package/dist/segmentation2d/rasterize.d.ts +14 -0
- package/dist/segmentation2d/types.d.ts +52 -0
- package/dist/select-Ck5LGz-J.cjs +1 -0
- package/dist/select-pYRo_win.js +233 -0
- package/dist/selectors-C4X71aoD.cjs +1 -0
- package/dist/selectors-DmNaKIwE.js +196 -0
- package/dist/session-BrH8G7iJ.cjs +31 -0
- package/dist/session-DgA_z6O1.js +418 -0
- package/dist/settings-BJ7FMBsO.js +111 -0
- package/dist/settings-C63FMBlF.cjs +1 -0
- package/dist/similarityFit-BFqHND2e.cjs +1 -0
- package/dist/similarityFit-Bbz-R8AY.js +91 -0
- package/dist/spring/index.d.ts +2 -0
- package/dist/spring/spring.d.ts +69 -0
- package/dist/spring/swing.d.ts +54 -0
- package/dist/subjects/index.d.ts +2 -0
- package/dist/subjects/select.d.ts +62 -0
- package/dist/subjects/types.d.ts +55 -0
- package/dist/tracking-config/apply.d.ts +57 -0
- package/dist/tracking-config/index.d.ts +7 -0
- package/dist/tracking-config/resolve.d.ts +25 -0
- package/dist/tracking-config/storage.d.ts +8 -0
- package/dist/tracking-config/types.d.ts +106 -0
- package/dist/tracking-config/useXRTrackingConfig.d.ts +38 -0
- package/dist/tracking.cjs +10 -1
- package/dist/tracking.js +1326 -506
- package/dist/trigger-D0Pm9noT.cjs +49 -0
- package/dist/trigger-IQeys0oS.js +2128 -0
- package/dist/types/compositor.d.ts +21 -0
- package/dist/types/face.d.ts +20 -1
- package/dist/types/hand-tracking.d.ts +9 -0
- package/dist/types/holistic.d.ts +121 -0
- package/dist/types/index.d.ts +1 -0
- package/dist/types/model.d.ts +22 -2
- package/dist/types/nodes.d.ts +47 -3
- package/dist/types/segmentation.d.ts +24 -0
- package/dist/types/session.d.ts +41 -3
- package/dist/updateThrottle-BseecYag.js +4 -0
- package/dist/updateThrottle-Of5Y4SVa.cjs +1 -0
- package/dist/useFaceInfo-BHDNCvsJ.cjs +1 -0
- package/dist/useFaceInfo-J4x7LsqL.js +76 -0
- package/dist/useFaceResultReader-BvEo5REG.js +61 -0
- package/dist/useFaceResultReader-DuaL1KJG.cjs +1 -0
- package/dist/useInstructionHold-DOu-RpCM.js +53 -0
- package/dist/useInstructionHold-DwJY1Alr.cjs +1 -0
- package/dist/useLandmarkPoseFit-Bg-h9BPb.cjs +1 -0
- package/dist/useLandmarkPoseFit-Bmb3h6Mw.js +87 -0
- package/dist/useXRCapabilities-Cr3RzuAW.cjs +1 -0
- package/dist/useXRCapabilities-Cxmlmpbd.js +30 -0
- package/dist/utils/canonicalRigidLandmarks.d.ts +8 -0
- package/dist/utils/fns.d.ts +6 -3
- package/dist/utils/headOccluderFit.d.ts +42 -0
- package/dist/utils/integrity.d.ts +21 -1
- package/dist/utils/resolveNumFaces.d.ts +13 -0
- package/dist/utils/shoulderOccluderFit.d.ts +38 -0
- package/dist/utils/similarityFit.d.ts +23 -0
- package/dist/utils/updateThrottle.d.ts +2 -0
- package/dist/utils/useStableUniforms.d.ts +18 -0
- package/dist/uv-BMFt19bg.cjs +1 -0
- package/dist/{index-ByoNj0QP.js → uv-DJU_XfmN.js} +15 -247
- package/docs/SDK_DOCUMENTATION.md +1 -2
- package/docs/api/adaptive-quality.mdx +104 -0
- package/docs/api/asset-lifecycle.mdx +78 -0
- package/docs/api/body-instructions.mdx +285 -0
- package/docs/api/body-triggers.mdx +234 -0
- package/docs/api/camera-permission.mdx +142 -0
- package/docs/api/coordinate-spaces.mdx +168 -0
- package/docs/api/cross-camera.mdx +89 -0
- package/docs/api/debug-ui-scene-editor.mdx +23 -2
- package/docs/api/diagnostics-calibration.mdx +97 -0
- package/docs/api/external-face-mesh.mdx +231 -0
- package/docs/api/face-actions.mdx +20 -16
- package/docs/api/face-attribute-expression.mdx +1 -1
- package/docs/api/face-binding-anchors.mdx +4 -2
- package/docs/api/face-character.mdx +157 -0
- package/docs/api/face-effects.mdx +9 -0
- package/docs/api/face-expression-controller.mdx +153 -0
- package/docs/api/face-info.mdx +17 -11
- package/docs/api/face-inset.mdx +204 -0
- package/docs/api/face-instructions.mdx +183 -0
- package/docs/api/face-liquify.mdx +196 -0
- package/docs/api/face-mesh.mdx +8 -9
- package/docs/api/face-morph.mdx +117 -0
- package/docs/api/face-painting.mdx +7 -0
- package/docs/api/face-reprojection.mdx +154 -0
- package/docs/api/face-retouching.mdx +18 -10
- package/docs/api/face-swap.mdx +350 -0
- package/docs/api/face-warp-3d.mdx +166 -0
- package/docs/api/faceless.mdx +143 -0
- package/docs/api/gestures.mdx +209 -0
- package/docs/api/hair.mdx +97 -0
- package/docs/api/hand-instructions.mdx +222 -0
- package/docs/api/hand-rig.mdx +535 -0
- package/docs/api/hand-touch.mdx +162 -0
- package/docs/api/head-occluder.mdx +563 -0
- package/docs/api/holistic-tracker.mdx +164 -0
- package/docs/api/instructions.mdx +323 -0
- package/docs/api/iris-tracking.mdx +247 -0
- package/docs/api/made-up-camera.mdx +131 -0
- package/docs/api/makeup-skin-tone.mdx +135 -0
- package/docs/api/makeup.mdx +353 -0
- package/docs/api/multi-subject.mdx +98 -0
- package/docs/api/particles.mdx +155 -0
- package/docs/api/person-cutout.mdx +136 -0
- package/docs/api/pin-to-face-mesh.mdx +274 -0
- package/docs/api/product-ar.mdx +114 -0
- package/docs/api/product-details.mdx +78 -0
- package/docs/api/screen-space-coordinates.mdx +4 -1
- package/docs/api/segmentation-overlay.mdx +301 -0
- package/docs/api/session-lifecycle.mdx +136 -0
- package/docs/api/trackers.mdx +5 -0
- package/docs/api/tracking-config.mdx +108 -0
- package/docs/docs.json +51 -1
- package/docs/examples/lip-shaders.mdx +273 -0
- package/docs/guides/face-atlas-template.svg +1 -0
- package/docs/guides/face-atlas-textures.mdx +186 -0
- package/docs/guides/face-texture-template.svg +1 -0
- package/docs/guides/harness-debug-ui.mdx +4 -4
- package/docs/guides/lip-effect-textures.mdx +368 -0
- package/docs/guides/lip-uv-template.png +0 -0
- package/docs/guides/lip-uv-template.svg +1 -0
- package/docs/guides/makeup-design-textures.mdx +109 -0
- package/docs/introduction.mdx +1 -2
- package/package.json +23 -1
- package/dist/DebuggerUI-B6bP6P9r.cjs +0 -1
- package/dist/DebuggerUI-BjOMr8q_.js +0 -269
- package/dist/FaceMeshRenderer-C5l6VLdO.cjs +0 -155
- package/dist/FaceMeshRenderer-wjAHrJzP.js +0 -1270
- package/dist/FaceRetouch-BkJzoA79.cjs +0 -134
- package/dist/FaceRetouch-DwbKQJAN.js +0 -551
- package/dist/components/FaceWarp3D/FaceWarp3DHead.d.ts +0 -15
- package/dist/components/FaceWarp3D/defaults.d.ts +0 -37
- package/dist/components/FaceWarp3D/warp.d.ts +0 -13
- package/dist/contexts-ByhzppYl.js +0 -663
- package/dist/contexts-Dr62It_K.cjs +0 -1
- package/dist/debug-ui/face-warp-3d/index.d.ts +0 -6
- package/dist/getFaceInfo-C4QpCQIY.js +0 -118
- package/dist/getFaceInfo-fA1bFBub.cjs +0 -1
- package/dist/index-9dlAQAhy.js +0 -1462
- package/dist/index-BjmTe9eM.cjs +0 -1
- package/dist/index-BpEf2BBb.cjs +0 -1
- package/dist/index-CyUUurQT.cjs +0 -1
- package/dist/index-DCiMbxC3.cjs +0 -1
- package/dist/index-DXT3WccE.js +0 -2089
- package/dist/index-DpI-qo5X.cjs +0 -17
- package/dist/index-DyVF4vEW.js +0 -111
- package/dist/index-VJ0SJwmG.js +0 -214
- package/dist/internal-Cq-TEQ5Y.cjs +0 -1
- package/dist/renderLayers-lDtL0_43.cjs +0 -1
- package/dist/renderLayers-zrK2pv5O.js +0 -13
- package/dist/renderPasses-BOoBSr8z.cjs +0 -21
- package/dist/renderPasses-BcquyVtu.js +0 -1500
- package/dist/selectors-B8H97CKA.js +0 -59
- package/dist/selectors-CZLKT2Iv.cjs +0 -1
- package/dist/session-CpkiK5YA.cjs +0 -31
- package/dist/session-DLFN_VII.js +0 -363
- package/dist/useFaceInfo-BJ8-_MOs.cjs +0 -1
- package/dist/useFaceInfo-Dk426LTu.js +0 -62
- package/dist/useFaceResults-CtetsO9M.js +0 -19
- package/dist/useFaceResults-wBJF3zyp.cjs +0 -1
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import { MakeupAutoShadeRegion, MakeupRegion } from './constants';
|
|
2
|
+
/**
|
|
3
|
+
* Curated shade palettes per region: generic camelCase names (no brand or
|
|
4
|
+
* product names) to sRGB hex. Shades are relative to the person's own skin,
|
|
5
|
+
* so an opaque shade renders as its nominal colour on average skin under
|
|
6
|
+
* settled light, on every skin tone.
|
|
7
|
+
*/
|
|
8
|
+
export declare const MAKEUP_SHADES: {
|
|
9
|
+
readonly lips: {
|
|
10
|
+
readonly nude: "#b9826f";
|
|
11
|
+
readonly rosewood: "#9e5a5a";
|
|
12
|
+
readonly mauve: "#a0606e";
|
|
13
|
+
readonly softPink: "#d88a95";
|
|
14
|
+
readonly coral: "#e0645a";
|
|
15
|
+
readonly peach: "#e8907a";
|
|
16
|
+
readonly classicRed: "#a3202d";
|
|
17
|
+
readonly brick: "#8e3b2c";
|
|
18
|
+
readonly berry: "#7b2846";
|
|
19
|
+
readonly plum: "#5e2a45";
|
|
20
|
+
readonly wine: "#5a1a28";
|
|
21
|
+
readonly chocolate: "#5b3a2e";
|
|
22
|
+
};
|
|
23
|
+
readonly contour: {
|
|
24
|
+
readonly fair: "#c9a08a";
|
|
25
|
+
readonly light: "#b48a72";
|
|
26
|
+
readonly medium: "#98705a";
|
|
27
|
+
readonly tan: "#7f5a45";
|
|
28
|
+
readonly deep: "#5e4032";
|
|
29
|
+
readonly rich: "#432c22";
|
|
30
|
+
readonly bronzeLight: "#b9805a";
|
|
31
|
+
readonly bronzeDeep: "#8a5532";
|
|
32
|
+
};
|
|
33
|
+
readonly blush: {
|
|
34
|
+
readonly softPink: "#e8a0a8";
|
|
35
|
+
readonly rose: "#d97a85";
|
|
36
|
+
readonly peach: "#f0a07c";
|
|
37
|
+
readonly coral: "#ec7b67";
|
|
38
|
+
readonly apricot: "#f2a86b";
|
|
39
|
+
readonly mauve: "#c0828f";
|
|
40
|
+
readonly berry: "#b04a68";
|
|
41
|
+
readonly brick: "#b4574a";
|
|
42
|
+
readonly terracotta: "#c4694c";
|
|
43
|
+
readonly plum: "#8f4a68";
|
|
44
|
+
};
|
|
45
|
+
readonly highlighter: {
|
|
46
|
+
readonly pearl: "#f6eee6";
|
|
47
|
+
readonly champagne: "#f2dcc0";
|
|
48
|
+
readonly gold: "#e9c27a";
|
|
49
|
+
readonly roseGold: "#eab3a0";
|
|
50
|
+
readonly bronzeGlow: "#d29a66";
|
|
51
|
+
readonly lilacPearl: "#e6d6ef";
|
|
52
|
+
};
|
|
53
|
+
readonly eyeshadow: {
|
|
54
|
+
readonly ivory: "#f3e6d3";
|
|
55
|
+
readonly champagne: "#e9d2b0";
|
|
56
|
+
readonly sand: "#d2b48c";
|
|
57
|
+
readonly taupe: "#8f7a6e";
|
|
58
|
+
readonly warmBrown: "#8b5a3c";
|
|
59
|
+
readonly coolBrown: "#6e5a50";
|
|
60
|
+
readonly espresso: "#3e2a22";
|
|
61
|
+
readonly charcoal: "#3a3a3c";
|
|
62
|
+
readonly black: "#141414";
|
|
63
|
+
readonly bronze: "#a8743f";
|
|
64
|
+
readonly copper: "#b5653a";
|
|
65
|
+
readonly gold: "#d4ae5a";
|
|
66
|
+
readonly roseGold: "#d49a8a";
|
|
67
|
+
readonly plum: "#6b3a5a";
|
|
68
|
+
readonly burgundy: "#6e2433";
|
|
69
|
+
readonly olive: "#6f6a3a";
|
|
70
|
+
readonly navy: "#23314f";
|
|
71
|
+
readonly emerald: "#1f6b52";
|
|
72
|
+
readonly teal: "#1f6f73";
|
|
73
|
+
readonly lilac: "#b8a0cf";
|
|
74
|
+
readonly silver: "#c5c7cb";
|
|
75
|
+
};
|
|
76
|
+
readonly eyeliner: {
|
|
77
|
+
readonly black: "#0d0d0d";
|
|
78
|
+
readonly brownBlack: "#231a16";
|
|
79
|
+
readonly brown: "#4a3226";
|
|
80
|
+
readonly charcoal: "#33343a";
|
|
81
|
+
readonly navy: "#1c2848";
|
|
82
|
+
readonly plum: "#4f2442";
|
|
83
|
+
readonly emerald: "#145a44";
|
|
84
|
+
readonly bronze: "#8a5a2e";
|
|
85
|
+
readonly gold: "#c9a14e";
|
|
86
|
+
readonly white: "#f5f3ef";
|
|
87
|
+
};
|
|
88
|
+
readonly brows: {
|
|
89
|
+
readonly blonde: "#a88a62";
|
|
90
|
+
readonly taupe: "#7c6a5c";
|
|
91
|
+
readonly softBrown: "#6b4f3c";
|
|
92
|
+
readonly mediumBrown: "#57402f";
|
|
93
|
+
readonly darkBrown: "#3d2c22";
|
|
94
|
+
readonly softBlack: "#252020";
|
|
95
|
+
readonly auburn: "#7a4030";
|
|
96
|
+
readonly grey: "#8a8580";
|
|
97
|
+
};
|
|
98
|
+
};
|
|
99
|
+
/** A named shade of one region's palette, e.g. `MakeupShadeName<"lips">` is `"nude" | "rosewood" | …`. */
|
|
100
|
+
export type MakeupShadeName<R extends MakeupRegion> = Extract<keyof (typeof MAKEUP_SHADES)[R], string>;
|
|
101
|
+
/**
|
|
102
|
+
* What a region's `shade` field accepts: a palette name, `"custom"` (the
|
|
103
|
+
* `color` field as given) and, for lips, blush, contour, highlighter and
|
|
104
|
+
* brows, `"auto"` (from the person's own colouring).
|
|
105
|
+
*/
|
|
106
|
+
export type MakeupShadeSetting<R extends MakeupRegion> = MakeupShadeName<R> | "custom" | (R extends MakeupAutoShadeRegion ? "auto" : never);
|
|
107
|
+
/** The palette names per region, in palette order. */
|
|
108
|
+
export declare const MAKEUP_SHADE_NAMES: {
|
|
109
|
+
readonly [R in MakeupRegion]: readonly MakeupShadeName<R>[];
|
|
110
|
+
};
|
|
111
|
+
/** True when `region`'s `shade` accepts `"auto"`. */
|
|
112
|
+
export declare const supportsAutoMakeupShade: (region: MakeupRegion) => region is MakeupAutoShadeRegion;
|
|
113
|
+
export declare const isMakeupShadeName: <R extends MakeupRegion>(region: R, value: unknown) => value is MakeupShadeName<R>;
|
|
114
|
+
/**
|
|
115
|
+
* A shade name to its sRGB hex; `"auto"` stays `"auto"` where the region
|
|
116
|
+
* supports it (the colour is computed on the GPU). `undefined` for
|
|
117
|
+
* `"custom"` and for names that are not in the region's palette.
|
|
118
|
+
*/
|
|
119
|
+
export declare function resolveMakeupShade(region: MakeupRegion, shade: string): string | undefined;
|
|
120
|
+
/**
|
|
121
|
+
* Resolves one `shade` / `color` pair (the region's main pair, or eyeshadow's
|
|
122
|
+
* crease and inner pairs). The shade comes from the explicit value, else the
|
|
123
|
+
* base (defaults then shape). A palette shade sets the colour; an explicit
|
|
124
|
+
* colour that differs from it wins and the shade becomes `"custom"`. With
|
|
125
|
+
* `"auto"` the colour keeps the base colour as the fallback shown until the
|
|
126
|
+
* person's own colour is measured. Re-resolving a resolved pair is a no-op.
|
|
127
|
+
*
|
|
128
|
+
* Exception: when both are explicit and the colour is one a shade produced
|
|
129
|
+
* (any colour of the region's palette, or the base colour), the explicit
|
|
130
|
+
* named or `"auto"` shade wins. That colour was carried over from a resolved
|
|
131
|
+
* object, so `{ ...resolved, shade: "coral" }` gives coral.
|
|
132
|
+
*/
|
|
133
|
+
export declare const resolveMakeupShadePair: <R extends MakeupRegion>(region: R, shadeInput: unknown, colorInput: unknown, baseShade: MakeupShadeSetting<R>, baseColor: string) => {
|
|
134
|
+
shade: MakeupShadeSetting<R>;
|
|
135
|
+
color: string;
|
|
136
|
+
};
|
|
137
|
+
/** `"classicRed"` → `"Classic red"`. */
|
|
138
|
+
export declare const makeupNameLabel: (name: string) => string;
|
|
139
|
+
/** Select options for a region's shade field: custom, auto (where supported), then the palette. */
|
|
140
|
+
export declare const makeupShadeOptions: <R extends MakeupRegion>(region: R) => {
|
|
141
|
+
label: string;
|
|
142
|
+
value: string;
|
|
143
|
+
}[];
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { MakeupRegion } from './constants';
|
|
2
|
+
import { MakeupSettings } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Placement presets per region, in display order. Lips use the `LipEffect`
|
|
5
|
+
* presets (their `preset` field plays the part of `shape`).
|
|
6
|
+
*/
|
|
7
|
+
export declare const MAKEUP_SHAPE_NAMES: {
|
|
8
|
+
readonly lips: readonly ["lipstick", "gloss", "matte", "tint", "metallic", "gradient", "shimmer", "glitter"];
|
|
9
|
+
readonly contour: readonly ["soft", "sculpted", "bronzed", "nose"];
|
|
10
|
+
readonly blush: readonly ["apples", "lifted", "draped", "sunKissed"];
|
|
11
|
+
readonly highlighter: readonly ["cheekbones", "strobe", "glow", "nose"];
|
|
12
|
+
readonly eyeshadow: readonly ["lid", "crease", "smoky", "cutCrease", "halo", "winged"];
|
|
13
|
+
readonly eyeliner: readonly ["tightline", "classic", "winged", "catEye", "smudged", "kohl"];
|
|
14
|
+
readonly brows: readonly ["natural", "softArch", "straight", "highArch", "bold", "thin"];
|
|
15
|
+
};
|
|
16
|
+
/** A placement preset of one region, e.g. `MakeupShape<"blush">` is `"apples" | "lifted" | …`. */
|
|
17
|
+
export type MakeupShape<R extends MakeupRegion> = (typeof MAKEUP_SHAPE_NAMES)[R][number];
|
|
18
|
+
/**
|
|
19
|
+
* What each shape sets. Shapes set placement (geometry fields), `softness`
|
|
20
|
+
* and `coverage`; the shade and finish stay the caller's. Resolution order is
|
|
21
|
+
* defaults → shape → finish → shade → explicit values.
|
|
22
|
+
*/
|
|
23
|
+
export declare const MAKEUP_SHAPES: {
|
|
24
|
+
readonly [R in MakeupRegion]: Readonly<Record<MakeupShape<R>, Partial<MakeupSettings[R]>>>;
|
|
25
|
+
};
|
|
26
|
+
/** True when `value` is one of `region`'s shapes (lips: a `LipEffect` preset). */
|
|
27
|
+
export declare const isMakeupShape: <R extends MakeupRegion>(region: R, value: unknown) => value is MakeupShape<R>;
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { FaceSkinStats } from '../../face-atlas/probe/stats';
|
|
2
|
+
import { Vec3 } from '../../face-atlas/shading';
|
|
3
|
+
import { MakeupRegion } from './constants';
|
|
4
|
+
import { MakeupShadeName } from './shades';
|
|
5
|
+
/**
|
|
6
|
+
* The skin-tone readout (FACE-1, `useMakeupSkinTone`): skin depth and
|
|
7
|
+
* undertone from the skin probe's settled skin colour, and the curated
|
|
8
|
+
* palette shades closest to what each region would paint on this person.
|
|
9
|
+
* Pure functions: the hook feeds them the probe's stats; a photo's stats
|
|
10
|
+
* (`FaceSkinProbe.renderStill` + `readStats`) work the same way.
|
|
11
|
+
*/
|
|
12
|
+
/** Skin depth, lightest to deepest (the contour palette's names). */
|
|
13
|
+
export declare const MAKEUP_SKIN_DEPTHS: readonly ["fair", "light", "medium", "tan", "deep", "rich"];
|
|
14
|
+
export type MakeupSkinDepth = (typeof MAKEUP_SKIN_DEPTHS)[number];
|
|
15
|
+
/** Undertone, from the skin's hue: pinker (cool) to more golden (warm). */
|
|
16
|
+
export declare const MAKEUP_UNDERTONES: readonly ["cool", "neutral", "warm"];
|
|
17
|
+
export type MakeupUndertone = (typeof MAKEUP_UNDERTONES)[number];
|
|
18
|
+
/** The readout's thresholds and defaults. Angles are degrees, lightness and chroma CIELAB units. */
|
|
19
|
+
export declare const MAKEUP_SKIN_TONE: Readonly<{
|
|
20
|
+
/**
|
|
21
|
+
* Lower ITA bound of each depth but the deepest (the Individual Typology
|
|
22
|
+
* Angle, `atan((L* − 50) / b*)`, with Chardon's skin categories: very light
|
|
23
|
+
* > 55°, light > 41°, intermediate > 28°, tan > 10°, brown > −30°, dark).
|
|
24
|
+
*/
|
|
25
|
+
readonly depthIta: Readonly<{
|
|
26
|
+
fair: 55;
|
|
27
|
+
light: 41;
|
|
28
|
+
medium: 28;
|
|
29
|
+
tan: 10;
|
|
30
|
+
deep: -30;
|
|
31
|
+
}>;
|
|
32
|
+
/** Skin hue (CIELAB `h_ab`) under this is cool (at `undertoneKneeL` and lighter). */
|
|
33
|
+
readonly coolHue: 50;
|
|
34
|
+
/** Skin hue over this is warm; between `coolHue` and it, neutral. */
|
|
35
|
+
readonly warmHue: 60;
|
|
36
|
+
/**
|
|
37
|
+
* Skin lightness (CIELAB `L*`) under which both hue cuts move down: deeper
|
|
38
|
+
* skin has a lower hue whatever its undertone.
|
|
39
|
+
*/
|
|
40
|
+
readonly undertoneKneeL: 50;
|
|
41
|
+
/** How far both hue cuts move down per `L*` unit under `undertoneKneeL`, degrees. */
|
|
42
|
+
readonly undertoneHueShift: 0.25;
|
|
43
|
+
/** Skin chroma (CIELAB `C*ab`) under this reads neutral whatever its hue (a grey or washed-out image). */
|
|
44
|
+
readonly minUndertoneChroma: 6;
|
|
45
|
+
/** Lip or brow colour used once the probe saw at least this share of their taps (else derived from the skin). */
|
|
46
|
+
readonly minFeatureSeen: 0.25;
|
|
47
|
+
/** Shades recommended per region. */
|
|
48
|
+
readonly recommendations: 3;
|
|
49
|
+
/** `useMakeupSkinTone`: ms between reads of the probe (2 a second). */
|
|
50
|
+
readonly readbackMs: 500;
|
|
51
|
+
/** `useMakeupSkinTone`: the shortest `intervalMs` it accepts. */
|
|
52
|
+
readonly minReadbackMs: 200;
|
|
53
|
+
}>;
|
|
54
|
+
/** Each region's recommended palette shades, best first. */
|
|
55
|
+
export type MakeupShadeRecommendations = {
|
|
56
|
+
readonly [R in MakeupRegion]: readonly MakeupShadeName<R>[];
|
|
57
|
+
};
|
|
58
|
+
/** What `computeMakeupSkinTone` reads off the stats (a `FaceSkinStats` fits). */
|
|
59
|
+
export type MakeupSkinToneInput = Pick<FaceSkinStats, "skinSlow" | "ready" | "lip" | "lipSeen" | "brow" | "browSeen">;
|
|
60
|
+
export type MakeupSkinTone = {
|
|
61
|
+
/** The settled skin colour as the camera shows it, sRGB hex. */
|
|
62
|
+
skin: string;
|
|
63
|
+
/** Its CIELAB (D65) `[L*, a*, b*]`. */
|
|
64
|
+
lab: readonly [number, number, number];
|
|
65
|
+
depth: MakeupSkinDepth;
|
|
66
|
+
/** The Individual Typology Angle, degrees: higher is lighter (`MAKEUP_SKIN_TONE.depthIta`). */
|
|
67
|
+
ita: number;
|
|
68
|
+
undertone: MakeupUndertone;
|
|
69
|
+
/** The skin's CIELAB hue angle `h_ab`, degrees (skin is usually 40–70). */
|
|
70
|
+
hue: number;
|
|
71
|
+
/** The skin's CIELAB chroma `C*ab`. */
|
|
72
|
+
chroma: number;
|
|
73
|
+
/** The person's own lip colour, sRGB hex, or null while too little lip was seen. */
|
|
74
|
+
lips: string | null;
|
|
75
|
+
/** The person's own brow-hair colour, sRGB hex, or null while too little brow was seen. */
|
|
76
|
+
brows: string | null;
|
|
77
|
+
/** Palette shades per region, best first: the shades nearest what each region would paint on this person. */
|
|
78
|
+
recommendations: MakeupShadeRecommendations;
|
|
79
|
+
};
|
|
80
|
+
export type ComputeMakeupSkinToneOptions = {
|
|
81
|
+
/** Shades per region. Default `MAKEUP_SKIN_TONE.recommendations` (3). */
|
|
82
|
+
count?: number;
|
|
83
|
+
};
|
|
84
|
+
type MVec3 = [number, number, number];
|
|
85
|
+
/** Linear sRGB → CIELAB (D65), `[L*, a*, b*]`. */
|
|
86
|
+
export declare const linearSrgbToLab: (c: Vec3) => MVec3;
|
|
87
|
+
/** `#rrggbb` → linear sRGB. */
|
|
88
|
+
export declare const hexToLinearSrgb: (hex: string) => MVec3;
|
|
89
|
+
/** Linear sRGB → `#rrggbb` (clamped). */
|
|
90
|
+
export declare const linearSrgbToHex: (c: Vec3) => string;
|
|
91
|
+
/** The Individual Typology Angle of a CIELAB colour, degrees: `atan2(L* − 50, b*)`. */
|
|
92
|
+
export declare const skinTypologyAngle: (lab: Vec3) => number;
|
|
93
|
+
/** Skin depth from the ITA (`MAKEUP_SKIN_TONE.depthIta`). */
|
|
94
|
+
export declare const classifyMakeupSkinDepth: (ita: number) => MakeupSkinDepth;
|
|
95
|
+
/**
|
|
96
|
+
* Undertone from the skin's CIELAB hue and chroma (`MAKEUP_SKIN_TONE`). With
|
|
97
|
+
* its `lightness` (`L*`), the hue cuts move down for skin deeper than
|
|
98
|
+
* `undertoneKneeL`, so deep skin is not read as cool for its lower hue.
|
|
99
|
+
*/
|
|
100
|
+
export declare const classifyMakeupUndertone: (hue: number, chroma: number, lightness?: number) => MakeupUndertone;
|
|
101
|
+
/**
|
|
102
|
+
* What each region would paint on this person (linear colours): the GPU's
|
|
103
|
+
* `shade: "auto"` recipes (`makeupAutoShade`) on the settled skin, lip and
|
|
104
|
+
* brow colours, plus a soft transition shade for eyeshadow (the skin
|
|
105
|
+
* deepened) and a liner from the brow hair (darkened). Blush, highlighter
|
|
106
|
+
* and eyeshadow then lean toward the undertone's hues (warm: peach, gold,
|
|
107
|
+
* bronze; cool: rose, pearl, taupe). Lips and brows fall back to colours
|
|
108
|
+
* derived from the skin while too little of them was seen.
|
|
109
|
+
*/
|
|
110
|
+
export declare const makeupToneTargets: (skin: Vec3, lip: Vec3 | null, brow: Vec3 | null, undertone?: MakeupUndertone) => { readonly [R in MakeupRegion]: MVec3; };
|
|
111
|
+
/** The `count` palette shades of `region` nearest (CIELAB ΔE) to a linear colour, best first. */
|
|
112
|
+
export declare const nearestMakeupShades: <R extends MakeupRegion>(region: R, target: Vec3, count?: number) => MakeupShadeName<R>[];
|
|
113
|
+
/**
|
|
114
|
+
* The skin-tone readout from the probe's stats (`FaceSkinStats`, e.g.
|
|
115
|
+
* `readFaceSkinStats` of `FaceSkinProbe.readStatsAsync`): skin depth (ITA),
|
|
116
|
+
* undertone (CIELAB hue) and palette shades per region. `null` until the
|
|
117
|
+
* probe is ready (`ready` past `MAKEUP_SKIN_READY`) or while the skin reads black.
|
|
118
|
+
*
|
|
119
|
+
* It measures the image, not the person: the camera's white balance moves
|
|
120
|
+
* the hue (a warm room reads warm), and its exposure moves the depth.
|
|
121
|
+
*/
|
|
122
|
+
/**
|
|
123
|
+
* `ready` at or above this counts as ready. It ramps to 1, but the packed
|
|
124
|
+
* 8-bit stats some GPUs fall back to (no float render targets) top out at
|
|
125
|
+
* 255/256, so an exact 1 never comes there (the probe's self-test uses the same).
|
|
126
|
+
*/
|
|
127
|
+
export declare const MAKEUP_SKIN_READY = 0.99;
|
|
128
|
+
export declare const computeMakeupSkinTone: (stats: MakeupSkinToneInput, options?: ComputeMakeupSkinToneOptions) => MakeupSkinTone | null;
|
|
129
|
+
/**
|
|
130
|
+
* Whether two readouts differ enough to tell the app (`useMakeupSkinTone`
|
|
131
|
+
* re-renders only then): another depth, undertone, recommendation, or a
|
|
132
|
+
* skin, lip or brow colour that moved by a step of the sRGB hex.
|
|
133
|
+
*/
|
|
134
|
+
export declare const makeupSkinToneChanged: (previous: MakeupSkinTone | null, next: MakeupSkinTone | null) => boolean;
|
|
135
|
+
export {};
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { LipEffectSettings } from '../LipEffect/settings';
|
|
2
|
+
import { MakeupFaceRegion, MakeupFinish, MakeupRegion, MakeupSide } from './constants';
|
|
3
|
+
import { MakeupShadeSetting } from './shades';
|
|
4
|
+
import { MakeupShape } from './shapes';
|
|
5
|
+
/**
|
|
6
|
+
* Fields every makeup region shares (lips use `LipEffectSettings`). Flat and
|
|
7
|
+
* serializable: a settings object can live in a store, a URL or a panel.
|
|
8
|
+
*/
|
|
9
|
+
export type MakeupRegionSettings<R extends MakeupFaceRegion> = {
|
|
10
|
+
/** `false` draws nothing and costs nothing. Looks use it for unused regions. */
|
|
11
|
+
enabled: boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Placement preset from `MAKEUP_SHAPES[region]`; it sets the geometry
|
|
14
|
+
* fields and `coverage`. `"custom"` applies no preset: the placement is the
|
|
15
|
+
* region's default shape's (contour `soft`, blush `apples`, highlighter
|
|
16
|
+
* `cheekbones`, eyeshadow `lid`, eyeliner `classic`, brows `natural`) with
|
|
17
|
+
* the fields as given.
|
|
18
|
+
*/
|
|
19
|
+
shape: MakeupShape<R> | "custom";
|
|
20
|
+
/**
|
|
21
|
+
* A named colour from `MAKEUP_SHADES[region]` (sets `color`), `"auto"`
|
|
22
|
+
* where supported (from the person's own colouring; `color` is the
|
|
23
|
+
* fallback until it is measured) or `"custom"` (`color` as given).
|
|
24
|
+
*/
|
|
25
|
+
shade: MakeupShadeSetting<R>;
|
|
26
|
+
/** CSS colour. An explicit colour that differs from the shade wins and the shade becomes `"custom"`. */
|
|
27
|
+
color: string;
|
|
28
|
+
/** Linear amount, 0..1: 0.8 renders 80 %. */
|
|
29
|
+
opacity: number;
|
|
30
|
+
/** 0 = sheer (filters the person's own colour, never lightens), 1 = opaque (covers the skin). */
|
|
31
|
+
coverage: number;
|
|
32
|
+
/** How the product reflects light. Choosing a finish sets `shine` and the sparkle fields. */
|
|
33
|
+
finish: MakeupFinish;
|
|
34
|
+
/** Strength of the finish highlight, 0..1. */
|
|
35
|
+
shine: number;
|
|
36
|
+
/** Flake colour for `shimmer` / `glitter`; `""` derives it from the shade. */
|
|
37
|
+
sparkleColor: string;
|
|
38
|
+
/** Flake density, 0..1 (`shimmer` and `glitter` only). */
|
|
39
|
+
sparkleDensity: number;
|
|
40
|
+
/** Flake size in millimetres, 0.1..1.5. */
|
|
41
|
+
sparkleSize: number;
|
|
42
|
+
/** Edge feather, 0..1. */
|
|
43
|
+
softness: number;
|
|
44
|
+
/** The person's own side(s) to paint, on every feed. */
|
|
45
|
+
side: MakeupSide;
|
|
46
|
+
};
|
|
47
|
+
export type BlushSettings = MakeupRegionSettings<"blush"> & {
|
|
48
|
+
/** Scale of the placement, 0.5..1.5. */
|
|
49
|
+
size: number;
|
|
50
|
+
/** −1..1: 0 sits on the cheek, positive lifts toward the temple, negative drops toward the apples. */
|
|
51
|
+
lift: number;
|
|
52
|
+
};
|
|
53
|
+
export type ContourSettings = MakeupRegionSettings<"contour"> & {
|
|
54
|
+
/** Scale of the placement, 0.5..1.5. */
|
|
55
|
+
size: number;
|
|
56
|
+
};
|
|
57
|
+
export type HighlighterSettings = MakeupRegionSettings<"highlighter"> & {
|
|
58
|
+
/** Scale of the placement, 0.5..1.5. */
|
|
59
|
+
size: number;
|
|
60
|
+
};
|
|
61
|
+
export type EyeshadowSettings = MakeupRegionSettings<"eyeshadow"> & {
|
|
62
|
+
/** How far the lid colour reaches, 0..1: lash line (0) to brow (1). */
|
|
63
|
+
height: number;
|
|
64
|
+
/** Strength of the crease band, 0..1. */
|
|
65
|
+
crease: number;
|
|
66
|
+
/** Crease colour by name; `creaseColor` wins when it differs. */
|
|
67
|
+
creaseShade: MakeupShadeSetting<"eyeshadow">;
|
|
68
|
+
creaseColor: string;
|
|
69
|
+
/** Shadow along the lower lash line, 0..1. */
|
|
70
|
+
lower: number;
|
|
71
|
+
/** Inner-corner highlight, 0..1. */
|
|
72
|
+
inner: number;
|
|
73
|
+
/** Inner-corner colour by name; `innerColor` wins when it differs. */
|
|
74
|
+
innerShade: MakeupShadeSetting<"eyeshadow">;
|
|
75
|
+
innerColor: string;
|
|
76
|
+
};
|
|
77
|
+
export type EyelinerSettings = MakeupRegionSettings<"eyeliner"> & {
|
|
78
|
+
/** Line width at its thickest, in millimetres, 0.2..4. */
|
|
79
|
+
thickness: number;
|
|
80
|
+
/** Wing length past the outer corner, in millimetres, 0..15. */
|
|
81
|
+
wing: number;
|
|
82
|
+
/** Wing angle in degrees, 0..45, upward in the person's frame. */
|
|
83
|
+
wingAngle: number;
|
|
84
|
+
/** Lower lash line, 0..1 (fades while blinking). */
|
|
85
|
+
lower: number;
|
|
86
|
+
/** Softens and widens the line, 0..1. */
|
|
87
|
+
smudge: number;
|
|
88
|
+
};
|
|
89
|
+
export type BrowsSettings = MakeupRegionSettings<"brows"> & {
|
|
90
|
+
/** 0..1; 0.5 follows the person's own brow, higher is thicker and darker. */
|
|
91
|
+
boldness: number;
|
|
92
|
+
/** 0 tints only the real hairs, 1 fills a full powder shape. */
|
|
93
|
+
fill: number;
|
|
94
|
+
/** Procedural hair strokes, 0..1. */
|
|
95
|
+
strokes: number;
|
|
96
|
+
};
|
|
97
|
+
/** Settings per region: `MakeupSettings["blush"]` is `BlushSettings`, lips are `LipEffectSettings`. */
|
|
98
|
+
export type MakeupSettings = {
|
|
99
|
+
lips: LipEffectSettings;
|
|
100
|
+
contour: ContourSettings;
|
|
101
|
+
blush: BlushSettings;
|
|
102
|
+
highlighter: HighlighterSettings;
|
|
103
|
+
eyeshadow: EyeshadowSettings;
|
|
104
|
+
eyeliner: EyelinerSettings;
|
|
105
|
+
brows: BrowsSettings;
|
|
106
|
+
};
|
|
107
|
+
/** Partial settings per region, as looks and overrides carry them. */
|
|
108
|
+
export type MakeupSettingsInput = {
|
|
109
|
+
[R in MakeupRegion]?: Partial<MakeupSettings[R]>;
|
|
110
|
+
};
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { FaceSkinQuality } from '../../face-atlas/probe/constants';
|
|
2
|
+
import { MakeupSkinTone } from './skinTone';
|
|
3
|
+
export type UseMakeupSkinToneOptions = {
|
|
4
|
+
/** Which tracked face. Default: the nearest `FaceRig` / `FaceTracker`'s face, else 0. */
|
|
5
|
+
faceIndex?: number;
|
|
6
|
+
/** Faces to start the face model with when this starts it (no `FaceTracker` above). */
|
|
7
|
+
numFaces?: number;
|
|
8
|
+
/**
|
|
9
|
+
* Milliseconds between reads of the probe, at least
|
|
10
|
+
* `MAKEUP_SKIN_TONE.minReadbackMs` (200). Default 500 (two reads a second).
|
|
11
|
+
*/
|
|
12
|
+
intervalMs?: number;
|
|
13
|
+
/** Shades recommended per region. Default 3. */
|
|
14
|
+
count?: number;
|
|
15
|
+
/** The skin probe's quality (`useFaceSkin`). Default `"auto"`. */
|
|
16
|
+
quality?: FaceSkinQuality;
|
|
17
|
+
/** `false` stops reading and releases the probe. Default true. */
|
|
18
|
+
enabled?: boolean;
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* The person's skin tone for shade-finder UIs: skin depth (`fair` … `rich`),
|
|
22
|
+
* undertone (`cool`, `neutral`, `warm`), the measured skin, lip and brow
|
|
23
|
+
* colours, and the curated palette shades nearest what each region would
|
|
24
|
+
* paint on them (`MakeupSkinTone`). `null` until the face's skin probe has
|
|
25
|
+
* settled.
|
|
26
|
+
*
|
|
27
|
+
* It reads the shared skin probe of the face (the one makeup uses; it starts
|
|
28
|
+
* one if none runs) back from the GPU without stalling it, at most every
|
|
29
|
+
* `intervalMs` (default 500 ms), and re-renders only when the readout
|
|
30
|
+
* changes. Works alone (it starts the face model when no `FaceTracker` is
|
|
31
|
+
* above). The camera's white balance moves the undertone and its exposure
|
|
32
|
+
* the depth: it describes the image, not the person, so offer it as a
|
|
33
|
+
* suggestion, never a label.
|
|
34
|
+
*
|
|
35
|
+
* ```tsx
|
|
36
|
+
* const tone = useMakeupSkinTone();
|
|
37
|
+
* <Blush shade={tone?.recommendations.blush[0] ?? "rose"} />
|
|
38
|
+
* ```
|
|
39
|
+
*/
|
|
40
|
+
export declare const useMakeupSkinTone: (options?: UseMakeupSkinToneOptions) => MakeupSkinTone | null;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { ReactNode } from 'react';
|
|
2
|
+
import { SpringSwingOptions } from '../../spring/swing';
|
|
3
|
+
import { CanonicalOffset } from '../HeadOccluder/useLandmarkPoseFit';
|
|
4
|
+
import { CanonicalTorsoFitOptions } from '../ShoulderOccluder/useCanonicalTorsoFit';
|
|
5
|
+
import type * as THREE from "three";
|
|
6
|
+
/** Nodes whose name contains one of these swing (`*_pendant`, `*_charm`). */
|
|
7
|
+
export declare const NECKLACE_SWING_NODES: readonly string[];
|
|
8
|
+
/** A pendant lies on the chest: it swings less far than an earring. */
|
|
9
|
+
export declare const NECKLACE_SWING_DEFAULTS: Readonly<SpringSwingOptions>;
|
|
10
|
+
export type NecklaceProps = Omit<CanonicalTorsoFitOptions, "offset"> & {
|
|
11
|
+
/**
|
|
12
|
+
* The necklace, authored in the torso frame: centimetres, origin between
|
|
13
|
+
* the shoulder joints, +X screen right, +Y up, +Z toward the camera, the
|
|
14
|
+
* chain on the neck base and upper chest. A pendant is a child node named
|
|
15
|
+
* `…pendant…` (or `…charm…`) with its origin on its bail. Cloned, so pass a
|
|
16
|
+
* loaded GLB's scene (or one of its nodes) as it is.
|
|
17
|
+
*/
|
|
18
|
+
model?: THREE.Object3D | null;
|
|
19
|
+
/** JSX in the same frame (it does not swing). */
|
|
20
|
+
children?: ReactNode;
|
|
21
|
+
/**
|
|
22
|
+
* The pendants swing on a spring about their bail as the body moves, then
|
|
23
|
+
* settle: `true` (default) for the gentle default, `SpringSwingOptions`, or
|
|
24
|
+
* `false` (rigid). They hang along the torso's own down.
|
|
25
|
+
*/
|
|
26
|
+
swing?: boolean | SpringSwingOptions;
|
|
27
|
+
/** Name parts of the nodes that swing. Default `NECKLACE_SWING_NODES`. */
|
|
28
|
+
swingNodes?: readonly string[];
|
|
29
|
+
/** Hide the chain behind the neck and shoulders (a `ShoulderOccluder`). Default true. */
|
|
30
|
+
occluder?: boolean;
|
|
31
|
+
/** The occluder's mesh (`ShoulderOccluder` `url`); default the SDK's CDN copy. */
|
|
32
|
+
occluderUrl?: string;
|
|
33
|
+
/** Nudge on top of the fit, in torso centimetres. */
|
|
34
|
+
offset?: CanonicalOffset;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* A necklace on a tracked body: the chain sits on the neck base and upper
|
|
38
|
+
* chest (the canonical torso fit), its pendants swing, and the shoulder
|
|
39
|
+
* occluder hides the chain behind the neck. Inside a `BodyTracker` it uses
|
|
40
|
+
* that body; anywhere else it tracks the body itself (`bodyIndex`). Hidden
|
|
41
|
+
* while the body is lost. Under a `HeadOccluder` (a `HeadBinding`) the chin
|
|
42
|
+
* hides the chain behind it too.
|
|
43
|
+
*/
|
|
44
|
+
export declare const Necklace: ({ model, children, swing, swingNodes, occluder, occluderUrl, offset, bodyIndex, ...fit }: NecklaceProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { NECKLACE_SWING_DEFAULTS, NECKLACE_SWING_NODES, Necklace, type NecklaceProps, } from './Necklace';
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { Euler, Vector3 } from '@react-three/fiber';
|
|
2
|
+
import { ReactNode } from 'react';
|
|
3
|
+
import { ParticleEmitterTarget } from '../../particles/eyes';
|
|
4
|
+
import { ParticlePreset } from '../../particles/presets';
|
|
5
|
+
import { ParticleSettings } from '../../particles/settings';
|
|
6
|
+
import { ParticleSystem } from '../../particles/system';
|
|
7
|
+
import type * as THREE from "three";
|
|
8
|
+
export type ParticleEmitterProps = Partial<ParticleSettings> & {
|
|
9
|
+
/** A built-in look the other settings go on top of (`PARTICLE_PRESETS`). */
|
|
10
|
+
preset?: ParticlePreset;
|
|
11
|
+
/**
|
|
12
|
+
* Emit from the person's own left eye, right eye, or both (two emitters),
|
|
13
|
+
* straight out of the face. `position`, `rotation` and `scale` then apply
|
|
14
|
+
* about the eye, in the head's centimetres. Inside a `FaceTracker` it
|
|
15
|
+
* follows that tracker's face; anywhere else it tracks the face itself.
|
|
16
|
+
*/
|
|
17
|
+
target?: ParticleEmitterTarget;
|
|
18
|
+
/** With `target`: the face (default: the enclosing `FaceTracker`'s, else 0). */
|
|
19
|
+
faceIndex?: number;
|
|
20
|
+
/** With `target` and no enclosing `FaceTracker`: faces the face model tracks when this starts it. */
|
|
21
|
+
numFaces?: number;
|
|
22
|
+
/** New particles keep coming. False stops emitting; the particles already out live on. Default true. */
|
|
23
|
+
emitting?: boolean;
|
|
24
|
+
/** The particles' render order (they draw in the transparent pass). Default 0. */
|
|
25
|
+
renderOrder?: number;
|
|
26
|
+
/** The emitter's place in its parent (its +Z is forward). */
|
|
27
|
+
position?: Vector3;
|
|
28
|
+
rotation?: Euler;
|
|
29
|
+
scale?: Vector3;
|
|
30
|
+
/** Called with each emitter's `ParticleSystem` when it is made, and with null when it goes. */
|
|
31
|
+
onSystem?: (system: ParticleSystem | null) => void;
|
|
32
|
+
children?: ReactNode;
|
|
33
|
+
};
|
|
34
|
+
/**
|
|
35
|
+
* Emits particles from where it is: put it anywhere in the scene, inside a
|
|
36
|
+
* tracker to follow a face or a hand, or give it a `target` (the eyes).
|
|
37
|
+
* Particles are drawn in world space and keep their own path once out; they
|
|
38
|
+
* live on when the emitter stops or its tracker hides (it emits only while
|
|
39
|
+
* shown). Settings are props (any subset of `ParticleSettings`, over a
|
|
40
|
+
* `preset`), in the emitter's units: inside a head frame (and with
|
|
41
|
+
* `target`), centimetres. The ref is the emitter's group (with two eyes, the
|
|
42
|
+
* person's left one).
|
|
43
|
+
*/
|
|
44
|
+
export declare const ParticleEmitter: import('react').ForwardRefExoticComponent<Partial<ParticleSettings> & {
|
|
45
|
+
/** A built-in look the other settings go on top of (`PARTICLE_PRESETS`). */
|
|
46
|
+
preset?: ParticlePreset;
|
|
47
|
+
/**
|
|
48
|
+
* Emit from the person's own left eye, right eye, or both (two emitters),
|
|
49
|
+
* straight out of the face. `position`, `rotation` and `scale` then apply
|
|
50
|
+
* about the eye, in the head's centimetres. Inside a `FaceTracker` it
|
|
51
|
+
* follows that tracker's face; anywhere else it tracks the face itself.
|
|
52
|
+
*/
|
|
53
|
+
target?: ParticleEmitterTarget;
|
|
54
|
+
/** With `target`: the face (default: the enclosing `FaceTracker`'s, else 0). */
|
|
55
|
+
faceIndex?: number;
|
|
56
|
+
/** With `target` and no enclosing `FaceTracker`: faces the face model tracks when this starts it. */
|
|
57
|
+
numFaces?: number;
|
|
58
|
+
/** New particles keep coming. False stops emitting; the particles already out live on. Default true. */
|
|
59
|
+
emitting?: boolean;
|
|
60
|
+
/** The particles' render order (they draw in the transparent pass). Default 0. */
|
|
61
|
+
renderOrder?: number;
|
|
62
|
+
/** The emitter's place in its parent (its +Z is forward). */
|
|
63
|
+
position?: Vector3;
|
|
64
|
+
rotation?: Euler;
|
|
65
|
+
scale?: Vector3;
|
|
66
|
+
/** Called with each emitter's `ParticleSystem` when it is made, and with null when it goes. */
|
|
67
|
+
onSystem?: (system: ParticleSystem | null) => void;
|
|
68
|
+
children?: ReactNode;
|
|
69
|
+
} & import('react').RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { ParticleEmitter, type ParticleEmitterProps } from './ParticleEmitter';
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { ScreenImageProps } from '../ScreenImage/types';
|
|
2
|
+
import { PersonCutoutFallback, PersonCutoutStatus } from './personCutout';
|
|
3
|
+
import type * as THREE from "three";
|
|
4
|
+
export type { PersonCutoutFallback, PersonCutoutStatus } from './personCutout';
|
|
5
|
+
export { FULL_SCREEN_ANCHORS, resolvePersonCutoutStatus, shouldDrawFallback } from './personCutout';
|
|
6
|
+
export type PersonMaskTextureResult = {
|
|
7
|
+
/**
|
|
8
|
+
* The portrait segmentation mask in feed space. The signal is in RGB:
|
|
9
|
+
* white (255) on the person, black (0) on the background, alpha 255
|
|
10
|
+
* everywhere (measured; three's `alphaMap` reads green, which is how
|
|
11
|
+
* `VideoBackground` consumes it).
|
|
12
|
+
*/
|
|
13
|
+
texture: THREE.Texture | null;
|
|
14
|
+
status: PersonCutoutStatus;
|
|
15
|
+
error: Error | null;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* The portrait segmentation mask as a texture, with the model's lifecycle.
|
|
19
|
+
* Acquires the segmentation model itself. The mask lives in feed space, like
|
|
20
|
+
* the camera texture; read its green channel: 255 on the person, 0 elsewhere.
|
|
21
|
+
*/
|
|
22
|
+
export declare const usePersonMaskTexture: (active?: boolean) => PersonMaskTextureResult;
|
|
23
|
+
export type PersonCutoutProps = Omit<ScreenImageProps, "source" | "src" | "maskTexture" | "maskChannel" | "maskInvert"> & {
|
|
24
|
+
/** Edge softening as a 3×3 blur radius in mask texels. Default 4; 0 = hard edge. */
|
|
25
|
+
maskFeather?: number;
|
|
26
|
+
/**
|
|
27
|
+
* Shrink the kept silhouette into the feathered edge (0..1 of the feather
|
|
28
|
+
* width) so background fringe from the segmenter is trimmed. Default 0.7.
|
|
29
|
+
*/
|
|
30
|
+
maskErode?: number;
|
|
31
|
+
/** Show the background only (cut the person out) instead of the person only. */
|
|
32
|
+
invert?: boolean;
|
|
33
|
+
/**
|
|
34
|
+
* What to draw while the segmentation model is loading or has failed:
|
|
35
|
+
* the unmasked camera (default, the experience degrades to a plain feed)
|
|
36
|
+
* or nothing.
|
|
37
|
+
*/
|
|
38
|
+
fallback?: PersonCutoutFallback;
|
|
39
|
+
/** Keep the segmentation model running. Default true. */
|
|
40
|
+
active?: boolean;
|
|
41
|
+
onStatusChange?: (status: PersonCutoutStatus, error: Error | null) => void;
|
|
42
|
+
};
|
|
43
|
+
/**
|
|
44
|
+
* The live camera, masked to the person, as a full-screen `ScreenImage`.
|
|
45
|
+
* Place any `ScreenImage` (image, video, GIF) or shader surface behind it
|
|
46
|
+
* with a lower `renderOrder` for background replacement. The camera texture is
|
|
47
|
+
* already cover-cropped and webcam-mirrored by the session, and the mask is in
|
|
48
|
+
* that same space, so no coordinate work is needed.
|
|
49
|
+
*/
|
|
50
|
+
export declare const PersonCutout: ({ invert, fallback, active, onStatusChange, fit, anchors, renderOrder, visible, maskFeather, maskErode, ...screenImageProps }: PersonCutoutProps) => import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { ScreenAnchorEdges } from '../ScreenSpaceUI';
|
|
2
|
+
/** Anchors that stretch a screen element over the whole viewport. */
|
|
3
|
+
export declare const FULL_SCREEN_ANCHORS: ScreenAnchorEdges;
|
|
4
|
+
export type PersonCutoutStatus = "loading" | "ready" | "error";
|
|
5
|
+
/**
|
|
6
|
+
* Status of a person cut-out from the segmentation model's lifecycle and
|
|
7
|
+
* whether its mask texture exists yet.
|
|
8
|
+
*/
|
|
9
|
+
export declare const resolvePersonCutoutStatus: ({ ready, error, hasMask, }: {
|
|
10
|
+
ready: boolean;
|
|
11
|
+
error: Error | null;
|
|
12
|
+
hasMask: boolean;
|
|
13
|
+
}) => PersonCutoutStatus;
|
|
14
|
+
export type PersonCutoutFallback = "camera" | "hidden";
|
|
15
|
+
/** Whether the camera layer should draw while the mask is not available. */
|
|
16
|
+
export declare const shouldDrawFallback: (status: PersonCutoutStatus, fallback: PersonCutoutFallback) => boolean;
|
|
@@ -5,5 +5,5 @@ type ScreenImageBodyProps = Omit<ScreenImageProps, "anchors" | "coordinateSpace"
|
|
|
5
5
|
height: number;
|
|
6
6
|
};
|
|
7
7
|
};
|
|
8
|
-
export declare function ScreenImageBody({ name, source, src, fit, stretchMode, materialType, blendMode, backdropTexture: providedBackdropTexture, rotation, opacity, color, flipX, flipY, renderOrder, transparent, alphaTest, overlay, visible, layoutSize, }: ScreenImageBodyProps): import("react/jsx-runtime").JSX.Element;
|
|
8
|
+
export declare function ScreenImageBody({ name, source, src, fit, stretchMode, materialType, blendMode, backdropTexture: providedBackdropTexture, rotation, opacity, color, maskTexture, maskChannel, maskInvert, maskFeather, maskErode, flipX, flipY, renderOrder, transparent, alphaTest, overlay, visible, layoutSize, }: ScreenImageBodyProps): import("react/jsx-runtime").JSX.Element;
|
|
9
9
|
export {};
|