@react-three/drei 9.62.4 → 9.64.0

package/README.md

@@ -110,6 +110,7 @@ The `native` route of the library **does not** export `Html` or `Loader`. The de
           <li><a href="#usecontextbridge">useContextBridge</a></li>
           <li><a href="#usefbo">useFBO</a></li>
           <li><a href="#usecamera">useCamera</a></li>
+          <li><a href="#usecubecamera">useCubeCamera</a></li>
           <li><a href="#usedetectgpu">useDetectGPU</a></li>          
           <li><a href="#useaspect">useAspect</a></li>
           <li><a href="#usecursor">useCursor</a></li>
@@ -1999,6 +2000,10 @@ return <Stats parent={parent} />
 
 [![](https://img.shields.io/badge/-storybook-%23ff69b4)](https://drei.vercel.app/?path=/story/staging-wireframe--wireframe-st)
 
+<p>
+  <a href="https://codesandbox.io/s/2572o5"><img width="20%" src="https://codesandbox.io/api/v1/sandboxes/2572o5/screenshot.png" alt="Demo"/></a>
+</p>
+
 Renders an Antialiased, shader based wireframe on or around a geometry.
 
 ```jsx
@@ -2096,6 +2101,31 @@ A hook for the rare case when you are using non-default cameras for heads-up-dis
 <mesh raycast={useCamera(customCamera)} />
 ```
 
+#### useCubeCamera
+
+[![](https://img.shields.io/badge/-storybook-%23ff69b4)](https://drei.vercel.app/?path=/story/misc-usecubecamera)
+
+Creates a [`THREE.CubeCamera`](https://threejs.org/docs/#api/en/cameras/CubeCamera) that renders into a `fbo` renderTarget and that you can `update()`.
+
+```tsx
+export function useCubeCamera({
+  /** Resolution of the FBO, 256 */
+  resolution?: number
+  /** Camera near, 0.1 */
+  near?: number
+  /** Camera far, 1000 */
+  far?: number
+  /** Custom environment map that is temporarily set as the scenes background */
+  envMap?: THREE.Texture
+  /** Custom fog that is temporarily set as the scenes fog */
+  fog?: Fog | FogExp2
+})
+```
+
+```jsx
+const { fbo, camera, update } = useCubeCamera()
+```
+
 #### useDetectGPU
 
 [![](https://img.shields.io/badge/-storybook-%23ff69b4)](https://drei.pmnd.rs/?path=/story/misc-usedetectgpu)
@@ -2421,6 +2451,7 @@ return (
       <VideoMaterial src={stream} />
     </React.Suspense>
 ```
+
 ```jsx
 function VideoMaterial({ src }) {
   const texture = useVideoTexture(src)
@@ -2428,6 +2459,7 @@ function VideoMaterial({ src }) {
   return <meshBasicMaterial map={texture} toneMapped={false} />
 }
 ```
+
 NB: It's important to wrap `VideoMaterial` into `React.Suspense` since, `useVideoTexture(src)` here will be suspended until the user shares its screen.
 
 #### useTrailTexture

package/core/CubeCamera.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("three"),r=require("react"),t=require("@react-three/fiber");function u(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var u=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,u.get?u:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var n=u(r);exports.CubeCamera=function({children:r,fog:u,frames:a=1/0,resolution:c=256,near:o=.1,far:f=1e3,envMap:i,...s}){const l=n.useRef(),[b,g]=n.useState(null),d=t.useThree((({scene:e})=>e)),p=t.useThree((({gl:e})=>e)),m=n.useMemo((()=>{const r=new e.WebGLCubeRenderTarget(c);return r.texture.encoding=p.outputEncoding,r.texture.type=e.HalfFloatType,r}),[c]);let v,O,h=0;return t.useFrame((()=>{b&&l.current&&(a===1/0||h<a)&&(l.current.visible=!1,v=d.fog,O=d.background,d.background=i||O,d.fog=u||v,b.update(p,d),d.fog=v,d.background=O,l.current.visible=!0,h++)})),n.createElement("group",s,n.createElement("cubeCamera",{ref:g,args:[o,f,m]}),n.createElement("group",{ref:l},r(m.texture)))};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),r=require("@react-three/fiber"),t=require("./useCubeCamera.cjs.js");function u(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var u=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,u.get?u:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}require("three");var a=u(e);exports.CubeCamera=function({children:e,frames:u=1/0,resolution:n,near:c,far:i,envMap:o,fog:f,...s}){const l=a.useRef(),{fbo:b,camera:p,update:m}=t.useCubeCamera({resolution:n,near:c,far:i,envMap:o,fog:f});let v=0;return r.useFrame((()=>{l.current&&(u===1/0||v<u)&&(l.current.visible=!1,m(),l.current.visible=!0,v++)})),a.createElement("group",s,a.createElement("primitive",{object:p}),a.createElement("group",{ref:l},e(b.texture)))};

package/core/CubeCamera.d.ts

@@ -1,13 +1,9 @@
-import { Fog, FogExp2, Texture } from 'three';
+import { Texture } from 'three';
 import * as React from 'react';
+import { CubeCameraOptions } from './useCubeCamera';
 declare type Props = JSX.IntrinsicElements['group'] & {
-    frames?: number;
-    resolution?: number;
-    near?: number;
-    far?: number;
-    envMap?: THREE.Texture;
-    fog?: Fog | FogExp2;
     children: (tex: Texture) => React.ReactNode;
-};
-export declare function CubeCamera({ children, fog, frames, resolution, near, far, envMap, ...props }: Props): JSX.Element;
+    frames?: number;
+} & CubeCameraOptions;
+export declare function CubeCamera({ children, frames, resolution, near, far, envMap, fog, ...props }: Props): JSX.Element;
 export {};

package/core/CubeCamera.js

@@ -1,51 +1,40 @@
-import { WebGLCubeRenderTarget, HalfFloatType } from 'three';
 import * as React from 'react';
-import { useThree, useFrame } from '@react-three/fiber';
+import { useFrame } from '@react-three/fiber';
+import { useCubeCamera } from './useCubeCamera.js';
 
 function CubeCamera({
   children,
-  fog,
   frames = Infinity,
-  resolution = 256,
-  near = 0.1,
-  far = 1000,
+  resolution,
+  near,
+  far,
   envMap,
+  fog,
   ...props
 }) {
   const ref = React.useRef();
-  const [camera, setCamera] = React.useState(null);
-  const scene = useThree(({
-    scene
-  }) => scene);
-  const gl = useThree(({
-    gl
-  }) => gl);
-  const fbo = React.useMemo(() => {
-    const fbo = new WebGLCubeRenderTarget(resolution);
-    fbo.texture.encoding = gl.outputEncoding;
-    fbo.texture.type = HalfFloatType;
-    return fbo;
-  }, [resolution]);
+  const {
+    fbo,
+    camera,
+    update
+  } = useCubeCamera({
+    resolution,
+    near,
+    far,
+    envMap,
+    fog
+  });
   let count = 0;
-  let originalFog;
-  let originalBackground;
   useFrame(() => {
-    if (camera && ref.current && (frames === Infinity || count < frames)) {
+    if (ref.current && (frames === Infinity || count < frames)) {
       ref.current.visible = false;
-      originalFog = scene.fog;
-      originalBackground = scene.background;
-      scene.background = envMap || originalBackground;
-      scene.fog = fog || originalFog;
-      camera.update(gl, scene);
-      scene.fog = originalFog;
-      scene.background = originalBackground;
+      update();
       ref.current.visible = true;
       count++;
     }
   });
-  return /*#__PURE__*/React.createElement("group", props, /*#__PURE__*/React.createElement("cubeCamera", {
-    ref: setCamera,
-    args: [near, far, fbo]
+  return /*#__PURE__*/React.createElement("group", props, /*#__PURE__*/React.createElement("primitive", {
+    object: camera
   }), /*#__PURE__*/React.createElement("group", {
     ref: ref
   }, children(fbo.texture)));

package/core/Decal.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("three"),n=require("@react-three/fiber"),o=require("three-stdlib");function a(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function i(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var s=a(e),c=i(t),l=i(r);function u(e=[0,0,0]){return function(e){return Array.isArray(e)}(e)?e:e instanceof l.Vector3||e instanceof l.Euler?[e.x,e.y,e.z]:[e,e,e]}exports.Decal=function({debug:e,mesh:t,children:r,position:a,rotation:i,scale:f,...p}){const m=c.useRef(null),y=c.useRef(null);return c.useLayoutEffect((()=>{const e=(null==t?void 0:t.current)||m.current.parent,r=m.current;if(!(e instanceof l.Mesh))throw new Error('Decal must have a Mesh as parent or specify its "mesh" prop');const s={position:new l.Vector3,rotation:new l.Euler,scale:new l.Vector3(1,1,1)};if(e){n.applyProps(s,{position:a,scale:f});const t=e.matrixWorld.clone();if(e.matrixWorld.identity(),i&&"number"!=typeof i)n.applyProps(s,{rotation:i});else{const t=new l.Object3D;t.position.copy(s.position),t.lookAt(e.position),"number"==typeof i&&t.rotateZ(i),n.applyProps(s,{rotation:t.rotation})}return r.geometry=new o.DecalGeometry(e,s.position,s.rotation,s.scale),y.current&&n.applyProps(y.current,s),e.matrixWorld=t,()=>{r.geometry.dispose()}}}),[t,...u(a),...u(f),...u(i)]),c.createElement("mesh",{ref:m},r||c.createElement("meshStandardMaterial",s.default({transparent:!0,polygonOffset:!0,polygonOffsetFactor:-10},p)),e&&c.createElement("mesh",{ref:y},c.createElement("boxGeometry",null),c.createElement("meshNormalMaterial",{wireframe:!0}),c.createElement("axesHelper",null)))};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("three"),n=require("@react-three/fiber"),o=require("three-stdlib");function a(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function i(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var s=a(e),c=i(t),l=i(r);function u(e=[0,0,0]){return function(e){return Array.isArray(e)}(e)?e:e instanceof l.Vector3||e instanceof l.Euler?[e.x,e.y,e.z]:[e,e,e]}const f=c.forwardRef((function({debug:e,mesh:t,children:r,position:a,rotation:i,scale:f,...p},m){const y=c.useRef(null);c.useImperativeHandle(m,(()=>y.current));const d=c.useRef(null);return c.useLayoutEffect((()=>{const e=(null==t?void 0:t.current)||y.current.parent,r=y.current;if(!(e instanceof l.Mesh))throw new Error('Decal must have a Mesh as parent or specify its "mesh" prop');const s={position:new l.Vector3,rotation:new l.Euler,scale:new l.Vector3(1,1,1)};if(e){n.applyProps(s,{position:a,scale:f});const t=e.matrixWorld.clone();if(e.matrixWorld.identity(),i&&"number"!=typeof i)n.applyProps(s,{rotation:i});else{const t=new l.Object3D;t.position.copy(s.position),t.lookAt(e.position),"number"==typeof i&&t.rotateZ(i),n.applyProps(s,{rotation:t.rotation})}return r.geometry=new o.DecalGeometry(e,s.position,s.rotation,s.scale),d.current&&n.applyProps(d.current,s),e.matrixWorld=t,()=>{r.geometry.dispose()}}}),[t,...u(a),...u(f),...u(i)]),c.createElement("mesh",{ref:y},r||c.createElement("meshStandardMaterial",s.default({transparent:!0,polygonOffset:!0,polygonOffsetFactor:-10},p)),e&&c.createElement("mesh",{ref:d},c.createElement("boxGeometry",null),c.createElement("meshNormalMaterial",{wireframe:!0}),c.createElement("axesHelper",null)))}));exports.Decal=f;

package/core/Decal.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import * as THREE from 'three';
 import * as FIBER from '@react-three/fiber';
-declare type DecalProps = Omit<JSX.IntrinsicElements['meshStandardMaterial'], 'children'> & {
+export declare type DecalProps = Omit<JSX.IntrinsicElements['meshStandardMaterial'], 'children'> & {
     debug?: boolean;
     mesh?: React.MutableRefObject<THREE.Mesh>;
     position?: FIBER.Vector3;
@@ -10,5 +10,4 @@ declare type DecalProps = Omit<JSX.IntrinsicElements['meshStandardMaterial'], 'c
     map?: THREE.Texture;
     children?: React.ReactNode;
 };
-export declare function Decal({ debug, mesh, children, position, rotation, scale, ...props }: DecalProps): JSX.Element;
-export {};
+export declare const Decal: React.ForwardRefExoticComponent<Pick<DecalProps, "attach" | "args" | "children" | "key" | "onUpdate" | "position" | "scale" | "rotation" | "mesh" | keyof THREE.MeshStandardMaterial | "debug"> & React.RefAttributes<THREE.Mesh<THREE.BufferGeometry, THREE.Material | THREE.Material[]>>>;

package/core/Decal.js

@@ -18,7 +18,7 @@ function vecToArray(vec = [0, 0, 0]) {
   }
 }
 
-function Decal({
+const Decal = /*#__PURE__*/React.forwardRef(function Decal({
   debug,
   mesh,
   children,
@@ -26,8 +26,9 @@ function Decal({
   rotation,
   scale,
   ...props
-}) {
+}, forwardRef) {
   const ref = React.useRef(null);
+  React.useImperativeHandle(forwardRef, () => ref.current);
   const helper = React.useRef(null);
   React.useLayoutEffect(() => {
     const parent = (mesh == null ? void 0 : mesh.current) || ref.current.parent;
@@ -86,6 +87,6 @@ function Decal({
   }, /*#__PURE__*/React.createElement("boxGeometry", null), /*#__PURE__*/React.createElement("meshNormalMaterial", {
     wireframe: true
   }), /*#__PURE__*/React.createElement("axesHelper", null)));
-}
+});
 
 export { Decal };

package/core/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./Billboard.cjs.js"),r=require("./ScreenSpace.cjs.js"),s=require("./QuadraticBezierLine.cjs.js"),t=require("./CubicBezierLine.cjs.js"),o=require("./CatmullRomLine.cjs.js"),i=require("./Line.cjs.js"),a=require("./PositionalAudio.cjs.js"),u=require("./Text.cjs.js"),c=require("./Text3D.cjs.js"),n=require("./Effects.cjs.js"),j=require("./GradientTexture.cjs.js"),p=require("./Image.cjs.js"),x=require("./Edges.cjs.js"),l=require("./Trail.cjs.js"),q=require("./Sampler.cjs.js"),d=require("./ComputedAttribute.cjs.js"),m=require("./Clone.cjs.js"),h=require("./MarchingCubes.cjs.js"),C=require("./Decal.cjs.js"),M=require("./Svg.cjs.js"),S=require("./Gltf.cjs.js"),T=require("./AsciiRenderer.cjs.js"),f=require("./OrthographicCamera.cjs.js"),B=require("./PerspectiveCamera.cjs.js"),P=require("./CubeCamera.cjs.js"),b=require("./DeviceOrientationControls.cjs.js"),g=require("./FlyControls.cjs.js"),v=require("./MapControls.cjs.js"),A=require("./OrbitControls.cjs.js"),L=require("./TrackballControls.cjs.js"),D=require("./ArcballControls.cjs.js"),k=require("./TransformControls.cjs.js"),G=require("./PointerLockControls.cjs.js"),E=require("./FirstPersonControls.cjs.js"),R=require("./CameraControls.cjs.js"),w=require("./GizmoHelper.cjs.js"),z=require("./GizmoViewcube.cjs.js"),F=require("./GizmoViewport.cjs.js"),O=require("./Grid.cjs.js"),I=require("./useCubeTexture.cjs.js"),H=require("./useFBX.cjs.js"),V=require("./useGLTF.cjs.js"),y=require("./useKTX2.cjs.js"),W=require("./useProgress.cjs.js"),Q=require("./useTexture.cjs.js"),X=require("./useVideoTexture.cjs.js"),K=require("./Stats.cjs.js"),N=require("./useDepthBuffer.cjs.js"),U=require("./useAspect.cjs.js"),_=require("./useCamera.cjs.js"),J=require("./useDetectGPU.cjs.js"),Y=require("./useHelper.cjs.js"),Z=require("./useBVH.cjs.js"),$=require("./useContextBridge.cjs.js"),ee=require("./useAnimations.cjs.js"),re=require("./useFBO.cjs.js"),se=require("./useIntersect.cjs.js"),te=require("./useBoxProjectedEnv.cjs.js"),oe=require("./BBAnchor.cjs.js"),ie=require("./useTrailTexture.cjs.js"),ae=require("./CurveModifier.cjs.js"),ue=require("./MeshDistortMaterial.cjs.js"),ce=require("./MeshWobbleMaterial.cjs.js"),ne=require("./MeshReflectorMaterial.cjs.js"),je=require("./MeshRefractionMaterial.cjs.js"),pe=require("./MeshTransmissionMaterial.cjs.js"),xe=require("./MeshDiscardMaterial.cjs.js"),le=require("./PointMaterial.cjs.js"),qe=require("./shaderMaterial.cjs.js"),de=require("./softShadows.cjs.js"),me=require("./shapes.cjs.js"),he=require("./RoundedBox.cjs.js"),Ce=require("./ScreenQuad.cjs.js"),Me=require("./Center.cjs.js"),Se=require("./Bounds.cjs.js"),Te=require("./CameraShake.cjs.js"),fe=require("./Float.cjs.js"),Be=require("./Stage.cjs.js"),Pe=require("./Backdrop.cjs.js"),be=require("./Shadow.cjs.js"),ge=require("./Caustics.cjs.js"),ve=require("./ContactShadows.cjs.js"),Ae=require("./AccumulativeShadows.cjs.js"),Le=require("./Reflector.cjs.js"),De=require("./SpotLight.cjs.js"),ke=require("./Environment.cjs.js"),Ge=require("./Lightformer.cjs.js"),Ee=require("./Sky.cjs.js"),Re=require("./Stars.cjs.js"),we=require("./Cloud.cjs.js"),ze=require("./Sparkles.cjs.js"),Fe=require("./useEnvironment.cjs.js"),Oe=require("./useMatcapTexture.cjs.js"),Ie=require("./useNormalTexture.cjs.js"),He=require("./Wireframe.cjs.js"),Ve=require("./Points.cjs.js"),ye=require("./Instances.cjs.js"),We=require("./Segments.cjs.js"),Qe=require("./Detailed.cjs.js"),Xe=require("./Preload.cjs.js"),Ke=require("./BakeShadows.cjs.js"),Ne=require("./meshBounds.cjs.js"),Ue=require("./AdaptiveDpr.cjs.js"),_e=require("./AdaptiveEvents.cjs.js"),Je=require("./PerformanceMonitor.cjs.js"),Ye=require("./RenderTexture.cjs.js"),Ze=require("./Mask.cjs.js"),$e=require("./Hud.cjs.js");require("@babel/runtime/helpers/extends"),require("react"),require("@react-three/fiber"),require("react-merge-refs"),require("three"),require("three-stdlib"),require("troika-three-text"),require("suspend-react"),require("meshline"),require("lodash.pick"),require("lodash.omit"),require("camera-controls"),require("zustand"),require("stats.js"),require("../helpers/useEffectfulState.cjs.js"),require("detect-gpu"),require("three-mesh-bvh"),require("../materials/BlurPass.cjs.js"),require("../materials/ConvolutionMaterial.cjs.js"),require("../materials/MeshReflectorMaterial.cjs.js"),require("../materials/MeshRefractionMaterial.cjs.js"),require("../materials/DiscardMaterial.cjs.js"),require("../helpers/environment-assets.cjs.js"),require("../materials/SpotLightMaterial.cjs.js"),require("../materials/WireframeMaterial.cjs.js"),require("react-composer"),exports.Billboard=e.Billboard,exports.ScreenSpace=r.ScreenSpace,exports.QuadraticBezierLine=s.QuadraticBezierLine,exports.CubicBezierLine=t.CubicBezierLine,exports.CatmullRomLine=o.CatmullRomLine,exports.Line=i.Line,exports.PositionalAudio=a.PositionalAudio,exports.Text=u.Text,exports.Text3D=c.Text3D,exports.Effects=n.Effects,exports.isWebGL2Available=n.isWebGL2Available,exports.GradientTexture=j.GradientTexture,exports.Image=p.Image,exports.Edges=x.Edges,exports.Trail=l.Trail,exports.useTrail=l.useTrail,exports.Sampler=q.Sampler,exports.useSurfaceSampler=q.useSurfaceSampler,exports.ComputedAttribute=d.ComputedAttribute,exports.Clone=m.Clone,exports.MarchingCube=h.MarchingCube,exports.MarchingCubes=h.MarchingCubes,exports.MarchingPlane=h.MarchingPlane,exports.Decal=C.Decal,exports.Svg=M.Svg,exports.Gltf=S.Gltf,exports.AsciiRenderer=T.AsciiRenderer,exports.OrthographicCamera=f.OrthographicCamera,exports.PerspectiveCamera=B.PerspectiveCamera,exports.CubeCamera=P.CubeCamera,exports.DeviceOrientationControls=b.DeviceOrientationControls,exports.FlyControls=g.FlyControls,exports.MapControls=v.MapControls,exports.OrbitControls=A.OrbitControls,exports.TrackballControls=L.TrackballControls,exports.ArcballControls=D.ArcballControls,exports.TransformControls=k.TransformControls,exports.PointerLockControls=G.PointerLockControls,exports.FirstPersonControls=E.FirstPersonControls,exports.CameraControls=R.CameraControls,exports.GizmoHelper=w.GizmoHelper,exports.useGizmoContext=w.useGizmoContext,exports.GizmoViewcube=z.GizmoViewcube,exports.GizmoViewport=F.GizmoViewport,exports.Grid=O.Grid,exports.useCubeTexture=I.useCubeTexture,exports.useFBX=H.useFBX,exports.useGLTF=V.useGLTF,exports.useKTX2=y.useKTX2,exports.useProgress=W.useProgress,exports.IsObject=Q.IsObject,exports.useTexture=Q.useTexture,exports.useVideoTexture=X.useVideoTexture,exports.Stats=K.Stats,exports.useDepthBuffer=N.useDepthBuffer,exports.useAspect=U.useAspect,exports.useCamera=_.useCamera,exports.useDetectGPU=J.useDetectGPU,exports.useHelper=Y.useHelper,exports.Bvh=Z.Bvh,exports.useBVH=Z.useBVH,exports.useContextBridge=$.useContextBridge,exports.useAnimations=ee.useAnimations,exports.useFBO=re.useFBO,exports.useIntersect=se.useIntersect,exports.useBoxProjectedEnv=te.useBoxProjectedEnv,exports.BBAnchor=oe.BBAnchor,exports.useTrailTexture=ie.useTrailTexture,exports.CurveModifier=ae.CurveModifier,exports.MeshDistortMaterial=ue.MeshDistortMaterial,exports.MeshWobbleMaterial=ce.MeshWobbleMaterial,exports.MeshReflectorMaterial=ne.MeshReflectorMaterial,exports.MeshRefractionMaterial=je.MeshRefractionMaterial,exports.MeshTransmissionMaterial=pe.MeshTransmissionMaterial,exports.MeshDiscardMaterial=xe.MeshDiscardMaterial,exports.PointMaterial=le.PointMaterial,exports.PointMaterialImpl=le.PointMaterialImpl,exports.shaderMaterial=qe.shaderMaterial,exports.SoftShadows=de.SoftShadows,exports.Box=me.Box,exports.Capsule=me.Capsule,exports.Circle=me.Circle,exports.Cone=me.Cone,exports.Cylinder=me.Cylinder,exports.Dodecahedron=me.Dodecahedron,exports.Extrude=me.Extrude,exports.Icosahedron=me.Icosahedron,exports.Lathe=me.Lathe,exports.Octahedron=me.Octahedron,exports.Plane=me.Plane,exports.Polyhedron=me.Polyhedron,exports.Ring=me.Ring,exports.Shape=me.Shape,exports.Sphere=me.Sphere,exports.Tetrahedron=me.Tetrahedron,exports.Torus=me.Torus,exports.TorusKnot=me.TorusKnot,exports.Tube=me.Tube,exports.RoundedBox=he.RoundedBox,exports.ScreenQuad=Ce.ScreenQuad,exports.Center=Me.Center,exports.Bounds=Se.Bounds,exports.useBounds=Se.useBounds,exports.CameraShake=Te.CameraShake,exports.Float=fe.Float,exports.Stage=Be.Stage,exports.Backdrop=Pe.Backdrop,exports.Shadow=be.Shadow,exports.Caustics=ge.Caustics,exports.ContactShadows=ve.ContactShadows,exports.AccumulativeShadows=Ae.AccumulativeShadows,exports.RandomizedLight=Ae.RandomizedLight,exports.accumulativeContext=Ae.accumulativeContext,exports.Reflector=Le.Reflector,exports.SpotLight=De.SpotLight,exports.SpotLightShadow=De.SpotLightShadow,exports.Environment=ke.Environment,exports.EnvironmentCube=ke.EnvironmentCube,exports.EnvironmentMap=ke.EnvironmentMap,exports.EnvironmentPortal=ke.EnvironmentPortal,exports.Lightformer=Ge.Lightformer,exports.Sky=Ee.Sky,exports.calcPosFromAngles=Ee.calcPosFromAngles,exports.Stars=Re.Stars,exports.Cloud=we.Cloud,exports.Sparkles=ze.Sparkles,exports.useEnvironment=Fe.useEnvironment,exports.useMatcapTexture=Oe.useMatcapTexture,exports.useNormalTexture=Ie.useNormalTexture,exports.Wireframe=He.Wireframe,exports.Point=Ve.Point,exports.Points=Ve.Points,exports.PointsBuffer=Ve.PointsBuffer,exports.PositionPoint=Ve.PositionPoint,exports.Instance=ye.Instance,exports.Instances=ye.Instances,exports.Merged=ye.Merged,exports.Segment=We.Segment,exports.SegmentObject=We.SegmentObject,exports.Segments=We.Segments,exports.Detailed=Qe.Detailed,exports.Preload=Xe.Preload,exports.BakeShadows=Ke.BakeShadows,exports.meshBounds=Ne.meshBounds,exports.AdaptiveDpr=Ue.AdaptiveDpr,exports.AdaptiveEvents=_e.AdaptiveEvents,exports.PerformanceMonitor=Je.PerformanceMonitor,exports.usePerformanceMonitor=Je.usePerformanceMonitor,exports.RenderTexture=Ye.RenderTexture,exports.Mask=Ze.Mask,exports.useMask=Ze.useMask,exports.Hud=$e.Hud;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./Billboard.cjs.js"),r=require("./ScreenSpace.cjs.js"),s=require("./QuadraticBezierLine.cjs.js"),t=require("./CubicBezierLine.cjs.js"),o=require("./CatmullRomLine.cjs.js"),i=require("./Line.cjs.js"),a=require("./PositionalAudio.cjs.js"),u=require("./Text.cjs.js"),c=require("./Text3D.cjs.js"),n=require("./Effects.cjs.js"),j=require("./GradientTexture.cjs.js"),p=require("./Image.cjs.js"),x=require("./Edges.cjs.js"),l=require("./Trail.cjs.js"),q=require("./Sampler.cjs.js"),d=require("./ComputedAttribute.cjs.js"),m=require("./Clone.cjs.js"),C=require("./MarchingCubes.cjs.js"),h=require("./Decal.cjs.js"),M=require("./Svg.cjs.js"),S=require("./Gltf.cjs.js"),T=require("./AsciiRenderer.cjs.js"),b=require("./OrthographicCamera.cjs.js"),f=require("./PerspectiveCamera.cjs.js"),B=require("./CubeCamera.cjs.js"),P=require("./DeviceOrientationControls.cjs.js"),g=require("./FlyControls.cjs.js"),v=require("./MapControls.cjs.js"),A=require("./OrbitControls.cjs.js"),L=require("./TrackballControls.cjs.js"),D=require("./ArcballControls.cjs.js"),k=require("./TransformControls.cjs.js"),G=require("./PointerLockControls.cjs.js"),E=require("./FirstPersonControls.cjs.js"),R=require("./CameraControls.cjs.js"),w=require("./GizmoHelper.cjs.js"),z=require("./GizmoViewcube.cjs.js"),F=require("./GizmoViewport.cjs.js"),O=require("./Grid.cjs.js"),I=require("./useCubeTexture.cjs.js"),H=require("./useFBX.cjs.js"),V=require("./useGLTF.cjs.js"),y=require("./useKTX2.cjs.js"),W=require("./useProgress.cjs.js"),Q=require("./useTexture.cjs.js"),X=require("./useVideoTexture.cjs.js"),K=require("./Stats.cjs.js"),N=require("./useDepthBuffer.cjs.js"),U=require("./useAspect.cjs.js"),_=require("./useCamera.cjs.js"),J=require("./useDetectGPU.cjs.js"),Y=require("./useHelper.cjs.js"),Z=require("./useBVH.cjs.js"),$=require("./useContextBridge.cjs.js"),ee=require("./useAnimations.cjs.js"),re=require("./useFBO.cjs.js"),se=require("./useIntersect.cjs.js"),te=require("./useBoxProjectedEnv.cjs.js"),oe=require("./BBAnchor.cjs.js"),ie=require("./useTrailTexture.cjs.js"),ae=require("./useCubeCamera.cjs.js"),ue=require("./CurveModifier.cjs.js"),ce=require("./MeshDistortMaterial.cjs.js"),ne=require("./MeshWobbleMaterial.cjs.js"),je=require("./MeshReflectorMaterial.cjs.js"),pe=require("./MeshRefractionMaterial.cjs.js"),xe=require("./MeshTransmissionMaterial.cjs.js"),le=require("./MeshDiscardMaterial.cjs.js"),qe=require("./PointMaterial.cjs.js"),de=require("./shaderMaterial.cjs.js"),me=require("./softShadows.cjs.js"),Ce=require("./shapes.cjs.js"),he=require("./RoundedBox.cjs.js"),Me=require("./ScreenQuad.cjs.js"),Se=require("./Center.cjs.js"),Te=require("./Bounds.cjs.js"),be=require("./CameraShake.cjs.js"),fe=require("./Float.cjs.js"),Be=require("./Stage.cjs.js"),Pe=require("./Backdrop.cjs.js"),ge=require("./Shadow.cjs.js"),ve=require("./Caustics.cjs.js"),Ae=require("./ContactShadows.cjs.js"),Le=require("./AccumulativeShadows.cjs.js"),De=require("./Reflector.cjs.js"),ke=require("./SpotLight.cjs.js"),Ge=require("./Environment.cjs.js"),Ee=require("./Lightformer.cjs.js"),Re=require("./Sky.cjs.js"),we=require("./Stars.cjs.js"),ze=require("./Cloud.cjs.js"),Fe=require("./Sparkles.cjs.js"),Oe=require("./useEnvironment.cjs.js"),Ie=require("./useMatcapTexture.cjs.js"),He=require("./useNormalTexture.cjs.js"),Ve=require("./Wireframe.cjs.js"),ye=require("./Points.cjs.js"),We=require("./Instances.cjs.js"),Qe=require("./Segments.cjs.js"),Xe=require("./Detailed.cjs.js"),Ke=require("./Preload.cjs.js"),Ne=require("./BakeShadows.cjs.js"),Ue=require("./meshBounds.cjs.js"),_e=require("./AdaptiveDpr.cjs.js"),Je=require("./AdaptiveEvents.cjs.js"),Ye=require("./PerformanceMonitor.cjs.js"),Ze=require("./RenderTexture.cjs.js"),$e=require("./Mask.cjs.js"),er=require("./Hud.cjs.js");require("@babel/runtime/helpers/extends"),require("react"),require("@react-three/fiber"),require("react-merge-refs"),require("three"),require("three-stdlib"),require("troika-three-text"),require("suspend-react"),require("meshline"),require("lodash.pick"),require("lodash.omit"),require("camera-controls"),require("zustand"),require("stats.js"),require("../helpers/useEffectfulState.cjs.js"),require("detect-gpu"),require("three-mesh-bvh"),require("../materials/BlurPass.cjs.js"),require("../materials/ConvolutionMaterial.cjs.js"),require("../materials/MeshReflectorMaterial.cjs.js"),require("../materials/MeshRefractionMaterial.cjs.js"),require("../materials/DiscardMaterial.cjs.js"),require("../helpers/environment-assets.cjs.js"),require("../materials/SpotLightMaterial.cjs.js"),require("../materials/WireframeMaterial.cjs.js"),require("react-composer"),exports.Billboard=e.Billboard,exports.ScreenSpace=r.ScreenSpace,exports.QuadraticBezierLine=s.QuadraticBezierLine,exports.CubicBezierLine=t.CubicBezierLine,exports.CatmullRomLine=o.CatmullRomLine,exports.Line=i.Line,exports.PositionalAudio=a.PositionalAudio,exports.Text=u.Text,exports.Text3D=c.Text3D,exports.Effects=n.Effects,exports.isWebGL2Available=n.isWebGL2Available,exports.GradientTexture=j.GradientTexture,exports.Image=p.Image,exports.Edges=x.Edges,exports.Trail=l.Trail,exports.useTrail=l.useTrail,exports.Sampler=q.Sampler,exports.useSurfaceSampler=q.useSurfaceSampler,exports.ComputedAttribute=d.ComputedAttribute,exports.Clone=m.Clone,exports.MarchingCube=C.MarchingCube,exports.MarchingCubes=C.MarchingCubes,exports.MarchingPlane=C.MarchingPlane,exports.Decal=h.Decal,exports.Svg=M.Svg,exports.Gltf=S.Gltf,exports.AsciiRenderer=T.AsciiRenderer,exports.OrthographicCamera=b.OrthographicCamera,exports.PerspectiveCamera=f.PerspectiveCamera,exports.CubeCamera=B.CubeCamera,exports.DeviceOrientationControls=P.DeviceOrientationControls,exports.FlyControls=g.FlyControls,exports.MapControls=v.MapControls,exports.OrbitControls=A.OrbitControls,exports.TrackballControls=L.TrackballControls,exports.ArcballControls=D.ArcballControls,exports.TransformControls=k.TransformControls,exports.PointerLockControls=G.PointerLockControls,exports.FirstPersonControls=E.FirstPersonControls,exports.CameraControls=R.CameraControls,exports.GizmoHelper=w.GizmoHelper,exports.useGizmoContext=w.useGizmoContext,exports.GizmoViewcube=z.GizmoViewcube,exports.GizmoViewport=F.GizmoViewport,exports.Grid=O.Grid,exports.useCubeTexture=I.useCubeTexture,exports.useFBX=H.useFBX,exports.useGLTF=V.useGLTF,exports.useKTX2=y.useKTX2,exports.useProgress=W.useProgress,exports.IsObject=Q.IsObject,exports.useTexture=Q.useTexture,exports.useVideoTexture=X.useVideoTexture,exports.Stats=K.Stats,exports.useDepthBuffer=N.useDepthBuffer,exports.useAspect=U.useAspect,exports.useCamera=_.useCamera,exports.useDetectGPU=J.useDetectGPU,exports.useHelper=Y.useHelper,exports.Bvh=Z.Bvh,exports.useBVH=Z.useBVH,exports.useContextBridge=$.useContextBridge,exports.useAnimations=ee.useAnimations,exports.useFBO=re.useFBO,exports.useIntersect=se.useIntersect,exports.useBoxProjectedEnv=te.useBoxProjectedEnv,exports.BBAnchor=oe.BBAnchor,exports.useTrailTexture=ie.useTrailTexture,exports.useCubeCamera=ae.useCubeCamera,exports.CurveModifier=ue.CurveModifier,exports.MeshDistortMaterial=ce.MeshDistortMaterial,exports.MeshWobbleMaterial=ne.MeshWobbleMaterial,exports.MeshReflectorMaterial=je.MeshReflectorMaterial,exports.MeshRefractionMaterial=pe.MeshRefractionMaterial,exports.MeshTransmissionMaterial=xe.MeshTransmissionMaterial,exports.MeshDiscardMaterial=le.MeshDiscardMaterial,exports.PointMaterial=qe.PointMaterial,exports.PointMaterialImpl=qe.PointMaterialImpl,exports.shaderMaterial=de.shaderMaterial,exports.SoftShadows=me.SoftShadows,exports.Box=Ce.Box,exports.Capsule=Ce.Capsule,exports.Circle=Ce.Circle,exports.Cone=Ce.Cone,exports.Cylinder=Ce.Cylinder,exports.Dodecahedron=Ce.Dodecahedron,exports.Extrude=Ce.Extrude,exports.Icosahedron=Ce.Icosahedron,exports.Lathe=Ce.Lathe,exports.Octahedron=Ce.Octahedron,exports.Plane=Ce.Plane,exports.Polyhedron=Ce.Polyhedron,exports.Ring=Ce.Ring,exports.Shape=Ce.Shape,exports.Sphere=Ce.Sphere,exports.Tetrahedron=Ce.Tetrahedron,exports.Torus=Ce.Torus,exports.TorusKnot=Ce.TorusKnot,exports.Tube=Ce.Tube,exports.RoundedBox=he.RoundedBox,exports.ScreenQuad=Me.ScreenQuad,exports.Center=Se.Center,exports.Bounds=Te.Bounds,exports.useBounds=Te.useBounds,exports.CameraShake=be.CameraShake,exports.Float=fe.Float,exports.Stage=Be.Stage,exports.Backdrop=Pe.Backdrop,exports.Shadow=ge.Shadow,exports.Caustics=ve.Caustics,exports.ContactShadows=Ae.ContactShadows,exports.AccumulativeShadows=Le.AccumulativeShadows,exports.RandomizedLight=Le.RandomizedLight,exports.accumulativeContext=Le.accumulativeContext,exports.Reflector=De.Reflector,exports.SpotLight=ke.SpotLight,exports.SpotLightShadow=ke.SpotLightShadow,exports.Environment=Ge.Environment,exports.EnvironmentCube=Ge.EnvironmentCube,exports.EnvironmentMap=Ge.EnvironmentMap,exports.EnvironmentPortal=Ge.EnvironmentPortal,exports.Lightformer=Ee.Lightformer,exports.Sky=Re.Sky,exports.calcPosFromAngles=Re.calcPosFromAngles,exports.Stars=we.Stars,exports.Cloud=ze.Cloud,exports.Sparkles=Fe.Sparkles,exports.useEnvironment=Oe.useEnvironment,exports.useMatcapTexture=Ie.useMatcapTexture,exports.useNormalTexture=He.useNormalTexture,exports.Wireframe=Ve.Wireframe,exports.Point=ye.Point,exports.Points=ye.Points,exports.PointsBuffer=ye.PointsBuffer,exports.PositionPoint=ye.PositionPoint,exports.Instance=We.Instance,exports.Instances=We.Instances,exports.Merged=We.Merged,exports.Segment=Qe.Segment,exports.SegmentObject=Qe.SegmentObject,exports.Segments=Qe.Segments,exports.Detailed=Xe.Detailed,exports.Preload=Ke.Preload,exports.BakeShadows=Ne.BakeShadows,exports.meshBounds=Ue.meshBounds,exports.AdaptiveDpr=_e.AdaptiveDpr,exports.AdaptiveEvents=Je.AdaptiveEvents,exports.PerformanceMonitor=Ye.PerformanceMonitor,exports.usePerformanceMonitor=Ye.usePerformanceMonitor,exports.RenderTexture=Ze.RenderTexture,exports.Mask=$e.Mask,exports.useMask=$e.useMask,exports.Hud=er.Hud;

package/core/index.d.ts

@@ -58,6 +58,7 @@ export * from './useIntersect';
 export * from './useBoxProjectedEnv';
 export * from './BBAnchor';
 export * from './useTrailTexture';
+export * from './useCubeCamera';
 export * from './CurveModifier';
 export * from './MeshDistortMaterial';
 export * from './MeshWobbleMaterial';

package/core/index.js

@@ -58,6 +58,7 @@ export { useIntersect } from './useIntersect.js';
 export { useBoxProjectedEnv } from './useBoxProjectedEnv.js';
 export { BBAnchor } from './BBAnchor.js';
 export { useTrailTexture } from './useTrailTexture.js';
+export { useCubeCamera } from './useCubeCamera.js';
 export { CurveModifier } from './CurveModifier.js';
 export { MeshDistortMaterial } from './MeshDistortMaterial.js';
 export { MeshWobbleMaterial } from './MeshWobbleMaterial.js';

package/core/useCubeCamera.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("three"),r=require("react"),t=require("@react-three/fiber");function u(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var u=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,u.get?u:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var n=u(e),o=u(r);exports.useCubeCamera=function({resolution:u=256,near:a=.1,far:c=1e3,envMap:s,fog:f}={}){const i=t.useThree((({gl:e})=>e)),b=t.useThree((({scene:e})=>e)),d=r.useMemo((()=>{const r=new e.WebGLCubeRenderTarget(u);return r.texture.encoding=i.outputEncoding,r.texture.type=e.HalfFloatType,r}),[u,i.outputEncoding]);r.useEffect((()=>()=>{d.dispose()}),[d]);const g=r.useMemo((()=>new n.CubeCamera(a,c,d)),[a,c,d]);let l,p;const O=o.useCallback((()=>{l=b.fog,p=b.background,b.background=s||p,b.fog=f||l,g.update(i,b),b.fog=l,b.background=p}),[i,b,g]);return{fbo:d,camera:g,update:O}};

package/core/useCubeCamera.d.ts

@@ -0,0 +1,14 @@
+import * as THREE from 'three';
+import { Fog, FogExp2 } from 'three';
+export declare type CubeCameraOptions = {
+    resolution?: number;
+    near?: number;
+    far?: number;
+    envMap?: THREE.Texture;
+    fog?: Fog | FogExp2;
+};
+export declare function useCubeCamera({ resolution, near, far, envMap, fog }?: CubeCameraOptions): {
+    fbo: THREE.WebGLCubeRenderTarget;
+    camera: THREE.CubeCamera;
+    update: () => void;
+};

package/core/useCubeCamera.js

@@ -0,0 +1,50 @@
+import * as THREE from 'three';
+import { WebGLCubeRenderTarget, HalfFloatType } from 'three';
+import * as React from 'react';
+import { useMemo, useEffect } from 'react';
+import { useThree } from '@react-three/fiber';
+
+function useCubeCamera({
+  resolution = 256,
+  near = 0.1,
+  far = 1000,
+  envMap,
+  fog
+} = {}) {
+  const gl = useThree(({
+    gl
+  }) => gl);
+  const scene = useThree(({
+    scene
+  }) => scene);
+  const fbo = useMemo(() => {
+    const fbo = new WebGLCubeRenderTarget(resolution);
+    fbo.texture.encoding = gl.outputEncoding;
+    fbo.texture.type = HalfFloatType;
+    return fbo;
+  }, [resolution, gl.outputEncoding]);
+  useEffect(() => {
+    return () => {
+      fbo.dispose();
+    };
+  }, [fbo]);
+  const camera = useMemo(() => new THREE.CubeCamera(near, far, fbo), [near, far, fbo]);
+  let originalFog;
+  let originalBackground;
+  const update = React.useCallback(() => {
+    originalFog = scene.fog;
+    originalBackground = scene.background;
+    scene.background = envMap || originalBackground;
+    scene.fog = fog || originalFog;
+    camera.update(gl, scene);
+    scene.fog = originalFog;
+    scene.background = originalBackground;
+  }, [gl, scene, camera]);
+  return {
+    fbo,
+    camera,
+    update
+  };
+}
+
+export { useCubeCamera };