首页IT科技vue做地图(记录–使用Lunchbox 在 vue3 中创建一个 3D 地球)

vue做地图(记录–使用Lunchbox 在 vue3 中创建一个 3D 地球)

时间2025-06-20 14:56:10分类IT科技浏览6011
导读:这里给大家分享我在网上总结出来的一些知识,希望对大家有所帮助...

这里给大家分享我在网上总结出来的一些知识              ,希望对大家有所帮助

<Lunchbox> <mesh> <boxGeometry :args="[1, 1 ,1]" /> <meshBasicMaterial :color="0xffff00" /> </mesh> </Lunchbox>
你会注意到                      ,在上面的示例中       ,每个<Lunchbox>组件都与对应的 Three.js 类和一个camelCase名称相匹配               。
// three.js new THREE.Mesh() <!-- Lunchbox --> <mesh/> // three.js new THREE.BoxGeometry() <!-- Lunchbox --> <boxGeometry/>
Lunchbox.js 和 Three.js 的语法非常相似       ,但有一些不同之处需要注意                     。 例如                      ,每个<Lunchbox>组件都使用args属性将参数作为props       。argsprop接受一个参数数组并将其传递给组件的类构造函数               。
new THREE.BoxGeometry(1, 2, 3)
上面的代码将在 Lunchbox 中转换为以下内容:
<boxGeometry :args="[1, 2, 3]" />
其他 Three.js 对象属性              ,例如MeshBasicMaterial类的color属性       ,可以作为响应式属性添加到<Lunchbox>组件上                     。 这就像我们在前面的例子中看到的一样       。
<meshBasicMaterial :color="red" />
但是                      ,使用点符号的属性(例如位置向量)将在<Lunchbox>组件中使用破折号 - 进行设置              ,如下所示:
<mesh :position-x="3" />

Lunchbox为大多数 Three.js 类提供内置支持; 你可以在此处找到组件列表        。

可以使用 Lunchbox的app.extend方法添加包含的组件中不可用的类                     。 例如,下面是我们如何将orbitControl类添加到 Lunchbox:

import { createApp } from lunchboxjs import App from YourApp.vue import { OrbitControls } from three/examples/jsm/controls/OrbitControls createApp(App) .extend({ OrbitControls }) .mount(#app)

extend() 方法是 Lunchbox 的独特功能之一                      ,使用该方法添加的类继承了 <Lunchbox> 组件的所有功能              。

我们已经了解了 Lunchbox.js 的核心概念                      ,接下来我们将了解如何使用 Lunchbox 进行构建        。

开始

要设置一个 Lunchbox.js 应用程序,首先使用 Vite 的 CLI 安装 Vue:

npm create vite@latest

运行命令后              ,从库列表中选择 Vue 并为项目命名                      。 接下来                      ,cd 进入项目文件夹并运行以下命令:

npm install lunchboxjs three

此命令将安装 Lunchbox.js 和 Three.js 作为 Vue 应用程序的依赖项              。 你可以在根目录的 package.json 文件中查看它们。

接下来清理项目中的样板代码       ,打开main.js文件              ,将内容替换为如下代码:

import { createApp } from lunchboxjs import App from ./App.vue createApp(App).mount(#app)

在这里                      ,我们从 lunchboxjs 而不是从 vue 导入 createApp 函数                      。 这会将 Vue 应用程序转换为 Lunchbox 环境                     。

现在我们可以开始在我们的应用程序中构建和渲染 3D 对象。

创建场景

场景是允许我们设置要渲染的项目的对象               。 它就像一个显示区域       ,可以将对象放在一起并呈现给浏览器                     。 以下是 Three.js 中设置的场景示例:

const scene = new THREE.Scene(); const camera = new THREE.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 0.1, 1000 ); const renderer = new THREE.WebGLRenderer(); renderer.setSize( window.innerWidth, window.innerHeight ); document.body.appendChild( renderer.domElement );

在Lunchbox.js 中设置场景更直接且不那么神秘       。 该库提供了一个 <Lunchbox> 组件       ,其中包含用于在 Three.js 中创建渲染器和场景的底层代码               。

要进行设置                      ,请转到 App.vue 主组件并将 <Lunchbox> 组件放在模板部分中              ,如下所示:

<template> <Lunchbox> <!-- ... --> </Lunchbox> </template>
嵌套在<Lunchbox>标记中的每个对象都将呈现给浏览器                     。 如果你保存代码并启动开发服务器       ,你应该会看到类似于下图的黑屏       。

这个黑屏是我们应用的渲染器; 我们添加到场景中的任何内容都将显示在这里        。 你可以使用背景道具更改背景颜色                      ,如下所示:

<Lunchbox background="indigo"> <!-- ... --> </Lunchbox>

以下是你可以在 <Lunchbox> 组件上使用的一些 props:

background cameraPosition camera zoom shadow

添加网格

几何是用于定义网格形状的 Three.js 类                     。 在本文前面              ,我们演示了如何使用 boxGeometry 组件渲染长方体网格              。 在这里,我们将看到如何向浏览器渲染更多 3D 形状        。

Lunchbox.js 带有几个自动生成的内置几何组件                      ,你可以在此处查看可用组件的列表                      。

继续并在Lunchbox标签内添加一个 <mesh> 组件                      ,并在其中嵌套你选择的任何几何组件              。 不要忘记包含一个带有颜色道具的材质组件。

<Lunchbox> <mesh> <boxGeometry /> <MeshBasicMaterial/> </mesh> </Lunchbox>

材质组件利用 Three.js Material() 类来定义网格的各种表面属性                      。

<mesh> 组件只接受一个 Geometry() 和 Material() 组件                     。 要为场景添加更多形状,我们必须创建更多网格              ,每个 Geometry() 一个                      ,如下所示。

<Lunchbox> <mesh> <boxGeometry /> <MeshBasicMaterial/> </mesh> <mesh> <torusKnotBufferGeometry /> <MeshBasicMaterial/> </mesh> </Lunchbox>
或者       ,我们可以为每个形状创建单独的组件并将它们导入到主组件中              ,如下所示:
<script> import {Sphere} from ./Sphere.vue </script> <template> <Lunchbox> <Sphere /> </Lunchbox> </template>
每个几何组件都接受独特的参数                      ,这些参数可用于微调和操纵其宽度               、高度                     、平滑度和其他视觉特征               。 可以使用args属性在 Lunchbox 中设置这些参数                     。
<torusKnotBufferGeometry :args="[1, 0.4, 240, 20]"/>
组件还接受多个 props       。 由于它作为Geometry()的容器       ,它还可以用于操纵位置       、旋转等               。
<Lunchbox> <mesh position-x="4" position-x="4"> ... </mesh> </Lunchbox>

在上面的代码中       ,我们添加了一个 positoin 属性                      ,它将球体网格沿 x 轴向右移动 4px                     。

以下是一些可用于操纵形状的网格 props:

position (x, y, z) rotation (x, y, x) scale (x, y)

网格也可以使用 <group> 组件进行分组       。 该组件用作几何图形的容器              ,我们可以在每个 <group> 中添加任意数量的 <mesh>        。

<Lunchbox> <group> <mesh> <boxGeometry /> <MeshBasicMaterial/> </mesh> <mesh> <torusKnotGeometry /> <MeshBasicMaterial/> </mesh> </group> </Lunchbox>

添加纹理

目前       ,我们的网格看起来不是很逼真                     。 应用的材料使它们看起来有点塑料              。 我们可以使用 Lunchbox 中的 <textureLoader> 组件应用纹理                      ,为每个网格赋予更逼真的外观        。

<textureLoader> 组件利用 Three.js Texture() 类              ,它让我们可以将逼真的纹理映射到引擎盖下的网格表面                      。 为了演示这个过程,我们将创建一个地球的 3D 模型              。

要创建地球                      ,请先清除场景                      ,然后使用<sphereGeometry/>组件创建具有球面几何形状的新网格。

<Lunchbox> <mesh> <sphereGeometry /> </mesh> </Lunchbox>
接下来,在网格中添加一个<meshPhysicalMaterial>组件并将<textureLoader>嵌套在其中              ,如下所示:
<Lunchbox> <mesh> <sphereGeometry :args="[1, 32, 32]" /> <meshPhysicalMaterial> <textureLoader /> </meshPhysicalMaterial> </mesh> </Lunchbox>

组件接受 src 和 attach prop                      。 src 属性接受纹理材质的相对或绝对路径                      ,而 attach 属性接受映射选项                     。

我们将在这个例子中使用 map 和 bumpMap 选项。 换句话说       ,我们必须在网格组件内声明第二个 <textureLoader>               。

复制下面的图像并将它们放在项目的 /public 文件夹中:

接下来              ,将第一个图像的路径添加到第一个<textureLoader>组件的src属性中                      ,并为附加属性赋予一个“map               ”值                     。

<meshPhysicalMaterial> <textureLoader src="https://www.cnblogs.com/first-image" attach="map" /> <textureLoader ... /> </meshPhysicalMaterial>
如果你现在保存项目       ,浏览器中将出现一个球形轮廓       。 这是因为我们的场景没有光源               。

要解决此问题       ,请在<Lunchbox>组件中添加<pointLight />和<directionalLight />组件                     。

<Lunchbox> <directionalLight /> <pointLight /> <mesh> ... </mesh> </Lunchbox>
现在                      ,如果你保存项目并返回浏览器              ,你应该会看到类似于下图的内容:

为了使图像更有趣和视觉上更令人惊叹       ,我们将使用第二张图像为地球添加逼真的轮廓       。

我们将按照我们处理第一张图像的方式进行处理        。 将图像的路径添加到 src 道具                      ,但这次给attachprop一个“bumpMap                     ”值                     。

添加动画

Lunchbox.js 提供了一个 onBeforeRender 函数              ,在渲染之前或之后的每一帧都会调用该函数              。 使用此函数,我们可以通过在每一帧上为其旋转属性添加一个值来为我们的地球设置动画        。

转到 App.vue 组件的脚本部分并从 Vue 导入 ref 和从 Lunchbox 导入 onBeforeRender 函数                      。

import {ref} from vue import {onBeforeRender} from lunchboxjs
接下来                      ,将ref分配给一个rotation变量                      ,并将一个具有以下属性的对象传递给它:
const rotation = ref({y: 0});
然后,调用 onBeforeRender 函数并添加以下代码:
onBeforeRender(() =>{ rotation.value.y += 0.02 })
在这里              ,我们在每一帧上为对象的 y 轴旋转添加 0.02 度              。 最后                      ,为地球的网格添加一个rotation-y属性       ,并将rotation.y值传递给它              ,如下所示:
<mesh rotation-y="rotation.y"> <sphereGeometry /> <meshPhysicalMaterial> <textureLoader ... /> <textureLoader ... /> </meshPhysicalMaterial> </mesh>

现在                      ,如果你保存项目       ,你的地球应该像下面的例子一样很好地动画。

你可以通过将 x 和 z 属性添加到 ref               、onBeforeRender 函数和地球的网格来添加更多旋转动画                      。

添加事件

我们可以像添加 Vue 中的任何其他元素一样向 <Lunchbox> 组件添加事件监听器                     。 为了演示       ,我们将添加一个 click 事件                      ,当它被触发时会暂停我们的地球动画。

继续在地球网格上创建一个 onClick 事件              ,如下所示:

<mesh rotation-y="rotation.y" @click=""> ... </mesh>
接下来       ,使用 ref 创建一个变量                      ,并将布尔值 true 传递给它               。 使用if语句将声明包装在onBeforeRender函数中:
const active = ref(true) onBeforeRender(() =>{ if(active){ rotation.value.y += 0.02 } })

在这里              ,我们将活动变量分配为 if 语句的条件                     。 当该值设置为 false 时,语句中的代码将不会被执行                      ,动画会暂停       。

最后                      ,将以下代码添加到<mesh>组件的onClick事件中:

<mesh rotation-y="rotation.y" @click="active = !active"> ... </mesh>

现在地球的动画在点击时会暂停播放,如下图:

现在              ,我们已经在 Vue 中成功构建了 3D 视觉效果!

本文转载于:

https://juejin.cn/post/7126059371938709517

如果对您有所帮助                      ,欢迎您点个关注       ,我会定时更新技术文档              ,大家一起讨论学习                      ,一起进步               。

声明:本站所有文章       ,如无特殊说明或标注       ,均为本站原创发布                     。任何个人或组织                      ,在未征得本站同意时              ,禁止复制                     、盗用       、采集        、发布本站内容到任何网站                     、书籍等各类媒体平台       。如若本站内容侵犯了原著者的合法权益       ,可联系我们进行处理        。

创心域SEO版权声明:以上内容作者已申请原创保护,未经允许不得转载,侵权必究!授权事宜、对本内容有异议或投诉,敬请联系网站管理员,我们将尽快回复您,谢谢合作!

展开全文READ MORE
怎样找到自己的价值观和价值观(怎样找到自己的价值观和行为)