站点导航

超级教程  ➠  体验家教程  ➠  代码运行器

入门教程  ➠  初级教程

教程索引  ➠  插件分类检索
krpano版本更新说明与下载  ➠  krpano-BUG汇总
本站教程更新索引  ➠  教程学习指南
2024.4.21
新增 移花接木（32）- 全景截图

 

2024.4.19
修改 移花接木（2）- 添加背景音乐和控制声音播放的按钮  krpano 1.21不支持flash，因此插件url属性需明确指向soundinterface.js

修改 移花接木（10）- 为场景增加krpano雨雪特效  krpano 1.21不支持flash，因此插件url属性需明确指向snow.js

修改 移花接木（12）- 添加自定义地图  krpano 1.21不支持flash，因此插件url属性需明确指向radar.js

修改 移花接木（14）- 插入平面视频或热点视频  krpano 1.21不支持flash，因此插件url属性需明确指向videoplayer.js

修改 移花接木（22）- krpano制作简单的全景视频项目 krpano 1.21不支持flash，因此插件url属性需明确指向videoplayer.js

 

2024.4.18
修改 krpano版本更新说明增加关于krpano 1.21的发布说明

新增 VR热点提示插件

 

2024.4.8
新增 krpano对三维模型使用的轨道控制插件

（更多…）

krpano threeJS插件

krpano ThreeJS Plugin threejs_krpanoplugin.jsVersion 1.22

  • 这是在 krpano 中使用 ThreeJS 3D 图形库的插件。
  • 使用该插件，可以将三维模型（glb、gltf、obj+mtl 文件）用作 krpano 热点。这些热点可以与 krpano 内容交互和交叉，并自动支持所有 krpano 热点控件和事件。
  • 此外，该插件还支持许多使用 3D 内容的辅助功能：
  • 该插件直接集成并嵌入了ThreeJS库及其部分附加模块。这种集成可大大加快加载速度，并提供更好的浏览器兼容性。
  • 除了插件提供的功能外，还可以通过 Javascript 直接访问 ThreeJS 库并执行自定义任务。
  • 为实现更多自定义功能，并帮助了解集成工作原理，该插件提供了开源版本。


文档主题：

（更多…）

krpano地图插件（1.22）

krpano Maps Plugin krpanomaps.xmlVersion 1.22

  • 基于 krpano 的地图插件，使用 Open Street Map 图像（或其他地图）。
  • 与谷歌地图和必应地图插件兼容，可直接替代谷歌地图和必应地图插件。
  • 作为基于 krpano 的开源 xml 插件，自定义程度更高且更加灵活，例如在地图上可使用任何类型的 krpano 热点或 krpano 图层。


插件文档主题：

（更多…）

plugin元素说明文档

<plugin>

更新 2025.2.7 krpano 1.22.3

 

关于 <plugin> 元素:

  •  <plugin> 元素和 <layer> 元素本质上是同一元素
  • 仅仅名字不同而已。
  • 任何时候都可以使用<layer>或<plugin> 或反向来处理相同的元素。在静态xml代码和动态Action或Javascript代码中，是相同的。
  • 术语 ‘plugin（插件）’ 来自krpano的老版本，其中的插件主要用于包含用于进一步交互的外部工具。
  • 如今，该元素提供了更多的布局功能，因此较新的术语“layer（图层）”更好地描述了它的行为、
  • 因此建议<plugin>仅在包含使用附加功能扩展的krpano插件（如Soundinterface或WebVR插件）时使用，<layer>则使用在所有与布局相关的元素。
  • 以下是关于<plugin> 的特殊用法，该设置仅与xml解析有关:
    • 当加载一个 krpano Javascript Plugin 并在xml文件中定义api属性时，将立即创建具有该名称的全局 krpano 插件对象。
    • 插件的item元素将获得与 api属性中设置中相同的名称。
    • 这允许在 xml 解析期间使用短的 api 名称设置指向该插件的链接。
    • 例子 – 当插件定义如下:
      可以使用api名字链接插件:
      替代完整的插件名称:

languages元素说明文档

<languages>

更新 2025.2.7 krpano 1.22.3

 

languages 变量（元素）是预定义的，但默认情况下为空的 krpano 数组。
它可以包任何自定义属性，该属性在 translate() 表达式用于查找当前语言中的单词。

使用例子:

翻译右键菜单中的全屏选项:
一个全屏按钮文本，该文本根据当前语言和当前全屏状态自动更改：:

layer/hotspot元素说明文档（1.22）

<layer><hotspot>

更新 2025.2.7 krpano 1.22.3

<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 ）。

目录

（更多…）

N氏场景分组插件

简介

  • 将全景分组，并生成分组列表。
  • 自动创建分组图标。
  • 可以为每个分组创建自己的图标。
  • 可改变图标的大小。
  • 为缩略图添加标题。
  • 可以通过参数更改列表位置。
  • 可更改列表的外观（拥有若干预设）。你也可以创造自己的外观。
  • 容易使用。
  • 不需要编辑xml中的代码。

 

（更多…）

VR热点提示插件

简介

 

  • 该插件可在VR模式下使用！
  • 一个简单可定制的热点提示插件，可以在热点上使用。
  • 可以定义两种不同的热点（圆形或方形）。
  • 可以设置热点的颜色、大小、搏动、透明度和图标
  • 可以设置全部的提示或单独进行设置（背景颜色、透明度、位置、大小……）。
  • 每个热点都可以单独配置（聚焦、缩放、视场…）。

（更多…）

krpano对三维模型使用的轨道控制插件

该插件使得在krpano对三维模型的鼠标和手势控制跟在普通的三维模型查看器一样。

触屏控制:

  • 双击: 将旋转中心设置到该位置并放大
  • 两个手指缩放: 缩放模型
  • 两个手指拖放动: 将模型左右上下移动
  • 滑动: 旋转模型

鼠标控制:

  • 双击: 将旋转中心设置到该位置并放大

  • 点击并拖动: 旋转模型

  • shift + 点击: 将模型左右上下移动

  • control + 点击: 靠近或远离模型

  • 鼠标滚轮: 放大模型

（更多…）

Z滤镜插件

简介

Z滤镜是一个后处理WebGL着色器插件，可实现全景图、layer和hotspot的动态效果，您可以为启动界面、场景变化、弹出窗口添加视觉效果，例如设置或调整简单属性可调节亮度，饱和度或模糊你的全景图！

  • 调整着色器 gamma、亮度、对比度，曝光、色调、饱和度、鲜艳度、怀旧、反转和混合色
  • 使用blur和fblur（fastblur）进行模糊！
  • 渐晕和颜色融合！
  • 有趣的着色器旋转、像素化、波纹、分裂和索贝尔！
  • 支持layer和hotspot的滤镜和背景滤镜！亮度、对比度、饱和度、色调、褐色调、反转、模糊、阴影
  • 可实时显示数值的编辑器

（更多…）

Z截图插件

简述

Z截图插件用于在全景中截图， 可以获取和保存支持跨浏览器的屏幕截图。
通过简单的 onclick 动作添加截图功能。

  • 与浏览器窗口无关，可自定义分辨率和宽高比。
  • 高分辨率截图（使用krpano 1.20.1或更高版本）
  • 用图像或文字为截图添加水印！
  • 不需要依赖其他组件（如jquery或其他脚本）
  • 非常简单易用！

案例

（更多…）

官方XML扩展应用（1.22-1.21）

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

可使用的xml扩展：

（更多…）

页面: 1 2

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

Bing Maps Plugin bingmaps.jsVersion 1.22

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


插件文档主题：

（更多…）

页面: 1 2

if元素说明文档（1.22-1.21）

<if>

更新 2025.2.7 krpano 1.22.3
只有满足条件时，才分析 XML 的特定部分。
与 if 属性类似，但适用于多个 xml 元素。注意 – 这里有一个限制： <include> 元素始终会被加载/包含，即使条件可能不满足。这是因为include解析是实际xml解析之前的单独初始过程！
<if check=”条件”>
… 其他xml元素 …
</if>
属性名 类型 默认值
check String
用于检查的条件/表达式。
此处使用的变量必须是已定义的变量。

 

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.22-1.21）

ScrollArea layer type=scrollareaVersion 1.22

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

（更多…）

页面: 1 2

Textfield官方文档（1.22-1.21）

Textfield layer type=textVersion 1.22

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

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

（更多…）

页面: 1 2

cssstyles元素说明文档（1.21）

<cssstyles>

更新 2025.2.7 krpano 1.22.3

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

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

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

语法：

 

注意：

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

3D空间距离测量插件

简介

 

插件压缩包解压，将measure3d.xml以及logic.xml复制到根目录下。

嵌入xml文件

在电脑上打开项目，按m键，会出现一个地板跟随热点，鼠标点击后，出现两个紫色圆点，可调整三维坐标以确定两点之间的距离。

（更多…）