krpano代码基础

if元素说明文档（1.21）

<if>

更新 2023.12.11 krpano 1.21.2
只有满足条件时，才分析 XML 的特定部分。
与 if 属性类似，但适用于多个 xml 元素。注意 – 这里有一个限制： <include> 元素始终会被加载/包含，即使条件可能不满足。这是因为include解析是实际xml解析之前的单独初始过程！

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

 

cssstyles元素说明文档（1.21）

<cssstyles>

更新 2023.12.11 krpano 1.21.2

直接在 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.12.11 krpano 1.21.2

<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插件（如Soundinterface或WebVR插件）时使用，<layer>则使用在所有与布局相关的元素。

目录

（更多…）

krpano xml元素文档索引

krpano xml元素文档

krpano本地/离线使用

如今，很多浏览器对于在本地运行互动内容时会有诸多限制。“本地”意味着直接在浏览器中打开来自本地文件系统的html文件。在浏览器的地址栏中显示的是file:// 路径。

在尝试运行一个本地html文件时，浏览器可能会限制脚本去访问其他本地文件，因为这个原因，动态加载xml、js或图片可能无法成功。

（更多…）

debug元素说明文档

<debug>

更新 2023.12.11 krpano 1.21.2

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