循序渐进(11)- 1.21版本的默认tour.xml解析与换肤

更新 2024.4.19 krpano 1.21.2

这次我们专门来讲讲tour.xml里的静态元素的作用以及如何更换在1.21中更换皮肤。

krpano根元素

上次已经提及了krpano元素是krpano xml文件的根元素(krpano元素官方文档krpano元素完全解析),我们可以看到整个xml文件一头一尾都是由krpano所闭合的。而在krpano元素中version是版本号,它是一个系统内置属性。title是自定义属性,title定义的值在默认皮肤下是显示在缩略图左上角的文字。

 

include元素

详细说明看 include元素完全解析 主要是嵌入了 vtourskin.xml,将这个xml的全部内容引入到include所在的位置后,相当于合并成一个大的xml内容后再一同解析。

 

skin_settings元素

该元素为自定义元素,非内置元素。主要是为了默认皮肤的各自设置而设计的。

对应的意思是

如果你要更改皮肤样式,你可以改变上面的<skin_settings>数值,或者选择性地include下面一个预设的设计,可以通过移除特定include元素的if属性或者在html文件的embedpano()中增加initvar:{design:’flat_light’}

我们如果要更改为Ultra Light风格,我们可以改为:

注意,当你使用了以上五种皮肤时,对应的皮肤设置需要在对应的xml文件修改,例如glass的部分皮肤设置,需要在skin文件夹的vtourskin_design_glass.xml进行修改。

具体可查看 krpano1.19切换皮肤

action元素

接下来是自启动的action,这里的action使用了autorun属性,其中onstart数值将使得这个action可以在项目启动时执行,因此可以看到是执行了loadscene这个动作。默认是载入第一个场景。

 

scene元素

接下来我们看到一堆scene元素(scene元素官方说明文档scene元素完全解析)我们知道scene就相当于一个暂时不被解析的代码存储体,只有当前被loadscene的scene才会被解析其中的内容:

这里我们看到了几个元素,包括scene、view、image以及preview。

scene有点类似于krpano元素的感觉,只是它是写在krpano元素里面的。在scene元素里也可以放其它各种的元素,这些元素只在这个scene场景中起作用,意思是说,通常在跳转到其它scene时,上一个scene元素的内容就会被移除。在1.19 pr4后多了自定义属性havevrimage,这个是因为新版生成了专门为VR准备的全景图。我们可以直接查看conifg配置。

view元素

是控制浏览者在查看全景时的视角设置,例如起始位置、视域范围、可缩放范围、是否限制,限制观看的区域等等。

preview元素

控制预览图设置。

image元素

控制全景图设置。针对VR图使用if了属性,当进入VR时使用VR专用全景图。

注意scene里面的元素只对这个scene有效,因此每个scene都有一套对应的设置。

最后是krpano根元素收尾。

请继续阅读:循序渐进(12)- krpano的26个内置元素

在 “循序渐进(11)- 1.21版本的默认tour.xml解析与换肤” 上有 1 条评论

发表评论