krpanoxml参考文档

1、krpano XML参考krpano使用简单的xml文本文件来存储krpano查看器的设置。这些文件可以编写或编辑任何texteditor,但当写xml代码,xml-syntax-rules将受尊敬,这是很重要的!关于基本的xml语法的更多信息,请您看一看:<基本的XML语法规则>关于这个文档这个文档是关于krpano xml结构,对所有krpano xml元素、属性和值和动态krpano变量名称映射到他们。文档分为正常和先进的部分。这只是为了更好的可读性,更清晰。更高级的设置和标签默认是隐藏的,可以显示(或隐藏)按显示/隐藏高级设置按钮withhin每个文档的一部分。文

2、档主题:xml结构xml元素/属性/值的变量动态使用krpano变量和动作看看:<行动/脚本参考>krpano XML结构这里所有krpano xml元素的结构化清单:(点击一个元素来获得更多信息)例子<krpano> <include> <preview> <image> <view> <area> <display> <control> <cursors> <autorotate> <plugin> <layer> <hotspo

3、t> <style> <events> <action> <contextmenu> <progress> <network> <memory> <security> <textstyle> <lensflareset> <lensflare> <data> <scene></krpano>xml文件的根元素需要< krpano >元素。所有其他元素必须被放置在这个元素。krpano xml中的所有xml元素和

4、属性是可选的,可以定义一个几次,以任意顺序。当相同的元素将再次定义两个或两个以上的时候,然后后来/后将覆盖以前的声明。还可以定义额外的< krpano >元素中的< krpano >根元素本身在krpano宣布额外的设置范围。xml本身只是一个transport-format这意味着它将只用于运输krpano的数据查看器。当xml解析,那么xml元素将转换/映射到krpano内部数据结构。这意味着解析后内部没有xml了。注意，一些在krpano xml元素和属性是一种特殊的方式处理:name属性:当一个xml元素名称属性,那么这个元素将被解释为一个数组的元素。这意味着可

5、以有多个元素的xml元素,其中每个元素需要有自己独特的名字识别。数组的名称将xml元素的名称。name属性的重要提示:1.每个名称需要以英文字母开始!这意味着使用数量,名称是不允许的!当一个名称仍以数字字符开始,然后将被解释为数组索引名称。这是可以动态的基于索引的读访问内部的行动而不是定义元素。2.内部所有的名字将被转换成小写允许不分大小写访问!3.设备属性:设备属性在xml有着特殊的功能。它可以被定义在每个xml元素。当xml文件将被解析并转换为krpano内部数据结构,然后将每个xml元素首先检查其设备属性。当当前设备不匹配中的设置设备属性,那么这个xml元素及其所有子/ children

6、-elements将被忽略。检查设备的动态行为,使用设备对象。Syntax1.设备值可以是漂亮几分设备只有一个设备字符串或组合字符串。2.哪几个设备需要通过逻辑运算符组合。3.管道字符|可以用作或运营商,4.加上字符+和运营商5.感叹号!不操作符可用的设备： all使用这个元素在所有设备(默认) Flash使用这个元素只有krpano Flash查看器 HTML5使用这个元素只有在krpano HTML5浏览器 desktop只在桌面使用该元素 mobile只在手机使用该元素 tablet只有在平板电脑上使用该元素 css3d使用这个元素只有当CSS-3D-Transforms可用(仅HTML

7、5) WebGL使用这个元素只有当WebGL是可用的(仅HTML5) fullscreensupport使用这个元素只有在全屏模式的支持 touchdevice使用这个元素只有在触摸设备 gesturedevice使用这个元素只有在手势(多点触控)设备 iOS使用这个元素只有在iOS设备(iPhone、iPod、iPad) iOS # # # -使用这个元素只有在iOS版本高于# # # iPhone使用这个元素只能在iPhone和iPod Touch) iPod使用这个元素只有在iPod Touch iPad使用这个元素只有在iPad上 retina使用这个元素只有在iOS视网膜显示器 An

8、droid只在Android设备使用该元素 androidstock使用这个元素只有在“股票”(= WebView-based)Android浏览器blackberry只在黑莓手机使用该元素 chrome使用这个元素只有在Chrome浏览器(仅HTML5) Firefox使用这个元素只有在Firefox浏览器(仅HTML5) ie -使用这个元素只有在ie浏览器(仅HTML5) Safari使用这个元素只有在Safari浏览器(仅HTML5) opera使用这个元素只有在(Presto-based)Opera浏览器(仅HTML5)air使用这个元素只有在Adobe AIR的球员 standal

9、one使用这个元素只有在独立的flash播放器 Windows使用这个元素只能在Windows系统 Mac -使用这个元素只能在Mac OSX系统Linux只在Linux系统使用该元素例子：devices="html5"devices="flash"devices="mobile"devices="tablet"devices="iphone|ipad"devices="desktop|tablet+html5"devices="android+flash"

10、;devices="html5+!iphone"devices="iphone+retina" = iPhone 4, iPhone 5devices="ipad+retina" = iPad 3, iPad 4devices="ipad+iOS5.1" = iPad with iOS 5.1 or higherdevices="flash|webgl" = systems with fisheye-distortion support<include>:<include>

11、;元素可以用来加载和包括其他xml文件。之前krpano查看器将开始解析和解决一个xml文件,它会搜索所有包含的xml元素。包括元素会被发现,然后给定的xml将加载,加载xml文件的内容将插入在当前xml文件并替换include元素。在这包括加载和解决过程,包括xml文件的url属性将被调整。看到notes url属性的更多细节。当所有包含加载和解析,那么主要的xml解析开始。<action> / <data> / <scene> 元素:这些都是特殊的元素,在xml解析内容将被忽略。他们的整个内容将作为字符串存储在变量中这些元素的内容url属性：一个url属

12、性在任何xml元素将krpano在一种特殊的方式来处理。当一个相对路径作为url的值,这将是相对于xml文件,属性定义的url。这也适用于包括xml文件。这意味着一个包含xml的相对路径相对于包含xml文件本身并不是主要/根xml文件。注意:当设置/动态改变url属性,那么就没有自动与xml文件路径了!使路径相对于一些特殊的预定义的路径,可以在url路径中使用这些占位符。% FIRSTXML %第一个加载xml文件的路径。 % CURRENTXML % -路径主要当前加载的xml文件(不包括一个)。 % SWFPATH % - swf文件的路径。 % HTMLPATH % - html文件的路

13、径。 % BASEDIR %使用BASEDIR路径。%$VARIABLE% 变量-使用给定的变量的值这可以是任何krpano变量,但它必须定义在当前xml或场景将加载,如已经在html文件中或之前loadpano(),loadscene()调用。XML元素/属性/值的变量在这里详细krpano xml元素的文档:< krpano > 这是krpano xml文件的根元素。需要进一步的所有元素定义在这个元素。例子： <krpano version="1.17" onstart="" basedir="%FIRSTXML

14、%" bgcolor="" idletime="0.5" colorcorrection="default" logkey="true" showerrors="true" debugmode="false" > .</krpano>Attribute nameFull variable nameTypeDefault valueversionxmlversionString"1.17"信息krpano版本创建xml文件时使用。

15、这仅仅是一个可选的信息价值,但它仍然应该定义为允许处理潜在compatibility-related版本变化。Attribute nameFull variable nameTypeDefault valueonstartonstartAction Event "onstart"事件在这里/功能的任何行动都将被称为“开始”的帕诺人查看可以定义。Attribute nameFull variable nameTypeDefault valuebasedirbasedirString"%FIRSTXML%"定义的基目录loadpano()操作。这是

16、一个相对或绝对路径,也可以使用theurl占位符。defaultvalue % FIRSTXML %,这意味着所有以下XML文件的路径,由loadpano加载(),是相对于第一次加载XML文件。Attribute nameFull variable nameTypeDefault valuebgcolorbgcolorString""背景颜色。部分帕诺斯/平面图像的背景观众变得可见。当设置为一个有效的十六进制格式(如颜色号码。“0 xffffff”为白色),背景形状与颜色会呈现在帕诺人后面。当不设置或设置为无效值没有背景的形状将被使用,它的行为“透明”,显示了浏览器默认背景

17、颜色或html页面时使用窗口模式=“透明”嵌入设置。设置时,它还允许使用鼠标以外的帕诺人形象本身(当使用导航部分帕诺斯)。和它还允许正确大小不同的部分帕诺斯之间的混合。Attribute nameFull variable nameTypeDefault valueidletimeidletimeNumber0.5时间间隔,以秒为单位在调用闲置之前没有任何用户交互事件。Attribute nameFull variable nameTypeDefault valuecolorcorrectioncolorcorrectionString"default"变化的颜色校正设置F

18、lashplayer 10。在这里看到更多细节:Flashplayer10色彩校正可能设置: "default", "on", "off"警告可降解性能设置为 "on" !Attribute nameFull variable nameTypeDefault valuelogkeylogkeyBooleantrue启用/禁用“O”键盘键,开关输出/日志窗口/ off.Note这个参数将在启动时只检查一次!Attribute nameFull variable nameTypeDefault valueshowerr

19、orsshowerrorsBooleantrue应该输出/跟踪(output/trace)日志窗口打开错误发生时自动显示错误消息。Attribute nameFull variable nameTypeDefault valuedebugmodedebugmodeBooleanfalse应该从krpano调试跟踪消息或从插件被显示。Examples<krpano version="1.17" onstart="loadscene(scene1);"> <scene name="scene1"> . </s

20、cene></krpano><include>包括其他的xml文件(可以使用不止一次)。这可以用于xml定义分成几个文件,例如重复使用某些设置。include元素本身将被替换为加载包含xml文件的内容。包括xml文件的url属性将被调整。看到notes theurl属性的更多细节。<include url="path/name-of-the-other-xml-file.xml" />Attribute nameFull variable nameTypeDefault valueurl-Stringxml文件的url /path应

21、该包括在内Examples<include url="settings.xml" /><include url="skin/skin.xml" /><include url="%SWFPATH%/global.xml" /><preview> 定义的url /文件名来一个小“预览”全景图像同时显示加载完整的帕诺人的形象。这个预览图像应该应该小(在文件大小和图像尺寸),允许快速加载!注意:最佳呈现质量和性能cubestrip图片推荐!高质量的预览图像(平滑所有边缘和各个方向)可以很容易地用

22、kmakepreview或kmakemultires工具创建的。<preview type="" url="previewpano.jpg" striporder="LFRBUD" details="16" />Attribute nameFull variable nameTypeDefault valuetypepreview.typeString""设置全景类型的预览图像。可能的设置:"(=空,默认)没有设置时,预览图像的类型将自动检测到它的大小和side-aspec

23、t(例如 2:1 = sphere, 1:6 = cubestrip, .)"SPHERE""CYLINDER""CUBESTRIP""grid(.)" -生成一个网格预览图像grid(type,xsteps,ysteps,res,lincol,bkcol,pntcol)可选参数: xsteps =行像素之间的水平距离,默认= 10 ysteps =行像素之间的垂直距离,默认= 10res =解决gridimage,默认= 400lincol = hex-format线条的颜色(默认= 0 x666666) bkc

24、ol =背景颜色(默认= 0 x222222) pntcol =点的颜色(默认= linecolor)Attribute nameFull variable nameTypeDefault valueurlpreview.urlString预览图像的url /路径。这可能是一个球形、圆柱形或cubestrip(1 x6,6 x1 2 x3或3 x2)的形象。当一个部分会用帕诺人的形象,然后,hfov / vfov voffset设置将使用从<image>元素。Attribute nameFull variable nameTypeDefault valuestriporderpre

25、view.striporderString"LFRBUD"定义图片的顺序在cubestrip形象。Attribute nameFull variable nameTypeDefault valuedetailspreview.detailsint16内部呈现tesslation细节,细节值将导致更高更详细的内部3 d-geometry。当使用flash播放器10和体积图像无失真(鱼眼,球面,),那么该设置将被忽略,因为一个tesslation将是没有必要的。Examples<preview url="pano_preview.jpg" />&

26、lt;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>元素的xm

27、l(或在<scene>元素)的类型、图像文件的工具路径pano的定义。 选择在这里pano来显示xml结构的类型和设置: CUBE（多维数据集）：<image type="CUBE" tiled="false" tiledimagewidth="." tiledimageheight="." tilesize="." baseindex="1" frames="1" frame="1" prealign=&q

28、uot;" > <cube url="pano_%s.jpg" /></image>在“%s”占位符的立方体侧面的特征（L，R，B，F，U，D）或<image type="CUBE" tiled="false" tiledimagewidth="." tiledimageheight="." tilesize="." baseindex="1" frames="1" frame="

29、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="p

30、ano_b.jpg" rotate="0" flip="" /> <up url="pano_u.jpg" rotate="0" flip="" /> <down url="pano_d.jpg" rotate="0" flip="" /></image>CUBESTRIP（多维数据集带） <image type="CUBESTRIP"> &l

31、t;cubestrip url="cubestrip.jpg" /> <left strip="0" rotate="0" flip="" /> <front strip="1" rotate="0" flip="" /> <right strip="2" rotate="0" flip="" /> <back strip="3"

32、 rotate="0" flip="" /> <up strip="4" rotate="0" flip="" /> <down strip="5" rotate="0" flip="" /></image>SPHERE （球）<image type="SPHERE" hfov="360" vfov="" voffset

33、="0" tiled="false" tiledimagewidth="." tiledimageheight="." tilesize="." baseindex="1" frames="1" frame="1" prealign="" > <sphere url="pano.jpg" /></image>CYLINDER （圆柱）<image ty

34、pe="CYLINDER" hfov="360" vfov="" voffset="0" tiled="false" tiledimagewidth="." tiledimageheight="." tilesize="." baseindex="1" frames="1" frame="1" prealign="" > <cylinder ur

35、l="pano.jpg" /></image>FLAT（平）<image type="CYLINDER" hfov="1.0" tiled="false" tiledimagewidth="." tiledimageheight="." tilesize="." baseindex="1" frames="1" frame="1" prealign=""

36、 > <cylinder url="image.jpg" /></image>QTVR <image type="QTVR"> <qtvr url="qtvrpano.mov" preview="true" setview="true" /></image>Zoomify <image type="ZOOMIFY" hfov="." vfov=""

37、; voffset="0" multiresthreshold="0.025" progressive="true" > <zoomify url="zoomifypano/ImageProperties.xml" type="SPHERE" setview="true" /></image>视频 +分辨分析<plugin name="video" url="videoplayer.swf"

38、 videourl="." /><image type="SPHERE" hfov="360" vfov="" voffset="0" prealign="" > <sphere url="plugin:video" /></image>or<image type="CYLINDER" hfov="360" vfov="" voffset="

39、;0" prealign="" > <cylinder url="plugin:video" /></image>在“video”的播放器插件播放视频的名字HTML5笔记-在HTML5浏览器只立方体和cubestrip图像支持！此外，由于一些技术上的限制，cubestrip图像应仅用于小图像的典型用法将预览图像。Attribute nameFull variable nameTypeDefault valuetypeimage.typeString定义的全景图像的类型。可能的值：SPHERE球形或圆柱的全

40、景图像。偏布也是可能的，在这个案例hfov设置和电压设置和选择的vfov也应该被用来定义下的维数。· CUBE立方体全景图像，六幅图像，每一个立方体的一面。· CUBESTRIP一个立方体全景图像是在一个单一的图像imagestrip”。支持的图像的命令是6x1，1x6，3x2或2x3。从立方体侧图像分配可以用带设置。CYLINDER柱面全景图像。圆柱部分帕诺斯也是可能的，在这种情况下，高频振荡通气设置也选择vfov和Voffset设置应该被用来定义Pano尺寸。·· QTVR使用cubicial QTVR.mov文件作为pano源.ZOOMI

41、FY使用zoomify图像作为输入源。该zoomify图像可用于（部分）的球形，圆柱形或扁平的全景.当使用简单的非多分辨率图像类型设置可以留下不注意，在这种情况下，将自动检测在<image>标签的标签.Attribute nameFull variable nameTypeDefault valuehfovimage.hfovNumber卧式defines the field of view（高频失真）of the Pano图像在度。This is the可见光that was on the Pano被俘的形象。

42、默认值是360，which means a view all around。使用偏小值的全景。for平Panos（或正常的图像）the value“1”should be used。Attribute nameFull variable nameTypeDefault valuevfovimage.vfovNumber定义的垂直视野（vfov）度全景图像。默认情况下（在没有值集），这个值可以通过使用HFOV自动计算的全景，类型和的全景图像的侧面。Attribute nameFull variable nameTypeDefault valuevoffsetimage.voffsetN

43、umber0.0定义了度的全景图像的垂直偏移。默认情况下，全景图像将集中在三维空间。这意味着观看范围将从HFOV / 2 + HFOV2和从vfov / 2 + vfov / 2。现在使用的图像部分均在地平线上不在图像中间时（不在0度），然后这个图像将显示扭曲。该Voffset可用于转移的视场范围内上升或下降到中心的图像正确地在三维空间。如何正确Voffset值：当的全景图像的垂直距离是已知的，那么它可以计算：voffset = (vfov_min + vfov_max) / 2例如240x100均与FO

44、V从- 75 + 25：vfov_min = -75vfov_max = +25voffset = (-75 + 25) / 2 = -25或看到的结果为360x180 pano - 90 + 90vfov_min = -90vfov_max = +90voffset = (-90 + 90) / 2 = 0.0当垂直范围是未知的，试试一些值（消极的和积极的，在范围从90到90）。此外，它可以在这里设置有帮助<view limitview="off" />在XML允许查看整个图像部分没有观看的局限性。Attrib

45、ute nameFull variable nameTypeDefault valuetiledimage.tiledBooleanfalse使一个平铺/切片图像中的应用。当设置为true，那么也tiledimagewidth，该tiledimageheight和tilesizeattributes必须设置来定义图像和tilesize。Attribute nameFull variable nameTypeDefault valuetiledimagewidthtiledimageheightimage.tiledimagewidthimage.tiledimageheightintint集的

46、平铺图像的全尺寸。Attribute nameFull variable nameTypeDefault valuetilesizeimage.tilesizeint定义了tilesize瓷砖或分辨分析图像.Attribute nameFull variable nameTypeDefault valuebaseindeximage.baseindexint1指标库（编号为砖等开始）。Attribute nameFull variable nameTypeDefault valuemultiresimage.multiresBooleanfalse使一个平铺/切片的多分辨率图像的使用。当设置为

47、true，那么<image>元素需要包含与每个多分辨率图像定义几个<level>元素Attribute nameFull variable nameTypeDefault valuemultiresthresholdimage.multiresthresholdNumber0.025阈值时，控制从一个多分辨率层次切换到下一个。合理的值是从1到+ 1，但较低或较高值也是可能的.Attribute nameFull variable nameTypeDefault gressiveBooleantrue启用或禁用渐进多分辨率

48、加载。逐步加载意味着多分辨率均将被加载步按从低到高的分辨率的步骤。只有在当前浏览范围的瓷砖将从水平加载。禁用时，那么当前的分辨率的瓷砖将装在第一，然后在当前所有可见的瓷砖加载完成，它将开始预当前视图的较低的分辨率。Attribute nameFull variable nameTypeDefault valueprealignimage.prealignString以prealign图像本身设置均可以对齐/旋转。这可以用来正确对齐pano小姐。语法:prealign="X|Y|Z"X，Y，Z定义了这些轴的旋转度。Attribute nameFull variable nam

49、eTypeDefault valueframesframeimage.framesimage.frameintint11当前帧与帧的均数。采用多帧图像的均是可能的，有%的F占位符中必须使用的图像的URL。这个占位符将与当前帧号取代。Full variable name (as3 usage only)TypeDefault valueimage.layerSpriteActionScript 3精灵对象的全景图像层。Attribute nameFull variable nameTypeDefault valuecube.urlimage.cube.urlString定义了一个立方体

50、全景图像的路径或URL。该路径包含一%的立方体侧占位符（L，R，B，F，U，D）。Attribute nameFull variable nameTypeDefault valueleft.urlfront.urlright.urlback.urlup.urldown.urlimage.left.urlimage.front.urlimage.right.urlimage.back.urlimage.up.urlimage.down.urlStringStringStringStringStringString定义了多维数据集的人脸图像的路径或URL。注：参见“瓦片索引占位符的笔记瓦占位符At

51、tribute nameFull variable nameTypeDefault valueleft.stripfront.stripright.stripback.stripup.stripdown.stripimage.left.stripimage.front.stripimage.right.stripimage.back.stripimage.up.stripimage.down.stripintintintintintint012345为cubestrip帕诺斯，定义的图像部分/带的cubestrip为cubeface图像。Attribute nameFull variable

52、nameTypeDefault valueleft.rotatefront.rotateright.rotateback.rotateup.rotatedown.rotateimage.left.rotateimage.front.rotateimage.right.rotateimage.back.rotateimage.up.rotateimage.down.rotateintintintintintint000000旋转的立方体面度。可用于其他非krpano立方体图像。Attribute nameFull variable nameTypeDefault valueleft.flipfr

53、ont.flipright.flipback.flipup.flipdown.flipimage.left.flipimage.front.flipimage.right.flipimage.back.flipimage.up.flipimage.down.flipStringStringStringStringStringString翻转/镜图像沿x和/或Y轴。可能的值：“X”或“Y”或“XY”或“默认”“，”Attribute nameFull variable nameTypeDefault valuecubestrip.urlimage.cubestrip.urlString定义一个立

54、方体带图像的路径或URL。Attribute nameFull variable nameTypeDefault valuesphere.urlimage.sphere.urlString定义了一个球形或部分球面全景图像的路径或URL。注：参见“瓦片索引占位符的笔记瓦占位符Attribute nameFull variable nameTypeDefault valuecylinder.urlimage.cylinder.urlString定义了一个圆柱形或部分圆柱形全景图像的路径或URL。注：参见“瓦片索引占位符的笔记瓦占位符Attribute nameFull variable nameT

55、ypeDefault valueqtvr.urlimage.qtvr.urlString定义的路径或URL是MOV QTVR图像布。基于静态图像的JPEG编码的文件具有只读cubical文件是可能的。Attribute nameFull variable nameTypeDefault valueqtvr.previewimage.qtvr.previewBooleantrue如果定义了嵌入式预览图像的QTVR MOV文件应该被使用。Attribute nameFull variable nameTypeDefault valueqtvr.setviewimage.qtvr.setv

56、iewBooleantrue如果定义viewng方向设置从QTVR.mov文件应使用/套。Attribute nameFull variable nameTypeDefault valuezoomify.urlimage.zoomify.urlString定义了zoomify XML文件的路径或URL，典型的“XML imageproperties。”。该zoomify砖必须在同一文件夹中此XML文件。Attribute nameFull variable nameTypeDefault valuezoomify.typeimage.zoomify.typeString"SPHERE

57、"定义的zoomify图像的全景式。可能的值是“球”或“缸”（ "SPHERE" or "CYLINDER"）Attribute nameFull variable nameTypeDefault valuezoomify.setviewimage.zoomify.setviewBooleantrue当启用时，查看设置将调整为zoomify用法。（无鱼眼和maxpixelzoom = 0.95）Full variable name (read only)TypeDefault valueimage.level.co

58、untint0所有图像层次的元素计数/数。Attribute nameFull variable nameTypeDefault valuelevel.tiledimagewidthlevel.tiledimageheightimage.level.tiledimagewidthimage.level.tiledimageheightintint设置此级别的平铺图像的全尺寸。Attribute nameFull variable nameTypeDefault valuelevel.tilesizeimage.level.tilesizeint此设置将否决的主要image.tilesize这个

59、级别设置。Attribute nameFull variable nameTypeDefault valuelevel.downloadlevel.decodeimage.level.downloadimage.level.decodeStringString"auto""auto"如果定义所有的瓷砖，水平应该下载并解码或只有一次，是目前需要查看。可能的值：“所有”，“视图”或“自动”（ "all", "view" or "auto"） all从水平砖将被加载。 view仅为当前视图所需的瓷砖将下载。 auto当水平的大小是小于10像素（=宽×高10MP）然后“所有”瓷砖将被加载，否则只有“视图”瓷砖.Attribute nameFull variable nameTypeDefault valuelevel.detailsimage.level.detailsint此设置将放弃默认display.details设置。Att