循序渐进(12)- krpano的内置元素

更新 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元素官方文档

请继续阅读:循序渐进(13)- 需要注意的krpano路径问题

在 “循序渐进(12)- krpano的内置元素” 上有 1 条评论

发表评论