更新 2020.9.15 krpano 1.20.8
krpano的代码可简单分为静态代码和动态代码的部分。静态代码就是24个内置元素(action元素比较特殊,其内容是动态代码)以及可自定义的其它元素。动态代码就是特指action元素的内容以及一些特定的元素的数值,例如事件触发的动作。本文简单介绍一下krpano24个内置元素。
<krpano>
krpano元素是krpano xml文件的根元素。任何一个krpano xml文件内的其它元素都要被krpano元素所嵌套。也就是krpano元素要放在一头一尾。
<include>
include元素可引入其它xml文件的内容,以便于更好的工作流程。例如我们常要用到的vtourskin.xml就是使用include嵌入到主xml中。使用include元素,相当于把所嵌入的xml文件的全部内容复制到include元素所在的代码行。
<preview>
preview元素对预览图进行设置。也就是全景图完全载入之前的模糊图像,但因为体积较小,因此载入速度较快,会在全景图之前先载入,避免黑屏。通常全景图拖到droplet下会自动生成预览图以及对应的preview代码,无需自行编写。
<image>
image元素控制全景图设置。包括全景图类型,渐进分辨率切片显示等。通常droplet会自动生成。无需自行编写。
<view>
view元素控制全景的视野。例如起始视角、视角限制与缩放等等。通常droplet会自动生成。当要设置限制视角或设定特定的初始视角时,需要自行设定或使用插件获取代码。
<area>
area元素控制全景图在浏览器(div)窗口中显示区域大小。
<display>
display元素控制全景图的显示品质。
<control>
control元素设置鼠标、键盘以及触摸设备对全景浏览的控制方式。
<cursors>
cursors元素设置鼠标光标样式。
<autorotate>
autorotate元素控制自动旋转。
<plugin>
<layer>
layer与plugin是同一种元素,只是名字不同。作用很大,可以调用插件,也可以插入图片和生成容器。
<hotspot>
hotspot元素即是热点,可在3D空间中插入图片,使之随着3D空间一同运动。可制作很多特效。
<style>
style元素可以保存其它元素的属性子集。注意在1.18以及之下只能是hotspot元素和layer元素的属性子集。
<events>
events元素可调用各类型事件,例如全景载入的不同阶段以及鼠标触发的不同行为等。
<action>
action元素可自定义动态代码。
<contextmenu>
contextmenu元素控制右键菜单内容。
<progress>
progress元素设置全景图载入进度。
<network>
network元素控制图像的下载、缓存与解码。
<memory>
memory元素控制全景图在设备中的存储。
<security>
security元素是与Flashplayer和HTML5相关的安全/跨域设置。
<textstyle>
textstyle元素是针对showtext的第二个参数的文本样式,官方推荐不再使用(1.18起)。
<lensflareset>
lensflareset元素是关于镜头眩光的设置(目前只能在flash下使用)。
<lensflare>
lensflare元素生成镜头眩光(目前只能在flash下使用)。
<data>
data元素可放置任意的数据。
<scene>
scene元素可放置任意krpano元素。每个scene元素只有在被loadscene时才会被载入到浏览器进行解析。
<set>
在xml解析过程中设置设置/定义一个变量。可用于设置或覆盖特殊的变量,这些特殊的变量在正常的xml声明无法访问。
<debug>
跟踪/输出xml解析过程中的信息。
详细完整的官方说明文档请查看下面的链接(部分文章为VIP会员内容)
krpano xml元素官方文档
- krpano xml元素基础官方文档
- krpano元素官方说明文档
- scene元素官方说明文档
- autorotate元素官方说明文档
- data元素官方说明文档
- style元素官方说明文档
- include元素官方说明文档
- preview元素官方说明文档
- view元素官方说明文档
- area元素官方说明文档
- cursors元素官方说明文档
- control元素官方说明文档
- display元素官方说明文档
- events元素官方说明文档
textstyle元素官方说明文档- lensflareset元素官方说明文档
- lensflare元素官方说明文档
- contextmenu元素官方说明文档
- action元素官方说明文档
- layer元素官方说明文档
- hotspot元素官方说明文档
- image元素官方说明文档
progress元素官方说明文档- network元素官方说明文档
- memory元素官方说明文档
- security元素官方说明文档
- textstyle元素官方说明文档
在 “循序渐进(12)- krpano的内置元素” 上有 1 条评论