krpano官网文档翻译-------krpano XML参考【krpano XML Reference】

 鸿蒙专栏:想学鸿蒙的,冲

C语言专栏:想学C语言的,冲

 VUE专栏:想学VUE的,冲这里

 CSS专栏:想学CSS的,冲这里

Krpano专栏:想学VUE的,冲这里

上述专栏,都在不定期持续更新中!!!!!!!!!!!!!

目录

✨ 前言

一、xml语法

基本的XML结构

关于本文档

krpano XML结构

特殊的krpano XML元素和属性

✨ 结语


 

✨ 前言

        Krpano使用简单的XML文本文件来存储Krpano查看器的设置。这些文件可以用任何常用的文本编辑器编写或编辑,但是在编写xml代码时,重要的是要遵守xml语法规则!这些基本规则对所有xml文件都是一样的,并不特定于krpano。

krpano官网文档翻译-------krpano XML参考【krpano XML Reference】_第1张图片

有关基本xml语法的更多信息,请参阅此处:

一、xml语法

Krpano使用简单的XML文本文件来存储Krpano查看器的设置。这些文件可以用任何常用的文本编辑器编写或编辑,但是在编写xml代码时,重要的是要遵守xml语法规则!这些基本规则对所有xml文件都是一样的,并不特定于krpano。
xml文件的语法规则简单、合乎逻辑、易学易用。
规则是这样的:

基本的XML结构

  • xml文件由几个xml元素(也称为xml节点或xml标记)构成。
  • xml元素的名称用< >括号括起来:
  • 每个xml元素都需要关闭。

这可以用两种形式写——要么用开始元素,要么用结束元素: 

 ... 

对于简单的例子是这样的:

  •  一个xml元素可以包含额外的子xml元素。

在这种情况下,xml-元素需要写成这种形式:


   
  • 一个xml元素可以有一个或多个属性。每个属性都由一个属性名和一个属性值构建而成。属性值必须写在单引号或双引号内。 

   

注意:一个元素上不允许有重复的属性,否则会导致语法错误! 

  • xml中必须总是有一个所谓的“根元素”。这是在层次结构上最顶层的xml元素。所有其他xml元素都需要在其中。

对于krpano查看器,此元素总是元素-例如: 


   ...
   
   
     
   
   ...
  • 注释——注释是xml的一部分,在读取/解析xml时将被忽略。xml注释的开头是:
     

大小写/字符编码/空白/不允许的字符

  • xml元素和xml属性的名称是区分大小写的。这意味着开始元素和结束元素的名称需要以相同的大小写书写。

注意—对于xml语法规则,大小写非常重要,但是对于krpano查看器本身,krpano xml元素的大小写无关紧要—krpano查看器将自动将所有元素和属性名称转换为小写,以使它们的krpano-usage不区分大小写。

  • 为了避免字符编码问题,所有xml文件都应该保存为Unicode UTF-8或UTF-16文件。在本例中,文本编辑器将在xml文件的开头添加一个小的隐藏头(称为UTF-BOM)。 
  • xml元素之间和xml属性之间的空白字符(如空格、制表符和换行符)将被忽略。但在属性值内部,它们将得到尊重。
    这允许以多种方式自由地编写和组织xml。但是为了更好的可读性,通常可以对元素进行缩进,使它们的层次结构更加清晰。
  • 有些字符是由xml语法本身保留的,因此不能直接使用。
    无论如何,要使用它们,可以使用一些替代实体:
不允许字符 替代实体 特征描述
< < 小于
> > 大于
& & &
' ' 撇号
" " 引号

关于本文档


本文档是关于krpano xml结构,关于所有krpano xml元素、属性和值以及它们到动态krpano变量名的映射。

文档的主题:

  • krpano XML结构
  • 特殊的krpano XML元素和属性
  • XML元素/属性/值/变量

关于krpano变量和动作的动态使用,请查看:
 krpano动作/脚本参考 

krpano XML结构

下面是所有krpano xml元素的结构化列表:(单击某个元素以获取更多信息)


    
    
      
      
      
      
      
      
      
      
    
    
    
    
    
    
    
    
    
      
      ...