目 录
概述
文件说明
载入全景
krpano xml语法
krpano xml内置元素
特殊属性
krpano
preview
image
view
area
display
control
cursors
autorotate
plugin/layer
hotspot
events
action
contextmenu
network
memory
security
lensflareset
lensflare
data
scene
style
include
progress(废弃)
textstyle(废弃)
action脚本语法
全局变量
逻辑、流程
数学运算符、函数
字符处理
动画效果
动态加载
视图动作、相机控制
本文档使用 看云 构建
- 2 -
坐标转换
更新重绘
动态添加移除元素
扩展js接口
调试
显示文字(废弃)
参考手册
常用操作
音乐控制
视频热点控制
全屏
键盘鼠标
场景
与js交互
获取中心坐标
插入全景视频
krpano tools使用
常用插件
Combobox(列表框)
Videoplayer(视频播放器)
Scrollarea(区域滚动)
Gyro2(陀螺仪)
MoreTweenTypes(动效)
gridmenu(网格缩略图)
skin_setting
本文档使用 看云 构建
- 3 -
概述
概述
本文档基于版本1.19 pr13,官网(https://krpano.com/)
注: 本文档由作者收集整理,并非全部原创,作者水平有限,敬请谅解
看云地址:https://www.kancloud.cn/wang11535041/test/355594
如果需要查看最新文档,请查看:Krpano全景漫游开发手册
概念
全景漫游(英文:panorama)技术可以让体验者在全景图像构建的全景空间里切换视角的浏览。它是通过拍摄
全景图像,再采用计算机图形图像技术构建出全景空间,让使用者能用控制浏览的方向,或左或右、或上或下观
看物体或场景,仿佛身临其境一般。与传统的3D建模相比,全景漫游技术制作简单,数据量小,系统消耗低,且
更有真实感。
早期270°或者360°全景漫游(柱状全景):
720°全景漫游:
全景图
全景图(这里特指球面全景图)是指一种图片宽高比为2比1的包含了360°x180°空间的图片,例如8000*4000的
jpg图片或tiff图片等。
本文档使用 看云 构建
- 4 -
概述
注:宽高比2:1为水平方向(360):垂直方向(180)
Krpano简介
krpano是一款全景漫游制作软件和工具。其具有以下特点:
高度灵活、性能卓越的轻量化全景漫游浏览器。
兼容HTML5和Flash,支持Webgl下的WebVR展示。
使用专用的krpano xml代码编写全景漫游,可开发出高度定制化的项目,也可利用krpano工具开发在线全
景制作及展示平台。
支持多种类型的全景图以及全景视频和环物全景。
支持多种投影模式。
同时提供简单高效的批处理方式,可在无需代码干预下迅速生成一个基本功能兼备的全景漫游项目。
如何选择
如果只想简单展示全景,无特殊定制需求,那么可以使用默认皮肤,或者使用全景平台进行开发。
如果需要开发全景平台、定制全景功能或者对全景开发有浓厚兴趣的可以学习和深入了解krpano。
特性
兼容Flash和HTML5
高性能和高质量的渲染
高度可定制的
丰富的全景格式和图像文件格式的支持
多分辨率
三维投影
虚拟旅游热点/脚本
渐进式
案例展示
见下载包或者官方网站https://krpano.com/examples/vtour/#top
本文档使用 看云 构建
- 5 -
文件说明
文件说明
下载包使用说明
examples文件夹
这是krpano的案例文件夹(1.19的examples文件夹在viewer文件夹下),里面包含了官方的绝大部分案例,这
些案例都是学习krpano代码的很好的素材。注意下载包的案例所使用的viewer是下载包自身的默认viewer文件
夹。因为你不能简单复制案例文件夹,你还需要设置一下对应viewer的路径,而且该viewer还必须是你自己的
viewer。
templates 文件夹
官方一系列模版所在的文件夹,包括了图片、xml、html以及相关配置文件等。通过对这里的了解和修改,我们
可以做出自己的皮肤模版,然后一键生成,实现批量的工作流。当然,正常情况下,你也无需从这里拷贝,因为
在droplet过程中会自动生成。部分模版在默认droplet过程中并没有使用到。
viewer 文件夹
本文档使用 看云 构建
- 6 -
文件说明
krpano 下载包的官方插件、引擎、案例的存放位置,同时也是让案例文件夹能够正确显示的 viewer 所在的位
置。其中plugins是当前版本的所有官方插件;examples是官方提供的案例。
小贴士
自身项目的 viewer(js和swf)会在droplet过程中自动生成无需从这里拷贝
droplet.bat 文件
Krpano Droplets 是krpano命令行工具加上配置文件config的一个快捷方式。droplets使用方式非常简单,将文
件(通常是图片或者xml等文件)直接拖放在droplet图标上松开即可。
本文档使用 看云 构建
- 7 -
文件说明
krpano droplet (图中齿轮状图标文件)
MAKE PANO (NORMAL) Droplet
用法说明:
生成普通 (=单分辨率) 全景.
制作典型的360度全景.
全部全景图将会一次性载入. 默认下方块最大边长为2048像素(可以在config配置文件中修改).
包括默认的导航皮肤.
支持Flash和HTML5.
Droplet 说明:
基于 kmakemultires 工具.
配置文件: normal.config
默认模版/皮肤配置文件: defaultbuttons.skin
本文档使用 看云 构建
- 8 -