feat: useCubeCamera hook

[abernier]

Note Merged
see useCubeCamera doc

Why / What

New hook useCubeCamera() "low-level" version:

const { fbo, update, camera } = useCubeCamera({resolution?, near?, far?, fog?, envMap?})

useFrame(() => {
  // camera.position.set(...) // (1) position the cube-camera wherever you want

  ref.current.visible = false
  update() // 📸
  ref.current.visible = true
})

<group {...props}>
  <primitive object={camera} /> {/* add to the scene or (1) */}
  <mesh ref={ref}>
    <sphereGeometry args={[5, 64, 64]} />
    <meshStandardMaterial roughness={0} metalness={1} envMap={fbo.texture} />
  </mesh>
</group>

Classic component <CubeCamera> version (uses hook internally):

<CubeCamera {...props}>
  {(texture) => (
    <mesh>
      <sphereGeometry args={[5, 64, 64]} />
      <meshStandardMaterial roughness={0} metalness={1} envMap={texture} />
    </mesh>
  )}
</CubeCamera>

Checklist

• Documentation updated
• Storybook entry added
• Ready to be merged

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
drei	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 5, 2023 10:45pm

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit cfd4718:

Sandbox	Source
epic-euclid-9ss4ck	Configuration
Ground reflections and video textures	Configuration
arc-x-pmndrs-colors	Configuration

[abernier]

thank you @CodyJasonBennett for your review 👌🏻

[github-actions]

🎉 This PR is included in version 9.64.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀