krpano-xml详细文档

krpanoxml详细文档krpano使用简单的xml文本文件来存储krpano查看器的设置。这些文件可以编写或编辑任何texteditor,但当写xml代码,xml-syntax-rules将受尊敬,这是很重要的!关于基本的xml语法的更多信息,请您看一看:基本的XML语法规则关于这个文档这个文档是关于krpanoxml结构,对所有krpanoxml元素、属性和值和动态krpano变量名称映射到他们。文档分为正常和先进的部分。这只是为了更好的可读性,更清晰。更高级的设置和标签默认是隐藏的,可以显示(或隐藏)按显示/隐藏高级设置按钮withhin每个文档的一部分。文档主题:?xml结构?xml元素/属性/值的变量动态使用krpano变量和动作看看:行动/脚本参考krpanoXML结构这里所有krpanoxml元素的结构化清单:(点击一个元素来获得更多信息)例子krpanoincludepreviewimageviewareadisplaycontrolcursorsautorotatepluginlayerhotspotstyleeventsactioncontextmenuprogressnetworkmemorysecuritytextstylelensflaresetlensflaredatascene/krpano?xml文件的根元素需要krpano元素。所有其他元素必须被放置在这个元素。?krpanoxml中的所有xml元素和属性是可选的,可以定义一个几次,以任意顺序。当相同的元素将再次定义两个或两个以上的时候,然后后来/后将覆盖以前的声明。?还可以定义额外的krpano元素中的krpano根元素本身在krpano宣布额外的设置范围。?xml本身只是一个transport-format——这意味着它将只用于运输krpano的数据查看器。当xml解析,那么xml元素将转换/映射到krpano内部数据结构。这意味着解析后内部没有xml了。注意，一些在krpanoxml元素和属性是一种特殊的方式处理:name属性:当一个xml元素名称属性,那么这个元素将被解释为一个数组的元素。这意味着可以有多个元素的xml元素,其中每个元素需要有自己独特的名字识别。数组的名称将xml元素的名称。name属性的重要提示:1.每个名称需要以英文字母开始!这意味着使用数量,名称是不允许的!当一个名称仍以数字字符开始,然后将被解释为数组索引名称。这是可以动态的基于索引的读访问内部的行动而不是定义元素。2.内部所有的名字将被转换成小写允许不分大小写访问!3.设备属性:设备属性在xml有着特殊的功能。它可以被定义在每个xml元素。当xml文件将被解析并转换为krpano内部数据结构,然后将每个xml元素首先检查其设备属性。当当前设备不匹配中的设置设备属性,那么这个xml元素及其所有子/children-elements将被忽略。检查设备的动态行为,使用设备对象。Syntax1.设备值可以是漂亮几分设备只有一个设备字符串或组合字符串。2.哪几个设备需要通过逻辑运算符组合。3.管道字符|可以用作或运营商,4.加上字符+和运营商5.感叹号!不操作符可用的设备：all——使用这个元素在所有设备(默认)Flash——使用这个元素只有krpanoFlash查看器HTML5——使用这个元素只有在krpanoHTML5浏览器desktop——只在桌面使用该元素mobile——只在手机使用该元素tablet——只有在平板电脑上使用该元素css3d——使用这个元素只有当CSS-3D-Transforms可用(仅HTML5)WebGL——使用这个元素只有当WebGL是可用的(仅HTML5)fullscreensupport——使用这个元素只有在全屏模式的支持touchdevice——使用这个元素只有在触摸设备gesturedevice——使用这个元素只有在手势(多点触控)设备iOS——使用这个元素只有在iOS设备(iPhone、iPod、iPad)iOS###-使用这个元素只有在iOS版本高于###iPhone——使用这个元素只能在iPhone和iPodTouch)iPod——使用这个元素只有在iPodTouchiPad——使用这个元素只有在iPad上retina——使用这个元素只有在iOS视网膜显示器Android——只在Android设备使用该元素androidstock——使用这个元素只有在“股票”(=WebView-based)Android浏览器blackberry——只在黑莓手机使用该元素chrome——使用这个元素只有在Chrome浏览器(仅HTML5)Firefox——使用这个元素只有在Firefox浏览器(仅HTML5)ie-使用这个元素只有在ie浏览器(仅HTML5)Safari——使用这个元素只有在Safari浏览器(仅HTML5)opera——使用这个元素只有在(Presto-based)Opera浏览器(仅HTML5)air——使用这个元素只有在AdobeAIR的球员standalone——使用这个元素只有在独立的flash播放器Windows——使用这个元素只能在Windows系统Mac-使用这个元素只能在MacOSX系统Linux——只在Linux系统使用该元素例子：devices=html5devices=flashdevices=mobiledevices=tabletdevices=iphone|ipaddevices=desktop|tablet+html5devices=android+flashdevices=html5+!iphonedevices=iphone+retina=iPhone4,iPhone5devices=ipad+retina=iPad3,iPad4devices=ipad+iOS5.1=iPadwithiOS5.1orhigherdevices=flash|webgl=systemswithfisheye-distortionsupportinclude:include元素可以用来加载和包括其他xml文件。之前krpano查看器将开始解析和解决一个xml文件,它会搜索所有包含的xml元素。包括元素会被发现,然后给定的xml将加载,加载xml文件的内容将插入在当前xml文件并替换include元素。在这包括加载和解决过程,包括xml文件的url属性将被调整。看到notesurl属性的更多细节。当所有包含加载和解析,那么主要的xml解析开始。action/data/scene元素:这些都是特殊的元素,在xml解析内容将被忽略。他们的整个内容将作为字符串存储在变量中这些元素的内容url属性：一个url属性在任何xml元素将krpano在一种特殊的方式来处理。当一个相对路径作为url的值,这将是相对于xml文件,属性定义的url。这也适用于包括xml文件。这意味着一个包含xml的相对路径相对于包含xml文件本身并不是主要/根xml文件。注意:当设置/动态改变url属性,那么就没有自动与xml文件路径了!使路径相对于一些特殊的预定义的路径,可以在url路径中使用这些占位符。%FIRSTXML%——第一个加载xml文件的路径。%CURRENTXML%-路径主要当前加载的xml文件(不包括一个)。%SWFPATH%-swf文件的路径。%HTMLPATH%-html文件的路径。%BASEDIR%——使用BASEDIR路径。%$VARIABLE%变量-使用给定的变量的值——这可以是任何krpano变量,但它必须定义在当前xml或场景将加载,如已经在html文件中或之前loadpano(),loadscene()调用。XML元素/属性/值的变量在这里详细krpanoxml元素的文档:krpano这是krpanoxml文件的根元素。需要进一步的所有元素定义在这个元素。例子：krpanoversion=1.17onstart=basedir=%FIRSTXML%bgcolor=idletime=0.5colorcorrection=defaultlogkey=trueshowerrors=truedebugmode=false.../krpanoAttributenameversionFullvariablenameTypeDefaultvaluexmlversionString1.17信息krpano版本创建xml文件时使用。这仅仅是一个可选的信息价值,但它仍然应该定义为允许处理潜在compatibility-related版本变化。AttributenameonstartFullvariablenameTypeDefaultvalueonstartActionEventonstart事件——在这里/功能的任何行动都将被称为“开始”的帕诺人查看可以定义。AttributenamebasedirFullvariablenameTypeDefaultvaluebasedirString%FIRSTXML%定义的基目录loadpano()操作。这是一个相对或绝对路径,也可以使用theurl占位符。defaultvalue%FIRSTXML%,这意味着所有以下XML文件的路径,由loadpano加载(),是相对于第一次加载XML文件。AttributenameFullvariablenamebgcolorbgcolorTypeStringDefaultvalue背景颜色。部分帕诺斯/平面图像的背景观众变得可见。?当设置为一个有效的十六进制格式(如颜色号码。“0xffffff”为白色),背景形状与颜色会呈现在帕诺人后面。?当不设置或设置为无效值——没有背景的形状将被使用,它的行为“透明”,显示了浏览器默认背景颜色或html页面时使用窗口模式=“透明”嵌入设置。?设置时,它还允许使用鼠标以外的帕诺人形象本身(当使用导航部分帕诺斯)。?和它还允许正确大小不同的部分帕诺斯之间的混合。AttributenameFullvariablenameidletimeidletimeTypeNumberDefaultvalue0.5时间间隔,以秒为单位在调用闲置之前没有任何用户交互事件。AttributenameFullvariablenameTypeDefaultvaluecolorcorrectioncolorcorrectionStringdefault变化的颜色校正设置Flashplayer10。在这里看到更多细节:Flashplayer10色彩校正可能设置:default,on,off警告——可降解性能设置为on!AttributenamelogkeyFullvariablenameTypelogkeyDefaultvalueBooleantrue启用/禁用“O”键盘键,开关输出/日志窗口/off.Note——这个参数将在启动时只检查一次!AttributenameFullvariablenameTypeDefaultvalueshowerrorsshowerrorsBooleantrue应该输出/跟踪(output/trace)日志窗口打开错误发生时自动显示错误消息。AttributenamedebugmodeFullvariablenameTypedebugmodeDefaultvalueBooleanfalse应该从krpano调试跟踪消息或从插件被显示。Exampleskrpanoversion=1.17onstart=loadscene(scene1);scenename=scene1.../scene/krpanoinclude包括其他的xml文件(可以使用不止一次)。这可以用于xml定义分成几个文件,例如重复使用某些设置。include元素