站点导航

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

入门教程    初级教程

教程索引    插件分类检索
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对三维模型使用的轨道控制插件

(更多…)

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.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.12.11 krpano 1.21.2
只有满足条件时,才分析 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.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插件(如SoundinterfaceWebVR插件)时使用,<layer>则使用在所有与布局相关的元素。

目录

(更多…)

3D空间距离测量插件

简介

 

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

嵌入xml文件

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

(更多…)