官方XML扩展应用(1.21)

默认的krpano下载包包括若干基于xml的扩展或辅助程序脚本。相关的 xml 文件可以在插件文件夹中找到,并在需要时可以选择include。因为是 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插件(如SoundinterfaceWebVR插件)时使用,<layer>则使用在所有与布局相关的元素。

目录

(更多…)