@vincentt-xr/sdk 2.0.0-alpha.0 → 2.0.0-alpha.10
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 +8193 -111
- package/README.md +86 -52
- package/dist/CanonicalHeadFrame-D_0OzdB9.cjs +1 -0
- package/dist/CanonicalHeadFrame-DdUqF6Fv.js +1506 -0
- package/dist/DebuggerUI-CVuV-VJ5.cjs +1 -0
- package/dist/DebuggerUI-D-rcPa54.js +275 -0
- package/dist/FaceRetouch-C1AxBNex.js +1071 -0
- package/dist/FaceRetouch-D7kryDE6.cjs +134 -0
- package/dist/FaceSurface-CHAMEeG1.cjs +1 -0
- package/dist/FaceSurface-DmP9AEeC.js +27 -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/assets/sdkModels.d.ts +22 -0
- package/dist/audio/AudioEngine.d.ts +3 -1
- package/dist/audio/AudioPlayer.d.ts +29 -0
- package/dist/audio/AudioPlayerLogic.d.ts +4 -0
- package/dist/audio/index.d.ts +2 -0
- package/dist/body/__fixtures__/syntheticRig.d.ts +21 -0
- package/dist/body/bodyFlipGuard.d.ts +39 -0
- package/dist/body/bodyIdentity.d.ts +72 -0
- package/dist/body/bodyMask.d.ts +79 -0
- package/dist/body/bodyMaskMaterial.d.ts +15 -0
- package/dist/body/bodyPose.d.ts +58 -0
- package/dist/body/bodyRigFit.d.ts +148 -0
- package/dist/body/bodyRigSolver.d.ts +114 -0
- package/dist/body/bodySubject.d.ts +46 -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/bodyMaskMaterial-CBWub5t_.cjs +68 -0
- package/dist/bodyMaskMaterial-Cs2awskk.js +207 -0
- package/dist/cache-2x3CUJuY.js +212 -0
- package/dist/cache-DL1Dbz6k.cjs +1 -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/Axes/index.d.ts +6 -0
- package/dist/components/BodyInstruction/BodyPoseHint.d.ts +63 -0
- package/dist/components/BodyInstruction/index.d.ts +76 -0
- package/dist/components/BodyInstruction/useBodyPose.d.ts +30 -0
- package/dist/components/BodyRig/BodyAttachment.d.ts +28 -0
- package/dist/components/BodyRig/BodyOccluder.d.ts +27 -0
- package/dist/components/BodyRig/bodyDepth.d.ts +57 -0
- package/dist/components/BodyRig/index.d.ts +129 -0
- package/dist/components/BodyRig/useBodyDepthTexture.d.ts +40 -0
- package/dist/components/BodyTracker/index.d.ts +26 -1
- package/dist/components/BodyTrigger/index.d.ts +56 -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/FaceMeshRenderer.d.ts +25 -0
- package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts +70 -1
- package/dist/components/FaceMesh/canonical/FaceMeshMaterial.d.ts +25 -0
- package/dist/components/FaceMesh/canonical/assets.d.ts +3 -0
- package/dist/components/FaceMesh/canonical/geometryGroups.d.ts +30 -0
- package/dist/components/FaceMesh/canonical/parseCanonicalFaceModel.d.ts +24 -0
- package/dist/components/FaceMesh/canonical/shaders.d.ts +2 -0
- package/dist/components/FaceMesh/deform.d.ts +3 -0
- package/dist/components/FaceMesh/index.d.ts +6 -1
- package/dist/components/FaceMesh/material/defaults.d.ts +74 -0
- package/dist/components/FaceMesh/material/index.d.ts +1 -0
- package/dist/components/FaceMesh/material/options.d.ts +5 -1
- package/dist/components/FaceMesh/material/support.d.ts +7 -2
- package/dist/components/FaceMesh/material/textures.d.ts +4 -0
- package/dist/components/FaceMesh/material/types.d.ts +4 -2
- package/dist/components/FaceRetouch/Background.d.ts +11 -5
- package/dist/components/FaceRetouch/FaceRetouch.d.ts +52 -0
- package/dist/components/FaceRetouch/index.d.ts +2 -6
- package/dist/components/FaceRetouch/landmarkMask.d.ts +4 -6
- package/dist/components/FaceRetouch/renderState.d.ts +19 -0
- package/dist/components/FaceRetouch/useFaceRetouchMask.d.ts +4 -7
- 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/FaceTracker/index.d.ts +5 -3
- package/dist/components/FaceWarp3D/FaceWarp3D.d.ts +50 -0
- package/dist/components/FaceWarp3D/index.d.ts +2 -0
- 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/HandEffect/index.d.ts +36 -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/HandJoints2D/index.d.ts +6 -0
- package/dist/components/HandRig/ForearmOccluder.d.ts +29 -0
- package/dist/components/HandRig/HandAttachment.d.ts +34 -0
- package/dist/components/HandRig/HandNails.d.ts +61 -0
- package/dist/components/HandRig/HandOccluder.d.ts +45 -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 +127 -0
- package/dist/components/HandRig/useArmMask.d.ts +29 -0
- package/dist/components/HandRig/wristSolve.d.ts +96 -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 +12 -2
- package/dist/components/HandTracking2D/HandVisual.d.ts +12 -0
- package/dist/components/HandTracking2D/index.d.ts +5 -0
- package/dist/components/HandTracking2DController/index.d.ts +5 -0
- package/dist/components/HandTracking3D/index.d.ts +6 -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 +67 -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/LightObject/index.d.ts +20 -0
- package/dist/components/LipEffect/LipEffect.d.ts +28 -0
- package/dist/components/LipEffect/LipEffectMaterial.d.ts +98 -0
- package/dist/components/LipEffect/LipEffects.d.ts +12 -0
- package/dist/components/LipEffect/defaults.d.ts +51 -0
- package/dist/components/LipEffect/index.d.ts +12 -0
- 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 +141 -0
- package/dist/components/LipEffect/useLipDesignTextures.d.ts +17 -0
- package/dist/components/LipEffect/uvGuide.d.ts +74 -0
- package/dist/components/LookAt/index.d.ts +23 -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/MeshRenderer/index.d.ts +59 -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 +46 -0
- package/dist/components/PersonCutout/personCutout.d.ts +16 -0
- package/dist/components/PersonCutout/personMask.d.ts +19 -0
- package/dist/components/PersonCutout/useBodyMaskTexture.d.ts +35 -0
- package/dist/components/PerspectiveCamera/index.d.ts +2 -8
- package/dist/components/PinToMesh/index.d.ts +47 -0
- package/dist/components/RenderGroupLayer/index.d.ts +6 -0
- package/dist/components/SceneObjectRenderer/index.d.ts +23 -0
- package/dist/components/Screen2D/ScreenTransformFrame.d.ts +11 -0
- package/dist/components/Screen2D/ScreenTransformHelpers.d.ts +19 -0
- package/dist/components/Screen2D/ScreenTransformInteraction.d.ts +18 -0
- package/dist/components/Screen2D/index.d.ts +5 -0
- package/dist/components/ScreenGlass/defaults.d.ts +3 -0
- package/dist/components/ScreenGlass/index.d.ts +5 -0
- package/dist/components/ScreenGlass/shaders.d.ts +2 -0
- package/dist/components/ScreenGlass/types.d.ts +10 -0
- package/dist/components/ScreenGradient/defaults.d.ts +5 -0
- package/dist/components/ScreenGradient/index.d.ts +5 -0
- package/dist/components/ScreenGradient/shaders.d.ts +2 -0
- package/dist/components/ScreenGradient/types.d.ts +19 -0
- package/dist/components/ScreenImage/ScreenImage.d.ts +4 -0
- package/dist/components/ScreenImage/components/DynamicTextureSync.d.ts +9 -0
- package/dist/components/ScreenImage/components/ScreenImageBody.d.ts +9 -0
- package/dist/components/ScreenImage/components/ScreenImageFrame.d.ts +9 -0
- package/dist/components/ScreenImage/components/ScreenImageTransformFrame.d.ts +9 -0
- package/dist/components/ScreenImage/fit.d.ts +52 -0
- package/dist/components/ScreenImage/index.d.ts +10 -0
- package/dist/components/ScreenImage/materials/ScreenImageBlendMaterial.d.ts +9 -0
- package/dist/components/ScreenImage/materials/ScreenImageMaskMaterial.d.ts +11 -0
- package/dist/components/ScreenImage/materials/ScreenImageMatcap.d.ts +3 -0
- package/dist/components/ScreenImage/source.d.ts +25 -0
- package/dist/components/ScreenImage/types.d.ts +64 -0
- package/dist/components/ScreenImage/utils/ScreenImageConstants.d.ts +9 -0
- package/dist/components/ScreenImage/utils/ScreenImageHelpers.d.ts +4 -0
- package/dist/components/ScreenShape/geometry.d.ts +5 -0
- package/dist/components/ScreenShape/index.d.ts +5 -0
- package/dist/components/ScreenShape/types.d.ts +54 -0
- package/dist/components/ScreenSpaceUI/ScreenTransformGuide.d.ts +15 -0
- package/dist/components/ScreenSpaceUI/ScreenTransformOverlayGuide.d.ts +9 -0
- package/dist/components/ScreenSpaceUI/index.d.ts +3 -0
- package/dist/components/ScreenText/components/ScreenTextBody.d.ts +2 -0
- package/dist/components/ScreenText/components/ScreenTextTransformFrame.d.ts +9 -0
- package/dist/components/ScreenText/constants.d.ts +5 -0
- package/dist/components/ScreenText/index.d.ts +6 -0
- package/dist/components/ScreenText/types.d.ts +31 -0
- package/dist/components/ScreenText/utils/ScreenTextHelpers.d.ts +14 -0
- package/dist/components/ScreenText/utils/ScreenTextMappings.d.ts +17 -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/SequentialRenderPasses/index.d.ts +6 -0
- package/dist/components/ShoulderOccluder/index.d.ts +46 -0
- package/dist/components/ShoulderOccluder/useCanonicalTorsoFit.d.ts +27 -0
- package/dist/components/SpringSwing/SpringSwing.d.ts +22 -0
- package/dist/components/SpringSwing/index.d.ts +1 -0
- package/dist/components/TextLabel/TextLabel.d.ts +5 -0
- package/dist/components/TextLabel/alignment.d.ts +4 -0
- package/dist/components/TextLabel/bend.d.ts +9 -0
- package/dist/components/TextLabel/canvas/buildTextLabelTexture.d.ts +4 -0
- package/dist/components/TextLabel/canvas/canvasTypography.d.ts +13 -0
- package/dist/components/TextLabel/canvas/drawBackground.d.ts +21 -0
- package/dist/components/TextLabel/canvas/drawEffects.d.ts +34 -0
- package/dist/components/TextLabel/canvas/drawText.d.ts +19 -0
- package/dist/components/TextLabel/components/TextLabelMesh.d.ts +13 -0
- package/dist/components/TextLabel/constants.d.ts +2 -0
- package/dist/components/TextLabel/hooks/useTextLabelTexture.d.ts +7 -0
- package/dist/components/TextLabel/index.d.ts +2 -62
- package/dist/components/TextLabel/layout/measurement.d.ts +8 -0
- package/dist/components/TextLabel/layout/resolveTextLayout.d.ts +25 -0
- package/dist/components/TextLabel/layout/wrapText.d.ts +6 -0
- package/dist/components/TextLabel/types.d.ts +337 -0
- package/dist/components/TrackingAnchor/index.d.ts +18 -2
- package/dist/components/Transform3D/index.d.ts +30 -0
- package/dist/components/XRMediaSurface/index.d.ts +8 -7
- package/dist/components/XRProvider/index.d.ts +16 -2
- package/dist/components/XRScene/index.d.ts +14 -3
- package/dist/components/XRScene/renderOutputTarget.d.ts +12 -0
- package/dist/components/XRViewport/XRViewport.d.ts +11 -0
- package/dist/components/XRViewport/components/HiddenMedia.d.ts +7 -0
- package/dist/components/XRViewport/components/MediaAssetPicker.d.ts +8 -0
- package/dist/components/XRViewport/components/MediaControlStack.d.ts +13 -0
- package/dist/components/XRViewport/components/XRViewportLayers.d.ts +30 -0
- package/dist/components/XRViewport/constants.d.ts +24 -0
- package/dist/components/XRViewport/contexts.d.ts +6 -0
- package/dist/components/XRViewport/hooks/useViewportExternalFaces.d.ts +13 -0
- package/dist/components/XRViewport/hooks/useViewportMediaSource.d.ts +16 -0
- package/dist/components/XRViewport/hooks/useViewportMediaTexture.d.ts +10 -0
- package/dist/components/XRViewport/hooks/useViewportPipeline.d.ts +41 -0
- package/dist/components/XRViewport/hooks/useViewportRenderState.d.ts +47 -0
- package/dist/components/XRViewport/index.d.ts +3 -101
- package/dist/components/XRViewport/layout.d.ts +16 -0
- package/dist/components/XRViewport/slots.d.ts +16 -0
- package/dist/components/XRViewport/types.d.ts +89 -0
- package/dist/components/XRViewport/useViewportSize.d.ts +3 -0
- package/dist/components/index.d.ts +31 -0
- package/dist/components/occluder/skinnedOccluder.d.ts +39 -0
- package/dist/config/index.d.ts +1 -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-DQc7zyqT.cjs +1 -0
- package/dist/contexts-Y_FhdnIv.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/component-editor/index.d.ts +19 -0
- package/dist/debug-ui/default-setting/index.d.ts +37 -0
- package/dist/debug-ui/default-setting.cjs +21 -0
- package/dist/debug-ui/default-setting.js +777 -0
- package/dist/debug-ui/face-mesh-renderer-settings/index.d.ts +8 -0
- package/dist/debug-ui/face-retouch/index.d.ts +11 -0
- 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/hand-joints-2d/index.d.ts +6 -0
- package/dist/debug-ui/hand-tracking-2d/index.d.ts +6 -0
- package/dist/debug-ui/hand-tracking-2d-controller/index.d.ts +6 -0
- package/dist/debug-ui/hand-tracking-3d/index.d.ts +6 -0
- package/dist/debug-ui/hierarchy-panel/index.d.ts +30 -0
- package/dist/debug-ui/holistic-tracker-settings/index.d.ts +16 -0
- package/dist/debug-ui/index.d.ts +61 -0
- package/dist/debug-ui/iris-effect-settings/index.d.ts +12 -0
- package/dist/debug-ui/layer-panel/index.d.ts +18 -0
- package/dist/debug-ui/lip-effect-settings/index.d.ts +15 -0
- package/dist/debug-ui/media-source/MediaSourceSwitcher.d.ts +10 -0
- package/dist/debug-ui/media-source/index.d.ts +6 -0
- package/dist/debug-ui/media-source/media-preset.d.ts +21 -0
- package/dist/debug-ui/media-source/session.d.ts +40 -0
- package/dist/debug-ui/media-source.cjs +1 -0
- package/dist/debug-ui/media-source.js +11 -0
- package/dist/debug-ui/mesh-renderer-settings/index.d.ts +6 -0
- package/dist/debug-ui/object-inspector-panel/index.d.ts +26 -0
- package/dist/debug-ui/pin-to-mesh-settings/index.d.ts +10 -0
- package/dist/debug-ui/product-hotspots/index.d.ts +25 -0
- package/dist/debug-ui/scene-editor/context.d.ts +38 -0
- package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts +11 -0
- package/dist/debug-ui/scene-editor/index.d.ts +11 -0
- package/dist/debug-ui/scene-editor/inspector-panel.d.ts +9 -0
- package/dist/debug-ui/scene-editor/store-utils.d.ts +2 -0
- package/dist/debug-ui/scene-editor/viewport-toolbar.d.ts +4 -0
- package/dist/debug-ui/scene-editor/viewport.d.ts +21 -0
- package/dist/debug-ui/screen-glass-settings/index.d.ts +6 -0
- package/dist/debug-ui/screen-gradient-settings/GradientStopsEditor.d.ts +5 -0
- package/dist/debug-ui/screen-gradient-settings/index.d.ts +6 -0
- package/dist/debug-ui/screen-gradient-settings/styles.d.ts +3 -0
- package/dist/debug-ui/screen-image-settings/index.d.ts +11 -0
- package/dist/debug-ui/screen-shape-settings/index.d.ts +6 -0
- package/dist/debug-ui/screen-text-settings/NumberField.d.ts +9 -0
- package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts +3 -0
- package/dist/debug-ui/screen-text-settings/controls/NestedSection.d.ts +7 -0
- package/dist/debug-ui/screen-text-settings/controls/Section.d.ts +8 -0
- package/dist/debug-ui/screen-text-settings/controls/icons.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/index.d.ts +2 -0
- package/dist/debug-ui/screen-text-settings/sections/BackgroundSection.d.ts +8 -0
- package/dist/debug-ui/screen-text-settings/sections/ContentSection.d.ts +5 -0
- package/dist/debug-ui/screen-text-settings/sections/EffectsSection.d.ts +25 -0
- package/dist/debug-ui/screen-text-settings/sections/StyleSection.d.ts +5 -0
- package/dist/debug-ui/screen-text-settings/sections/TransformSection.d.ts +5 -0
- package/dist/debug-ui/screen-text-settings/sections/background/BackgroundFillControls.d.ts +2 -0
- package/dist/debug-ui/screen-text-settings/sections/background/BackgroundSizeControls.d.ts +2 -0
- package/dist/debug-ui/screen-text-settings/sections/background/BackgroundStrokeControls.d.ts +2 -0
- package/dist/debug-ui/screen-text-settings/sections/background/types.d.ts +7 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/BendEffectSection.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/EffectChrome.d.ts +21 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/GlowEffectSection.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/InnerShadowEffectSection.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/OutlineEffectSection.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/ShadowEffectSection.d.ts +4 -0
- package/dist/debug-ui/screen-text-settings/sections/effects/types.d.ts +14 -0
- package/dist/debug-ui/screen-text-settings/settings.d.ts +90 -0
- package/dist/debug-ui/screen-text-settings/styles.d.ts +26 -0
- package/dist/debug-ui/screen-text-settings/transform.d.ts +6 -0
- package/dist/debug-ui/screen-text-settings/types.d.ts +11 -0
- package/dist/debug-ui/segmentation-overlay-settings/index.d.ts +12 -0
- package/dist/debug-ui/settings-panel/index.d.ts +43 -0
- package/dist/debug-ui/shared/MaterialSection.d.ts +13 -0
- package/dist/debug-ui/shared/ScreenTransformSection.d.ts +32 -0
- package/dist/debug-ui/shared/debugWindow.d.ts +51 -0
- package/dist/debug-ui/transform-3d-settings/index.d.ts +11 -0
- package/dist/debug-ui/xr-diagnostics/index.d.ts +26 -0
- package/dist/debug-ui.cjs +10 -0
- package/dist/debug-ui.js +9051 -0
- package/dist/detector-K8aej4MB.js +59 -0
- package/dist/detector-ijypGtse.cjs +1 -0
- package/dist/drawNormalizedCrop-C4KFaRne.cjs +1 -0
- package/dist/drawNormalizedCrop-DG3gtJxf.js +135 -0
- package/dist/entries/all.d.ts +4 -1
- package/dist/entries/core.d.ts +76 -6
- package/dist/entries/face-effects.d.ts +130 -10
- package/dist/entries/instructions.d.ts +48 -0
- package/dist/entries/internal.d.ts +5 -2
- package/dist/entries/low-level.d.ts +104 -6
- package/dist/entries/particles.d.ts +15 -0
- package/dist/entries/product.d.ts +11 -0
- package/dist/entries/scene-object.d.ts +10 -0
- package/dist/entries/tracking.d.ts +110 -2
- package/dist/face-action/index.d.ts +34 -0
- 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-attribute-expression/index.d.ts +10 -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 +2267 -195
- package/dist/face-effects.js +14191 -3346
- package/dist/face-expression/index.d.ts +182 -0
- package/dist/face-info/blendshapes.d.ts +3 -0
- package/dist/face-info/derive.d.ts +8 -0
- package/dist/face-info/drawFaceCrop.d.ts +10 -0
- package/dist/face-info/getFaceInfo.d.ts +8 -0
- package/dist/face-info/index.d.ts +8 -0
- package/dist/face-info/landmarks.d.ts +35 -0
- package/dist/face-info/types.d.ts +69 -0
- 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-BafgGT27.js +62 -0
- package/dist/getFaceInfo-BzlwHMjX.cjs +1 -0
- package/dist/hand/armFit.d.ts +46 -0
- package/dist/hand/armMask.d.ts +190 -0
- package/dist/hand/forearm.d.ts +114 -0
- package/dist/hand/handCutout.d.ts +23 -0
- package/dist/hand/handCutoutRegistry.d.ts +7 -0
- package/dist/hand/handEffect.d.ts +38 -0
- package/dist/hand/handGestures.d.ts +524 -0
- package/dist/hand/handJoints2d.d.ts +49 -0
- package/dist/hand/handNail.d.ts +73 -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/handTracking2d.d.ts +33 -0
- package/dist/hand/handTracking2dController.d.ts +65 -0
- package/dist/hand/handTracking3d.d.ts +52 -0
- package/dist/hand/nailImageMask.d.ts +40 -0
- package/dist/hand/nailMaskFingers.d.ts +23 -0
- package/dist/hand/nailTipRefine.d.ts +37 -0
- package/dist/hand/wrist.d.ts +44 -0
- package/dist/hand/wristFilter.d.ts +44 -0
- package/dist/hooks/faceResults.d.ts +1 -1
- package/dist/hooks/selectors.d.ts +77 -4
- package/dist/hooks/useBodies.d.ts +39 -0
- package/dist/hooks/useCalibrationFaceTracker.d.ts +1 -1
- package/dist/hooks/useFaceAction.d.ts +3 -0
- package/dist/hooks/useFaceAttributeExpression.d.ts +16 -0
- package/dist/hooks/useFaceDetection.d.ts +18 -0
- package/dist/hooks/useFaceInfo.d.ts +19 -0
- package/dist/hooks/useFaceInfos.d.ts +15 -0
- package/dist/hooks/useFaceModelAcquisition.d.ts +38 -0
- package/dist/hooks/useFaceResultReader.d.ts +10 -0
- package/dist/hooks/useFrameCapture.d.ts +18 -0
- package/dist/hooks/useGesture.d.ts +39 -0
- package/dist/hooks/useIrisTracking.d.ts +45 -0
- package/dist/hooks/useMediaRecorder.d.ts +14 -2
- package/dist/hooks/useOwnedTexture.d.ts +6 -0
- package/dist/hooks/useTrackerContext.d.ts +14 -2
- package/dist/hooks/useXRDiagnostics.d.ts +81 -0
- package/dist/hooks/useXRModel.d.ts +12 -0
- package/dist/hooks/useXRSession/facade.d.ts +47 -2
- package/dist/hooks/useXRSession/index.d.ts +2 -2
- package/dist/hooks/useXRSession/reason.d.ts +21 -0
- package/dist/hooks/useXRSession/registry.d.ts +23 -0
- package/dist/hooks/useXRSession/store.d.ts +64 -7
- package/dist/index-BZoBxyLn.js +1103 -0
- package/dist/index-By_LCo2V.cjs +1 -0
- package/dist/index-C-Mryx_u.cjs +21 -0
- package/dist/index-CKRN-xJp.js +3740 -0
- package/dist/index-CUldCMRl.js +188 -0
- package/dist/index-Cyk_VIZE.js +1432 -0
- package/dist/index-D-4w34GO.cjs +1 -0
- package/dist/index-DiIoHK_4.js +442 -0
- package/dist/index-Dv3WnY9n.cjs +46 -0
- package/dist/index-ItufYyHH.cjs +1 -0
- package/dist/index-S3gqudT6.cjs +1 -0
- package/dist/index-Sho4F4it.cjs +1 -0
- package/dist/index-iIQ9jBDb.js +240 -0
- package/dist/index-vr2ichWQ.js +190 -0
- package/dist/instructions.cjs +30 -0
- package/dist/instructions.js +1528 -0
- package/dist/internal-Bb9ZXbpr.cjs +1 -0
- package/dist/{internal-KOKJDxCG.js → internal-Gt1wn6Z3.js} +152 -127
- package/dist/internal.cjs +1 -1
- package/dist/internal.js +16 -9
- 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-CvN-L5NT.cjs +1 -0
- package/dist/landmarkMask-DHivVjJm.js +225 -0
- package/dist/landmarks-BEjJXcnE.cjs +1 -0
- package/dist/landmarks-DtCAFV_m.js +76 -0
- package/dist/low-level.cjs +1 -1
- package/dist/low-level.js +1494 -629
- package/dist/main.cjs +1 -1
- package/dist/main.js +1306 -475
- package/dist/material/MaterialFill.d.ts +20 -0
- package/dist/material/MeshMaterial.d.ts +14 -0
- package/dist/material/index.d.ts +2 -0
- package/dist/models/Base/index.d.ts +49 -0
- package/dist/models/Body/index.d.ts +30 -1
- package/dist/models/Face/constants.d.ts +8 -0
- package/dist/models/Face/index.d.ts +5 -12
- package/dist/models/Face/rotation.d.ts +18 -0
- package/dist/models/Hand/GestureTracking.d.ts +1 -1
- package/dist/models/Hand/HandTracking.d.ts +19 -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 +6 -3
- 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 +71 -0
- package/dist/particles/system.d.ts +66 -0
- package/dist/particles.cjs +122 -0
- package/dist/particles.js +999 -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-CEZQgz2s.cjs +62 -0
- package/dist/providers-CRuaD8bi.js +424 -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/layerStack.d.ts +29 -0
- package/dist/render/renderGroups.d.ts +47 -0
- package/dist/render/renderPasses.d.ts +26 -0
- package/dist/render/sceneBeforeRender.d.ts +12 -0
- package/dist/renderGroups-BADrepA1.cjs +1 -0
- package/dist/renderGroups-CNB99dZ2.js +152 -0
- package/dist/renderPasses-DgxUKn9b.cjs +158 -0
- package/dist/renderPasses-DuapJA6V.js +1290 -0
- package/dist/renderState-CJNmj5jz.js +39 -0
- package/dist/renderState-apSfg4eR.cjs +1 -0
- package/dist/scene-object/index.d.ts +146 -0
- package/dist/scene-object/runtimeRegistry.d.ts +14 -0
- package/dist/scene-object.cjs +1 -0
- package/dist/scene-object.js +40 -0
- package/dist/screen-image/screenImagePresets.d.ts +13 -0
- package/dist/screen-image/screenImageSettings.d.ts +57 -0
- package/dist/screen-text/screenTextPresets.d.ts +6 -0
- package/dist/screen-text/screenTextSettings.d.ts +147 -0
- package/dist/screen2d/coordinates.d.ts +107 -0
- package/dist/screen2d/index.d.ts +7 -0
- package/dist/screen2d/material-runtime.d.ts +32 -0
- package/dist/screen2d/screenTransform.d.ts +60 -0
- package/dist/screen2d/smoothing.d.ts +5 -0
- package/dist/screen2d/texture.d.ts +10 -0
- package/dist/screen2d/transform.d.ts +25 -0
- package/dist/screen2d/types.d.ts +90 -0
- package/dist/segmentation-BOZJdWFC.js +1911 -0
- package/dist/segmentation-J8GoNBvP.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/selectors-BvJepq6H.js +196 -0
- package/dist/selectors-QB2qsaxy.cjs +1 -0
- package/dist/services/MetricsCollector/index.d.ts +7 -1
- package/dist/services/MetricsCollector/utils.d.ts +1 -1
- package/dist/session-BVX859as.cjs +31 -0
- package/dist/session-Cz8aie4K.js +493 -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 +70 -0
- package/dist/subjects/types.d.ts +59 -0
- package/dist/texture/animatedTexture.d.ts +63 -0
- package/dist/texture/animationMath.d.ts +8 -0
- package/dist/texture/gifReader.d.ts +17 -0
- package/dist/texture/gifTextureSource.d.ts +16 -0
- package/dist/texture/sourceResolver.d.ts +30 -0
- package/dist/textures-BVwo9Z7z.js +38 -0
- package/dist/textures-DAfc61zz.cjs +1 -0
- package/dist/tracking/coordinates.d.ts +5 -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 +1531 -294
- package/dist/trigger-D9L4GPmQ.js +3726 -0
- package/dist/trigger-DZ9vU7jo.cjs +147 -0
- package/dist/types/common.d.ts +11 -1
- package/dist/types/compositor.d.ts +21 -0
- package/dist/types/face.d.ts +21 -14
- package/dist/types/gesture-tracking.d.ts +2 -2
- package/dist/types/hand-tracking.d.ts +19 -2
- package/dist/types/holistic.d.ts +121 -0
- package/dist/types/index.d.ts +1 -1
- package/dist/types/model.d.ts +22 -2
- package/dist/types/nodes.d.ts +83 -6
- package/dist/types/segmentation.d.ts +26 -0
- package/dist/types/session.d.ts +50 -4
- package/dist/types/tracking.d.ts +8 -2
- package/dist/types/util-types.d.ts +1 -1
- package/dist/useBodies-BYzJpQ4L.js +75 -0
- package/dist/useBodies-Cxpmx6Bb.cjs +1 -0
- package/dist/useFaceInfo-BzEUj2OI.js +75 -0
- package/dist/useFaceInfo-DlLRAVNw.cjs +1 -0
- package/dist/useFaceResultReader-Cc4Qrutf.js +61 -0
- package/dist/useFaceResultReader-D3jOQNKz.cjs +1 -0
- package/dist/useInstructionHold-DOu-RpCM.js +53 -0
- package/dist/useInstructionHold-DwJY1Alr.cjs +1 -0
- package/dist/useIrisTracking-Bz4uLDa7.js +6190 -0
- package/dist/useIrisTracking-DRGWgoNy.cjs +35 -0
- package/dist/useLandmarkPoseFit-Bg-h9BPb.cjs +1 -0
- package/dist/useLandmarkPoseFit-Bmb3h6Mw.js +87 -0
- package/dist/useXRCapabilities-B1KLckqw.js +30 -0
- package/dist/useXRCapabilities-CZlPUBjF.cjs +1 -0
- package/dist/utils/canonicalRigidLandmarks.d.ts +8 -0
- package/dist/utils/drawNormalizedCrop.d.ts +22 -0
- package/dist/utils/fns.d.ts +6 -3
- package/dist/utils/headOccluderFit.d.ts +42 -0
- package/dist/utils/integrity.d.ts +25 -26
- package/dist/utils/landmarkBounds.d.ts +1 -1
- package/dist/utils/logger.d.ts +2 -2
- 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/utils/visionWasm.d.ts +18 -0
- package/dist/uv-BMFt19bg.cjs +1 -0
- package/dist/{index-BD-JWMjE.js → uv-DJU_XfmN.js} +15 -180
- package/dist/x-Co8jPhP0.js +127 -0
- package/dist/x-KC8E4Gaj.cjs +41 -0
- package/docs/MIGRATION_GUIDE.md +589 -0
- package/docs/SDK_DOCUMENTATION.md +1157 -0
- package/docs/api/adaptive-quality.mdx +104 -0
- package/docs/api/asset-lifecycle.mdx +78 -0
- package/docs/api/audio.mdx +36 -0
- package/docs/api/behavior-components.mdx +164 -0
- package/docs/api/body-instructions.mdx +287 -0
- package/docs/api/body-rig.mdx +384 -0
- package/docs/api/body-triggers.mdx +235 -0
- package/docs/api/camera-permission.mdx +142 -0
- package/docs/api/capture-recording.mdx +111 -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 +270 -0
- package/docs/api/diagnostics-calibration.mdx +97 -0
- package/docs/api/external-face-mesh.mdx +231 -0
- package/docs/api/face-actions.mdx +108 -0
- package/docs/api/face-attribute-expression.mdx +87 -0
- package/docs/api/face-binding-anchors.mdx +55 -0
- package/docs/api/face-character.mdx +157 -0
- package/docs/api/face-effects.mdx +28 -0
- package/docs/api/face-expression-controller.mdx +153 -0
- package/docs/api/face-info.mdx +118 -0
- 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 +130 -0
- package/docs/api/face-morph.mdx +117 -0
- package/docs/api/face-painting.mdx +40 -0
- package/docs/api/face-reprojection.mdx +154 -0
- package/docs/api/face-retouching.mdx +81 -0
- 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 +210 -0
- package/docs/api/hair.mdx +97 -0
- package/docs/api/hand-instructions.mdx +222 -0
- package/docs/api/hand-rig.mdx +661 -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/material-render-state.mdx +132 -0
- package/docs/api/multi-subject.mdx +185 -0
- package/docs/api/particles.mdx +183 -0
- package/docs/api/person-cutout.mdx +171 -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/runtime-3d.mdx +316 -0
- package/docs/api/scene-object-store.mdx +213 -0
- package/docs/api/screen-image.mdx +67 -0
- package/docs/api/screen-shape.mdx +64 -0
- package/docs/api/screen-space-coordinates.mdx +75 -0
- package/docs/api/screen-text.mdx +39 -0
- package/docs/api/segmentation-overlay.mdx +301 -0
- package/docs/api/session-lifecycle.mdx +136 -0
- package/docs/api/texture-sources.mdx +74 -0
- package/docs/api/trackers.mdx +65 -0
- package/docs/api/tracking-config.mdx +108 -0
- package/docs/docs.json +121 -0
- package/docs/examples/lip-shaders.mdx +273 -0
- package/docs/examples/scene-object-recipes.mdx +194 -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 +139 -0
- 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/inspector/hierarchy-panel.mdx +51 -0
- package/docs/inspector/object-inspector-panel.mdx +51 -0
- package/docs/introduction.mdx +120 -0
- package/docs/scene-objects/overview.mdx +127 -0
- package/docs/scene-objects/render-groups.mdx +77 -0
- package/docs/scene-objects/runtime-rendering.mdx +75 -0
- package/docs/texture-api-consumer.md +84 -0
- package/package.json +86 -8
- package/settings.json +1998 -0
- package/dist/DebuggerUI-CEfdddkZ.cjs +0 -1
- package/dist/DebuggerUI-Dgop6Q6o.js +0 -269
- package/dist/components/FaceRetouch/retouchRegions.d.ts +0 -23
- package/dist/components/FaceRetouch/useFaceRetouchRegions.d.ts +0 -12
- package/dist/index-B5J4gzn2.cjs +0 -1
- package/dist/index-BVBVg96G.cjs +0 -1
- package/dist/index-CYMj26Ej.js +0 -1331
- package/dist/index-DtwHElmG.js +0 -157
- package/dist/index-PtFmD6B8.cjs +0 -1
- package/dist/internal-DH5d1Xnq.cjs +0 -1
- package/dist/modules/XRClient/index.d.ts +0 -9
- package/dist/modules/index.d.ts +0 -1
- package/dist/selectors-BHO6TnoC.js +0 -59
- package/dist/selectors-Bub0o3qy.cjs +0 -1
- package/dist/services/ApiService.d.ts +0 -12
- package/dist/types/client.d.ts +0 -3
- package/dist/useFaceResults-cpsSmKKc.js +0 -81
- package/dist/useFaceResults-hVUJYSEY.cjs +0 -1
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The define that makes `LIP_EFFECT_VERTEX_SHADER` read the skin probe's
|
|
3
|
+
* stats (`uSkinStats`, `uSkinStatsPacked`: spread `skin.uniforms`). The
|
|
4
|
+
* built-in material sets it; without it the probe varyings read "not
|
|
5
|
+
* ready" and the shader binds no probe texture.
|
|
6
|
+
*/
|
|
7
|
+
export declare const LIP_EFFECT_SKIN_STATS_DEFINE = "LIP_EFFECT_SKIN_STATS";
|
|
8
|
+
/**
|
|
9
|
+
* The lip vertex shader, for a `FaceAtlasLayer` geometry (the face-atlas
|
|
10
|
+
* surface's attributes). It writes every varying of the makeup core
|
|
11
|
+
* (`MAKEUP_VARYINGS_GLSL`: the camera at the un-warped point, the atlas uv,
|
|
12
|
+
* rest point and normals, `lipEdge`, and, with `LIP_EFFECT_SKIN_STATS`
|
|
13
|
+
* defined, the skin probe's stats) and, for custom lip shaders written
|
|
14
|
+
* against alpha.8, the old varyings:
|
|
15
|
+
*
|
|
16
|
+
* - `vUv`: the face-atlas uv (`FACE_ATLAS_UVS`, the design texture's layout);
|
|
17
|
+
* - `vFaceUv`: the camera-image uv (the `faceUv` attribute; `LipEffect` keeps
|
|
18
|
+
* it current for custom materials);
|
|
19
|
+
* - `vLipEdge`: 0 on the outer lip ring, 1 at the mouth line;
|
|
20
|
+
* - `vNormal`: the live normal in view space; `vViewDir`: surface → eye, view space.
|
|
21
|
+
*
|
|
22
|
+
* `gl_Position` is computed exactly as the face's depth pre-pass does.
|
|
23
|
+
*/
|
|
24
|
+
export declare const LIP_EFFECT_VERTEX_SHADER: string;
|
|
25
|
+
/**
|
|
26
|
+
* The lip-specific fragment code, after the makeup core chunks: the design
|
|
27
|
+
* (flipped on mirrored feeds, sRGB-decoded when the GPU does not), the
|
|
28
|
+
* per-lip shade, gradient and inner-lip tint, the feathered mask with each
|
|
29
|
+
* lip's linear opacity, `shading`, the finish (`makeupFinish`) and the
|
|
30
|
+
* alpha.8 extra highlight (`gloss`, `roughness`, `highlightColor`).
|
|
31
|
+
* Mirrors `lipShading.ts`.
|
|
32
|
+
*/
|
|
33
|
+
export declare const LIP_EFFECT_GLSL: string;
|
|
34
|
+
/**
|
|
35
|
+
* The built-in lip fragment shader: the makeup core (`common` → `shading`
|
|
36
|
+
* → `sparkle` → `finish`) plus the lip code. Premultiplied output; draw it
|
|
37
|
+
* with `MAKEUP_BLENDING`.
|
|
38
|
+
*/
|
|
39
|
+
export declare const LIP_EFFECT_FRAGMENT_SHADER: string;
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { ReactNode } from 'react';
|
|
2
|
+
import { FaceAtlasUniforms } from '../../face-atlas/registry';
|
|
3
|
+
import { FaceSkinReference, FaceSkinUniforms } from '../FaceAtlas/useFaceSkin';
|
|
4
|
+
import { LipEffectSettings } from './settings';
|
|
5
|
+
import { LipUvBounds } from './uvGuide';
|
|
6
|
+
import type * as THREE from "three";
|
|
7
|
+
export type LipMaskMode = "outer-lips" | "outer-and-inner-lips";
|
|
8
|
+
/**
|
|
9
|
+
* Inputs handed to a custom lip material factory: everything alpha.8 gave,
|
|
10
|
+
* plus the face-atlas surface's rest positions, the face's skin probe, the
|
|
11
|
+
* side sign and the layer's uniforms. The default `LipEffectMaterial` is
|
|
12
|
+
* built from the same inputs.
|
|
13
|
+
*/
|
|
14
|
+
export type LipEffectMaterialContext = {
|
|
15
|
+
/** Live camera frame; sample it with `faceUv` to read the skin under the lips. */
|
|
16
|
+
cameraTexture: THREE.Texture | null;
|
|
17
|
+
/** The creator's design texture in the face atlas (`FACE_ATLAS_UVS`), or `null` when none was given. */
|
|
18
|
+
designTexture: THREE.Texture | null;
|
|
19
|
+
/**
|
|
20
|
+
* Live per-vertex camera-texture UVs. The same attribute is bound to the lip
|
|
21
|
+
* geometry as `attribute vec2 faceUv` (kept current while a custom material
|
|
22
|
+
* is in use), so a custom vertex shader can read it directly; the object is
|
|
23
|
+
* exposed for uniforms, debugging, or readback.
|
|
24
|
+
*/
|
|
25
|
+
faceUv: THREE.BufferAttribute;
|
|
26
|
+
/** Static per-vertex lip band position, bound as `attribute float lipEdge` (0 outer ring, 1 mouth line). */
|
|
27
|
+
lipEdge: THREE.BufferAttribute;
|
|
28
|
+
/** Rest position of each vertex in canonical cm (+X is canonical, not a side), `attribute vec3 restPosition`. */
|
|
29
|
+
restPosition: THREE.BufferAttribute;
|
|
30
|
+
/** Design texture for the lower lip when `splitLips` is on, or `null`. */
|
|
31
|
+
lowerDesignTexture: THREE.Texture | null;
|
|
32
|
+
faceIndex: number;
|
|
33
|
+
/** The active mask mode, so a custom material can decide whether to honour the mouth stencil. */
|
|
34
|
+
maskMode: LipMaskMode;
|
|
35
|
+
/** Lip region of the face atlas, for texture transforms and gradients. */
|
|
36
|
+
lipUvBounds: LipUvBounds;
|
|
37
|
+
/** The resolved settings driving the built-in material. */
|
|
38
|
+
settings: LipEffectSettings;
|
|
39
|
+
/**
|
|
40
|
+
* `personLeftSign(mirrored)`: +1 on an unmirrored feed, −1 on the mirrored
|
|
41
|
+
* webcam. Designs are painted as on an unmirrored photo; sample them at
|
|
42
|
+
* `(1 − u, v)` when it is −1 so they keep the person's sides.
|
|
43
|
+
*/
|
|
44
|
+
personLeftSign: 1 | -1;
|
|
45
|
+
/**
|
|
46
|
+
* The face's skin probe (`useFaceSkin`): spread `skin.uniforms` into a
|
|
47
|
+
* material whose vertex shader is `LIP_EFFECT_VERTEX_SHADER` (it reads
|
|
48
|
+
* `uSkinStats`), or read the person's skin, light and lip colour yourself.
|
|
49
|
+
*/
|
|
50
|
+
skin: FaceSkinReference;
|
|
51
|
+
/**
|
|
52
|
+
* The layer's uniforms with the face's live skin probe: `uCameraMap`,
|
|
53
|
+
* `uPresence` (fade in / out with the face), `uPersonLeftSign`, and
|
|
54
|
+
* `skin.uniforms` (`uSkinStats`, `uSkinStatsPacked`, `uSkinMap`, `uSkinLod`,
|
|
55
|
+
* `uSkinSqrt`). Spread it whole into a material's `uniforms`; the `{ value }`
|
|
56
|
+
* objects are the ones the SDK updates every frame.
|
|
57
|
+
*/
|
|
58
|
+
uniforms: FaceAtlasUniforms & FaceSkinUniforms;
|
|
59
|
+
};
|
|
60
|
+
/** A material node, or a three.js material instance (which can be shared across meshes and faces). */
|
|
61
|
+
export type LipEffectMaterialResult = ReactNode | THREE.Material;
|
|
62
|
+
export type LipEffectMaterialSpec = LipEffectMaterialResult | ((context: LipEffectMaterialContext) => LipEffectMaterialResult);
|
|
63
|
+
export type LipEffectProps = Partial<LipEffectSettings> & {
|
|
64
|
+
/**
|
|
65
|
+
* Which tracked face. Default: the face of the `FaceRig` / `FaceWarp3D` /
|
|
66
|
+
* `FaceMorph` it is nested in (it rides that face), else the enclosing
|
|
67
|
+
* `FaceTracker`'s `faceIndex`, else 0.
|
|
68
|
+
*/
|
|
69
|
+
faceIndex?: number;
|
|
70
|
+
/**
|
|
71
|
+
* Faces to ask the face model for when the lips start it themselves (no
|
|
72
|
+
* `FaceTracker` above): at least `faceIndex + 1`. Pass the same count to
|
|
73
|
+
* every face component; the first to start the model sets it. A
|
|
74
|
+
* `FaceTracker` mounted beside the lips in the same commit starts it first
|
|
75
|
+
* (its `numFaces` and `targetFps` win); one that mounts later, in another
|
|
76
|
+
* commit (a later `Suspense`), does not: give the lips its `numFaces`.
|
|
77
|
+
*/
|
|
78
|
+
numFaces?: number;
|
|
79
|
+
/** Whether the feed is mirrored, for the design's sides. Default: the session's (`useXRMirrored`). */
|
|
80
|
+
mirrored?: boolean;
|
|
81
|
+
/**
|
|
82
|
+
* Design texture in the face atlas, painted as on an unmirrored photo
|
|
83
|
+
* (image-left = the person's right). Without one the lips are filled with `color`.
|
|
84
|
+
*/
|
|
85
|
+
designTexture?: THREE.Texture | string;
|
|
86
|
+
/** Lower-lip design texture, used when `splitLips` is on. Falls back to `designTexture`. */
|
|
87
|
+
lowerDesignTexture?: THREE.Texture | string;
|
|
88
|
+
material?: LipEffectMaterialSpec;
|
|
89
|
+
/**
|
|
90
|
+
* Use this material instead of the built-in one (and instead of `material`),
|
|
91
|
+
* for example one from `useLipEffectMaterial` shared by several faces.
|
|
92
|
+
*/
|
|
93
|
+
sharedMaterial?: THREE.Material;
|
|
94
|
+
/**
|
|
95
|
+
* Keep the `faceUv` attribute (camera-image uv per vertex) current for a
|
|
96
|
+
* custom material: one projection of the face's landmarks per frame.
|
|
97
|
+
* Default: on for a custom `material` or `sharedMaterial`, off for the
|
|
98
|
+
* built-in one (a `LipEffectMaterial` node, a `createLipEffectMaterial` /
|
|
99
|
+
* `useLipEffectMaterial` instance). A factory function cannot be inspected
|
|
100
|
+
* in advance: pass `faceUv={false}` when it returns the built-in material.
|
|
101
|
+
*/
|
|
102
|
+
faceUv?: boolean;
|
|
103
|
+
/**
|
|
104
|
+
* @deprecated Ignored. The lips ride the face's shared surface, which
|
|
105
|
+
* follows every landmark update (and leads between them by quality tier).
|
|
106
|
+
*/
|
|
107
|
+
maxUpdateFps?: number;
|
|
108
|
+
/**
|
|
109
|
+
* Keep the face on its last landmarks for this long (ms) across tracker
|
|
110
|
+
* dropouts, then fade it out. Default 250. The hold is the face's shared
|
|
111
|
+
* surface's (as `FaceAtlasLayer`'s `holdMs`): every layer on the face
|
|
112
|
+
* shares it, and the largest `holdMs` any of them asks for wins. Nested in
|
|
113
|
+
* a `FaceRig` / `FaceWarp3D` / `FaceMorph`, the rig's own `holdMs` applies.
|
|
114
|
+
*/
|
|
115
|
+
holdMs?: number;
|
|
116
|
+
/**
|
|
117
|
+
* @deprecated Ignored. The face's shared surface leads the landmarks by the
|
|
118
|
+
* quality tier's interval (`FaceAtlasLayer` `leadMs`) and holds them still
|
|
119
|
+
* through dropouts.
|
|
120
|
+
*/
|
|
121
|
+
predictMs?: number;
|
|
122
|
+
/** Draw order of the lips. Default `MAKEUP_RENDER_ORDER.lips` (-1.64). */
|
|
123
|
+
renderOrder?: number;
|
|
124
|
+
};
|
|
125
|
+
/** Per-face configuration for `LipEffects`: everything but the face index. */
|
|
126
|
+
export type LipEffectFaceConfig = Omit<LipEffectProps, "faceIndex">;
|
|
127
|
+
export type LipEffectsProps = {
|
|
128
|
+
/** How many face slots to render. Match the tracker's `numFaces`. Default 2. */
|
|
129
|
+
maxFaces?: number;
|
|
130
|
+
/** One config for all faces, or a picker per face (`null` skips a face). */
|
|
131
|
+
faces: LipEffectFaceConfig | ((faceIndex: number) => LipEffectFaceConfig | null);
|
|
132
|
+
/** Share one built-in material across faces. Default: on for a single config, off for a picker. */
|
|
133
|
+
shareMaterial?: boolean;
|
|
134
|
+
/** @deprecated Ignored (see `LipEffectProps.maxUpdateFps`). */
|
|
135
|
+
maxUpdateFps?: number;
|
|
136
|
+
/** The faces' hold through dropouts (see `LipEffectProps.holdMs`: the largest on a face wins). */
|
|
137
|
+
holdMs?: number;
|
|
138
|
+
/** @deprecated Ignored (see `LipEffectProps.predictMs`). */
|
|
139
|
+
predictMs?: number;
|
|
140
|
+
renderOrder?: number;
|
|
141
|
+
};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import * as THREE from "three";
|
|
2
|
+
export type LipDesignTextureSource = THREE.Texture | string | undefined;
|
|
3
|
+
/**
|
|
4
|
+
* Resolve the design texture props (URL or texture object) to textures.
|
|
5
|
+
* URLs load through R3F's loader cache, so faces sharing a URL share one
|
|
6
|
+
* texture; a constant hook count keeps the pair reloadable.
|
|
7
|
+
*
|
|
8
|
+
* The textures are returned as they are: a cached texture is shared with
|
|
9
|
+
* every other user of its URL, so its `colorSpace` is never changed here.
|
|
10
|
+
* The lip material decodes sRGB itself for a texture without a colour space
|
|
11
|
+
* (as `TextureLoader` loads it) and lets the GPU decode one tagged
|
|
12
|
+
* `SRGBColorSpace`.
|
|
13
|
+
*/
|
|
14
|
+
export declare const useLipDesignTextures: (designTexture: LipDesignTextureSource, lowerDesignTexture: LipDesignTextureSource) => {
|
|
15
|
+
designTexture: THREE.Texture | null;
|
|
16
|
+
lowerDesignTexture: THREE.Texture | null;
|
|
17
|
+
};
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { ParsedCanonicalMesh } from '../FaceMesh/canonical/parseCanonicalFaceModel';
|
|
2
|
+
/** Lip extent in the face atlas (`v` grows upward, as in the OBJ). */
|
|
3
|
+
export type LipUvBounds = {
|
|
4
|
+
minU: number;
|
|
5
|
+
maxU: number;
|
|
6
|
+
minV: number;
|
|
7
|
+
maxV: number;
|
|
8
|
+
/** `v` of the mouth line (mean of the inner ring); above it is the upper lip. */
|
|
9
|
+
mouthV: number;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Lip region of the face atlas, rounded. `getLipUvBounds()` gives the exact
|
|
13
|
+
* values from the bundled atlas data.
|
|
14
|
+
*/
|
|
15
|
+
export declare const CANONICAL_LIP_UV_BOUNDS: LipUvBounds;
|
|
16
|
+
export type LipUvGuideOptions = {
|
|
17
|
+
/** Pixel size of the square texture canvas the guide represents. Default 1024. */
|
|
18
|
+
size?: number;
|
|
19
|
+
/** Frame the whole canvas (the design contract) or zoom onto the lip region. Default "canvas". */
|
|
20
|
+
region?: "canvas" | "lips";
|
|
21
|
+
/** Draw the lip triangle wireframe. Default true. */
|
|
22
|
+
wireframe?: boolean;
|
|
23
|
+
/** Draw orientation and region labels. Default true. */
|
|
24
|
+
labels?: boolean;
|
|
25
|
+
/** Fill the canvas with a colour. Omit for a transparent background. */
|
|
26
|
+
background?: string;
|
|
27
|
+
};
|
|
28
|
+
/** The guide's colours: the face atlas guide's `lips` and `mouth` colours, and its wireframe and text. */
|
|
29
|
+
export declare const LIP_UV_GUIDE_COLORS: {
|
|
30
|
+
outerRing: string;
|
|
31
|
+
innerRing: string;
|
|
32
|
+
wireframe: string;
|
|
33
|
+
text: string;
|
|
34
|
+
frame: string;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* Convert a face-atlas UV to texture pixel space. `TextureLoader` textures are
|
|
38
|
+
* `flipY`, so `v = 1` is the top row of the image (`faceAtlasUvToPixel`).
|
|
39
|
+
*/
|
|
40
|
+
export declare const lipUvToPixel: (u: number, v: number, size: number) => {
|
|
41
|
+
x: number;
|
|
42
|
+
y: number;
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* Bounding box of the outer lip ring in the face atlas, plus the mouth line.
|
|
46
|
+
* Without an argument it reads the bundled atlas (`FACE_ATLAS_UVS`), which
|
|
47
|
+
* is what `LipEffect` samples; with a parsed canonical mesh it reads that
|
|
48
|
+
* mesh's `uv` attribute (the same layout).
|
|
49
|
+
*/
|
|
50
|
+
export declare const getLipUvBounds: (mesh?: ParsedCanonicalMesh) => LipUvBounds;
|
|
51
|
+
/**
|
|
52
|
+
* Render the creator-facing lip template as an SVG string. It is the face
|
|
53
|
+
* atlas guide (`createFaceAtlasGuideSvg`) for the `lips` and `mouth` regions,
|
|
54
|
+
* drawn from the bundled atlas data `LipEffect` samples, plus the lip
|
|
55
|
+
* triangle wireframe and lip labels: which side of the image is which side
|
|
56
|
+
* of the person (image-left = the person's right, on every feed), the upper
|
|
57
|
+
* and lower lip, and the lip region's extent. `region: "lips"` zooms onto
|
|
58
|
+
* the lips.
|
|
59
|
+
*
|
|
60
|
+
* `createLipUvGuideSvg(mesh, options)` (alpha.8) still works; the mesh is
|
|
61
|
+
* no longer read, since its UVs are the atlas.
|
|
62
|
+
*/
|
|
63
|
+
export declare const createLipUvGuideSvg: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => string;
|
|
64
|
+
/**
|
|
65
|
+
* The guide as an `image/svg+xml` data URL, loadable with `THREE.TextureLoader`
|
|
66
|
+
* or an `<img>`. Takes `(options)` or alpha.8's `(mesh, options)`.
|
|
67
|
+
*/
|
|
68
|
+
export declare const createLipUvGuideDataUrl: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => string;
|
|
69
|
+
/**
|
|
70
|
+
* Rasterize the guide to a PNG `Blob` in the browser (an `<img>` and a 2D
|
|
71
|
+
* canvas), for download or for use as a texture. Transparent unless
|
|
72
|
+
* `options.background` is set. Takes `(options)` or alpha.8's `(mesh, options)`.
|
|
73
|
+
*/
|
|
74
|
+
export declare const createLipUvGuidePngBlob: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => Promise<Blob>;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { Object3D } from 'three';
|
|
2
|
+
export type LookAtSettings = {
|
|
3
|
+
enabled: boolean;
|
|
4
|
+
targetObjectId: string | null;
|
|
5
|
+
mode: "point" | "direction";
|
|
6
|
+
inheritChildren: boolean;
|
|
7
|
+
offsetRotation: {
|
|
8
|
+
x: number;
|
|
9
|
+
y: number;
|
|
10
|
+
z: number;
|
|
11
|
+
};
|
|
12
|
+
};
|
|
13
|
+
export type LookAtProps = {
|
|
14
|
+
target: Object3D | null;
|
|
15
|
+
settings: LookAtSettings;
|
|
16
|
+
children: React.ReactNode;
|
|
17
|
+
};
|
|
18
|
+
export declare const applyLookAt: ({ source, target, settings, }: {
|
|
19
|
+
source: Object3D;
|
|
20
|
+
target: Object3D | null;
|
|
21
|
+
settings: LookAtSettings;
|
|
22
|
+
}) => boolean;
|
|
23
|
+
export declare const LookAt: ({ target, settings, children }: LookAtProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { BlushSettings } from './types';
|
|
3
|
+
/** `<Blush>` props: any `BlushSettings` (resolved like `resolveMakeupSettings("blush", …)`) plus the region props. */
|
|
4
|
+
export type BlushProps = Partial<BlushSettings> & MakeupRegionProps<"blush">;
|
|
5
|
+
/**
|
|
6
|
+
* Blush on the cheeks of the live face: soft, Gaussian-like shapes placed
|
|
7
|
+
* by `shape` (`apples`, `lifted`, `draped`, `sunKissed`), `size` and `lift`
|
|
8
|
+
* (toward the temple), shaded relative to the person's own skin and light.
|
|
9
|
+
* Works alone (no `FaceTracker` or Suspense needed), inside a `FaceTracker`
|
|
10
|
+
* (that face), or nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph` (it
|
|
11
|
+
* rides that face). `enabled={false}` draws and costs nothing.
|
|
12
|
+
*
|
|
13
|
+
* ```tsx
|
|
14
|
+
* <Blush shade="rose" />
|
|
15
|
+
* <Blush {...MAKEUP_LOOKS.glam.blush} shade="coral" />
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
export declare const Blush: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: BlushProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { BrowsSettings } from './types';
|
|
3
|
+
/** `<Brows>` props: any `BrowsSettings` (resolved like `resolveMakeupSettings("brows", …)`) plus the region props. */
|
|
4
|
+
export type BrowsProps = Partial<BrowsSettings> & MakeupRegionProps<"brows">;
|
|
5
|
+
/**
|
|
6
|
+
* Brows on the live face, built on the person's own brow: `shape`
|
|
7
|
+
* (`natural`, `softArch`, `straight`, `highArch`, `bold`, `thin`) reshapes
|
|
8
|
+
* its centre line, `boldness` its width (0.5 = their own), `fill` mixes a
|
|
9
|
+
* tint of only the real hairs (0) toward a full powder shape (1), and
|
|
10
|
+
* `strokes` adds procedural hair strokes. Shaded relative to the person's
|
|
11
|
+
* own skin and light; `shade: "auto"` is their own brow-hair colour.
|
|
12
|
+
* Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
|
|
13
|
+
* `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
|
|
14
|
+
*
|
|
15
|
+
* ```tsx
|
|
16
|
+
* <Brows shape="softArch" shade="softBrown" />
|
|
17
|
+
* <Brows shade="auto" fill={0} />
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
export declare const Brows: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: BrowsProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { ContourSettings } from './types';
|
|
3
|
+
/** `<Contour>` props: any `ContourSettings` (resolved like `resolveMakeupSettings("contour", …)`) plus the region props. */
|
|
4
|
+
export type ContourProps = Partial<ContourSettings> & MakeupRegionProps<"contour">;
|
|
5
|
+
/**
|
|
6
|
+
* Contour on the live face: soft tapered lines in the cheek hollows, along
|
|
7
|
+
* the jaw, at the temples and down the sides of the nose, placed by `shape`
|
|
8
|
+
* (`soft`, `sculpted`, `bronzed`, `nose`) and `size`, shaded relative to the
|
|
9
|
+
* person's own skin and light (`shade: "auto"` darkens their own skin).
|
|
10
|
+
* Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
|
|
11
|
+
* `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
|
|
12
|
+
*
|
|
13
|
+
* ```tsx
|
|
14
|
+
* <Contour shape="sculpted" shade="tan" />
|
|
15
|
+
* ```
|
|
16
|
+
*/
|
|
17
|
+
export declare const Contour: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: ContourProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { EyelinerSettings } from './types';
|
|
3
|
+
/** `<Eyeliner>` props: any `EyelinerSettings` (resolved like `resolveMakeupSettings("eyeliner", …)`) plus the region props. */
|
|
4
|
+
export type EyelinerProps = Partial<EyelinerSettings> & MakeupRegionProps<"eyeliner">;
|
|
5
|
+
/**
|
|
6
|
+
* Eyeliner on the live face: a line along the upper lashes (`thickness` mm
|
|
7
|
+
* at its outer part, tapering toward the inner corner), an optional `lower`
|
|
8
|
+
* line (it fades while blinking), a `wing` (mm) swept `wingAngle` degrees
|
|
9
|
+
* upward in the person's frame past the outer corner, and `smudge`, placed
|
|
10
|
+
* by `shape` (`tightline`, `classic`, `winged`, `catEye`, `smudged`, `kohl`)
|
|
11
|
+
* and shaded relative to the person's own skin and light. Never paints the
|
|
12
|
+
* eyeball. Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
|
|
13
|
+
* `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
|
|
14
|
+
*
|
|
15
|
+
* ```tsx
|
|
16
|
+
* <Eyeliner shape="winged" />
|
|
17
|
+
* <Eyeliner shape="catEye" wingAngle={30} side="left" />
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
export declare const Eyeliner: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: EyelinerProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { EyeshadowSettings } from './types';
|
|
3
|
+
/** `<Eyeshadow>` props: any `EyeshadowSettings` (resolved like `resolveMakeupSettings("eyeshadow", …)`) plus the region props. */
|
|
4
|
+
export type EyeshadowProps = Partial<EyeshadowSettings> & MakeupRegionProps<"eyeshadow">;
|
|
5
|
+
/**
|
|
6
|
+
* Eyeshadow on the live face's lids: the shade from the lash line up to
|
|
7
|
+
* `height` of the way to the brow, a `crease` band in `creaseShade` at its
|
|
8
|
+
* top edge, shadow along the `lower` lash line (it fades while blinking) and
|
|
9
|
+
* an `inner`-corner highlight in `innerShade`, placed by `shape` (`lid`,
|
|
10
|
+
* `crease`, `smoky`, `cutCrease`, `halo`, `winged`) and shaded relative to
|
|
11
|
+
* the person's own skin and light. Never paints the eyeball. Works alone,
|
|
12
|
+
* inside a `FaceTracker`, or nested in a `FaceRig` / `FaceWarp3D` /
|
|
13
|
+
* `FaceMorph`. `enabled={false}` draws and costs nothing.
|
|
14
|
+
*
|
|
15
|
+
* ```tsx
|
|
16
|
+
* <Eyeshadow shape="crease" shade="warmBrown" creaseShade="espresso" />
|
|
17
|
+
* <Eyeshadow {...MAKEUP_LOOKS.smokyEye.eyeshadow} />
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
export declare const Eyeshadow: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: EyeshadowProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
2
|
+
import { HighlighterSettings } from './types';
|
|
3
|
+
/** `<Highlighter>` props: any `HighlighterSettings` (resolved like `resolveMakeupSettings("highlighter", …)`) plus the region props. */
|
|
4
|
+
export type HighlighterProps = Partial<HighlighterSettings> & MakeupRegionProps<"highlighter">;
|
|
5
|
+
/**
|
|
6
|
+
* Highlighter on the high points of the live face: soft blobs on the
|
|
7
|
+
* cheekbones, brow bone, nose bridge, cupid's bow and chin, placed by
|
|
8
|
+
* `shape` (`cheekbones`, `strobe`, `glow`, `nose`) and `size`. Defaults to a
|
|
9
|
+
* `shimmer` finish in `champagne`. Its own region, so a look can switch
|
|
10
|
+
* contour off and keep the glow. Works alone, inside a `FaceTracker`, or
|
|
11
|
+
* nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph`. `enabled={false}`
|
|
12
|
+
* draws and costs nothing.
|
|
13
|
+
*
|
|
14
|
+
* ```tsx
|
|
15
|
+
* <Highlighter shape="strobe" finish="metallic" shade="gold" />
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
export declare const Highlighter: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: HighlighterProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { MakeupDesignSettings } from './design';
|
|
2
|
+
import { MakeupRegionProps } from './MakeupRegion';
|
|
3
|
+
import * as THREE from "three";
|
|
4
|
+
/** Art for `MakeupDesign`: a URL, a texture you own, or nothing. */
|
|
5
|
+
export type MakeupDesignTexture = string | THREE.Texture | null;
|
|
6
|
+
/** `<MakeupDesign>` props: any `MakeupDesignSettings`, the art and the region props. */
|
|
7
|
+
export type MakeupDesignProps = Partial<MakeupDesignSettings> & MakeupRegionProps<"design"> & {
|
|
8
|
+
/**
|
|
9
|
+
* The art, painted in the face atlas as on an unmirrored photo
|
|
10
|
+
* (image-left = the person's right; template `docs/guides/face-atlas-template.svg`):
|
|
11
|
+
* a URL (PNG, WebP or SVG with a size; loaded without Suspense, owned
|
|
12
|
+
* and disposed here) or a `THREE.Texture` you own (never changed;
|
|
13
|
+
* read as sRGB unless tagged `LinearSRGBColorSpace`). `null` / `""`
|
|
14
|
+
* draws nothing. With `sharedMaterial` the material's own art is used.
|
|
15
|
+
*/
|
|
16
|
+
texture?: MakeupDesignTexture;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Creator art painted on the live face, in the face atlas (FACE-1):
|
|
20
|
+
* freckles, face gems, graphic liner, face paint. The art is shaded like
|
|
21
|
+
* makeup (relative to the person's own skin and light, with a `finish`),
|
|
22
|
+
* its alpha is the mask and its colours are the paint (`color` tints them).
|
|
23
|
+
* Each side of the art stays on the person's own side on every feed: on the
|
|
24
|
+
* mirrored webcam the art is sampled at `(1 − u, v)`.
|
|
25
|
+
*
|
|
26
|
+
* Works alone (no `FaceTracker` or Suspense), inside a `FaceTracker` (that
|
|
27
|
+
* face), or nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph` (it rides that
|
|
28
|
+
* face). Draws at `MAKEUP_RENDER_ORDER.design` (-1.68): over the eye
|
|
29
|
+
* regions, under the lips. Nothing draws until the art has loaded (a custom
|
|
30
|
+
* `material` draws at once: a procedural design needs no art).
|
|
31
|
+
*
|
|
32
|
+
* ```tsx
|
|
33
|
+
* <MakeupDesign texture="/makeup/freckles.svg" region={["nose", "cheeks"]} coverage={0.4} opacity={0.7} />
|
|
34
|
+
* <MakeupDesign texture="/makeup/face-gems.svg" finish="gloss" />
|
|
35
|
+
* ```
|
|
36
|
+
*/
|
|
37
|
+
export declare const MakeupDesign: ({ texture, faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: MakeupDesignProps) => import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import { FaceAtlasMaterialContext, FaceAtlasMaterialResult } from '../FaceAtlas/FaceAtlasLayer';
|
|
2
|
+
import { FaceSkinReference } from '../FaceAtlas/useFaceSkin';
|
|
3
|
+
import { MakeupMaterialRegion, MakeupMaterialSettings, MakeupUniforms } from './material';
|
|
4
|
+
import type * as THREE from "three";
|
|
5
|
+
/**
|
|
6
|
+
* The makeup region core (FACE-1): what `Blush`, `Contour`, `Highlighter`,
|
|
7
|
+
* `Eyeshadow`, `Eyeliner`, `Brows` and `MakeupDesign` are built on. One region on one face is
|
|
8
|
+
* one `FaceAtlasLayer` mesh over the region's atlas triangles, drawn at the
|
|
9
|
+
* region's `MAKEUP_RENDER_ORDER`, shaded with `MAKEUP_GLSL` against the
|
|
10
|
+
* face's skin probe (`useFaceSkin`). It
|
|
11
|
+
*
|
|
12
|
+
* - draws nothing and holds nothing while `enabled` is false (no surface, no
|
|
13
|
+
* probe, no material);
|
|
14
|
+
* - writes the resolved settings into ONE uniforms object per region
|
|
15
|
+
* instance, which the built-in material and a custom material share
|
|
16
|
+
* (`ctx.uniforms`), so edits never recompile; inputs that are not
|
|
17
|
+
* settings (a design texture) come in as `uniforms` and join it;
|
|
18
|
+
* - binds the face's shared uniforms into it: the layer's camera feed,
|
|
19
|
+
* presence and `uPersonLeftSign` (#298 sides), and the skin probe's maps
|
|
20
|
+
* and stats;
|
|
21
|
+
* - routes the material: `sharedMaterial` as given, else `material` (a
|
|
22
|
+
* node, an instance, or a factory of `MakeupMaterialContext`, run once
|
|
23
|
+
* per factory), else the built-in `createMakeupMaterial(region)`, owned
|
|
24
|
+
* here and disposed once its warm-up compile has settled; a material
|
|
25
|
+
* from `createMakeupMaterial`, through either prop, keeps its own
|
|
26
|
+
* settings and is drawn through a per-face copy
|
|
27
|
+
* (`createMakeupFaceCopy`) that holds this face's bindings, so the
|
|
28
|
+
* source is never changed and can serve several faces;
|
|
29
|
+
* - warms the built-in program up with `renderer.compileAsync` and shows
|
|
30
|
+
* the region once it is ready (blush, contour and highlighter share one
|
|
31
|
+
* program, so only the first one waits).
|
|
32
|
+
*
|
|
33
|
+
* A region plugs in through its `MAKEUP_REGION_PROGRAMS` entry
|
|
34
|
+
* (`MakeupRegionProgram`): fragment shader, own uniforms, `resolve` /
|
|
35
|
+
* `patch` of its settings, settings → uniforms, triangles, auto shade,
|
|
36
|
+
* order and an optional per-frame hook.
|
|
37
|
+
*/
|
|
38
|
+
/**
|
|
39
|
+
* What a custom makeup material factory receives (`material={(ctx) => …}`).
|
|
40
|
+
* The factory runs once per region instance (again only for a new factory
|
|
41
|
+
* or region): not on edits, a new camera, a mirroring change, a new
|
|
42
|
+
* triangle set or the skin probe becoming ready. Read live values from
|
|
43
|
+
* `uniforms` and `skin`; the other fields are those of when it ran.
|
|
44
|
+
*/
|
|
45
|
+
export type MakeupMaterialContext<R extends MakeupMaterialRegion = MakeupMaterialRegion> = Omit<FaceAtlasMaterialContext, "uniforms"> & {
|
|
46
|
+
/**
|
|
47
|
+
* Every uniform `MAKEUP_GLSL` reads, kept current from the settings
|
|
48
|
+
* (`uColor`, `uOpacity`, `uCoverage`, `uFinish`, `uShine`, the sparkle
|
|
49
|
+
* fields, `uSide`, the shape uniforms…) and bound to the face (`uCameraMap`,
|
|
50
|
+
* `uPresence`, `uPersonLeftSign`, the skin probe's `uSkin*`). Pass it as
|
|
51
|
+
* `uniforms={ctx.uniforms}` (or spread it and add your own): the objects
|
|
52
|
+
* are stable, so the material never needs rebuilding on an edit.
|
|
53
|
+
*/
|
|
54
|
+
uniforms: MakeupUniforms;
|
|
55
|
+
/** The region. */
|
|
56
|
+
region: R;
|
|
57
|
+
/** The resolved settings when the material was made (`uniforms` follow later edits). */
|
|
58
|
+
settings: MakeupMaterialSettings[R];
|
|
59
|
+
/** The face's skin probe (`useFaceSkin`): maps, stats, `ready`, always the current ones. */
|
|
60
|
+
skin: FaceSkinReference;
|
|
61
|
+
/** `MAKEUP_GLSL.atlasVertex`, the vertex shader to pair with these uniforms. */
|
|
62
|
+
vertexShader: string;
|
|
63
|
+
/** The built-in material's fragment shader, to start from. */
|
|
64
|
+
fragmentShader: string;
|
|
65
|
+
};
|
|
66
|
+
/** A region's material: an instance, a node, or a factory of either from the context. */
|
|
67
|
+
export type MakeupMaterialSpec<R extends MakeupMaterialRegion = MakeupMaterialRegion> = FaceAtlasMaterialResult | ((context: MakeupMaterialContext<R>) => FaceAtlasMaterialResult);
|
|
68
|
+
/** Props every makeup region component takes besides its settings. */
|
|
69
|
+
export type MakeupRegionProps<R extends MakeupMaterialRegion = MakeupMaterialRegion> = {
|
|
70
|
+
/**
|
|
71
|
+
* Which face. Default: the enclosing `FaceRig` / `FaceWarp3D` / `FaceMorph`'s
|
|
72
|
+
* (it rides that face), else the enclosing `FaceTracker`'s, else 0.
|
|
73
|
+
*/
|
|
74
|
+
faceIndex?: number;
|
|
75
|
+
/**
|
|
76
|
+
* Faces to start the face model with when this region starts it (no
|
|
77
|
+
* `FaceTracker` above): at least `faceIndex + 1`. Pass the same value to
|
|
78
|
+
* every face component.
|
|
79
|
+
*/
|
|
80
|
+
numFaces?: number;
|
|
81
|
+
/** Whether the feed is mirrored, for the person's own sides. Default: the session's. */
|
|
82
|
+
mirrored?: boolean;
|
|
83
|
+
/** Draw order in the face layer. Default `MAKEUP_RENDER_ORDER[region]`. */
|
|
84
|
+
renderOrder?: number;
|
|
85
|
+
/**
|
|
86
|
+
* A custom material: a node, an instance (you own it), or
|
|
87
|
+
* `(ctx: MakeupMaterialContext) => either`. Spread `MAKEUP_BLENDING`, set
|
|
88
|
+
* `depthWrite={false}` and pass `uniforms={ctx.uniforms}`. Prefer a
|
|
89
|
+
* factory that returns a node (the layer owns and disposes it). A
|
|
90
|
+
* factory runs once per factory, not on edits; a new factory (an inline
|
|
91
|
+
* arrow, each render) runs again, and an instance the previous one made
|
|
92
|
+
* is then disposed, so keep one that returns an instance stable (module
|
|
93
|
+
* scope or `useCallback`) and dispose the last one it made. A material
|
|
94
|
+
* from `createMakeupMaterial` is drawn as `sharedMaterial` is (its own
|
|
95
|
+
* settings; pass it as `sharedMaterial`).
|
|
96
|
+
*/
|
|
97
|
+
material?: MakeupMaterialSpec<R>;
|
|
98
|
+
/**
|
|
99
|
+
* Use this material instead of the built-in one and `material`; you own
|
|
100
|
+
* it and its settings (the region never writes settings into it). Any
|
|
101
|
+
* material is drawn as given and never changed, except one from
|
|
102
|
+
* `createMakeupMaterial`: it is drawn through a per-face copy that shares
|
|
103
|
+
* its program and its uniform objects and adds this face's camera,
|
|
104
|
+
* presence, sides and skin probe, so one such material can serve every
|
|
105
|
+
* face (`<FaceTracker numFaces={2}>`). Drive its look with
|
|
106
|
+
* `updateMakeupMaterial` (or its uniforms in `useFrame`). It is drawn
|
|
107
|
+
* over every triangle its own region can reach, at its own region's
|
|
108
|
+
* order: give it to that region's component (`<Blush>` for a blush
|
|
109
|
+
* material), one component per face.
|
|
110
|
+
*/
|
|
111
|
+
sharedMaterial?: THREE.Material;
|
|
112
|
+
};
|
|
113
|
+
/** Internal props of the core: the region, its resolved settings, and optional triangles and uniforms. */
|
|
114
|
+
export type MakeupRegionLayerProps<R extends MakeupMaterialRegion> = MakeupRegionProps<R> & {
|
|
115
|
+
region: R;
|
|
116
|
+
/** Resolved settings (`MAKEUP_REGION_PROGRAMS[region].resolve(…)`). */
|
|
117
|
+
settings: MakeupMaterialSettings[R];
|
|
118
|
+
/** Atlas triangles to draw instead of the region's own (stable). */
|
|
119
|
+
triangles?: ArrayLike<number>;
|
|
120
|
+
/**
|
|
121
|
+
* Uniforms that are not settings (a design texture, a time): merged into
|
|
122
|
+
* the region's uniforms by name, replacing the program's neutral entries,
|
|
123
|
+
* before settings are written. Keep the `{ value }` objects stable and
|
|
124
|
+
* change their values.
|
|
125
|
+
*/
|
|
126
|
+
uniforms?: Record<string, THREE.IUniform>;
|
|
127
|
+
};
|
|
128
|
+
/**
|
|
129
|
+
* The core every makeup region component renders: nothing while
|
|
130
|
+
* `settings.enabled` is false, else the region's layer (see the module doc).
|
|
131
|
+
*/
|
|
132
|
+
export declare const MakeupRegionLayer: <R extends MakeupMaterialRegion>(props: MakeupRegionLayerProps<R>) => import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Makeup vocabulary shared by every region and by `LipEffect`. Plain data with
|
|
3
|
+
* no imports, so the lip settings and the makeup tables can both build on it.
|
|
4
|
+
*/
|
|
5
|
+
/** The seven makeup region keys: lips first, then the six face regions. Not the draw order. */
|
|
6
|
+
export declare const MAKEUP_REGIONS: readonly ["lips", "contour", "blush", "highlighter", "eyeshadow", "eyeliner", "brows"];
|
|
7
|
+
export type MakeupRegion = (typeof MAKEUP_REGIONS)[number];
|
|
8
|
+
/** The six regions drawn by the makeup region components (every region but lips). */
|
|
9
|
+
export type MakeupFaceRegion = Exclude<MakeupRegion, "lips">;
|
|
10
|
+
/**
|
|
11
|
+
* How the product reflects light. `matte` removes the skin's own shine,
|
|
12
|
+
* `satin` keeps a soft sheen, `gloss` adds a wet highlight, `shimmer` fine
|
|
13
|
+
* flakes, `metallic` a highlight tinted by the shade, `glitter` sparse large
|
|
14
|
+
* flakes.
|
|
15
|
+
*/
|
|
16
|
+
export declare const MAKEUP_FINISHES: readonly ["matte", "satin", "gloss", "shimmer", "metallic", "glitter"];
|
|
17
|
+
export type MakeupFinish = (typeof MAKEUP_FINISHES)[number];
|
|
18
|
+
/** Which of the person's own sides a paired region paints, on every feed. */
|
|
19
|
+
export declare const MAKEUP_SIDES: readonly ["both", "left", "right"];
|
|
20
|
+
export type MakeupSide = (typeof MAKEUP_SIDES)[number];
|
|
21
|
+
/**
|
|
22
|
+
* Regions whose `shade` accepts `"auto"`: a colour taken from the person's
|
|
23
|
+
* own skin, lips or brows (lips: their lip colour deepened; blush: their skin
|
|
24
|
+
* hue moved toward rose; contour and highlighter: their skin darkened or
|
|
25
|
+
* lifted; brows: their brow-hair colour), measured on the GPU by the face's
|
|
26
|
+
* skin probe (`useFaceSkin`). `Blush`, `Contour`, `Highlighter`, `Brows`
|
|
27
|
+
* and `LipEffect` derive it there; `color` shows until it is measured.
|
|
28
|
+
*/
|
|
29
|
+
export declare const MAKEUP_AUTO_SHADE_REGIONS: readonly ["lips", "blush", "contour", "highlighter", "brows"];
|
|
30
|
+
export type MakeupAutoShadeRegion = (typeof MAKEUP_AUTO_SHADE_REGIONS)[number];
|
|
31
|
+
/** The fields a finish sets. Choosing a finish re-applies them; explicit values win. */
|
|
32
|
+
export type MakeupFinishDefaults = {
|
|
33
|
+
/** Strength of the finish highlight, 0..1. */
|
|
34
|
+
shine: number;
|
|
35
|
+
/** Flake density, 0..1. Read by `shimmer` and `glitter` only. */
|
|
36
|
+
sparkleDensity: number;
|
|
37
|
+
/** Flake size in millimetres on the face, 0.1..1.5. */
|
|
38
|
+
sparkleSize: number;
|
|
39
|
+
};
|
|
40
|
+
export declare const MAKEUP_FINISH_DEFAULTS: Record<MakeupFinish, MakeupFinishDefaults>;
|
|
41
|
+
/** The keys a finish sets. */
|
|
42
|
+
export declare const MAKEUP_FINISH_KEYS: readonly ["shine", "sparkleDensity", "sparkleSize"];
|
|
43
|
+
/** Range of `sparkleSize` in millimetres (lips and every region). */
|
|
44
|
+
export declare const MAKEUP_SPARKLE_SIZE_RANGE: readonly [0.1, 1.5];
|