Krpano教程tour.xml详解

Posted 2021-02-15 cangqinglang

<krpano version="1.18"             //版本号  
    onstart=""                  //网页启动时调用的函数  
    basedir="%FIRSTXML%"        //设置程序根目录  
    bgcolor=""                  //页面背景颜色  
    idletime="0.5"              //没用户干预情况下的调用时间  
    colorcorrection="default"   //flash 10配送方案  
    logkey="true"               //是否输出日志  
    showerrors="true"          //是否输出错误信息  
    debugmode="false"          //编译模式是否打开  
>  
//...  
</krpano>  

//krpano作为XML文件唯一根元素，必须设置！  

//样例：   
<krpano version="1.18" onstart="loadscene(scene1);">  
  <scene name="scene1">  
  //...  
  </scene>  
</krpano> 

##autorotate（自动旋转、扭曲／移动，缩放 ）

<autorotate enabled="false"     //是否开启自动旋转  
    waittime="1.5"      //用户不对屏幕操作后，开始自动旋转的等待秒数  
    accel="1.0"         //旋转扭曲的速度：角度/秒  
    speed="10.0"        //最大旋转速度：角度/秒  
    horizon="0.0"       //旋转到特定的水平位置  
    tofov="off"         //缩放到特定的区域视角  
/>  
  
//当无用户交互时．自动旋转、扭曲／移动，缩放  

//样例：  
<autorotate enabled="true"  
    waittime="5.0"   
    speed="-3.0"   
    horizon="0.0"   
    tofov="120.0"   
/>  

自动旋转控制：

switch(autorotate.enabled);

<krpano version="1.18" onstart="switch(autorotate.enabled);"> 

##include
##skin_settings
##action
##scene（场景）

###view（默认视角的参数设置和视角限制设置）

<view hlookat="0.0"    //水平视角  -180 至  180 之间  
      vlookat="0.0"    //垂直视角  -90  至  90  之间  
      camroll="0.0"    //镜头旋转视角  
      fovtype="VFOV"   //定义视场角类型  
      fov="90.0"        //默认视角的缩放  
      fovmin="1.0"      //默认视角缩放最大值  
      fovmax="179.0"    //默认视角缩放最小值  
      maxpixelzoom=""   //默认视角最大缩放倍数  
      fisheye="0.0"     //鱼眼视角设置 0.0 至  1.0 之间（扭曲程度）  
      fisheyefovlink="0.5"  //fov值与鱼眼视角的关联值，默认0.5(0.0-3.0之间)  
      stereographic="false" //是否启动立体鱼眼投影效果（小行星）  
      pannini="false"       //启用/禁用“Pannini / vedutismo”投影效果  
      architectural="0.0"   //建筑视角设置 0.0 至  1.0 之间  
      architecturalonlymiddle="false"  //是否只对中间区域的图像实行建筑投影  
      limitview="auto"    //视角限制类型  
      hlookatmin=""   //最小水平视角范围  (-180 .. +180).  
      hlookatmax=""   //最大水平视角范围  (-180 .. +180).  
      vlookatmin=""   //最小垂直视角范围  (-90 .. +90).  
      vlookatmax=""   //最大垂直视角范围  (-90 .. +90).  
/>  

fovtype 几种选项（在手机和平板设备的默认值将MFOV！）：

 - vfov -垂直视场，基于屏幕的高度  。
 - HFOV -水平视野，基于屏幕宽度
 - DFOV -看对角线场，基于屏幕的对角线
 - MFOV -最大的视场（动态混合vfov和HFOV）

limitview 几种选项：

 - off--不限制在所有  
 - auto--自动限制（默认）  
 - lookat--限制查看变量直。（接“hlookatmin”，“hlookatmax”，“vlookatmin”，“vlookatmax”）
 - range--限制的地区设置（由“hlookatmin”，“hlookatmax”，“vlookatmin”，“vlookatmax”，只有在这个范围内，允许观察）  
 - fullrage--的地区设置（由“hlookatmin”，“hlookatmax”，“vlookatmin”，“vlookatmax”，但允许放大看到整个图像  ）
 - offrange---限制的地区设置（由“hlookatmin”，“hlookatmax”，“vlookatmin”，“vlookatmax”，但不以任何方式限制缩放。  ）


//默认视角的参数设置和视角限制设置  
//样例：   
//正常: 
<view hlookat="0" vlookat="0" fov="80" />  
  
//小行星视角
<view hlookat="0"  
      vlookat="90"  
      fisheye="1.0"  
      stereographic="true"  
      fov="150"  
      fovmax="150"  
      />  
  
//平面全景
<view hlookat="0"  
      vlookat="0"  
      maxpixelzoom="1.0"  
      limitview="fullrange"  
      /> 

###preview（指定一张全景预览图）

<preview type=""              //过渡全景图的类型  
    url="previewpano.jpg"     /过渡全景图路径  
    striporder="LFRBUD"       //定义图像顺序  
    details="16"              //图像细节质量调整，越大越清晰  
/>  

//指定一张全景预览图，以便在读取过程中，过渡显示   

//样例：  
<preview url="pano_preview.jpg" />  
<preview type="grid(CUBE,16,16,512,0xCCCCCC,0xFFFFFF,0x999999);" />  
<preview type="SPHERE" url="spherepreview.jpg" details="16" />  
<preview type="CUBESTRIP" url="cspreview.jpg" />  

###image（加载图片资源）

<image type="CUBE"                //全景图类型（六面体）  
       tiled="false"              //是否使用平铺图像  
       tiledimagewidth="..."      //平铺图像宽度  
       tiledimageheight="..."     //平铺图像高度  
       tilesize="..."             //平铺图像大小  
       baseindex="1"              //图像读取默认索引数字(第一个)  
       frames="1"                 //当前图像帧数       
       frame="1"  
       prealign=""                //prealign,采用X|Y|Z轴对齐方式  
 >  
    <cube url="pano_%s.jpg" />  
</image>  
//where "%s" is the placeholder of the cube-side character (l,f,r,b,u,d)  

//以上是数字索引方式读取切片图片，以下是通过定义六个方向的图片路径读取切片，文件后缀要加上_l，_f....方式来识别。  

<image type="CUBE"  
       tiled="false"   
       tiledimagewidth="..."   
       tiledimageheight="..."   
       tilesize="..."  
       baseindex="1"  
       frames="1"   
       frame="1"  
       prealign=""  
 >  
    <left  url="pano_l.jpg" rotate="0" flip="" />  
    <front url="pano_f.jpg" rotate="0" flip="" />  
    <right url="pano_r.jpg" rotate="0" flip="" />  
    <back  url="pano_b.jpg" rotate="0" flip="" />  
    <up    url="pano_u.jpg" rotate="0" flip="" />  
    <down  url="pano_d.jpg" rotate="0" flip="" />  
</image>