官方XML扩展应用（1.21）

默认的krpano下载包包括若干基于xml的扩展或辅助程序脚本。相关的 xml 文件可以在插件文件夹中找到，并在需要时可以选择include。因为是 xml 文件，因此可以轻松自定义以满足进一步的需求。

可使用的xml扩展：

（更多…）

必应地图插件官方说明文档（1.21）

Bing Maps Plugin bingmaps.jsVersion 1.21

  • 必应地图插件添加可交互的Bing Map到krpano viewer中。
  • 该地图可以任意尺寸放置在屏幕上的任意位置。
  • 可以在地图上放置点，并链接 actions例如loadpano ，这样在点击地图点时可载入其它全景。
  • 插件内置了一个可自定义的雷达，可在激活点上显示。
  • 可增加’Google Maps’ 样式的控制，例如添加位置和缩放控制。
  • 可动态控制整个地图和地图点，例如缩放地图，添加或移除点。
  • Google Maps / Bing Maps 注意事项 – 必应地图和谷歌地图的插件的XML接口几乎是相同的。要使用必应地图插件，只需要替换谷歌地图插件，将谷歌地图的密钥换成必应地图的密钥。


插件文档主题：

（更多…）

if元素说明文档（1.21）

<if>

更新 2023.3.30 krpano 1.21

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

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

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

 

krpano Javascript接口说明文档（1.21）

krpano Javascript接口Version 1.21

要从Javascript访问 krpano，需要 krpano Javascript-Interface object。此接口与 krpano HTML5 Viewer 和 krpano Flash Viewer 相同，可以相同的方式控制两个viewer。

可通过以下某种方式获取对象：

  • 使用 embedding script 的 onready 回调函数（推荐方法）。
  • 或通过Javascript 调用： document.getElementById(id)
    id参数是viewer的唯一性id（默认为”krpanoSWFObject“）可在embedding script中进行设置。

（更多…）

krpano插件接口说明文档（1.21）

krpano插件接口

更新 2023.3.21 krpano 1.20.11

krpano为开发者提供了简单轻便的接口用于开发第三方插件。krpano插件可以是纯代码插件，用于扩展功能或控制krpano，也可以是在屏幕上展示或处理某些事情的“图形化插件”。有两种类型的插件：

插件的基础结构里含有以下公共函数，它们将在krpano中被调用：

  • registerplugin函数 – 当插件载入时，该插件从krpano中被调用。该函数提供了krpano Interface Object以及krpano Plugin Object。
  • unloadplugin函数 – 当插件从krpano中移除时，该函数被调用。这样插件添加的所有元素和事件将被移除。
  • 此外提供了onresize函数允许插件根据屏幕大小改变插件的尺寸。

插件本身可以将自定义函数或属性直接添加/设置到krpano对象或插件对象中，实现向krpano添加自定义函数或属性。对于设置从xml中传递来的属性，提供了registerattribute函数，它可以使得属性既可以有自己的默认值，也可以接受从xml传递来的数值。registerattribute函数可以用来添加setter/getter属性-这些属性在访问变量时自动调用get或set函数-可用于在属性更改时获得通知。

 

（更多…）

ScrollArea官方文档（1.21）

ScrollArea layer type=scrollareaVersion 1.21

  • 可滚动区域 – 自动滚动父图层内的子图层。
  • scrollarea插件需定义尺寸和对齐方式，并且只能作为其他layer元素内的子layer。在其父元素中，可以通过拖动其子layer或使用鼠标滚轮来滚动scrollarea插件。
  • 滚动区域图层的大小需手动设置，或者通过启用flowchilden进行自动选择。

（更多…）

Textfield官方文档（1.21）

Textfield layer type=textVersion 1.21

  • 该插件是krpano中文本类型的元素。
  • 可用于按钮、简单文本甚至完整的HTML布局。
  • 可以是HTML标签或BBCode标签，并且用CSS标签或CSS类进行样式设置。
  • Textfield就是一个扩展的容器元素，可与容器元素共享多个设置和功能，例如背景形状、边框的设置、功能。
  • 通过layer/hotspot的标准属性可以定义插件的尺寸和位置。
  • 如果没有设定宽度/高度，元素将调整自身大小以适应给定的内容。当有进一步的更改时（例如，当嵌入的图像被加载或html内容本身更改时），它还会自动调整其大小。
  • textfiled也可以用于输入字段和编辑字段。
  • 当使用textfiled作为图层或CSS3D渲染的热点时，支持完整的HTML / CSS功能，但是当使用文本字段作为WebGL渲染的热点时，例如用于VR支持，则仅支持简单/简化的HTML / CSS子集。因为在这种情况下，需要手动绘制文本字段。

以下隐藏内容只提供VIP赞助会员，VIP会员说明请查看置顶文章

（更多…）

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

目录

（更多…）