@motionscript/core 0.1.0-alpha.3 → 0.1.0-alpha.6
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/CHANGELOG.md +247 -0
- package/LICENSE +201 -201
- package/NOTICE +48 -0
- package/README.md +93 -72
- package/dist/assets/asset-index.js.map +1 -1
- package/dist/assets/catalog.d.ts +9 -0
- package/dist/assets/catalog.d.ts.map +1 -1
- package/dist/assets/catalog.js +11 -0
- package/dist/assets/catalog.js.map +1 -1
- package/dist/assets/errors.d.ts.map +1 -1
- package/dist/assets/errors.js +8 -3
- package/dist/assets/errors.js.map +1 -1
- package/dist/assets/index.js.map +1 -1
- package/dist/assets/manager.d.ts +26 -1
- package/dist/assets/manager.d.ts.map +1 -1
- package/dist/assets/manager.js +79 -4
- package/dist/assets/manager.js.map +1 -1
- package/dist/assets/manifest.js.map +1 -1
- package/dist/assets/record.js.map +1 -1
- package/dist/assets/scope.d.ts +3 -3
- package/dist/assets/scope.d.ts.map +1 -1
- package/dist/assets/scope.js.map +1 -1
- package/dist/attributes/audio/filters/chain.d.ts +1 -1
- package/dist/attributes/audio/filters/chain.js.map +1 -1
- package/dist/attributes/audio/filters/curve.d.ts +8 -8
- package/dist/attributes/audio/filters/curve.d.ts.map +1 -1
- package/dist/attributes/audio/filters/curve.js +20 -19
- package/dist/attributes/audio/filters/curve.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/echo.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/gain.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/highpass.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/lowpass.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/speed.d.ts +2 -2
- package/dist/attributes/audio/filters/implementations/speed.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/tremolo.js.map +1 -1
- package/dist/attributes/audio/filters/index.d.ts +1 -1
- package/dist/attributes/audio/filters/index.d.ts.map +1 -1
- package/dist/attributes/audio/filters/index.js +1 -1
- package/dist/attributes/audio/filters/index.js.map +1 -1
- package/dist/attributes/audio/filters/registry.js.map +1 -1
- package/dist/attributes/audio/filters/union.js.map +1 -1
- package/dist/attributes/audio/request.d.ts +17 -2
- package/dist/attributes/audio/request.d.ts.map +1 -1
- package/dist/attributes/audio/request.js.map +1 -1
- package/dist/attributes/audio/schedule.d.ts +4 -2
- package/dist/attributes/audio/schedule.d.ts.map +1 -1
- package/dist/attributes/audio/schedule.js +15 -8
- package/dist/attributes/audio/schedule.js.map +1 -1
- package/dist/attributes/audio/sound.d.ts +4 -2
- package/dist/attributes/audio/sound.d.ts.map +1 -1
- package/dist/attributes/audio/sound.js +8 -4
- package/dist/attributes/audio/sound.js.map +1 -1
- package/dist/attributes/index.js.map +1 -1
- package/dist/attributes/layout/alignment.js +1 -1
- package/dist/attributes/layout/alignment.js.map +1 -1
- package/dist/attributes/layout/index.js.map +1 -1
- package/dist/attributes/layout/insets.js.map +1 -1
- package/dist/attributes/layout/matrix2d.js.map +1 -1
- package/dist/attributes/layout/size.js.map +1 -1
- package/dist/attributes/layout/transform3d.js.map +1 -1
- package/dist/attributes/layout/vector2.js.map +1 -1
- package/dist/attributes/layout/world-transform.js.map +1 -1
- package/dist/attributes/mask/boolean.js.map +1 -1
- package/dist/attributes/mask/mask.js.map +1 -1
- package/dist/attributes/properties/decorator.d.ts +3 -1
- package/dist/attributes/properties/decorator.d.ts.map +1 -1
- package/dist/attributes/properties/decorator.js.map +1 -1
- package/dist/attributes/properties/inputs.js.map +1 -1
- package/dist/attributes/properties/typed.d.ts +9 -2
- package/dist/attributes/properties/typed.d.ts.map +1 -1
- package/dist/attributes/properties/typed.js +15 -1
- package/dist/attributes/properties/typed.js.map +1 -1
- package/dist/attributes/render3d/orbit.d.ts +8 -8
- package/dist/attributes/render3d/orbit.js +7 -7
- package/dist/attributes/render3d/orbit.js.map +1 -1
- package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
- package/dist/attributes/shape/corners/corner-style.js.map +1 -1
- package/dist/attributes/shape/corners/corners.js.map +1 -1
- package/dist/attributes/shape/corners/index.js.map +1 -1
- package/dist/attributes/shape/effects/backdrop.d.ts +4 -4
- package/dist/attributes/shape/effects/backdrop.d.ts.map +1 -1
- package/dist/attributes/shape/effects/backdrop.js.map +1 -1
- package/dist/attributes/shape/effects/chain.d.ts +28 -120
- package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
- package/dist/attributes/shape/effects/chain.js +16 -88
- package/dist/attributes/shape/effects/chain.js.map +1 -1
- package/dist/attributes/shape/effects/effect-data.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +2 -2
- package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/curves.d.ts +1 -1
- package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.d.ts +15 -24
- package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/lut.d.ts +1 -1
- package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.js +15 -8
- package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
- package/dist/attributes/shape/effects/index.d.ts +2 -6
- package/dist/attributes/shape/effects/index.d.ts.map +1 -1
- package/dist/attributes/shape/effects/index.js.map +1 -1
- package/dist/attributes/shape/effects/registry.d.ts +23 -6
- package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
- package/dist/attributes/shape/effects/registry.js +44 -10
- package/dist/attributes/shape/effects/registry.js.map +1 -1
- package/dist/attributes/shape/effects/union.d.ts +2 -6
- package/dist/attributes/shape/effects/union.d.ts.map +1 -1
- package/dist/attributes/shape/effects/union.js.map +1 -1
- package/dist/attributes/shape/fill/blend.js.map +1 -1
- package/dist/attributes/shape/fill/chain.js.map +1 -1
- package/dist/attributes/shape/fill/coerce.js.map +1 -1
- package/dist/attributes/shape/fill/color/constants.js.map +1 -1
- package/dist/attributes/shape/fill/color/parser.d.ts.map +1 -1
- package/dist/attributes/shape/fill/color/parser.js +81 -44
- package/dist/attributes/shape/fill/color/parser.js.map +1 -1
- package/dist/attributes/shape/fill/gradient-stops.d.ts +16 -0
- package/dist/attributes/shape/fill/gradient-stops.d.ts.map +1 -0
- package/dist/attributes/shape/fill/gradient-stops.js +65 -0
- package/dist/attributes/shape/fill/gradient-stops.js.map +1 -0
- package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/color.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/conic-gradient.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/conic-gradient.js +2 -5
- package/dist/attributes/shape/fill/implementations/conic-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/dot-grid.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/fractal-noise.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/fractal-noise.js +2 -10
- package/dist/attributes/shape/fill/implementations/fractal-noise.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/grid.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/image.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/image.js +5 -4
- package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/linear-gradient.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/linear-gradient.js +2 -6
- package/dist/attributes/shape/fill/implementations/linear-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/noise.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/radial-gradient.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/radial-gradient.js +2 -5
- package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/stripe.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/video.js +1 -1
- package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
- package/dist/attributes/shape/fill/index.js.map +1 -1
- package/dist/attributes/shape/fill/lerp.js.map +1 -1
- package/dist/attributes/shape/fill/media-preset.js.map +1 -1
- package/dist/attributes/shape/fill/registry.js.map +1 -1
- package/dist/attributes/shape/fill/union.js.map +1 -1
- package/dist/attributes/shape/filters/chain.d.ts +4 -10
- package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
- package/dist/attributes/shape/filters/chain.js +1 -13
- package/dist/attributes/shape/filters/chain.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/alpha.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/blur.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/color-adjustment.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/curves.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/echo.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/exposure.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/grayscale.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/posterize-time.js.map +1 -1
- package/dist/attributes/shape/filters/index.d.ts +1 -1
- package/dist/attributes/shape/filters/index.js.map +1 -1
- package/dist/attributes/shape/filters/registry.d.ts +2 -2
- package/dist/attributes/shape/filters/registry.js +3 -3
- package/dist/attributes/shape/filters/registry.js.map +1 -1
- package/dist/attributes/shape/filters/union.d.ts +6 -7
- package/dist/attributes/shape/filters/union.d.ts.map +1 -1
- package/dist/attributes/shape/filters/union.js.map +1 -1
- package/dist/attributes/shape/path/anchors.d.ts.map +1 -1
- package/dist/attributes/shape/path/anchors.js +12 -5
- package/dist/attributes/shape/path/anchors.js.map +1 -1
- package/dist/attributes/shape/path/bezier.js.map +1 -1
- package/dist/attributes/shape/path/index.js.map +1 -1
- package/dist/attributes/shape/path/measure.js.map +1 -1
- package/dist/attributes/shape/path/morph.d.ts.map +1 -1
- package/dist/attributes/shape/path/morph.js +16 -4
- package/dist/attributes/shape/path/morph.js.map +1 -1
- package/dist/attributes/shape/path/ops.js.map +1 -1
- package/dist/attributes/shape/path/types.js.map +1 -1
- package/dist/attributes/shape/path/walk.js.map +1 -1
- package/dist/attributes/shape/shaders/index.js.map +1 -1
- package/dist/attributes/shape/shaders/pack.js.map +1 -1
- package/dist/attributes/shape/shaders/resolve.js.map +1 -1
- package/dist/attributes/shape/shadow/index.js.map +1 -1
- package/dist/attributes/shape/shadow/shadow.js.map +1 -1
- package/dist/attributes/shape/stroke/index.d.ts +2 -2
- package/dist/attributes/shape/stroke/index.d.ts.map +1 -1
- package/dist/attributes/shape/stroke/index.js +1 -1
- package/dist/attributes/shape/stroke/index.js.map +1 -1
- package/dist/attributes/shape/stroke/stroke.d.ts +27 -6
- package/dist/attributes/shape/stroke/stroke.d.ts.map +1 -1
- package/dist/attributes/shape/stroke/stroke.js +22 -2
- package/dist/attributes/shape/stroke/stroke.js.map +1 -1
- package/dist/attributes/shared/operators.js.map +1 -1
- package/dist/attributes/text/index.js.map +1 -1
- package/dist/attributes/text/ops.d.ts +6 -0
- package/dist/attributes/text/ops.d.ts.map +1 -1
- package/dist/attributes/text/ops.js +1 -0
- package/dist/attributes/text/ops.js.map +1 -1
- package/dist/attributes/text/types.js.map +1 -1
- package/dist/browser/chunks/chunk-2RIYH36X.js +3 -0
- package/dist/browser/chunks/chunk-2RIYH36X.js.map +7 -0
- package/dist/browser/chunks/chunk-DDJN3QII.js +15 -0
- package/dist/browser/chunks/chunk-DDJN3QII.js.map +7 -0
- package/dist/browser/chunks/chunk-DHB4COFY.js +2 -0
- package/dist/browser/chunks/chunk-DHB4COFY.js.map +7 -0
- package/dist/browser/chunks/chunk-EJDPYDQI.js +5 -0
- package/dist/browser/chunks/chunk-EJDPYDQI.js.map +7 -0
- package/dist/browser/chunks/chunk-SFNJRPBV.js +2 -0
- package/dist/browser/chunks/chunk-SFNJRPBV.js.map +7 -0
- package/dist/browser/chunks/chunk-XAWE4EAK.js +2 -0
- package/dist/browser/chunks/chunk-XAWE4EAK.js.map +7 -0
- package/dist/browser/component.js +1 -1
- package/dist/browser/component.js.map +4 -4
- package/dist/browser/experimental.js +2 -0
- package/dist/browser/experimental.js.map +7 -0
- package/dist/browser/index.js +1 -1
- package/dist/browser/index.js.map +4 -4
- package/dist/browser/jsx-jsx-dev-runtime.js +1 -1
- package/dist/browser/jsx-jsx-runtime.js +1 -1
- package/dist/browser/manifest.json +4 -2
- package/dist/browser/sdk.js +1 -1
- package/dist/component/api.d.ts +508 -0
- package/dist/component/api.d.ts.map +1 -0
- package/dist/component/api.js +4 -0
- package/dist/component/api.js.map +1 -0
- package/dist/component/builtins/audio.d.ts +26 -0
- package/dist/component/builtins/audio.d.ts.map +1 -0
- package/dist/component/builtins/audio.js +41 -0
- package/dist/component/builtins/audio.js.map +1 -0
- package/dist/component/builtins/canvas3d.d.ts +98 -0
- package/dist/component/builtins/canvas3d.d.ts.map +1 -0
- package/dist/component/builtins/canvas3d.js +21 -0
- package/dist/component/builtins/canvas3d.js.map +1 -0
- package/dist/component/builtins/composite.d.ts +56 -0
- package/dist/component/builtins/composite.d.ts.map +1 -0
- package/dist/component/builtins/composite.js +25 -0
- package/dist/component/builtins/composite.js.map +1 -0
- package/dist/component/builtins/geometry.d.ts +505 -0
- package/dist/component/builtins/geometry.d.ts.map +1 -0
- package/dist/component/builtins/geometry.js +107 -0
- package/dist/component/builtins/geometry.js.map +1 -0
- package/dist/component/builtins/layout.d.ts +88 -0
- package/dist/component/builtins/layout.d.ts.map +1 -0
- package/dist/component/builtins/layout.js +84 -0
- package/dist/component/builtins/layout.js.map +1 -0
- package/dist/component/builtins/media.d.ts +95 -0
- package/dist/component/builtins/media.d.ts.map +1 -0
- package/dist/component/builtins/media.js +149 -0
- package/dist/component/builtins/media.js.map +1 -0
- package/dist/component/builtins/providers.d.ts +23 -0
- package/dist/component/builtins/providers.d.ts.map +1 -0
- package/dist/component/builtins/providers.js +30 -0
- package/dist/component/builtins/providers.js.map +1 -0
- package/dist/component/builtins/text.d.ts +193 -0
- package/dist/component/builtins/text.d.ts.map +1 -0
- package/dist/component/builtins/text.js +113 -0
- package/dist/component/builtins/text.js.map +1 -0
- package/dist/component/builtins/three.d.ts +1085 -0
- package/dist/component/builtins/three.d.ts.map +1 -0
- package/dist/component/builtins/three.js +265 -0
- package/dist/component/builtins/three.js.map +1 -0
- package/dist/component/clip-of.d.ts +5 -0
- package/dist/component/clip-of.d.ts.map +1 -0
- package/dist/component/clip-of.js +33 -0
- package/dist/component/clip-of.js.map +1 -0
- package/dist/component/commands-for.d.ts +19 -0
- package/dist/component/commands-for.d.ts.map +1 -0
- package/dist/component/commands-for.js +5 -0
- package/dist/component/commands-for.js.map +1 -0
- package/dist/component/component-audio.d.ts +9 -0
- package/dist/component/component-audio.d.ts.map +1 -0
- package/dist/component/component-audio.js +18 -0
- package/dist/component/component-audio.js.map +1 -0
- package/dist/component/component2d.d.ts +9 -0
- package/dist/component/component2d.d.ts.map +1 -0
- package/dist/component/component2d.js +239 -0
- package/dist/component/component2d.js.map +1 -0
- package/dist/component/component3d.d.ts +9 -0
- package/dist/component/component3d.d.ts.map +1 -0
- package/dist/component/component3d.js +99 -0
- package/dist/component/component3d.js.map +1 -0
- package/dist/component/factory.d.ts +63 -0
- package/dist/component/factory.d.ts.map +1 -0
- package/dist/component/factory.js +313 -0
- package/dist/component/factory.js.map +1 -0
- package/dist/component/modules/aim.d.ts +30 -0
- package/dist/component/modules/aim.d.ts.map +1 -0
- package/dist/component/modules/aim.js +39 -0
- package/dist/component/modules/aim.js.map +1 -0
- package/dist/component/modules/corners.d.ts +13 -0
- package/dist/component/modules/corners.d.ts.map +1 -0
- package/dist/component/modules/corners.js +12 -0
- package/dist/component/modules/corners.js.map +1 -0
- package/dist/component/modules/flow.d.ts +26 -0
- package/dist/component/modules/flow.d.ts.map +1 -0
- package/dist/component/modules/flow.js +55 -0
- package/dist/component/modules/flow.js.map +1 -0
- package/dist/component/modules/material.d.ts +40 -0
- package/dist/component/modules/material.d.ts.map +1 -0
- package/dist/component/modules/material.js +75 -0
- package/dist/component/modules/material.js.map +1 -0
- package/dist/component/modules/paint.d.ts +71 -0
- package/dist/component/modules/paint.d.ts.map +1 -0
- package/dist/component/modules/paint.js +106 -0
- package/dist/component/modules/paint.js.map +1 -0
- package/dist/component/modules/shapes.d.ts +31 -0
- package/dist/component/modules/shapes.d.ts.map +1 -0
- package/dist/component/modules/shapes.js +43 -0
- package/dist/component/modules/shapes.js.map +1 -0
- package/dist/component/modules/text-layout.d.ts +26 -0
- package/dist/component/modules/text-layout.d.ts.map +1 -0
- package/dist/component/modules/text-layout.js +57 -0
- package/dist/component/modules/text-layout.js.map +1 -0
- package/dist/component/modules/text-style.d.ts +48 -0
- package/dist/component/modules/text-style.d.ts.map +1 -0
- package/dist/component/modules/text-style.js +63 -0
- package/dist/component/modules/text-style.js.map +1 -0
- package/dist/component/modules/three-entries.d.ts +23 -0
- package/dist/component/modules/three-entries.d.ts.map +1 -0
- package/dist/component/modules/three-entries.js +41 -0
- package/dist/component/modules/three-entries.js.map +1 -0
- package/dist/component/modules/view3d.d.ts +55 -0
- package/dist/component/modules/view3d.d.ts.map +1 -0
- package/dist/component/modules/view3d.js +160 -0
- package/dist/component/modules/view3d.js.map +1 -0
- package/dist/component/timeline.d.ts +22 -0
- package/dist/component/timeline.d.ts.map +1 -0
- package/dist/component/timeline.js +128 -0
- package/dist/component/timeline.js.map +1 -0
- package/dist/component/type-def.d.ts +26 -0
- package/dist/component/type-def.d.ts.map +1 -0
- package/dist/component/type-def.js +16 -0
- package/dist/component/type-def.js.map +1 -0
- package/dist/component/types.d.ts +91 -0
- package/dist/component/types.d.ts.map +1 -0
- package/dist/component/types.js +88 -0
- package/dist/component/types.js.map +1 -0
- package/dist/component/views.d.ts +121 -0
- package/dist/component/views.d.ts.map +1 -0
- package/dist/component/views.js +413 -0
- package/dist/component/views.js.map +1 -0
- package/dist/component.d.ts +4 -5
- package/dist/component.d.ts.map +1 -1
- package/dist/component.js +3 -5
- package/dist/component.js.map +1 -1
- package/dist/document/audio.d.ts +10 -2
- package/dist/document/audio.d.ts.map +1 -1
- package/dist/document/audio.js +45 -4
- package/dist/document/audio.js.map +1 -1
- package/dist/document/builtins.d.ts.map +1 -1
- package/dist/document/builtins.js +15 -39
- package/dist/document/builtins.js.map +1 -1
- package/dist/document/command-traits.d.ts +1 -1
- package/dist/document/command-traits.js +16 -1
- package/dist/document/command-traits.js.map +1 -1
- package/dist/document/deny-globals.js.map +1 -1
- package/dist/document/diff.d.ts.map +1 -1
- package/dist/document/diff.js +3 -3
- package/dist/document/diff.js.map +1 -1
- package/dist/document/doc-index.d.ts +2 -2
- package/dist/document/doc-index.d.ts.map +1 -1
- package/dist/document/doc-index.js +3 -3
- package/dist/document/doc-index.js.map +1 -1
- package/dist/document/expression/compile.d.ts.map +1 -1
- package/dist/document/expression/compile.js +8 -5
- package/dist/document/expression/compile.js.map +1 -1
- package/dist/document/expression/index.js.map +1 -1
- package/dist/document/expression/ops.js +1 -1
- package/dist/document/expression/ops.js.map +1 -1
- package/dist/document/expression/parse.d.ts.map +1 -1
- package/dist/document/expression/parse.js +15 -6
- package/dist/document/expression/parse.js.map +1 -1
- package/dist/document/expression/refs.d.ts +1 -1
- package/dist/document/expression/refs.js +1 -1
- package/dist/document/expression/refs.js.map +1 -1
- package/dist/document/expression/types.js.map +1 -1
- package/dist/document/expression/walk.d.ts.map +1 -1
- package/dist/document/expression/walk.js +2 -1
- package/dist/document/expression/walk.js.map +1 -1
- package/dist/document/index.d.ts +2 -0
- package/dist/document/index.d.ts.map +1 -1
- package/dist/document/index.js +2 -0
- package/dist/document/index.js.map +1 -1
- package/dist/document/node-decorator.js.map +1 -1
- package/dist/document/node-descriptor.d.ts +25 -0
- package/dist/document/node-descriptor.d.ts.map +1 -1
- package/dist/document/node-descriptor.js.map +1 -1
- package/dist/document/placement.d.ts +70 -0
- package/dist/document/placement.d.ts.map +1 -0
- package/dist/document/placement.js +83 -0
- package/dist/document/placement.js.map +1 -0
- package/dist/document/project.d.ts +2 -2
- package/dist/document/project.d.ts.map +1 -1
- package/dist/document/project.js.map +1 -1
- package/dist/document/registry.d.ts +23 -11
- package/dist/document/registry.d.ts.map +1 -1
- package/dist/document/registry.js +46 -19
- package/dist/document/registry.js.map +1 -1
- package/dist/document/settled-index.d.ts +49 -0
- package/dist/document/settled-index.d.ts.map +1 -0
- package/dist/document/settled-index.js +247 -0
- package/dist/document/settled-index.js.map +1 -0
- package/dist/document/timeline-patch.js.map +1 -1
- package/dist/document/timeline.d.ts +100 -19
- package/dist/document/timeline.d.ts.map +1 -1
- package/dist/document/timeline.js +290 -42
- package/dist/document/timeline.js.map +1 -1
- package/dist/document/types.d.ts +12 -12
- package/dist/document/types.d.ts.map +1 -1
- package/dist/document/types.js +2 -2
- package/dist/document/types.js.map +1 -1
- package/dist/document/validate.d.ts +2 -2
- package/dist/document/validate.d.ts.map +1 -1
- package/dist/document/validate.js +37 -31
- package/dist/document/validate.js.map +1 -1
- package/dist/document/withdraw.d.ts +28 -0
- package/dist/document/withdraw.d.ts.map +1 -0
- package/dist/document/withdraw.js +61 -0
- package/dist/document/withdraw.js.map +1 -0
- package/dist/experimental.d.ts +22 -0
- package/dist/experimental.d.ts.map +1 -0
- package/dist/experimental.js +20 -0
- package/dist/experimental.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -1
- package/dist/jsx/jsx-dev-runtime.js.map +1 -1
- package/dist/jsx/jsx-runtime.d.ts +9 -1
- package/dist/jsx/jsx-runtime.d.ts.map +1 -1
- package/dist/jsx/jsx-runtime.js +13 -3
- package/dist/jsx/jsx-runtime.js.map +1 -1
- package/dist/layout/bounds.d.ts +0 -1
- package/dist/layout/bounds.d.ts.map +1 -1
- package/dist/layout/bounds.js.map +1 -1
- package/dist/layout/constraints.js.map +1 -1
- package/dist/layout/flex.d.ts +4 -2
- package/dist/layout/flex.d.ts.map +1 -1
- package/dist/layout/flex.js +27 -11
- package/dist/layout/flex.js.map +1 -1
- package/dist/layout/freeform.js.map +1 -1
- package/dist/layout/grid.js.map +1 -1
- package/dist/layout/index.js.map +1 -1
- package/dist/layout/item.js.map +1 -1
- package/dist/layout/ops.d.ts +6 -0
- package/dist/layout/ops.d.ts.map +1 -1
- package/dist/layout/ops.js +6 -0
- package/dist/layout/ops.js.map +1 -1
- package/dist/layout/types.js.map +1 -1
- package/dist/nodes/2d/node-lifecycle.js.map +1 -1
- package/dist/nodes/2d/node-motion.js.map +1 -1
- package/dist/nodes/2d/node-render.d.ts +3 -3
- package/dist/nodes/2d/node-render.d.ts.map +1 -1
- package/dist/nodes/2d/node-render.js.map +1 -1
- package/dist/nodes/2d/node-transform.js.map +1 -1
- package/dist/nodes/2d/node2d.d.ts +115 -3
- package/dist/nodes/2d/node2d.d.ts.map +1 -1
- package/dist/nodes/2d/node2d.js +180 -28
- package/dist/nodes/2d/node2d.js.map +1 -1
- package/dist/nodes/2d/paint-node.d.ts +27 -0
- package/dist/nodes/2d/paint-node.d.ts.map +1 -1
- package/dist/nodes/2d/paint-node.js +42 -0
- package/dist/nodes/2d/paint-node.js.map +1 -1
- package/dist/nodes/audio/audio-bus.js.map +1 -1
- package/dist/nodes/audio/index.d.ts +2 -2
- package/dist/nodes/audio/index.d.ts.map +1 -1
- package/dist/nodes/audio/index.js +0 -2
- package/dist/nodes/audio/index.js.map +1 -1
- package/dist/nodes/audio/node-audio.js.map +1 -1
- package/dist/nodes/audio/sound-node.d.ts +4 -3
- package/dist/nodes/audio/sound-node.d.ts.map +1 -1
- package/dist/nodes/audio/sound-node.js +4 -1
- package/dist/nodes/audio/sound-node.js.map +1 -1
- package/dist/nodes/geometry/bounds-shape-node.d.ts +4 -4
- package/dist/nodes/geometry/bounds-shape-node.js +2 -2
- package/dist/nodes/geometry/bounds-shape-node.js.map +1 -1
- package/dist/nodes/geometry/box-path-node.d.ts +3 -3
- package/dist/nodes/geometry/box-path-node.js +2 -2
- package/dist/nodes/geometry/box-path-node.js.map +1 -1
- package/dist/nodes/geometry/ellipse-node.js.map +1 -1
- package/dist/nodes/geometry/group-bounds.d.ts +2 -2
- package/dist/nodes/geometry/group-bounds.d.ts.map +1 -1
- package/dist/nodes/geometry/group-bounds.js +1 -2
- package/dist/nodes/geometry/group-bounds.js.map +1 -1
- package/dist/nodes/geometry/path-node.d.ts.map +1 -1
- package/dist/nodes/geometry/path-node.js +6 -0
- package/dist/nodes/geometry/path-node.js.map +1 -1
- package/dist/nodes/geometry/polygon-node.js.map +1 -1
- package/dist/nodes/geometry/polygram-node.js.map +1 -1
- package/dist/nodes/geometry/rect-node.js.map +1 -1
- package/dist/nodes/geometry/shape-node.js.map +1 -1
- package/dist/nodes/geometry/shape-outline.d.ts +2 -2
- package/dist/nodes/geometry/shape-outline.d.ts.map +1 -1
- package/dist/nodes/geometry/shape-outline.js +2 -13
- package/dist/nodes/geometry/shape-outline.js.map +1 -1
- package/dist/nodes/index.d.ts +40 -33
- package/dist/nodes/index.d.ts.map +1 -1
- package/dist/nodes/index.js +17 -36
- package/dist/nodes/index.js.map +1 -1
- package/dist/nodes/layout/camera-node.d.ts +9 -0
- package/dist/nodes/layout/camera-node.d.ts.map +1 -1
- package/dist/nodes/layout/camera-node.js +38 -3
- package/dist/nodes/layout/camera-node.js.map +1 -1
- package/dist/nodes/layout/orbit-camera-node.d.ts +1 -1
- package/dist/nodes/layout/orbit-camera-node.js +1 -1
- package/dist/nodes/layout/orbit-camera-node.js.map +1 -1
- package/dist/nodes/layout/rotated-box.js.map +1 -1
- package/dist/nodes/media/video-node.d.ts.map +1 -1
- package/dist/nodes/media/video-node.js +2 -0
- package/dist/nodes/media/video-node.js.map +1 -1
- package/dist/nodes/node/declare-paints.js.map +1 -1
- package/dist/nodes/node/node-editor-state.js.map +1 -1
- package/dist/nodes/node/node-reactive.js.map +1 -1
- package/dist/nodes/node/node-time.d.ts +3 -3
- package/dist/nodes/node/node-time.d.ts.map +1 -1
- package/dist/nodes/node/node-time.js +1 -1
- package/dist/nodes/node/node-time.js.map +1 -1
- package/dist/nodes/node/node-walk.js.map +1 -1
- package/dist/nodes/node/node.d.ts +12 -4
- package/dist/nodes/node/node.d.ts.map +1 -1
- package/dist/nodes/node/node.js +67 -27
- package/dist/nodes/node/node.js.map +1 -1
- package/dist/nodes/node/text-defaults.d.ts +10 -12
- package/dist/nodes/node/text-defaults.d.ts.map +1 -1
- package/dist/nodes/node/text-defaults.js +10 -12
- package/dist/nodes/node/text-defaults.js.map +1 -1
- package/dist/nodes/{scene → root}/canvas2d-node.d.ts +4 -3
- package/dist/nodes/root/canvas2d-node.d.ts.map +1 -0
- package/dist/nodes/{scene → root}/canvas2d-node.js +5 -2
- package/dist/nodes/root/canvas2d-node.js.map +1 -0
- package/dist/nodes/root/provider-node.d.ts.map +1 -0
- package/dist/nodes/root/provider-node.js.map +1 -0
- package/dist/nodes/root/theme-provider-node.d.ts.map +1 -0
- package/dist/nodes/root/theme-provider-node.js.map +1 -0
- package/dist/nodes/text/default-text-style-node.d.ts +5 -2
- package/dist/nodes/text/default-text-style-node.d.ts.map +1 -1
- package/dist/nodes/text/default-text-style-node.js +10 -4
- package/dist/nodes/text/default-text-style-node.js.map +1 -1
- package/dist/nodes/text/number-format.d.ts +1 -1
- package/dist/nodes/text/number-format.js +1 -1
- package/dist/nodes/text/number-format.js.map +1 -1
- package/dist/nodes/text/number-node.js.map +1 -1
- package/dist/nodes/text/number-pattern.js.map +1 -1
- package/dist/nodes/text/richtext-node.d.ts +0 -5
- package/dist/nodes/text/richtext-node.d.ts.map +1 -1
- package/dist/nodes/text/richtext-node.js +6 -72
- package/dist/nodes/text/richtext-node.js.map +1 -1
- package/dist/nodes/text/text-base.d.ts +5 -22
- package/dist/nodes/text/text-base.d.ts.map +1 -1
- package/dist/nodes/text/text-base.js +13 -364
- package/dist/nodes/text/text-base.js.map +1 -1
- package/dist/nodes/text/text-layout.d.ts +87 -0
- package/dist/nodes/text/text-layout.d.ts.map +1 -0
- package/dist/nodes/text/text-layout.js +368 -0
- package/dist/nodes/text/text-layout.js.map +1 -0
- package/dist/nodes/text/text-node.js.map +1 -1
- package/dist/nodes/text/text-selection.js.map +1 -1
- package/dist/nodes/three/camera-nodes.d.ts +21 -3
- package/dist/nodes/three/camera-nodes.d.ts.map +1 -1
- package/dist/nodes/three/camera-nodes.js +42 -1
- package/dist/nodes/three/camera-nodes.js.map +1 -1
- package/dist/nodes/three/canvas3d-node.d.ts +32 -7
- package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
- package/dist/nodes/three/canvas3d-node.js +50 -2
- package/dist/nodes/three/canvas3d-node.js.map +1 -1
- package/dist/nodes/three/drawable-nodes.d.ts +25 -11
- package/dist/nodes/three/drawable-nodes.d.ts.map +1 -1
- package/dist/nodes/three/drawable-nodes.js +43 -13
- package/dist/nodes/three/drawable-nodes.js.map +1 -1
- package/dist/nodes/three/environment-nodes.d.ts +9 -3
- package/dist/nodes/three/environment-nodes.d.ts.map +1 -1
- package/dist/nodes/three/environment-nodes.js.map +1 -1
- package/dist/nodes/three/geometry-nodes.d.ts +2 -2
- package/dist/nodes/three/geometry-nodes.js +2 -2
- package/dist/nodes/three/geometry-nodes.js.map +1 -1
- package/dist/nodes/three/grid-geometry3d.js.map +1 -1
- package/dist/nodes/three/group3d.js.map +1 -1
- package/dist/nodes/three/light-nodes.d.ts.map +1 -1
- package/dist/nodes/three/light-nodes.js +3 -3
- package/dist/nodes/three/light-nodes.js.map +1 -1
- package/dist/nodes/three/mesh3d.js.map +1 -1
- package/dist/nodes/three/node3d.d.ts +48 -0
- package/dist/nodes/three/node3d.d.ts.map +1 -1
- package/dist/nodes/three/node3d.js +53 -3
- package/dist/nodes/three/node3d.js.map +1 -1
- package/dist/platform/audio-sink.d.ts +2 -2
- package/dist/platform/audio-sink.d.ts.map +1 -1
- package/dist/platform/audio-sink.js.map +1 -1
- package/dist/platform/exporter.d.ts +13 -8
- package/dist/platform/exporter.d.ts.map +1 -1
- package/dist/platform/exporter.js.map +1 -1
- package/dist/platform/index.d.ts +1 -1
- package/dist/platform/index.d.ts.map +1 -1
- package/dist/platform/index.js.map +1 -1
- package/dist/platform/stepped-clock.js.map +1 -1
- package/dist/platform/storage-adapter.d.ts +12 -6
- package/dist/platform/storage-adapter.d.ts.map +1 -1
- package/dist/platform/storage-adapter.js +4 -0
- package/dist/platform/storage-adapter.js.map +1 -1
- package/dist/platform/ticker.d.ts +6 -0
- package/dist/platform/ticker.d.ts.map +1 -1
- package/dist/platform/ticker.js +6 -0
- package/dist/platform/ticker.js.map +1 -1
- package/dist/project/config.js.map +1 -1
- package/dist/project/index.js.map +1 -1
- package/dist/project/tree.d.ts +3 -3
- package/dist/project/tree.d.ts.map +1 -1
- package/dist/project/tree.js.map +1 -1
- package/dist/props/host.js.map +1 -1
- package/dist/props/index.js.map +1 -1
- package/dist/props/observer.js.map +1 -1
- package/dist/props/slot.js.map +1 -1
- package/dist/renamed-scene-names.d.ts +17 -0
- package/dist/renamed-scene-names.d.ts.map +1 -0
- package/dist/renamed-scene-names.js +9 -0
- package/dist/renamed-scene-names.js.map +1 -0
- package/dist/render/canvas-render-context2d.d.ts +2 -2
- package/dist/render/canvas-render-context2d.d.ts.map +1 -1
- package/dist/render/canvas-render-context2d.js.map +1 -1
- package/dist/render/clip-contains.js.map +1 -1
- package/dist/render/clip.js.map +1 -1
- package/dist/render/descriptors/ellipse.js.map +1 -1
- package/dist/render/descriptors/latex.js.map +1 -1
- package/dist/render/descriptors/line.js.map +1 -1
- package/dist/render/descriptors/path-builder.js.map +1 -1
- package/dist/render/descriptors/path.js.map +1 -1
- package/dist/render/descriptors/polygon.js.map +1 -1
- package/dist/render/descriptors/polygram.js.map +1 -1
- package/dist/render/descriptors/rect.js.map +1 -1
- package/dist/render/descriptors/richtext.js.map +1 -1
- package/dist/render/descriptors/shape.d.ts +12 -0
- package/dist/render/descriptors/shape.d.ts.map +1 -1
- package/dist/render/descriptors/shape.js.map +1 -1
- package/dist/render/descriptors/text.d.ts +2 -2
- package/dist/render/descriptors/text.js +2 -2
- package/dist/render/descriptors/text.js.map +1 -1
- package/dist/render/descriptors/transform.d.ts +2 -2
- package/dist/render/descriptors/transform.d.ts.map +1 -1
- package/dist/render/descriptors/transform.js.map +1 -1
- package/dist/render/graphics2d.d.ts +3 -3
- package/dist/render/graphics2d.d.ts.map +1 -1
- package/dist/render/graphics2d.js +1 -1
- package/dist/render/graphics2d.js.map +1 -1
- package/dist/render/index.js.map +1 -1
- package/dist/render/measure-context.js.map +1 -1
- package/dist/render/null-render-context.js.map +1 -1
- package/dist/render/render-context2d.d.ts +2 -2
- package/dist/render/render-context2d.d.ts.map +1 -1
- package/dist/render/render-context2d.js.map +1 -1
- package/dist/render/surface.js.map +1 -1
- package/dist/render/text-defaults.js.map +1 -1
- package/dist/render/text-layout.js.map +1 -1
- package/dist/render3d/bounds3d.d.ts.map +1 -1
- package/dist/render3d/bounds3d.js +4 -2
- package/dist/render3d/bounds3d.js.map +1 -1
- package/dist/render3d/builders.js.map +1 -1
- package/dist/render3d/camera.d.ts +6 -0
- package/dist/render3d/camera.d.ts.map +1 -1
- package/dist/render3d/camera.js +5 -3
- package/dist/render3d/camera.js.map +1 -1
- package/dist/render3d/fill3d.d.ts +2 -9
- package/dist/render3d/fill3d.d.ts.map +1 -1
- package/dist/render3d/fill3d.js +2 -13
- package/dist/render3d/fill3d.js.map +1 -1
- package/dist/render3d/geometry.d.ts +8 -1
- package/dist/render3d/geometry.d.ts.map +1 -1
- package/dist/render3d/geometry.js.map +1 -1
- package/dist/render3d/graphics3d.d.ts +8 -4
- package/dist/render3d/graphics3d.d.ts.map +1 -1
- package/dist/render3d/graphics3d.js +18 -10
- package/dist/render3d/graphics3d.js.map +1 -1
- package/dist/render3d/index.d.ts +1 -1
- package/dist/render3d/index.js +1 -1
- package/dist/render3d/index.js.map +1 -1
- package/dist/render3d/inert.d.ts +14 -0
- package/dist/render3d/inert.d.ts.map +1 -0
- package/dist/render3d/inert.js +62 -0
- package/dist/render3d/inert.js.map +1 -0
- package/dist/render3d/light.js.map +1 -1
- package/dist/render3d/material.d.ts +10 -5
- package/dist/render3d/material.d.ts.map +1 -1
- package/dist/render3d/material.js.map +1 -1
- package/dist/render3d/matrix4.js.map +1 -1
- package/dist/render3d/render-context3d.js.map +1 -1
- package/dist/render3d/resources.js.map +1 -1
- package/dist/render3d/rounded-box.js.map +1 -1
- package/dist/render3d/scene-settings.d.ts +23 -4
- package/dist/render3d/scene-settings.d.ts.map +1 -1
- package/dist/render3d/scene-settings.js.map +1 -1
- package/dist/render3d/scene3d.d.ts +11 -0
- package/dist/render3d/scene3d.d.ts.map +1 -1
- package/dist/render3d/scene3d.js +39 -6
- package/dist/render3d/scene3d.js.map +1 -1
- package/dist/render3d/segments.js.map +1 -1
- package/dist/render3d/texture.d.ts +9 -0
- package/dist/render3d/texture.d.ts.map +1 -1
- package/dist/render3d/texture.js +13 -0
- package/dist/render3d/texture.js.map +1 -1
- package/dist/render3d/tracking.js.map +1 -1
- package/dist/render3d/transform.d.ts +1 -1
- package/dist/render3d/transform.js.map +1 -1
- package/dist/render3d/vector3.d.ts +18 -1
- package/dist/render3d/vector3.d.ts.map +1 -1
- package/dist/render3d/vector3.js +27 -0
- package/dist/render3d/vector3.js.map +1 -1
- package/dist/render3d/walk.d.ts +1 -1
- package/dist/render3d/walk.d.ts.map +1 -1
- package/dist/render3d/walk.js +5 -1
- package/dist/render3d/walk.js.map +1 -1
- package/dist/runtime/asset-refine.js.map +1 -1
- package/dist/runtime/asset-timeline.js.map +1 -1
- package/dist/runtime/asset-update.js.map +1 -1
- package/dist/runtime/audio-index.js.map +1 -1
- package/dist/runtime/builtin-context.js.map +1 -1
- package/dist/runtime/clip-instance.d.ts +9 -4
- package/dist/runtime/clip-instance.d.ts.map +1 -1
- package/dist/runtime/clip-instance.js +27 -9
- package/dist/runtime/clip-instance.js.map +1 -1
- package/dist/runtime/clip-store.d.ts +18 -0
- package/dist/runtime/clip-store.d.ts.map +1 -1
- package/dist/runtime/clip-store.js +97 -0
- package/dist/runtime/clip-store.js.map +1 -1
- package/dist/runtime/engine.d.ts +5 -0
- package/dist/runtime/engine.d.ts.map +1 -1
- package/dist/runtime/engine.js +2 -0
- package/dist/runtime/engine.js.map +1 -1
- package/dist/runtime/frame-time.d.ts +31 -0
- package/dist/runtime/frame-time.d.ts.map +1 -0
- package/dist/runtime/frame-time.js +29 -0
- package/dist/runtime/frame-time.js.map +1 -0
- package/dist/runtime/index.d.ts +1 -0
- package/dist/runtime/index.d.ts.map +1 -1
- package/dist/runtime/index.js +1 -0
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/node-picking.d.ts +44 -3
- package/dist/runtime/node-picking.d.ts.map +1 -1
- package/dist/runtime/node-picking.js +124 -10
- package/dist/runtime/node-picking.js.map +1 -1
- package/dist/runtime/node-picking3d.d.ts +13 -5
- package/dist/runtime/node-picking3d.d.ts.map +1 -1
- package/dist/runtime/node-picking3d.js +10 -2
- package/dist/runtime/node-picking3d.js.map +1 -1
- package/dist/runtime/placement.d.ts.map +1 -1
- package/dist/runtime/placement.js +4 -5
- package/dist/runtime/placement.js.map +1 -1
- package/dist/runtime/playback-controller.d.ts +31 -2
- package/dist/runtime/playback-controller.d.ts.map +1 -1
- package/dist/runtime/playback-controller.js +63 -6
- package/dist/runtime/playback-controller.js.map +1 -1
- package/dist/runtime/playback.js.map +1 -1
- package/dist/runtime/precompisition.js.map +1 -1
- package/dist/runtime/project-assets.js.map +1 -1
- package/dist/runtime/session.d.ts +9 -7
- package/dist/runtime/session.d.ts.map +1 -1
- package/dist/runtime/session.js +12 -4
- package/dist/runtime/session.js.map +1 -1
- package/dist/runtime/settle.js.map +1 -1
- package/dist/runtime/state-evaluator.d.ts +1 -1
- package/dist/runtime/state-evaluator.d.ts.map +1 -1
- package/dist/runtime/state-evaluator.js +4 -3
- package/dist/runtime/state-evaluator.js.map +1 -1
- package/dist/runtime/text-geometry.d.ts.map +1 -1
- package/dist/runtime/text-geometry.js +7 -3
- package/dist/runtime/text-geometry.js.map +1 -1
- package/dist/sdk/index.d.ts +50 -25
- package/dist/sdk/index.d.ts.map +1 -1
- package/dist/sdk/index.js +52 -42
- package/dist/sdk/index.js.map +1 -1
- package/dist/tween/command-decorator.d.ts +2 -0
- package/dist/tween/command-decorator.d.ts.map +1 -1
- package/dist/tween/command-decorator.js.map +1 -1
- package/dist/tween/command.d.ts +12 -0
- package/dist/tween/command.d.ts.map +1 -1
- package/dist/tween/command.js +14 -0
- package/dist/tween/command.js.map +1 -1
- package/dist/tween/ease/constants.d.ts.map +1 -1
- package/dist/tween/ease/constants.js +8 -5
- package/dist/tween/ease/constants.js.map +1 -1
- package/dist/tween/ease/curve.d.ts.map +1 -1
- package/dist/tween/ease/curve.js +4 -3
- package/dist/tween/ease/curve.js.map +1 -1
- package/dist/tween/ease/describe.d.ts +15 -0
- package/dist/tween/ease/describe.d.ts.map +1 -0
- package/dist/tween/ease/describe.js +37 -0
- package/dist/tween/ease/describe.js.map +1 -0
- package/dist/tween/ease/type.js.map +1 -1
- package/dist/tween/index.js.map +1 -1
- package/dist/tween/inert.js.map +1 -1
- package/dist/tween/lerp.js.map +1 -1
- package/dist/tween/loop.js.map +1 -1
- package/dist/tween/prepare.d.ts +3 -3
- package/dist/tween/prepare.js +3 -3
- package/dist/tween/prepare.js.map +1 -1
- package/dist/tween/seekable.d.ts +1 -1
- package/dist/tween/seekable.js.map +1 -1
- package/dist/tween/stepper.js.map +1 -1
- package/dist/tween/to-command.js.map +1 -1
- package/dist/util/clamp.js.map +1 -1
- package/dist/util/context.js.map +1 -1
- package/dist/util/csv.js.map +1 -1
- package/dist/util/generateList.js.map +1 -1
- package/dist/util/index.js.map +1 -1
- package/dist/util/metrics.d.ts +1 -1
- package/dist/util/metrics.js +1 -1
- package/dist/util/metrics.js.map +1 -1
- package/dist/util/random.js.map +1 -1
- package/dist/util/reference.js.map +1 -1
- package/dist/util/scheduler.js.map +1 -1
- package/package.json +7 -1
- package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
- package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/displace.js +0 -30
- package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
- package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
- package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
- package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/texture.js +0 -25
- package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
- package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/trails.js +0 -22
- package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
- package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
- package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
- package/dist/browser/chunks/chunk-KJXGRHOL.js +0 -3
- package/dist/browser/chunks/chunk-KJXGRHOL.js.map +0 -7
- package/dist/browser/chunks/chunk-TGDX2SS2.js +0 -18
- package/dist/browser/chunks/chunk-TGDX2SS2.js.map +0 -7
- package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
- package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
- package/dist/nodes/geometry/dot-grid-node.js +0 -142
- package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
- package/dist/nodes/geometry/grid-lines.d.ts +0 -101
- package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
- package/dist/nodes/geometry/grid-lines.js +0 -128
- package/dist/nodes/geometry/grid-lines.js.map +0 -1
- package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
- package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
- package/dist/nodes/geometry/grid-pattern-node.js +0 -172
- package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
- package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
- package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
- package/dist/nodes/geometry/line-grid-node.js +0 -127
- package/dist/nodes/geometry/line-grid-node.js.map +0 -1
- package/dist/nodes/geometry/line-node.d.ts +0 -58
- package/dist/nodes/geometry/line-node.d.ts.map +0 -1
- package/dist/nodes/geometry/line-node.js +0 -123
- package/dist/nodes/geometry/line-node.js.map +0 -1
- package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
- package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
- package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
- package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
- package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
- package/dist/nodes/scene/canvas2d-node.js.map +0 -1
- package/dist/nodes/scene/provider-node.d.ts.map +0 -1
- package/dist/nodes/scene/provider-node.js.map +0 -1
- package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
- package/dist/nodes/scene/theme-provider-node.js.map +0 -1
- /package/dist/nodes/{scene → root}/provider-node.d.ts +0 -0
- /package/dist/nodes/{scene → root}/provider-node.js +0 -0
- /package/dist/nodes/{scene → root}/theme-provider-node.d.ts +0 -0
- /package/dist/nodes/{scene → root}/theme-provider-node.js +0 -0
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { Transform3D } from "../../render3d/transform.js";
|
|
2
|
-
import type
|
|
2
|
+
import { type CameraData3D } from "../../render3d/camera.js";
|
|
3
|
+
import type { Command, CommandArgs } from "../../tween/command.js";
|
|
3
4
|
import type { RenderContext3D } from "../../render3d/render-context3d.js";
|
|
4
5
|
import type { Vector3Input } from "../../render3d/vector3.js";
|
|
5
6
|
import { Node3D, type Node3DProps } from "./node3d.js";
|
|
@@ -20,8 +21,7 @@ import { Node3D, type Node3DProps } from "./node3d.js";
|
|
|
20
21
|
* around the thing it is looking at, which is what a camera move almost always
|
|
21
22
|
* *is*. Written through `position` the same move is a `Math.sin`/`Math.cos` pair
|
|
22
23
|
* recomputed every frame in a prop binding — which is exactly what every scene
|
|
23
|
-
* did before this existed
|
|
24
|
-
* independently reinvented `orbit`/`elevation`/`zoom` props to avoid.
|
|
24
|
+
* did before this existed.
|
|
25
25
|
*
|
|
26
26
|
* `position` and `lookAt` still work and are right for a shot pinned to
|
|
27
27
|
* something; setting any polar field takes over, so the two can never be half
|
|
@@ -73,6 +73,24 @@ export declare class Camera3D<P extends Camera3DProps = Camera3DProps> extends N
|
|
|
73
73
|
near: number | undefined;
|
|
74
74
|
far: number | undefined;
|
|
75
75
|
zoom: number | undefined;
|
|
76
|
+
/**
|
|
77
|
+
* Swing round {@link target}, and pull back or in, whichever are given. A
|
|
78
|
+
* camera not yet placed by its polar fields starts from what an unset one
|
|
79
|
+
* reads as.
|
|
80
|
+
*/
|
|
81
|
+
orbitTo(args: CommandArgs<{
|
|
82
|
+
orbit?: number;
|
|
83
|
+
elevation?: number;
|
|
84
|
+
distance?: number;
|
|
85
|
+
}> & {
|
|
86
|
+
duration: number;
|
|
87
|
+
}): Command<P>;
|
|
88
|
+
/** Turn to look at another point: animates {@link target}. */
|
|
89
|
+
lookTo(args: CommandArgs<{
|
|
90
|
+
target: Vector3Input;
|
|
91
|
+
}> & {
|
|
92
|
+
duration: number;
|
|
93
|
+
}): Command<P>;
|
|
76
94
|
/**
|
|
77
95
|
* A camera's group stays identity; the camera places itself.
|
|
78
96
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"camera-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/camera-nodes.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"camera-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/camera-nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAC9C,qDAAqD;IACrD,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAOD,qBAAa,QAAQ,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnE;;;;OAIG;IAQH,OAAO,CACH,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GACpG,OAAO,CAAC,CAAC,CAAC;IAiBb,8DAA8D;IAE9D,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAItF;;;;;;;;OAQG;cACgB,cAAc,IAAI,WAAW;IAIhD,SAAS,CAAC,WAAW,IAAI,YAAY;IASrC,4FAA4F;IACnF,aAAa,IAAI,IAAI;cAEX,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;CAG5D"}
|
|
@@ -5,12 +5,41 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
|
|
|
5
5
|
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
6
|
};
|
|
7
7
|
import { property } from "../../attributes/properties/decorator.js";
|
|
8
|
+
import { optionalVector3Property } from "../../attributes/properties/typed.js";
|
|
9
|
+
import { ORBIT_CAMERA_DEFAULTS } from "../../render3d/camera.js";
|
|
10
|
+
import { command } from "../../tween/command-decorator.js";
|
|
8
11
|
import { Node3D } from "./node3d.js";
|
|
9
12
|
const CAMERA_KEYS = [
|
|
10
13
|
"target", "orbit", "elevation", "distance",
|
|
11
14
|
"fov", "frustumHeight", "near", "far", "zoom",
|
|
12
15
|
];
|
|
13
16
|
export class Camera3D extends Node3D {
|
|
17
|
+
/**
|
|
18
|
+
* Swing round {@link target}, and pull back or in, whichever are given. A
|
|
19
|
+
* camera not yet placed by its polar fields starts from what an unset one
|
|
20
|
+
* reads as.
|
|
21
|
+
*/
|
|
22
|
+
orbitTo(args) {
|
|
23
|
+
const to = args.data ?? {};
|
|
24
|
+
const from = {
|
|
25
|
+
orbit: this.orbit ?? ORBIT_CAMERA_DEFAULTS.orbit,
|
|
26
|
+
elevation: this.elevation ?? ORBIT_CAMERA_DEFAULTS.elevation,
|
|
27
|
+
distance: this.distance ?? ORBIT_CAMERA_DEFAULTS.distance,
|
|
28
|
+
};
|
|
29
|
+
return this.command((t) => {
|
|
30
|
+
const out = {};
|
|
31
|
+
for (const key of ["orbit", "elevation", "distance"]) {
|
|
32
|
+
const end = to[key];
|
|
33
|
+
if (end !== undefined)
|
|
34
|
+
out[key] = from[key] + (end - from[key]) * t;
|
|
35
|
+
}
|
|
36
|
+
return out;
|
|
37
|
+
}, args.duration, args.easing);
|
|
38
|
+
}
|
|
39
|
+
/** Turn to look at another point: animates {@link target}. */
|
|
40
|
+
lookTo(args) {
|
|
41
|
+
return this.to({ data: args.data, duration: args.duration, easing: args.easing });
|
|
42
|
+
}
|
|
14
43
|
/**
|
|
15
44
|
* A camera's group stays identity; the camera places itself.
|
|
16
45
|
*
|
|
@@ -42,7 +71,7 @@ __decorate([
|
|
|
42
71
|
property({ default: "perspective" })
|
|
43
72
|
], Camera3D.prototype, "type", void 0);
|
|
44
73
|
__decorate([
|
|
45
|
-
|
|
74
|
+
optionalVector3Property("origin")
|
|
46
75
|
], Camera3D.prototype, "target", void 0);
|
|
47
76
|
__decorate([
|
|
48
77
|
property({ default: undefined })
|
|
@@ -68,4 +97,16 @@ __decorate([
|
|
|
68
97
|
__decorate([
|
|
69
98
|
property({ default: undefined })
|
|
70
99
|
], Camera3D.prototype, "zoom", void 0);
|
|
100
|
+
__decorate([
|
|
101
|
+
command({
|
|
102
|
+
args: [
|
|
103
|
+
{ key: "orbit", kind: "number", step: 1, unit: "°" },
|
|
104
|
+
{ key: "elevation", kind: "number", min: -89, max: 89, step: 1, unit: "°" },
|
|
105
|
+
{ key: "distance", kind: "number", min: 0.01, step: 0.1 },
|
|
106
|
+
],
|
|
107
|
+
})
|
|
108
|
+
], Camera3D.prototype, "orbitTo", null);
|
|
109
|
+
__decorate([
|
|
110
|
+
command({ args: ["target"] })
|
|
111
|
+
], Camera3D.prototype, "lookTo", null);
|
|
71
112
|
//# sourceMappingURL=camera-nodes.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"camera-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/camera-nodes.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAK7D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AA8DpD,MAAM,WAAW,GAAG;IAChB,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU;IAC1C,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CACvC,CAAC;AAEX,MAAM,OAAO,QAAkD,SAAQ,MAAS;IAc5E;;;;;;;;OAQG;IACgB,cAAc;QAC7B,OAAO,EAAE,CAAC;IACd,CAAC;IAES,WAAW;QACjB,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAI,IAA2C,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9C,CAAC;QACD,OAAO,GAA8B,CAAC;IAC1C,CAAC;IAED,4FAA4F;IACnF,aAAa,KAAW,CAAC;IAEf,UAAU,CAAC,GAAoB;QAC9C,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAkB,CAAC,CAAC;IACjF,CAAC;CACJ;AAzCiD;IAA7C,QAAQ,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;sCAAoC;AAE/B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;wCAA0C;AACjC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;uCAAmC;AAC1B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;2CAAuC;AAC9B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;0CAAsC;AAE7B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAiC;AACxB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;+CAA2C;AAClC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAkC;AACzB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAiC;AACxB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAkC","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport type { Transform3D } from \"@/render3d/transform\";\nimport type { CameraData3D } from \"@/render3d/camera\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\nimport type { Vector3Input } from \"@/render3d/vector3\";\nimport { Node3D, type Node3DProps } from \"./node3d\";\n\n/**\n * The camera — where the scene is viewed from.\n *\n * **One node, two projections.** `<Camera3D type=\"orthographic\">` is the flat\n * one; there is no second class, because a perspective and an orthographic\n * camera are one object with a projection setting, which is how every editor\n * presents it and how a scene switching between them has to be written.\n *\n * <Camera3D target={[0, 0.2, 0]} orbit={-18} elevation={12} distance={13} fov={42} />\n *\n * cam().to({ data: { orbit: 160, elevation: 30 }, duration: 4, easing: easeInOut(\"quad\") });\n *\n * ── Orbit, not trigonometry ───────────────────────────────────────────────────\n * `target`/`orbit`/`elevation`/`distance` place the camera in polar coordinates\n * around the thing it is looking at, which is what a camera move almost always\n * *is*. Written through `position` the same move is a `Math.sin`/`Math.cos` pair\n * recomputed every frame in a prop binding — which is exactly what every scene\n * did before this existed, and what the template's own `Graph3D` node\n * independently reinvented `orbit`/`elevation`/`zoom` props to avoid.\n *\n * `position` and `lookAt` still work and are right for a shot pinned to\n * something; setting any polar field takes over, so the two can never be half\n * applied. Either way the camera is a node, so parenting it to a moving\n * `Group3D` carries the shot with the rig.\n *\n * ── What is derived ───────────────────────────────────────────────────────────\n * `near`/`far` come from the scene's own bounds unless you set them, and the\n * aspect ratio always tracks the viewport's layout box — it was a prop whose\n * documentation said \"don't set this\", and setting it stretched the render.\n * An asymmetric orthographic frustum is a `params` override rather than four\n * more fields.\n *\n * A scene with no camera gets a sensible default framing. A scene that declares\n * more than one keeps the last, since there is only ever one view.\n */\nexport interface Camera3DProps extends Node3DProps {\n /** `\"perspective\"` (default) or `\"orthographic\"`. */\n type: CameraData3D[\"type\"];\n /**\n * The point the camera looks at, and orbits around.\n *\n * On its own it is `lookAt` under a name that reads right beside `orbit`;\n * together with any of the three below it is also the centre they turn about.\n */\n target: Vector3Input | undefined;\n /** Azimuth around {@link target}, in **degrees**. */\n orbit: number | undefined;\n /** Angle above the horizon, in **degrees**. */\n elevation: number | undefined;\n /** Distance from {@link target}. */\n distance: number | undefined;\n /** Perspective only: vertical field of view in **degrees**. Default 50. */\n fov: number | undefined;\n /** Orthographic only: visible world height. Default 10. */\n frustumHeight: number | undefined;\n near: number | undefined;\n far: number | undefined;\n zoom: number | undefined;\n}\n\nconst CAMERA_KEYS = [\n \"target\", \"orbit\", \"elevation\", \"distance\",\n \"fov\", \"frustumHeight\", \"near\", \"far\", \"zoom\",\n] as const;\n\nexport class Camera3D<P extends Camera3DProps = Camera3DProps> extends Node3D<P> {\n @property({ default: \"perspective\" }) declare type: CameraData3D[\"type\"];\n\n @property({ default: undefined }) declare target: Vector3Input | undefined;\n @property({ default: undefined }) declare orbit: number | undefined;\n @property({ default: undefined }) declare elevation: number | undefined;\n @property({ default: undefined }) declare distance: number | undefined;\n\n @property({ default: undefined }) declare fov: number | undefined;\n @property({ default: undefined }) declare frustumHeight: number | undefined;\n @property({ default: undefined }) declare near: number | undefined;\n @property({ default: undefined }) declare far: number | undefined;\n @property({ default: undefined }) declare zoom: number | undefined;\n\n /**\n * A camera's group stays identity; the camera places itself.\n *\n * three aims a camera's **-Z** at `lookAt` and a plain group's **+Z**, so a\n * camera sitting inside a group that carried its placement would face exactly\n * backwards. Putting the placement on the descriptor hands it to the camera\n * object itself, where `Object3D.lookAt` uses the camera convention — and it\n * is still parent-relative, so a camera inside a moving rig is carried by it.\n */\n protected override groupTransform(): Transform3D {\n return {};\n }\n\n protected buildCamera(): CameraData3D {\n const out: Record<string, unknown> = { type: this.type };\n for (const key of CAMERA_KEYS) {\n const value = (this as unknown as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n return out as unknown as CameraData3D;\n }\n\n /** Loads nothing — and recording `renderSelf` would make every orbit tween a dependency. */\n override declareAssets(): void { }\n\n protected override renderSelf(ctx: RenderContext3D): void {\n ctx.camera({ ...this.transform3D(), ...this.buildCamera() } as CameraData3D);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"camera-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/camera-nodes.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,EAAE,qBAAqB,EAAqB,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AA6DpD,MAAM,WAAW,GAAG;IAChB,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU;IAC1C,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CACvC,CAAC;AAEX,MAAM,OAAO,QAAkD,SAAQ,MAAS;IAc5E;;;;OAIG;IAQH,OAAO,CACH,IAAmG;QAEnG,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG;YACT,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC,KAAK;YAChD,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,qBAAqB,CAAC,SAAS;YAC5D,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,qBAAqB,CAAC,QAAQ;SAC5D,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAI,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAU,EAAE,CAAC;gBAC5D,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;gBACpB,IAAI,GAAG,KAAK,SAAS;oBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,GAAiB,CAAC;QAC7B,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,8DAA8D;IAE9D,MAAM,CAAC,IAAkE;QACrE,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAkB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;;;;;;OAQG;IACgB,cAAc;QAC7B,OAAO,EAAE,CAAC;IACd,CAAC;IAES,WAAW;QACjB,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAI,IAA2C,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9C,CAAC;QACD,OAAO,GAA8B,CAAC;IAC1C,CAAC;IAED,4FAA4F;IACnF,aAAa,KAAW,CAAC;IAEf,UAAU,CAAC,GAAoB;QAC9C,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAkB,CAAC,CAAC;IACjF,CAAC;CACJ;AA9EiD;IAA7C,QAAQ,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;sCAAoC;AAE9B;IAA1C,uBAAuB,CAAC,QAAQ,CAAC;wCAA0C;AAClC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;uCAAmC;AAC1B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;2CAAuC;AAC9B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;0CAAsC;AAE7B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAiC;AACxB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;+CAA2C;AAClC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAkC;AACzB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAiC;AACxB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAkC;AAcnE;IAPC,OAAO,CAAC;QACL,IAAI,EAAE;YACF,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACpD,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YAC3E,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;SAC5D;KACJ,CAAC;uCAkBD;AAID;IADC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;sCAG7B","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { optionalVector3Property } from \"@/attributes/properties/typed\";\r\nimport type { Transform3D } from \"@/render3d/transform\";\r\nimport { ORBIT_CAMERA_DEFAULTS, type CameraData3D } from \"@/render3d/camera\";\r\nimport type { Command, CommandArgs } from \"@/tween/command\";\r\nimport { command } from \"@/tween/command-decorator\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\nimport type { Vector3Input } from \"@/render3d/vector3\";\r\nimport { Node3D, type Node3DProps } from \"./node3d\";\r\n\r\n/**\r\n * The camera — where the scene is viewed from.\r\n *\r\n * **One node, two projections.** `<Camera3D type=\"orthographic\">` is the flat\r\n * one; there is no second class, because a perspective and an orthographic\r\n * camera are one object with a projection setting, which is how every editor\r\n * presents it and how a scene switching between them has to be written.\r\n *\r\n * <Camera3D target={[0, 0.2, 0]} orbit={-18} elevation={12} distance={13} fov={42} />\r\n *\r\n * cam().to({ data: { orbit: 160, elevation: 30 }, duration: 4, easing: easeInOut(\"quad\") });\r\n *\r\n * ── Orbit, not trigonometry ───────────────────────────────────────────────────\r\n * `target`/`orbit`/`elevation`/`distance` place the camera in polar coordinates\r\n * around the thing it is looking at, which is what a camera move almost always\r\n * *is*. Written through `position` the same move is a `Math.sin`/`Math.cos` pair\r\n * recomputed every frame in a prop binding — which is exactly what every scene\r\n * did before this existed.\r\n *\r\n * `position` and `lookAt` still work and are right for a shot pinned to\r\n * something; setting any polar field takes over, so the two can never be half\r\n * applied. Either way the camera is a node, so parenting it to a moving\r\n * `Group3D` carries the shot with the rig.\r\n *\r\n * ── What is derived ───────────────────────────────────────────────────────────\r\n * `near`/`far` come from the scene's own bounds unless you set them, and the\r\n * aspect ratio always tracks the viewport's layout box — it was a prop whose\r\n * documentation said \"don't set this\", and setting it stretched the render.\r\n * An asymmetric orthographic frustum is a `params` override rather than four\r\n * more fields.\r\n *\r\n * A scene with no camera gets a sensible default framing. A scene that declares\r\n * more than one keeps the last, since there is only ever one view.\r\n */\r\nexport interface Camera3DProps extends Node3DProps {\r\n /** `\"perspective\"` (default) or `\"orthographic\"`. */\r\n type: CameraData3D[\"type\"];\r\n /**\r\n * The point the camera looks at, and orbits around.\r\n *\r\n * On its own it is `lookAt` under a name that reads right beside `orbit`;\r\n * together with any of the three below it is also the centre they turn about.\r\n */\r\n target: Vector3Input | undefined;\r\n /** Azimuth around {@link target}, in **degrees**. */\r\n orbit: number | undefined;\r\n /** Angle above the horizon, in **degrees**. */\r\n elevation: number | undefined;\r\n /** Distance from {@link target}. */\r\n distance: number | undefined;\r\n /** Perspective only: vertical field of view in **degrees**. Default 50. */\r\n fov: number | undefined;\r\n /** Orthographic only: visible world height. Default 10. */\r\n frustumHeight: number | undefined;\r\n near: number | undefined;\r\n far: number | undefined;\r\n zoom: number | undefined;\r\n}\r\n\r\nconst CAMERA_KEYS = [\r\n \"target\", \"orbit\", \"elevation\", \"distance\",\r\n \"fov\", \"frustumHeight\", \"near\", \"far\", \"zoom\",\r\n] as const;\r\n\r\nexport class Camera3D<P extends Camera3DProps = Camera3DProps> extends Node3D<P> {\r\n @property({ default: \"perspective\" }) declare type: CameraData3D[\"type\"];\r\n\r\n @optionalVector3Property(\"origin\") declare target: Vector3Input | undefined;\r\n @property({ default: undefined }) declare orbit: number | undefined;\r\n @property({ default: undefined }) declare elevation: number | undefined;\r\n @property({ default: undefined }) declare distance: number | undefined;\r\n\r\n @property({ default: undefined }) declare fov: number | undefined;\r\n @property({ default: undefined }) declare frustumHeight: number | undefined;\r\n @property({ default: undefined }) declare near: number | undefined;\r\n @property({ default: undefined }) declare far: number | undefined;\r\n @property({ default: undefined }) declare zoom: number | undefined;\r\n\r\n /**\r\n * Swing round {@link target}, and pull back or in, whichever are given. A\r\n * camera not yet placed by its polar fields starts from what an unset one\r\n * reads as.\r\n */\r\n @command({\r\n args: [\r\n { key: \"orbit\", kind: \"number\", step: 1, unit: \"°\" },\r\n { key: \"elevation\", kind: \"number\", min: -89, max: 89, step: 1, unit: \"°\" },\r\n { key: \"distance\", kind: \"number\", min: 0.01, step: 0.1 },\r\n ],\r\n })\r\n orbitTo(\r\n args: CommandArgs<{ orbit?: number; elevation?: number; distance?: number }> & { duration: number },\r\n ): Command<P> {\r\n const to = args.data ?? {};\r\n const from = {\r\n orbit: this.orbit ?? ORBIT_CAMERA_DEFAULTS.orbit,\r\n elevation: this.elevation ?? ORBIT_CAMERA_DEFAULTS.elevation,\r\n distance: this.distance ?? ORBIT_CAMERA_DEFAULTS.distance,\r\n };\r\n return this.command<P>((t) => {\r\n const out: Record<string, number> = {};\r\n for (const key of [\"orbit\", \"elevation\", \"distance\"] as const) {\r\n const end = to[key];\r\n if (end !== undefined) out[key] = from[key] + (end - from[key]) * t;\r\n }\r\n return out as Partial<P>;\r\n }, args.duration, args.easing);\r\n }\r\n\r\n /** Turn to look at another point: animates {@link target}. */\r\n @command({ args: [\"target\"] })\r\n lookTo(args: CommandArgs<{ target: Vector3Input }> & { duration: number }): Command<P> {\r\n return this.to({ data: args.data as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /**\r\n * A camera's group stays identity; the camera places itself.\r\n *\r\n * three aims a camera's **-Z** at `lookAt` and a plain group's **+Z**, so a\r\n * camera sitting inside a group that carried its placement would face exactly\r\n * backwards. Putting the placement on the descriptor hands it to the camera\r\n * object itself, where `Object3D.lookAt` uses the camera convention — and it\r\n * is still parent-relative, so a camera inside a moving rig is carried by it.\r\n */\r\n protected override groupTransform(): Transform3D {\r\n return {};\r\n }\r\n\r\n protected buildCamera(): CameraData3D {\r\n const out: Record<string, unknown> = { type: this.type };\r\n for (const key of CAMERA_KEYS) {\r\n const value = (this as unknown as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n return out as unknown as CameraData3D;\r\n }\r\n\r\n /** Loads nothing — and recording `renderSelf` would make every orbit tween a dependency. */\r\n override declareAssets(): void { }\r\n\r\n protected override renderSelf(ctx: RenderContext3D): void {\r\n ctx.camera({ ...this.transform3D(), ...this.buildCamera() } as CameraData3D);\r\n }\r\n}\r\n"]}
|
|
@@ -2,10 +2,11 @@ import { RenderContext2D } from "../../render/render-context2d.js";
|
|
|
2
2
|
import { Scene3D } from "../../render3d/scene3d.js";
|
|
3
3
|
import { type PostEffect3D, type Shadows3D, type ToneMapping3D } from "../../render3d/scene-settings.js";
|
|
4
4
|
import type { Color } from "../../attributes/shape/fill/color/parser.js";
|
|
5
|
+
import type { Command, CommandArgs } from "../../tween/command.js";
|
|
5
6
|
import type { AssetScope } from "../../assets/scope.js";
|
|
6
7
|
import { Rect, RectProps } from "../geometry/rect-node.js";
|
|
7
|
-
import { Node, NodeConfig } from "../../nodes/node/node.js";
|
|
8
|
-
import { Node3D } from "./node3d.js";
|
|
8
|
+
import { Node, NodeConfig, type NodeDimension } from "../../nodes/node/node.js";
|
|
9
|
+
import { Node3D, type ChildSpace3D } from "./node3d.js";
|
|
9
10
|
export interface Canvas3DProps extends RectProps {
|
|
10
11
|
/**
|
|
11
12
|
* Ceiling on the 3D buffer's device-pixel ratio. Default 2.
|
|
@@ -35,6 +36,10 @@ export interface Canvas3DProps extends RectProps {
|
|
|
35
36
|
* blur and the rest of the 2D `effects` chain already run over the composited
|
|
36
37
|
* result. What is here is what genuinely needs the depth buffer, object ids,
|
|
37
38
|
* or HDR radiance before tone mapping.
|
|
39
|
+
*
|
|
40
|
+
* **Inert today**: the chain is recorded on the scene and no pass is applied,
|
|
41
|
+
* so a viewport with `post` renders exactly like one without (the first one
|
|
42
|
+
* set warns in development). Use the viewport's 2D `effects` instead.
|
|
38
43
|
*/
|
|
39
44
|
post: PostEffect3D | readonly PostEffect3D[];
|
|
40
45
|
/**
|
|
@@ -42,8 +47,7 @@ export interface Canvas3DProps extends RectProps {
|
|
|
42
47
|
*
|
|
43
48
|
* A host that renders a **timeline** needs a camera a `to` command can tween
|
|
44
49
|
* and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes
|
|
45
|
-
* the same values the timeline reads.
|
|
46
|
-
* this vocabulary for the same reason. Only read when the scene contains no
|
|
50
|
+
* the same values the timeline reads. Only read when the scene contains no
|
|
47
51
|
* camera of its own, so a `<Camera3D>` child still wins.
|
|
48
52
|
*/
|
|
49
53
|
/** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */
|
|
@@ -92,7 +96,7 @@ export interface Canvas3DProps extends RectProps {
|
|
|
92
96
|
* make that impossible is for there to be nothing to keep in step: see
|
|
93
97
|
* {@link Canvas3DView.fadeColor}.
|
|
94
98
|
*
|
|
95
|
-
* The same rule
|
|
99
|
+
* The same rule the engine applies to fog with no colour of its own, one
|
|
96
100
|
* layer down (`Canvas3D.buildScene3D`), and for the same reason.
|
|
97
101
|
*/
|
|
98
102
|
gridFadeColor: Color;
|
|
@@ -162,7 +166,7 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
|
|
|
162
166
|
* Each default is applied only when the walk left that slot empty, so a
|
|
163
167
|
* `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the
|
|
164
168
|
* node's own props rather than being silently overwritten by them — which is
|
|
165
|
-
* the behaviour that lets this class stop being special the day
|
|
169
|
+
* the behaviour that lets this class stop being special the day an editor
|
|
166
170
|
* offers those as node types.
|
|
167
171
|
*/
|
|
168
172
|
/**
|
|
@@ -189,7 +193,7 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
|
|
|
189
193
|
* leaves {@link Canvas3DProps.gridFadeColor} standing, rather than
|
|
190
194
|
* inventing black.
|
|
191
195
|
*
|
|
192
|
-
* Restated here rather than imported because
|
|
196
|
+
* Restated here rather than imported because the engine's own copy (used
|
|
193
197
|
* for fog, in `Canvas3D.buildScene3D`) is a module-private function. The
|
|
194
198
|
* duplication is small and deliberate — the alternative was a second control
|
|
195
199
|
* the author had to keep in step with the fill, which is exactly what this
|
|
@@ -204,6 +208,18 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
|
|
|
204
208
|
exposure: number | undefined;
|
|
205
209
|
post: PostEffect3D | readonly PostEffect3D[] | undefined;
|
|
206
210
|
constructor(props?: NodeConfig<Canvas3D<P>, P>);
|
|
211
|
+
/**
|
|
212
|
+
* Swing the default camera round the scene and pull it back or in,
|
|
213
|
+
* whichever are given. `zoom` is its distance, as the prop is. A scene with
|
|
214
|
+
* a `Camera3D` of its own is framed by that camera's `orbitTo` instead.
|
|
215
|
+
*/
|
|
216
|
+
orbitTo(args: CommandArgs<{
|
|
217
|
+
orbit?: number;
|
|
218
|
+
elevation?: number;
|
|
219
|
+
zoom?: number;
|
|
220
|
+
}> & {
|
|
221
|
+
duration: number;
|
|
222
|
+
}): Command<P>;
|
|
207
223
|
/**
|
|
208
224
|
* Accept both dimensions — the only node that does.
|
|
209
225
|
*
|
|
@@ -211,6 +227,14 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
|
|
|
211
227
|
* (see {@link Node.acceptsChild}); here it is the entire point.
|
|
212
228
|
*/
|
|
213
229
|
protected acceptsChild(child: Node): boolean;
|
|
230
|
+
get _childTrees(): readonly NodeDimension[];
|
|
231
|
+
/**
|
|
232
|
+
* The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the
|
|
233
|
+
* default) when they are the scene's own. A viewport that is a graph answers
|
|
234
|
+
* with the graph's units. See {@link ChildSpace3D}.
|
|
235
|
+
*/
|
|
236
|
+
/** @internal */
|
|
237
|
+
_spaceOf(_child: Node3D | null): ChildSpace3D | null;
|
|
214
238
|
/** This node's children that describe the 3D scene. */
|
|
215
239
|
get children3D(): Node3D[];
|
|
216
240
|
/**
|
|
@@ -250,6 +274,7 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
|
|
|
250
274
|
* state rather than a cache a scrub could leave behind.
|
|
251
275
|
*/
|
|
252
276
|
/** @internal */
|
|
277
|
+
_isViewport3D(): boolean;
|
|
253
278
|
_scene3D(): Scene3D;
|
|
254
279
|
/**
|
|
255
280
|
* The 3D runtime. The scene's resources are its `Node3D` children's to declare;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canvas3d-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAEH,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EACxD,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;
|
|
1
|
+
{"version":3,"file":"canvas3d-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,6 +14,7 @@ import { cameraOrbit, lerpColor3D, resolveColor3D } from "../../attributes/rende
|
|
|
14
14
|
import { gridGeometry3D } from "./grid-geometry3d.js";
|
|
15
15
|
import { Fills, resolveChainFill } from "../../attributes/shape/fill/chain.js";
|
|
16
16
|
import { property } from "../../attributes/properties/decorator.js";
|
|
17
|
+
import { command } from "../../tween/command-decorator.js";
|
|
17
18
|
import { declare3DResources } from "../../render3d/tracking.js";
|
|
18
19
|
import { Rect } from "../geometry/rect-node.js";
|
|
19
20
|
import { Node3D } from "./node3d.js";
|
|
@@ -66,7 +67,7 @@ export class Canvas3D extends Rect {
|
|
|
66
67
|
* Each default is applied only when the walk left that slot empty, so a
|
|
67
68
|
* `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the
|
|
68
69
|
* node's own props rather than being silently overwritten by them — which is
|
|
69
|
-
* the behaviour that lets this class stop being special the day
|
|
70
|
+
* the behaviour that lets this class stop being special the day an editor
|
|
70
71
|
* offers those as node types.
|
|
71
72
|
*/
|
|
72
73
|
/**
|
|
@@ -93,7 +94,7 @@ export class Canvas3D extends Rect {
|
|
|
93
94
|
* leaves {@link Canvas3DProps.gridFadeColor} standing, rather than
|
|
94
95
|
* inventing black.
|
|
95
96
|
*
|
|
96
|
-
* Restated here rather than imported because
|
|
97
|
+
* Restated here rather than imported because the engine's own copy (used
|
|
97
98
|
* for fog, in `Canvas3D.buildScene3D`) is a module-private function. The
|
|
98
99
|
* duplication is small and deliberate — the alternative was a second control
|
|
99
100
|
* the author had to keep in step with the fill, which is exactly what this
|
|
@@ -141,6 +142,18 @@ export class Canvas3D extends Rect {
|
|
|
141
142
|
constructor(props) {
|
|
142
143
|
super((props ?? {}));
|
|
143
144
|
}
|
|
145
|
+
/**
|
|
146
|
+
* Swing the default camera round the scene and pull it back or in,
|
|
147
|
+
* whichever are given. `zoom` is its distance, as the prop is. A scene with
|
|
148
|
+
* a `Camera3D` of its own is framed by that camera's `orbitTo` instead.
|
|
149
|
+
*/
|
|
150
|
+
orbitTo(args) {
|
|
151
|
+
const data = {};
|
|
152
|
+
for (const [key, value] of Object.entries(args.data ?? {}))
|
|
153
|
+
if (value !== undefined)
|
|
154
|
+
data[key] = value;
|
|
155
|
+
return this.to({ data: data, duration: args.duration, easing: args.easing });
|
|
156
|
+
}
|
|
144
157
|
/**
|
|
145
158
|
* Accept both dimensions — the only node that does.
|
|
146
159
|
*
|
|
@@ -150,6 +163,18 @@ export class Canvas3D extends Rect {
|
|
|
150
163
|
acceptsChild(child) {
|
|
151
164
|
return true;
|
|
152
165
|
}
|
|
166
|
+
get _childTrees() {
|
|
167
|
+
return ["2d", "3d"];
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the
|
|
171
|
+
* default) when they are the scene's own. A viewport that is a graph answers
|
|
172
|
+
* with the graph's units. See {@link ChildSpace3D}.
|
|
173
|
+
*/
|
|
174
|
+
/** @internal */
|
|
175
|
+
_spaceOf(_child) {
|
|
176
|
+
return null;
|
|
177
|
+
}
|
|
153
178
|
/** This node's children that describe the 3D scene. */
|
|
154
179
|
get children3D() {
|
|
155
180
|
return this._allChildren.filter((c) => c instanceof Node3D);
|
|
@@ -227,6 +252,17 @@ export class Canvas3D extends Rect {
|
|
|
227
252
|
},
|
|
228
253
|
}));
|
|
229
254
|
}
|
|
255
|
+
// A viewport holding only 2D children (a HUD) has nothing to frame or to
|
|
256
|
+
// light. Without this the default camera and rig made every scene
|
|
257
|
+
// non-empty, so `renderSelf` ran a full 3D pass and created the WebGL
|
|
258
|
+
// context to paint nothing. A subclass overriding `buildScene3D` is
|
|
259
|
+
// exempt: it adds its own content after `super` returns and relies on the
|
|
260
|
+
// rig being there.
|
|
261
|
+
if (this.buildScene3D === Canvas3D.prototype.buildScene3D &&
|
|
262
|
+
scene.isEmpty() &&
|
|
263
|
+
!this._children.some((child) => child instanceof Node3D)) {
|
|
264
|
+
return scene;
|
|
265
|
+
}
|
|
230
266
|
if (scene.cameraDescriptor() === null) {
|
|
231
267
|
// Polar placement is the camera's own vocabulary now, so the viewport's
|
|
232
268
|
// orbit/elevation/zoom pass straight through instead of being converted to
|
|
@@ -284,6 +320,9 @@ export class Canvas3D extends Rect {
|
|
|
284
320
|
* state rather than a cache a scrub could leave behind.
|
|
285
321
|
*/
|
|
286
322
|
/** @internal */
|
|
323
|
+
_isViewport3D() {
|
|
324
|
+
return true;
|
|
325
|
+
}
|
|
287
326
|
_scene3D() {
|
|
288
327
|
return this.buildScene3D();
|
|
289
328
|
}
|
|
@@ -416,6 +455,15 @@ __decorate([
|
|
|
416
455
|
__decorate([
|
|
417
456
|
property({ default: undefined })
|
|
418
457
|
], Canvas3D.prototype, "post", void 0);
|
|
458
|
+
__decorate([
|
|
459
|
+
command({
|
|
460
|
+
args: [
|
|
461
|
+
{ key: "orbit", kind: "number", step: 1, unit: "°" },
|
|
462
|
+
{ key: "elevation", kind: "number", min: -89, max: 89, step: 1, unit: "°" },
|
|
463
|
+
{ key: "zoom", kind: "number", min: 0.01, step: 0.1 },
|
|
464
|
+
],
|
|
465
|
+
})
|
|
466
|
+
], Canvas3D.prototype, "orbitTo", null);
|
|
419
467
|
/**
|
|
420
468
|
* The colour a fill chain reads as, for anything that has to match it.
|
|
421
469
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canvas3d-node.js","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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","sourcesContent":["import { RenderContext2D } from \"@/render/render-context2d\";\nimport { Scene3D } from \"@/render3d/scene3d\";\nimport {\n resolveShadows3D,\n type PostEffect3D, type Shadows3D, type ToneMapping3D,\n} from \"@/render3d/scene-settings\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\nimport { warmCanvas3D } from \"@/render3d/resources\";\nimport { forEachTexture3D } from \"@/render3d/walk\";\nimport { isSurfaceTexture3D, resolveSurfaceSource } from \"@/render3d/texture\";\nimport { Graphics3D } from \"@/render3d/graphics3d\";\nimport type { BufferGeometry3D } from \"@/render3d/geometry\";\nimport { cameraOrbit, lerpColor3D, resolveColor3D } from \"@/attributes/render3d/orbit\";\nimport { gridGeometry3D, type Grid3DOptions } from \"./grid-geometry3d\";\nimport { Fills, resolveChainFill } from \"@/attributes/shape/fill/chain\";\nimport { property } from \"@/attributes/properties/decorator\";\nimport { declare3DResources } from \"@/render3d/tracking\";\nimport type { AssetScope } from \"@/assets/scope\";\nimport type { LoaderFn } from \"@/assets/record\";\nimport { Rect, RectProps } from \"../geometry/rect-node\";\nimport { Node, NodeConfig } from \"@/nodes/node/node\";\nimport { Node3D } from \"./node3d\";\n\n// `warmCanvas3D` returns `void` when no backend registered a runtime, so it can't\n// be a loader bare. One function for every declaration keeps the key's loader stable.\nconst loadThreeRuntime: LoaderFn = async () => { await warmCanvas3D(); };\n\nexport interface Canvas3DProps extends RectProps {\n /**\n * Ceiling on the 3D buffer's device-pixel ratio. Default 2.\n *\n * Lower it for an expensive scene: the 3D renders at a smaller buffer and is\n * scaled up on composite, which trades sharpness for fill rate.\n */\n maxPixelRatio: number;\n /** Multisample the 3D pass. Default true. */\n antialias: boolean;\n /**\n * Turn shadow casting on for the scene. A switch, or `{ quality }`.\n *\n * A render setting rather than a scene object, which is why it is a prop here\n * and not a `<Shadows3D>` node: it has no position, and two of them in a tree\n * meant one silently doing nothing.\n */\n shadows: Shadows3D;\n /** How HDR colour is compressed to what the screen can show. Default `\"aces\"`. */\n tone: ToneMapping3D;\n /** Stops of exposure applied before tone mapping. Default 1. */\n exposure: number;\n /**\n * Post-processing inside the 3D composite: `bloom`, `ssao`, `dof`, `outline`.\n *\n * Short by design — a `Canvas3D` is a `Node2D`, so vignette, grain, grading,\n * blur and the rest of the 2D `effects` chain already run over the composited\n * result. What is here is what genuinely needs the depth buffer, object ids,\n * or HDR radiance before tone mapping.\n */\n post: PostEffect3D | readonly PostEffect3D[];\n /**\n * The camera, as three numbers rather than a `<Camera3D>` child.\n *\n * A host that renders a **timeline** needs a camera a `to` command can tween\n * and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes\n * the same values the timeline reads. `Graph3D` and `Protein` already carry\n * this vocabulary for the same reason. Only read when the scene contains no\n * camera of its own, so a `<Camera3D>` child still wins.\n */\n\n /** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */\n orbit: number;\n /** Camera elevation above the ground plane, in **degrees**. */\n elevation: number;\n /** Camera distance from the origin, in scene units. */\n zoom: number;\n /** Vertical field of view, in **degrees**. */\n fov: number;\n /** Strength of the ambient fill. */\n ambientIntensity: number;\n /** Colour of the ambient fill. White leaves the meshes' own colours alone. */\n ambientColor: Color;\n /** Strength of the key light; the rim light is derived from it. */\n keyIntensity: number;\n /** Colour of the key light, and of the rim derived from it. */\n keyColor: Color;\n\n /**\n * Whether the ground plane is drawn. **Off by default** — it is an authoring\n * reference rather than part of the picture; see the property below.\n */\n showGrid: boolean;\n /** Total extent of the grid, in scene units. */\n gridSize: number;\n /** How many cells across it. */\n gridDivisions: number;\n /** Every Nth line is drawn heavier. */\n gridMajorEvery: number;\n gridColor: Color;\n gridMajorColor: Color;\n /** Whether the two coloured axis lines are drawn. Off by default, as above. */\n showAxes: boolean;\n axisXColor: Color;\n axisZColor: Color;\n /** How much of the way to the edge the grid has faded out, in `[0, 1]`. */\n gridFade: number;\n /**\n * What the grid fades into, when the node's own fills do not answer.\n *\n * **Derived, not authored.** The horizon dissolves into the first solid layer\n * of this node's `fill` — the viewport's background — and falls back to this\n * only when the stack has no solid in it to read (an empty stack, or a\n * gradient or image on its own). A grid that faded into a *different* colour\n * than the one behind it would ring the horizon with a halo, and the way to\n * make that impossible is for there to be nothing to keep in step: see\n * {@link Canvas3DView.fadeColor}.\n *\n * The same rule motion-script applies to fog with no colour of its own, one\n * layer down (`Canvas3D.buildScene3D`), and for the same reason.\n */\n gridFadeColor: Color;\n}\n\n/**\n * A 3D viewport in the 2D document — the one node that holds both dimensions.\n *\n * `Canvas3D` is a {@link Rect} that partitions its children by which tree they\n * belong to. `Node3D` children describe a scene: they are walked through a\n * {@link Scene3D} every frame and the result is painted through this rect's own\n * path. `Node2D` children are ordinary children and draw *over* the 3D, which is\n * how a HUD is written.\n *\n * <Canvas3D width=\"fill\" height=\"fill\" cornerRadius={24} fill=\"#0b0d12\" shadows>\n * <Camera3D orbit={-18} elevation={12} distance={13} fov={45} />\n * <AmbientLight3D intensity={0.4} />\n * <DirectionalLight3D intensity={2.4} position={[4, 6, 3]} shadow />\n * <Fog3D near={5} far={30} />\n *\n * <Group3D ref={rig}>\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\n * </Group3D>\n *\n * <Text text=\"FPS 60\" fontSize={32} /> // a 2D HUD, over the 3D\n * </Canvas3D>\n *\n * Being a `Rect` is what makes it lay out in flex/stack groups, take\n * `cornerRadius`/`clip`, be masked, blended and filtered. The 3D is one more\n * fill layer, so the author's own `fill` paints *beneath* it and `stroke` and\n * `overlay` still paint over everything.\n *\n * **That fill is also the background.** There is no `<Background3D>`: three's\n * background pass is unaffected by every light and by fog, the renderer clears\n * transparent, and this node already composites the 3D over its own fill layers —\n * so a solid colour, a gradient, an image or a video behind a 3D scene is the\n * ordinary 2D fill chain, which does strictly more. What genuinely needs the 3D\n * pass is a sky that reprojects as the camera turns, and that is\n * `<Environment3D background>`.\n *\n * The scene is a value, not machinery: the same recorded {@link Scene3D} can be\n * built by hand and used as a fill on any shape, which is how 3D is painted\n * through glyphs or an arbitrary path (`<Text fill={scene} />`).\n */\nexport class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends Rect<P> {\n\n @property({ default: 35 }) declare orbit: number;\n @property({ default: 20 }) declare elevation: number;\n @property({ default: 12 }) declare zoom: number;\n @property({ default: 45 }) declare fov: number;\n\n @property({ default: 0.45 }) declare ambientIntensity: number;\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\n declare ambientColor: Color;\n @property({ default: 2.4 }) declare keyIntensity: number;\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\n declare keyColor: Color;\n\n // Off by default, both of them: the grid and the axes are **reference**, and\n // reference belongs to whoever is authoring rather than to whoever is\n // watching. The studio's 3D view turns them on for the viewport it is a room\n // for and nothing else does — see `BuildSceneOptions.focusCanvas3dId`, and\n // note that the export goes through the same builder with that option unset.\n @property({ default: false }) declare showGrid: boolean;\n @property({ default: 40 }) declare gridSize: number;\n @property({ default: 40 }) declare gridDivisions: number;\n @property({ default: 5 }) declare gridMajorEvery: number;\n @property({ default: \"#26292f\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridColor: Color;\n @property({ default: \"#363a42\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridMajorColor: Color;\n @property({ default: false }) declare showAxes: boolean;\n @property({ default: \"#c8404f\", mapper: resolveColor3D, tween: lerpColor3D })\n declare axisXColor: Color;\n @property({ default: \"#2f6fd0\", mapper: resolveColor3D, tween: lerpColor3D })\n declare axisZColor: Color;\n @property({ default: 0.55 }) declare gridFade: number;\n @property({ default: \"#0b0d12\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridFadeColor: Color;\n\n\n /**\n * The children's scene, plus whatever it did not already state.\n *\n * Each default is applied only when the walk left that slot empty, so a\n * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the\n * node's own props rather than being silently overwritten by them — which is\n * the behaviour that lets this class stop being special the day the studio\n * offers those as node types.\n */\n /**\n * The grid geometry, rebuilt only when one of its fields moves.\n *\n * A `Scene3D` is recorded from scratch every frame, which is what makes the\n * whole design seekable — but the grid is thousands of floats and depends on\n * nothing that changes between frames. Caching it here is what lets the\n * descriptor claim `staticData`: the renderer compares buffers by identity, so\n * handing it the *same* arrays is the difference between one upload and sixty\n * a second.\n *\n * Keyed by the fields themselves rather than by a dirty flag, so a tween\n * through `gridFade` still rebuilds and nothing has to remember to invalidate.\n */\n private gridCache: { key: string; geometry: BufferGeometry3D } | null = null;\n\n /**\n * The colour a receding grid line ends up at: the background it is drawn on.\n *\n * The first **opaque solid** layer of the fill stack, which is what a\n * background stack is built on — everything above it is a gradient, an image\n * or a video painted over a base colour, and it is that base a surface\n * disappearing into the distance has to match. A stack with no solid in it\n * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than\n * inventing black.\n *\n * Restated here rather than imported because motion-script's own copy (used\n * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The\n * duplication is small and deliberate — the alternative was a second control\n * the author had to keep in step with the fill, which is exactly what this\n * node used to have.\n */\n private fadeColor(): Color {\n const layers = this.fill as unknown;\n if (Array.isArray(layers)) {\n for (const layer of layers) {\n const paint = layer as { type?: string; color?: unknown } | null;\n if (paint?.type !== \"solid\") continue;\n const color = paint.color;\n // A `Color` is a string or a normalized tuple, and the grid takes\n // either — but the tuple's fourth channel is what says whether this\n // layer covers anything, so a transparent \"solid\" is passed over rather\n // than faded into.\n if (typeof color === \"string\") return color;\n if (Array.isArray(color) && (color[3] ?? 1) > 0) return color as Color;\n }\n }\n return this.gridFadeColor;\n }\n\n private gridDescriptor(): BufferGeometry3D {\n const options: Grid3DOptions = {\n size: this.gridSize,\n divisions: Math.max(1, Math.round(this.gridDivisions)),\n majorEvery: Math.max(1, Math.round(this.gridMajorEvery)),\n minorColor: this.gridColor,\n majorColor: this.gridMajorColor,\n axisXColor: this.axisXColor,\n axisZColor: this.axisZColor,\n showAxes: this.showAxes,\n fadeTo: this.fadeColor(),\n fade: this.gridFade,\n };\n\n const key = JSON.stringify(options);\n if (this.gridCache?.key !== key) {\n this.gridCache = { key, geometry: gridGeometry3D(options) };\n }\n return this.gridCache.geometry;\n }\n\n\n\n\n @property({ default: 2 }) declare maxPixelRatio: number;\n @property({ default: true }) declare antialias: boolean;\n @property({ default: false }) declare shadows: Shadows3D;\n @property({ default: undefined }) declare tone: ToneMapping3D | undefined;\n @property({ default: undefined }) declare exposure: number | undefined;\n @property({ default: undefined }) declare post: PostEffect3D | readonly PostEffect3D[] | undefined;\n\n constructor(props?: NodeConfig<Canvas3D<P>, P>) {\n super((props ?? {}) as NodeConfig<any, P>);\n }\n\n /**\n * Accept both dimensions — the only node that does.\n *\n * Everywhere else a mixed tree is a mistake that would silently draw nothing\n * (see {@link Node.acceptsChild}); here it is the entire point.\n */\n protected override acceptsChild(child: Node): boolean {\n return true;\n }\n\n /** This node's children that describe the 3D scene. */\n get children3D(): Node3D[] {\n return this._allChildren.filter((c): c is Node3D => c instanceof Node3D);\n }\n\n /**\n * A 3D viewport has no intrinsic size and shouldn't be sized by its overlay\n * children — hugging a HUD label would collapse the viewport to the size of\n * the text. So it fills unless given an explicit size, whether or not it has\n * children (which is where this diverges from {@link Rect}).\n */\n protected override applyDefaultSize(props?: NodeConfig<any, P>): void {\n if (!props || props.width === undefined) this.applyProp(\"width\", \"fill\");\n if (!props || props.height === undefined) this.applyProp(\"height\", \"fill\");\n }\n\n /**\n * Record this frame's scene by walking the 3D children.\n *\n * The single seam both the real render and the asset-declaration pass go\n * through, so what gets loaded can never drift from what gets drawn. Override\n * it in a subclass for a reusable 3D component that builds its scene some\n * other way.\n *\n * Called inside the synchronous render pass, after the frame's state has been\n * evaluated and layout resolved, so every prop read here samples the\n * *current* frame. That is what makes a 3D scene seekable: frame N is\n * identical whether it was reached by playing forward or by scrubbing\n * backwards, because nothing accumulates.\n */\n protected buildScene3D(): Scene3D {\n const scene = new Scene3D();\n\n // The viewport's own render settings go on first, so a node in the tree\n // can still override one — the same last-writer-wins rule the scene\n // settings have always had, with the viewport as the first writer.\n const shadows = resolveShadows3D(this.shadows);\n if (shadows) scene.shadows(shadows);\n if (this.tone !== undefined || this.exposure !== undefined) {\n scene.tone({ mapping: this.tone, exposure: this.exposure });\n }\n if (this.post !== undefined) scene.post(this.post);\n\n for (const child of this._children) {\n if (child instanceof Node3D) child.render(scene);\n }\n\n // Fog with no colour of its own takes the viewport's. Fog that does not\n // match what is behind it reads as a grey wall rather than as distance,\n // and the two being typed separately is exactly how they drift — which\n // is what the old `<Background3D>` + `<Fog3D>` pair made you do.\n const fog = scene.fogDescriptor();\n if (fog && fog.color === undefined) {\n const base = baseFillColor(this.fill as FillResolved[]);\n if (base !== undefined) scene.fog({ ...fog, color: base });\n }\n\n\n\n // Drawn first, so it sits at the back of the op list — a mesh standing on\n // the ground plane should read as standing *on* it.\n if (this.showGrid) {\n scene.draw(\n new Graphics3D().line({\n geometry: this.gridDescriptor(),\n segments: true,\n material: {\n type: \"lineBasic\",\n // The whole picture is in the vertex colours — the minor lines, the\n // major ones, the two axes and the distance fade at once. See\n // {@link gridGeometry3D} for why that is one op rather than four.\n vertexColors: true,\n // The colours are already exactly what should appear: they were\n // chosen against this background and faded toward it by hand. Tone\n // mapping would re-grade them and pull the fade apart from the fill\n // it is supposed to disappear into.\n toneMapped: false,\n },\n }),\n );\n }\n\n if (scene.cameraDescriptor() === null) {\n // Polar placement is the camera's own vocabulary now, so the viewport's\n // orbit/elevation/zoom pass straight through instead of being converted to\n // a position here; `near`/`far` come from the scene's own bounds.\n // `cameraOrbit` is the quarter turn between the stored zero and the\n // camera's — see it for why that is converted rather than redefined.\n scene.perspective({\n fov: this.fov,\n orbit: cameraOrbit(this.orbit),\n elevation: this.elevation,\n distance: this.zoom,\n });\n }\n\n // A soft ambient fill, a key from the front-right and a weaker rim from\n // behind — enough that a plain untextured box reads as three distinct faces,\n // which is the whole job of a default rig.\n //\n // The rim takes the key's colour as well as a fraction of its strength: it\n // is the key seen from the other side rather than a light of its own, and a\n // rig whose two halves could be tinted apart is two controls rather than\n // one. See the schema's `keyColor`, which says the same from the panel's\n // side.\n if (!scene.ops().some((op) => op.kind === \"light\")) {\n scene\n .light({\n type: \"ambient\",\n intensity: this.ambientIntensity,\n color: this.ambientColor,\n })\n .light(\n {\n type: \"directional\",\n intensity: this.keyIntensity,\n color: this.keyColor,\n },\n { position: [4, 6, 3] },\n )\n .light(\n {\n type: \"directional\",\n intensity: this.keyIntensity * 0.35,\n color: this.keyColor,\n },\n { position: [-5, -2, -4] },\n );\n }\n\n return scene;\n }\n\n /**\n * This frame's scene, for a reader outside the render pass.\n *\n * {@link buildScene3D} is protected because a subclass overrides it, not\n * because the result is private — the asset pass and the render already call\n * it twice a frame. The editor geometry in `runtime/node-picking3d.ts` is the\n * third caller, and it has to go through the *same* seam rather than walking\n * the `Node3D` children itself: a subclass that builds its scene some other\n * way (supplying a default camera and lighting rig, say) would otherwise be\n * picked against a scene nobody renders.\n *\n * Recorded fresh, like the other two, so what it reports is this frame's\n * state rather than a cache a scrub could leave behind.\n */\n /** @internal */\n _scene3D(): Scene3D {\n return this.buildScene3D();\n }\n\n /**\n * The 3D runtime. The scene's resources are its `Node3D` children's to declare;\n * only a subclass building its scene some other way has resources no child states.\n */\n override declareAssets(assets: AssetScope): void {\n super.declareAssets(assets);\n assets.loader(\"three:runtime\", loadThreeRuntime);\n if (this.buildScene3D === Canvas3D.prototype.buildScene3D) return;\n const scene = this.buildScene3D();\n if (!scene.isEmpty()) declare3DResources(scene, assets);\n }\n\n /**\n * Bind every `Node2D` used as a `Tex.surface` source in this scene.\n *\n * A source node is detached — it is a value in a descriptor, not a child — so\n * nothing else would ever hand it an asset catalog, a context map or a clock.\n * This node has all three, and is the only thing that knows the scene, so it\n * adopts them. See {@link Node.attachDetached}.\n */\n private bindSurfaceSources(scene: Scene3D): void {\n forEachTexture3D(scene, (texture) => {\n if (!isSurfaceTexture3D(texture)) return;\n const source = resolveSurfaceSource(texture.source);\n if (source.kind === \"node\") this.attachDetached(source.node);\n });\n }\n\n protected override renderSelf(ctx: RenderContext2D): void {\n const built = this.buildScene3D();\n const scene = built.isEmpty() ? null : built;\n\n if (scene) {\n // Fail loudly at the author's source rather than silently reparenting\n // everything after an unclosed scope.\n scene.assertBalanced();\n this.bindSurfaceSources(scene);\n }\n\n // The author's own fill layers stay first, so a `fill` still paints\n // *beneath* the 3D; the scene goes on top as one more layer.\n const fill = scene\n ? [\n ...resolveChainFill(this.fill),\n ...Fills.canvas3D(scene, {\n maxPixelRatio: this.maxPixelRatio,\n antialias: this.antialias,\n }),\n ]\n : this.fill;\n\n // Stroke is deferred to renderStroke (drawn after children + overlay).\n ctx.draw(this.shapeGraphics().shadow(this.shadow).fill(fill));\n }\n}\n\n/**\n * The colour a fill chain reads as, for anything that has to match it.\n *\n * The first opaque solid layer, which is what a background stack is built on:\n * everything above it is a gradient, an image or a texture painted *over* a base\n * colour, and it is that base a receding surface fades into. Returns `undefined`\n * for a chain with no solid layer at all, which leaves the renderer's own\n * default in place rather than inventing black.\n */\nfunction baseFillColor(fill: FillResolved[] | undefined): Color | undefined {\n if (!fill) return undefined;\n for (const layer of fill) {\n if (layer && (layer as { type?: string }).type === \"solid\") {\n return (layer as unknown as { color: Color }).color;\n }\n }\n return undefined;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"canvas3d-node.js","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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","sourcesContent":["import { RenderContext2D } from \"@/render/render-context2d\";\r\nimport { Scene3D } from \"@/render3d/scene3d\";\r\nimport {\r\n resolveShadows3D,\r\n type PostEffect3D, type Shadows3D, type ToneMapping3D,\r\n} from \"@/render3d/scene-settings\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\r\nimport { warmCanvas3D } from \"@/render3d/resources\";\r\nimport { forEachTexture3D } from \"@/render3d/walk\";\r\nimport { isSurfaceTexture3D, resolveSurfaceSource } from \"@/render3d/texture\";\r\nimport { Graphics3D } from \"@/render3d/graphics3d\";\r\nimport type { BufferGeometry3D } from \"@/render3d/geometry\";\r\nimport { cameraOrbit, lerpColor3D, resolveColor3D } from \"@/attributes/render3d/orbit\";\r\nimport { gridGeometry3D, type Grid3DOptions } from \"./grid-geometry3d\";\r\nimport { Fills, resolveChainFill } from \"@/attributes/shape/fill/chain\";\r\nimport { property } from \"@/attributes/properties/decorator\";\r\nimport type { Command, CommandArgs } from \"@/tween/command\";\r\nimport { command } from \"@/tween/command-decorator\";\r\nimport { declare3DResources } from \"@/render3d/tracking\";\r\nimport type { AssetScope } from \"@/assets/scope\";\r\nimport type { LoaderFn } from \"@/assets/record\";\r\nimport { Rect, RectProps } from \"../geometry/rect-node\";\r\nimport { Node, NodeConfig, type NodeDimension } from \"@/nodes/node/node\";\r\nimport { Node3D, type ChildSpace3D } from \"./node3d\";\r\n\r\n// `warmCanvas3D` returns `void` when no backend registered a runtime, so it can't\r\n// be a loader bare. One function for every declaration keeps the key's loader stable.\r\nconst loadThreeRuntime: LoaderFn = async () => { await warmCanvas3D(); };\r\n\r\nexport interface Canvas3DProps extends RectProps {\r\n /**\r\n * Ceiling on the 3D buffer's device-pixel ratio. Default 2.\r\n *\r\n * Lower it for an expensive scene: the 3D renders at a smaller buffer and is\r\n * scaled up on composite, which trades sharpness for fill rate.\r\n */\r\n maxPixelRatio: number;\r\n /** Multisample the 3D pass. Default true. */\r\n antialias: boolean;\r\n /**\r\n * Turn shadow casting on for the scene. A switch, or `{ quality }`.\r\n *\r\n * A render setting rather than a scene object, which is why it is a prop here\r\n * and not a `<Shadows3D>` node: it has no position, and two of them in a tree\r\n * meant one silently doing nothing.\r\n */\r\n shadows: Shadows3D;\r\n /** How HDR colour is compressed to what the screen can show. Default `\"aces\"`. */\r\n tone: ToneMapping3D;\r\n /** Stops of exposure applied before tone mapping. Default 1. */\r\n exposure: number;\r\n /**\r\n * Post-processing inside the 3D composite: `bloom`, `ssao`, `dof`, `outline`.\r\n *\r\n * Short by design — a `Canvas3D` is a `Node2D`, so vignette, grain, grading,\r\n * blur and the rest of the 2D `effects` chain already run over the composited\r\n * result. What is here is what genuinely needs the depth buffer, object ids,\r\n * or HDR radiance before tone mapping.\r\n *\r\n * **Inert today**: the chain is recorded on the scene and no pass is applied,\r\n * so a viewport with `post` renders exactly like one without (the first one\r\n * set warns in development). Use the viewport's 2D `effects` instead.\r\n */\r\n post: PostEffect3D | readonly PostEffect3D[];\r\n /**\r\n * The camera, as three numbers rather than a `<Camera3D>` child.\r\n *\r\n * A host that renders a **timeline** needs a camera a `to` command can tween\r\n * and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes\r\n * the same values the timeline reads. Only read when the scene contains no\r\n * camera of its own, so a `<Camera3D>` child still wins.\r\n */\r\n\r\n /** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */\r\n orbit: number;\r\n /** Camera elevation above the ground plane, in **degrees**. */\r\n elevation: number;\r\n /** Camera distance from the origin, in scene units. */\r\n zoom: number;\r\n /** Vertical field of view, in **degrees**. */\r\n fov: number;\r\n /** Strength of the ambient fill. */\r\n ambientIntensity: number;\r\n /** Colour of the ambient fill. White leaves the meshes' own colours alone. */\r\n ambientColor: Color;\r\n /** Strength of the key light; the rim light is derived from it. */\r\n keyIntensity: number;\r\n /** Colour of the key light, and of the rim derived from it. */\r\n keyColor: Color;\r\n\r\n /**\r\n * Whether the ground plane is drawn. **Off by default** — it is an authoring\r\n * reference rather than part of the picture; see the property below.\r\n */\r\n showGrid: boolean;\r\n /** Total extent of the grid, in scene units. */\r\n gridSize: number;\r\n /** How many cells across it. */\r\n gridDivisions: number;\r\n /** Every Nth line is drawn heavier. */\r\n gridMajorEvery: number;\r\n gridColor: Color;\r\n gridMajorColor: Color;\r\n /** Whether the two coloured axis lines are drawn. Off by default, as above. */\r\n showAxes: boolean;\r\n axisXColor: Color;\r\n axisZColor: Color;\r\n /** How much of the way to the edge the grid has faded out, in `[0, 1]`. */\r\n gridFade: number;\r\n /**\r\n * What the grid fades into, when the node's own fills do not answer.\r\n *\r\n * **Derived, not authored.** The horizon dissolves into the first solid layer\r\n * of this node's `fill` — the viewport's background — and falls back to this\r\n * only when the stack has no solid in it to read (an empty stack, or a\r\n * gradient or image on its own). A grid that faded into a *different* colour\r\n * than the one behind it would ring the horizon with a halo, and the way to\r\n * make that impossible is for there to be nothing to keep in step: see\r\n * {@link Canvas3DView.fadeColor}.\r\n *\r\n * The same rule the engine applies to fog with no colour of its own, one\r\n * layer down (`Canvas3D.buildScene3D`), and for the same reason.\r\n */\r\n gridFadeColor: Color;\r\n}\r\n\r\n/**\r\n * A 3D viewport in the 2D document — the one node that holds both dimensions.\r\n *\r\n * `Canvas3D` is a {@link Rect} that partitions its children by which tree they\r\n * belong to. `Node3D` children describe a scene: they are walked through a\r\n * {@link Scene3D} every frame and the result is painted through this rect's own\r\n * path. `Node2D` children are ordinary children and draw *over* the 3D, which is\r\n * how a HUD is written.\r\n *\r\n * <Canvas3D width=\"fill\" height=\"fill\" cornerRadius={24} fill=\"#0b0d12\" shadows>\r\n * <Camera3D orbit={-18} elevation={12} distance={13} fov={45} />\r\n * <AmbientLight3D intensity={0.4} />\r\n * <DirectionalLight3D intensity={2.4} position={[4, 6, 3]} shadow />\r\n * <Fog3D near={5} far={30} />\r\n *\r\n * <Group3D ref={rig}>\r\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\r\n * </Group3D>\r\n *\r\n * <Text text=\"FPS 60\" fontSize={32} /> // a 2D HUD, over the 3D\r\n * </Canvas3D>\r\n *\r\n * Being a `Rect` is what makes it lay out in flex/stack groups, take\r\n * `cornerRadius`/`clip`, be masked, blended and filtered. The 3D is one more\r\n * fill layer, so the author's own `fill` paints *beneath* it and `stroke` and\r\n * `overlay` still paint over everything.\r\n *\r\n * **That fill is also the background.** There is no `<Background3D>`: three's\r\n * background pass is unaffected by every light and by fog, the renderer clears\r\n * transparent, and this node already composites the 3D over its own fill layers —\r\n * so a solid colour, a gradient, an image or a video behind a 3D scene is the\r\n * ordinary 2D fill chain, which does strictly more. What genuinely needs the 3D\r\n * pass is a sky that reprojects as the camera turns, and that is\r\n * `<Environment3D background>`.\r\n *\r\n * The scene is a value, not machinery: the same recorded {@link Scene3D} can be\r\n * built by hand and used as a fill on any shape, which is how 3D is painted\r\n * through glyphs or an arbitrary path (`<Text fill={scene} />`).\r\n */\r\nexport class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends Rect<P> {\r\n\r\n @property({ default: 35 }) declare orbit: number;\r\n @property({ default: 20 }) declare elevation: number;\r\n @property({ default: 12 }) declare zoom: number;\r\n @property({ default: 45 }) declare fov: number;\r\n\r\n @property({ default: 0.45 }) declare ambientIntensity: number;\r\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare ambientColor: Color;\r\n @property({ default: 2.4 }) declare keyIntensity: number;\r\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare keyColor: Color;\r\n\r\n // Off by default, both of them: the grid and the axes are **reference**, and\r\n // reference belongs to whoever is authoring rather than to whoever is\r\n // watching. A host with an authoring view turns them on there, and nothing\r\n // else does — an export goes through the same builder with them left off.\r\n @property({ default: false }) declare showGrid: boolean;\r\n @property({ default: 40 }) declare gridSize: number;\r\n @property({ default: 40 }) declare gridDivisions: number;\r\n @property({ default: 5 }) declare gridMajorEvery: number;\r\n @property({ default: \"#26292f\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridColor: Color;\r\n @property({ default: \"#363a42\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridMajorColor: Color;\r\n @property({ default: false }) declare showAxes: boolean;\r\n @property({ default: \"#c8404f\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare axisXColor: Color;\r\n @property({ default: \"#2f6fd0\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare axisZColor: Color;\r\n @property({ default: 0.55 }) declare gridFade: number;\r\n @property({ default: \"#0b0d12\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridFadeColor: Color;\r\n\r\n\r\n /**\r\n * The children's scene, plus whatever it did not already state.\r\n *\r\n * Each default is applied only when the walk left that slot empty, so a\r\n * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the\r\n * node's own props rather than being silently overwritten by them — which is\r\n * the behaviour that lets this class stop being special the day an editor\r\n * offers those as node types.\r\n */\r\n /**\r\n * The grid geometry, rebuilt only when one of its fields moves.\r\n *\r\n * A `Scene3D` is recorded from scratch every frame, which is what makes the\r\n * whole design seekable — but the grid is thousands of floats and depends on\r\n * nothing that changes between frames. Caching it here is what lets the\r\n * descriptor claim `staticData`: the renderer compares buffers by identity, so\r\n * handing it the *same* arrays is the difference between one upload and sixty\r\n * a second.\r\n *\r\n * Keyed by the fields themselves rather than by a dirty flag, so a tween\r\n * through `gridFade` still rebuilds and nothing has to remember to invalidate.\r\n */\r\n private gridCache: { key: string; geometry: BufferGeometry3D } | null = null;\r\n\r\n /**\r\n * The colour a receding grid line ends up at: the background it is drawn on.\r\n *\r\n * The first **opaque solid** layer of the fill stack, which is what a\r\n * background stack is built on — everything above it is a gradient, an image\r\n * or a video painted over a base colour, and it is that base a surface\r\n * disappearing into the distance has to match. A stack with no solid in it\r\n * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than\r\n * inventing black.\r\n *\r\n * Restated here rather than imported because the engine's own copy (used\r\n * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The\r\n * duplication is small and deliberate — the alternative was a second control\r\n * the author had to keep in step with the fill, which is exactly what this\r\n * node used to have.\r\n */\r\n private fadeColor(): Color {\r\n const layers = this.fill as unknown;\r\n if (Array.isArray(layers)) {\r\n for (const layer of layers) {\r\n const paint = layer as { type?: string; color?: unknown } | null;\r\n if (paint?.type !== \"solid\") continue;\r\n const color = paint.color;\r\n // A `Color` is a string or a normalized tuple, and the grid takes\r\n // either — but the tuple's fourth channel is what says whether this\r\n // layer covers anything, so a transparent \"solid\" is passed over rather\r\n // than faded into.\r\n if (typeof color === \"string\") return color;\r\n if (Array.isArray(color) && (color[3] ?? 1) > 0) return color as Color;\r\n }\r\n }\r\n return this.gridFadeColor;\r\n }\r\n\r\n private gridDescriptor(): BufferGeometry3D {\r\n const options: Grid3DOptions = {\r\n size: this.gridSize,\r\n divisions: Math.max(1, Math.round(this.gridDivisions)),\r\n majorEvery: Math.max(1, Math.round(this.gridMajorEvery)),\r\n minorColor: this.gridColor,\r\n majorColor: this.gridMajorColor,\r\n axisXColor: this.axisXColor,\r\n axisZColor: this.axisZColor,\r\n showAxes: this.showAxes,\r\n fadeTo: this.fadeColor(),\r\n fade: this.gridFade,\r\n };\r\n\r\n const key = JSON.stringify(options);\r\n if (this.gridCache?.key !== key) {\r\n this.gridCache = { key, geometry: gridGeometry3D(options) };\r\n }\r\n return this.gridCache.geometry;\r\n }\r\n\r\n\r\n\r\n\r\n @property({ default: 2 }) declare maxPixelRatio: number;\r\n @property({ default: true }) declare antialias: boolean;\r\n @property({ default: false }) declare shadows: Shadows3D;\r\n @property({ default: undefined }) declare tone: ToneMapping3D | undefined;\r\n @property({ default: undefined }) declare exposure: number | undefined;\r\n @property({ default: undefined }) declare post: PostEffect3D | readonly PostEffect3D[] | undefined;\r\n\r\n constructor(props?: NodeConfig<Canvas3D<P>, P>) {\r\n super((props ?? {}) as NodeConfig<any, P>);\r\n }\r\n\r\n /**\r\n * Swing the default camera round the scene and pull it back or in,\r\n * whichever are given. `zoom` is its distance, as the prop is. A scene with\r\n * a `Camera3D` of its own is framed by that camera's `orbitTo` instead.\r\n */\r\n @command({\r\n args: [\r\n { key: \"orbit\", kind: \"number\", step: 1, unit: \"°\" },\r\n { key: \"elevation\", kind: \"number\", min: -89, max: 89, step: 1, unit: \"°\" },\r\n { key: \"zoom\", kind: \"number\", min: 0.01, step: 0.1 },\r\n ],\r\n })\r\n orbitTo(args: CommandArgs<{ orbit?: number; elevation?: number; zoom?: number }> & { duration: number }): Command<P> {\r\n const data: Record<string, number> = {};\r\n for (const [key, value] of Object.entries(args.data ?? {})) if (value !== undefined) data[key] = value;\r\n return this.to({ data: data as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /**\r\n * Accept both dimensions — the only node that does.\r\n *\r\n * Everywhere else a mixed tree is a mistake that would silently draw nothing\r\n * (see {@link Node.acceptsChild}); here it is the entire point.\r\n */\r\n protected override acceptsChild(child: Node): boolean {\r\n return true;\r\n }\r\n\r\n override get _childTrees(): readonly NodeDimension[] {\r\n return [\"2d\", \"3d\"];\r\n }\r\n\r\n /**\r\n * The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the\r\n * default) when they are the scene's own. A viewport that is a graph answers\r\n * with the graph's units. See {@link ChildSpace3D}.\r\n */\r\n /** @internal */\r\n _spaceOf(_child: Node3D | null): ChildSpace3D | null {\r\n return null;\r\n }\r\n\r\n /** This node's children that describe the 3D scene. */\r\n get children3D(): Node3D[] {\r\n return this._allChildren.filter((c): c is Node3D => c instanceof Node3D);\r\n }\r\n\r\n /**\r\n * A 3D viewport has no intrinsic size and shouldn't be sized by its overlay\r\n * children — hugging a HUD label would collapse the viewport to the size of\r\n * the text. So it fills unless given an explicit size, whether or not it has\r\n * children (which is where this diverges from {@link Rect}).\r\n */\r\n protected override applyDefaultSize(props?: NodeConfig<any, P>): void {\r\n if (!props || props.width === undefined) this.applyProp(\"width\", \"fill\");\r\n if (!props || props.height === undefined) this.applyProp(\"height\", \"fill\");\r\n }\r\n\r\n /**\r\n * Record this frame's scene by walking the 3D children.\r\n *\r\n * The single seam both the real render and the asset-declaration pass go\r\n * through, so what gets loaded can never drift from what gets drawn. Override\r\n * it in a subclass for a reusable 3D component that builds its scene some\r\n * other way.\r\n *\r\n * Called inside the synchronous render pass, after the frame's state has been\r\n * evaluated and layout resolved, so every prop read here samples the\r\n * *current* frame. That is what makes a 3D scene seekable: frame N is\r\n * identical whether it was reached by playing forward or by scrubbing\r\n * backwards, because nothing accumulates.\r\n */\r\n protected buildScene3D(): Scene3D {\r\n const scene = new Scene3D();\r\n\r\n // The viewport's own render settings go on first, so a node in the tree\r\n // can still override one — the same last-writer-wins rule the scene\r\n // settings have always had, with the viewport as the first writer.\r\n const shadows = resolveShadows3D(this.shadows);\r\n if (shadows) scene.shadows(shadows);\r\n if (this.tone !== undefined || this.exposure !== undefined) {\r\n scene.tone({ mapping: this.tone, exposure: this.exposure });\r\n }\r\n if (this.post !== undefined) scene.post(this.post);\r\n\r\n for (const child of this._children) {\r\n if (child instanceof Node3D) child.render(scene);\r\n }\r\n\r\n // Fog with no colour of its own takes the viewport's. Fog that does not\r\n // match what is behind it reads as a grey wall rather than as distance,\r\n // and the two being typed separately is exactly how they drift — which\r\n // is what the old `<Background3D>` + `<Fog3D>` pair made you do.\r\n const fog = scene.fogDescriptor();\r\n if (fog && fog.color === undefined) {\r\n const base = baseFillColor(this.fill as FillResolved[]);\r\n if (base !== undefined) scene.fog({ ...fog, color: base });\r\n }\r\n\r\n\r\n\r\n // Drawn first, so it sits at the back of the op list — a mesh standing on\r\n // the ground plane should read as standing *on* it.\r\n if (this.showGrid) {\r\n scene.draw(\r\n new Graphics3D().line({\r\n geometry: this.gridDescriptor(),\r\n segments: true,\r\n material: {\r\n type: \"lineBasic\",\r\n // The whole picture is in the vertex colours — the minor lines, the\r\n // major ones, the two axes and the distance fade at once. See\r\n // {@link gridGeometry3D} for why that is one op rather than four.\r\n vertexColors: true,\r\n // The colours are already exactly what should appear: they were\r\n // chosen against this background and faded toward it by hand. Tone\r\n // mapping would re-grade them and pull the fade apart from the fill\r\n // it is supposed to disappear into.\r\n toneMapped: false,\r\n },\r\n }),\r\n );\r\n }\r\n\r\n // A viewport holding only 2D children (a HUD) has nothing to frame or to\r\n // light. Without this the default camera and rig made every scene\r\n // non-empty, so `renderSelf` ran a full 3D pass and created the WebGL\r\n // context to paint nothing. A subclass overriding `buildScene3D` is\r\n // exempt: it adds its own content after `super` returns and relies on the\r\n // rig being there.\r\n if (\r\n this.buildScene3D === Canvas3D.prototype.buildScene3D &&\r\n scene.isEmpty() &&\r\n !this._children.some((child) => child instanceof Node3D)\r\n ) {\r\n return scene;\r\n }\r\n\r\n if (scene.cameraDescriptor() === null) {\r\n // Polar placement is the camera's own vocabulary now, so the viewport's\r\n // orbit/elevation/zoom pass straight through instead of being converted to\r\n // a position here; `near`/`far` come from the scene's own bounds.\r\n // `cameraOrbit` is the quarter turn between the stored zero and the\r\n // camera's — see it for why that is converted rather than redefined.\r\n scene.perspective({\r\n fov: this.fov,\r\n orbit: cameraOrbit(this.orbit),\r\n elevation: this.elevation,\r\n distance: this.zoom,\r\n });\r\n }\r\n\r\n // A soft ambient fill, a key from the front-right and a weaker rim from\r\n // behind — enough that a plain untextured box reads as three distinct faces,\r\n // which is the whole job of a default rig.\r\n //\r\n // The rim takes the key's colour as well as a fraction of its strength: it\r\n // is the key seen from the other side rather than a light of its own, and a\r\n // rig whose two halves could be tinted apart is two controls rather than\r\n // one. See the schema's `keyColor`, which says the same from the panel's\r\n // side.\r\n if (!scene.ops().some((op) => op.kind === \"light\")) {\r\n scene\r\n .light({\r\n type: \"ambient\",\r\n intensity: this.ambientIntensity,\r\n color: this.ambientColor,\r\n })\r\n .light(\r\n {\r\n type: \"directional\",\r\n intensity: this.keyIntensity,\r\n color: this.keyColor,\r\n },\r\n { position: [4, 6, 3] },\r\n )\r\n .light(\r\n {\r\n type: \"directional\",\r\n intensity: this.keyIntensity * 0.35,\r\n color: this.keyColor,\r\n },\r\n { position: [-5, -2, -4] },\r\n );\r\n }\r\n\r\n return scene;\r\n }\r\n\r\n /**\r\n * This frame's scene, for a reader outside the render pass.\r\n *\r\n * {@link buildScene3D} is protected because a subclass overrides it, not\r\n * because the result is private — the asset pass and the render already call\r\n * it twice a frame. The editor geometry in `runtime/node-picking3d.ts` is the\r\n * third caller, and it has to go through the *same* seam rather than walking\r\n * the `Node3D` children itself: a subclass that builds its scene some other\r\n * way (supplying a default camera and lighting rig, say) would otherwise be\r\n * picked against a scene nobody renders.\r\n *\r\n * Recorded fresh, like the other two, so what it reports is this frame's\r\n * state rather than a cache a scrub could leave behind.\r\n */\r\n /** @internal */\r\n _isViewport3D(): boolean {\r\n return true;\r\n }\r\n\r\n _scene3D(): Scene3D {\r\n return this.buildScene3D();\r\n }\r\n\r\n /**\r\n * The 3D runtime. The scene's resources are its `Node3D` children's to declare;\r\n * only a subclass building its scene some other way has resources no child states.\r\n */\r\n override declareAssets(assets: AssetScope): void {\r\n super.declareAssets(assets);\r\n assets.loader(\"three:runtime\", loadThreeRuntime);\r\n if (this.buildScene3D === Canvas3D.prototype.buildScene3D) return;\r\n const scene = this.buildScene3D();\r\n if (!scene.isEmpty()) declare3DResources(scene, assets);\r\n }\r\n\r\n /**\r\n * Bind every `Node2D` used as a `Tex.surface` source in this scene.\r\n *\r\n * A source node is detached — it is a value in a descriptor, not a child — so\r\n * nothing else would ever hand it an asset catalog, a context map or a clock.\r\n * This node has all three, and is the only thing that knows the scene, so it\r\n * adopts them. See {@link Node.attachDetached}.\r\n */\r\n private bindSurfaceSources(scene: Scene3D): void {\r\n forEachTexture3D(scene, (texture) => {\r\n if (!isSurfaceTexture3D(texture)) return;\r\n const source = resolveSurfaceSource(texture.source);\r\n if (source.kind === \"node\") this.attachDetached(source.node);\r\n });\r\n }\r\n\r\n protected override renderSelf(ctx: RenderContext2D): void {\r\n const built = this.buildScene3D();\r\n const scene = built.isEmpty() ? null : built;\r\n\r\n if (scene) {\r\n // Fail loudly at the author's source rather than silently reparenting\r\n // everything after an unclosed scope.\r\n scene.assertBalanced();\r\n this.bindSurfaceSources(scene);\r\n }\r\n\r\n // The author's own fill layers stay first, so a `fill` still paints\r\n // *beneath* the 3D; the scene goes on top as one more layer.\r\n const fill = scene\r\n ? [\r\n ...resolveChainFill(this.fill),\r\n ...Fills.canvas3D(scene, {\r\n maxPixelRatio: this.maxPixelRatio,\r\n antialias: this.antialias,\r\n }),\r\n ]\r\n : this.fill;\r\n\r\n // Stroke is deferred to renderStroke (drawn after children + overlay).\r\n ctx.draw(this.shapeGraphics().shadow(this.shadow).fill(fill));\r\n }\r\n}\r\n\r\n/**\r\n * The colour a fill chain reads as, for anything that has to match it.\r\n *\r\n * The first opaque solid layer, which is what a background stack is built on:\r\n * everything above it is a gradient, an image or a texture painted *over* a base\r\n * colour, and it is that base a receding surface fades into. Returns `undefined`\r\n * for a chain with no solid layer at all, which leaves the renderer's own\r\n * default in place rather than inventing black.\r\n */\r\nfunction baseFillColor(fill: FillResolved[] | undefined): Color | undefined {\r\n if (!fill) return undefined;\r\n for (const layer of fill) {\r\n if (layer && (layer as { type?: string }).type === \"solid\") {\r\n return (layer as unknown as { color: Color }).color;\r\n }\r\n }\r\n return undefined;\r\n}\r\n"]}
|