krpano xml参考1.docx

1、krpano xml参考1Krpano XML参考目 录关于这个文档 2krpano XML结构 2name属性： 4Syntax 5include： 7url属性： 7XML元素/属性/值的变量 823个属性 12 12 14 31 37 41 46(Flash only) 51 53/ 55 70 87 88 93 96 99show / hide advanced settings 102 103 103(Flash only) 105Full variable name(read only) 106Type 106Default value 106(Flash only) 111(Fl

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

3、属性/值的变量动态使用krpano变量和动作看看：krpano XML结构这里所有krpano xml元素的结构化清单：(点击一个元素来获得更多信息)例子 xml文件的根元素需要元素。所有其他元素必须被放置在这个元素。krpano xml中的所有xml元素和属性是可选的，可以定义一个几次，以任意顺序。当相同的元素将再次定义两个或两个以上的时候，然后后来/后将覆盖以前的声明。还可以定义额外的元素中的根元素本身在krpano宣布额外的设置范围。xml本身只是一个transport-format这意味着它将只用于运输krpano的数据查看器。当xml解析，那么xml元素将转换/映射到krpano内部

4、数据结构。这意味着解析后内部没有xml了。注意，一些在krpano xml元素和属性是一种特殊的方式处理：name属性：当一个xml元素名称属性，那么这个元素将被解释为一个数组的元素。这意味着可以有多个元素的xml元素，其中每个元素需要有自己独特的名字识别。数组的名称将xml元素的名称。name属性的重要提示：1.每个名称需要以英文字母开始！这意味着使用数量，名称是不允许的！当一个名称仍以数字字符开始，然后将被解释为数组索引名称。这是可以动态的基于索引的读访问内部的行动而不是定义元素。2.内部所有的名字将被转换成小写允许不分大小写访问！3.设备属性：设备属性在xml有着特殊的功能。它可以被定义

5、在每个xml元素。当xml文件将被解析并转换为krpano内部数据结构，然后将每个xml元素首先检查其设备属性。当当前设备不匹配中的设置设备属性，那么这个xml元素及其所有子/ children-elements将被忽略。检查设备的动态行为，使用设备对象。Syntax1.设备值可以是漂亮几分设备只有一个设备字符串或组合字符串。2.哪几个设备需要通过逻辑运算符组合。3.管道字符|可以用作或运营商，4.加上字符+和运营商5.感叹号！不操作符可用的设备： all使用这个元素在所有设备(默认) Flash使用这个元素只有krpano Flash查看器 HTML5使用这个元素只有在krpano HTML

6、5浏览器 desktop只在桌面使用该元素 mobile只在手机使用该元素 tablet只有在平板电脑上使用该元素 css3d使用这个元素只有当CSS-3D-Transforms可用(仅HTML5) WebGL使用这个元素只有当WebGL是可用的(仅HTML5) fullscreensupport使用这个元素只有在全屏模式的支持 touchdevice使用这个元素只有在触摸设备 gesturedevice使用这个元素只有在手势(多点触控)设备 iOS使用这个元素只有在iOS设备(iPhone、iPod、iPad) iOS # # # -使用这个元素只有在iOS版本高于# # # iPhone使

7、用这个元素只能在iPhone和iPod Touch) iPod使用这个元素只有在iPod Touch iPad使用这个元素只有在iPad上 retina使用这个元素只有在iOS视网膜显示器 Android只在Android设备使用该元素 androidstock使用这个元素只有在“股票”(= WebView-based)Android浏览器blackberry只在黑莓手机使用该元素 chrome使用这个元素只有在Chrome浏览器(仅HTML5) Firefox使用这个元素只有在Firefox浏览器(仅HTML5) ie -使用这个元素只有在ie浏览器(仅HTML5) Safari使用这个元素

8、只有在Safari浏览器(仅HTML5) opera使用这个元素只有在(Presto-based)Opera浏览器(仅HTML5)air使用这个元素只有在Adobe AIR的球员 standalone使用这个元素只有在独立的flash播放器 Windows使用这个元素只能在Windows系统 Mac -使用这个元素只能在Mac OSX系统Linux只在Linux系统使用该元素例子：devices=html5devices=flashdevices=mobiledevices=tabletdevices=iphone|ipaddevices=desktop|tablet+html5devices

9、=android+flashdevices=html5+！iphonedevices=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 supportinclude：元素可以用来加载和包括其他xml文件。之前krpano查看器将开始解析和解决一个xml文件，它会搜索所有包含的xml元素。包括元素会被发现

10、，然后给定的xml将加载，加载xml文件的内容将插入在当前xml文件并替换include元素。在这包括加载和解决过程，包括xml文件的url属性将被调整。看到notes url属性的更多细节。当所有包含加载和解析，那么主要的xml解析开始。 / / 元素：这些都是特殊的元素，在xml解析内容将被忽略。他们的整个内容将作为字符串存储在变量中这些元素的内容。url属性：一个url属性在任何xml元素将krpano在一种特殊的方式来处理。当一个相对路径作为url的值，这将是相对于xml文件，属性定义的url。这也适用于包括xml文件。这意味着一个包含xml的相对路径相对于包含xml文件本身并不是主要

11、/根xml文件。注意：当设置/动态改变url属性，那么就没有自动与xml文件路径了！使路径相对于一些特殊的预定义的路径，可以在url路径中使用这些占位符。% FIRSTXML %第一个加载xml文件的路径。 % CURRENTXML % -路径主要当前加载的xml文件(不包括一个)。 % SWFPATH % - swf文件的路径。 % HTMLPATH % - html文件的路径。 % BASEDIR %使用BASEDIR路径。%$VARIABLE%变量-使用给定的变量的值这可以是任何krpano变量，但它必须定义在当前xml或场景将加载，如已经在html文件中或之前loadpano()，lo

12、adscene()调用。XML元素/属性/值的变量在这里详细krpano xml元素的文档： 这是krpano xml文件的根元素。需要进一步的所有元素定义在这个元素。例子： .Attribute nameFull variable nameTypeDefault valueversionxmlversionString1.17信息krpano版本创建xml文件时使用。这仅仅是一个可选的信息价值，但它仍然应该定义为允许处理潜在compatibility-related版本变化。Attribute nameFull variable nameTypeDefault valueonstartons

13、tartActionEvent onstart事件在这里/功能的任何行动都将被称为“开始”的帕诺人查看可以定义。Attribute nameFull variable nameTypeDefault valuebasedirbasedirString%FIRSTXML%定义的基目录loadpano()操作。这是一个相对或绝对路径，也可以使用theurl占位符。defaultvalue % FIRSTXML %，这意味着所有以下XML文件的路径，由loadpano加载()，是相对于第一次加载XML文件。Attribute nameFull variable nameTypeDefault val

14、uebgcolorbgcolorString背景颜色。部分帕诺斯/平面图像的背景观众变得可见。当设置为一个有效的十六进制格式(如颜色号码。“0 xffffff”为白色)，背景形状与颜色会呈现在帕诺人后面。当不设置或设置为无效值没有背景的形状将被使用，它的行为“透明”，显示了浏览器默认背景颜色或html页面时使用窗口模式=“透明”嵌入设置。设置时，它还允许使用鼠标以外的帕诺人形象本身(当使用导航部分帕诺斯)。和它还允许正确大小不同的部分帕诺斯之间的混合。Attribute nameFull variable nameTypeDefault valueidletimeidletimeNumber0

15、.5时间间隔，以秒为单位在调用闲置之前没有任何用户交互事件。Attribute nameFull variable nameTypeDefault valuecolorcorrectioncolorcorrectionStringdefault变化的颜色校正设置Flashplayer 10。在这里看到更多细节：Flashplayer10色彩校正可能设置： default， on， off警告可降解性能设置为 on ！Attribute nameFull variable nameTypeDefault valuelogkeylogkeyBooleantrue启用/禁用“O”键盘键，开关输出/日

16、志窗口/ off.Note这个参数将在启动时只检查一次！Attribute nameFull variable nameTypeDefault valueshowerrorsshowerrorsBooleantrue应该输出/跟踪(output/trace)日志窗口打开错误发生时自动显示错误消息。Attribute nameFull variable nameTypeDefault valuedebugmodedebugmodeBooleanfalse应该从krpano调试跟踪消息或从插件被显示。Examples . 包括其他的xml文件(可以使用不止一次)。这可以用于xml定义分成几个文件，

17、例如重复使用某些设置。include元素本身将被替换为加载包含xml文件的内容。包括xml文件的url属性将被调整。看到notes theurl属性的更多细节。Attribute nameFull variable nameTypeDefault valueurl-Stringxml文件的url /path应该包括在内Examples23个属性 定义的url /文件名来一个小“预览”全景图像同时显示加载完整的帕诺人的形象。这个预览图像应该应该小(在文件大小和图像尺寸)，允许快速加载！注意：最佳呈现质量和性能cubestrip图片推荐！高质量的预览图像(平滑所有边缘和各个方向)可以很容易地用km

18、akepreview或kmakemultires工具创建的。Attribute nameFull variable nameTypeDefault valuetypepreview.typeString设置全景类型的预览图像。可能的设置：(=空，默认)没有设置时，预览图像的类型将自动检测到它的大小和side-aspect(例如 2：1 = sphere， 1：6 = cubestrip， .)SPHERECYLINDERCUBESTRIPgrid(.) -生成一个网格预览图像grid(type，xsteps，ysteps，res，lincol，bkcol，pntcol)可选参数： xsteps

19、 =行像素之间的水平距离，默认= 10 ysteps =行像素之间的垂直距离，默认= 10res =解决gridimage，默认= 400lincol = hex-format线条的颜色(默认= 0 x666666) bkcol =背景颜色(默认= 0 x222222) pntcol =点的颜色(默认= linecolor)Attribute nameFull variable nameTypeDefault valueurlpreview.urlString预览图像的url /路径。这可能是一个球形、圆柱形或cubestrip(1 x6，6 x1 2 x3或3 x2)的形象。当一个部分会用帕

20、诺人的形象，然后，hfov / vfov voffset设置将使用从元素。Attribute nameFull variable nameTypeDefault valuestriporderpreview.striporderStringLFRBUD定义图片的顺序在cubestrip形象。Attribute nameFull variable nameTypeDefault valuedetailspreview.detailsint16内部呈现tesslation细节，细节值将导致更高更详细的内部3 d-geometry。当使用flash播放器10和体积图像无失真(鱼眼，球面，)，那么该设置将被忽略，因为一个tesslation将是没有必要的。Examples或演示：视图预览的一些例子互动元素的xml(或在元素)的类型、图像文件的工具路径pano的定义。 选择在这里pano来显示xml结构的类型和设置：CUBE（多维数据集）： 在“%s”占位符的立方体侧面的特征（L，R，B，F，U，D）或 CUBESTRIP（多维数据集带） SPHERE（球） CYLINDER（圆柱） FLAT（平）image type=CYLINDER hfov=1.0 tiled=false tiledimagewidth=. tiledimagehei