if元素说明文档(1.21)

<if>

更新 2023.3.30 krpano 1.21

只有满足条件时,才分析 XML 的特定部分。
if 属性类似,但适用于多个 xml 元素。

注意 – 这里有一个限制: <include> 元素始终会被加载/包含,即使条件可能不满足。这是因为include解析是实际xml解析之前的单独初始过程!

<if check=”条件”>
… 其他xml元素 …
</if>
属性名 类型 默认值
check String
用于检查的条件/表达式。
此处使用的变量必须是已定义的变量。

 

cssstyles元素说明文档(1.21)

<cssstyles>

更新 2023.3.21 krpano 1.21

直接在 xml 文件中定义任意CSS 样式。

等同于html 文件中包含.css文件或html文件<head>部中定义的<style>元素。

定义CSS样式/类,是为在具有cssclass设置的textfield或图层/容器中使用它们。

语法:

 

注意:

  • krpano不解析<cssstyles>元素内的内容,但因为需要在xml进行定义,所以xml语法规则以及若干xml实体自动解析过程仍然生效。
  • 为了避免任何的xml语法规则和xml实体解析,需将整个数据内容放在 <![CDATA[以及]]> 内。这样所有字符和xml标签都不会被解析。
  • 例子 – 使用 CDATA 避免xml解析:
<cssstyles><![CDATA[

]]></cssstyles>

layer/hotspot元素说明文档(1.21)

<layer><hotspot>

更新 2023.4.30 krpano 1.21

<layer> 与<hotspot> 是krpano主要的界面交互元素:

  • layer元素基于 2D 屏幕空间,是可用于所有类型的布局元素。可包含图像,文本,按钮,视频,也可以为其他layer创建容器以及添加特殊元素,如嵌入iframe,html代码甚至其他krpano viewer。
  • hotspot元素与layer元素基本相同,但处于全景图/3D空间中。
  • hotspot元素还能绘制多边形或直线。
  • 这两种元素可通过父设置或定义更多layer子元素来组合、堆栈、继承。
  • 从技术上看,layer元素就是HTML元素,hotspot元素可以是HTML元素也可以由WebGL绘制,这取决于 renderer 设置和hotspot的类型(type),以及是否需要进行立体渲染(stereo-rendering )。

关于 <plugin> 元素:

  •  <plugin> 元素和 <layer> 元素本质上是同一元素
  • 仅仅名字不同而已。
  • 任何时候都可以使用<layer>或<plugin> 或反向来处理相同的元素。在静态xml代码和动态Action或Javascript代码中,是相同的。
  • 术语 ‘plugin(插件)’ 来自krpano的老版本,其中的插件主要用于包含用于进一步交互的外部工具。
  • 如今,该元素提供了更多的布局功能,因此较新的术语“layer(图层)”更好地描述了它的行为、
  • 因此建议<plugin>仅在包含使用附加功能扩展的krpano插件(如SoundinterfaceWebVR插件)时使用,<layer>则使用在所有与布局相关的元素。

目录

(更多…)

debug元素说明文档

<debug>

更新 2023.3.21 krpano 1.21

跟踪/输出xml解析过程中的信息。
注意 – 调错信息只有在debugmode设置启用时可显示!
<debug trace=”…” />
属性名 类型 默认值
trace String
任意数字、文本或表达式

 

hotspot元素说明文档(1.20)

<hotspot>

更新 2022.3.7 krpano 1.20.11

以下为隐藏内容

热点是全景内部区域,热点可以与鼠标发生交互,鼠标可悬停或点击在热点上。热点可用于载入其它全景、链接到其他超链接、改变视角等等。

krpano有两种类型的热点:
(更多…)