比特起舞

主题

krpano ​

这是 krpano xml 文件的根元素。所有其他 XML 元素都必须在其中定义。

xml
<krpano>
其它元素...
</krpano>
xml
<krpano version="1.23.1"
        onstart=""
        basedir="%FIRSTXML%"
        bgcolor=""
        language="..."
        defaultlanguage="en"
        idletime="0.5"
        strict="false"
        usestrictjs="true"
        showerrors="true"
        logkey="true"
        debugmode="false"
        debugkeys="false"
        debugkeeplog="true"
        debugjsactions="false"
        debugjsplugins="false"
        deprecatedwarnings="true"
    >
其它元素...
</krpano>

version ​

  • 类型 string
  • 默认值 1.23.1

INFO

创建 xml 文件时使用的 krpano 版本的信息。它允许处理不同版本之间与兼容性相关的更改。根据设置的版本，函数的行为或设置的默认值可能会有所不同。

onstart ​

  • 类型 动作

INFO

onstart 事件会在 xml 加载和解析完成后，在启动时直接调用。

basedir ​

  • 类型 string
  • 默认值 %FIRSTXML% (第一个加载的 xml 文件的路径)

INFO

basedir 设置定义了所有后续 loadpano() 操作调用的基目录。这可以是相对路径或绝对路径，也可以在此处使用 url 占位符。默认值为 %FIRSTXML%，这意味着所有后续 loadpano() 操作调用的所有相对 XML 路径都相对于第一个加载的 XML 文件。

bgcolor ​

  • 类型 string
  • 默认值 ""

INFO

查看器的背景颜色。该背景颜色仅在全景图加载前或使用未覆盖完整视图的部分全景图/平面图像时可见。当设置为十六进制格式的有效颜色编号（例如，白色为 0xFFFFFF）时，全景图后将渲染具有该颜色的背景形状。如果未设置或设置为无效值，则不会使用任何背景形状，其行为类似于"透明"，并在使用 bgcolor="transparent" 嵌入设置时显示 HTML 页面。

language ​

  • 类型 string
  • 默认值 ""

INFO

当前语言代码（小写）, en 代表英语，de 代表德语，fr 代表法语，等等。默认情况下，这与 systemlanguage 相同。当使用 translate()表达式时，此语言代码用于在 languages 翻译表中查找单词。

defaultlanguage ​

  • 类型 string
  • 默认值 "en"

INFO

如果当前语言的 language 翻译表中没有该单词，则使用默认语言来查找特定单词

idletime ​

  • 类型 Boolean
  • 默认值 true

    INFO

    在调用 onidle 事件之前，没有任何用户交互的 时间（以秒为单位）

strict ​

  • 类型 Boolean
  • 默认值 true

INFO

启用或禁用表达式解析器的“严格模式”。 启用后，表达式中的变量将不再“自动”解析为其值。这可以避免变量和字符串之间意外混淆。此外，一些特殊的向后兼容性变通方案（例如比较空的 %N 参数时）将被禁用。 当使用非严格比较（即在严格模式设置为 false 时使用==或 !=）时，系统会假定给定的值要么是变量，要么是字符串。这意味着，如果存在具有给定名称的变量，则比较时将使用该变量的值。但如果该变量不存在，则将给定名称作为字符串使用。 在严格比较中，字符串必须用引号显式标记。变量要么解析为其值，要么在不存在时解析为 null。

usestrictjs ​

  • 类型 Boolean
  • 默认值 true

INFO

所有由 krpano 直接调用的 JavaScript 代码（例如在 JavaScript 操作中，或通过 jscall、jsget、js:...等方法调用，或通过 loadjs()加载 JavaScript 文件时）在启用后都将使用严格模式。 这有助于查找未声明变量等编码错误，但在某些情况下其工作方式略有不同，因此启用后可能会导致向后兼容性问题。 如有必要，可以在此处全局禁用 JavaScript 严格模式，也可以针对每个操作单独禁用（使用 action[].usestrictjs）。

showerrors ​

  • 类型 Boolean
  • 默认值 true

    INFO

    设置当发生错误时是否自动打开 krpano 输出/日志窗口，以便向用户显示错误信息。 注意：使用无品牌标识许可时， 默认值为 false。

logkey ​

  • 类型 Boolean
  • 默认值 true

INFO

启用或禁用用于显示或隐藏 krpano 输出/日志窗口的键盘按键。 该按键位于键盘上，始终是 ESC 键下方最左上角的按键（与键盘语言或键盘映射无关） 在触控设备上没有按键，因此可以通过触摸查看器窗口的右下角并向上滑动来打开日志窗口。 注意：使用无品牌授权时 ，默认值为 false。

debugmode ​

  • 类型 Boolean
  • 默认值 true

INFO

启用或禁用特殊调试模式。
启用后：

插件或 debug()和 debugvar()操作发送的调试消息将显示出来，否则将被忽略/跳过。
上下文菜单 中的 versioninfo 字段 将始终显示，可以单击或触摸以打开或关闭 krpano 输出/日志窗口。
在 krpano 日志中，将有额外的调试按钮，用于：输入命令、启用特殊的调试键盘键、可视化图层和热点轮廓以及显示有关全景图像结构/图块的一些提示。
点击“输入”或按 SHIFT + logkey 键，将打开一个输入字段，用于输入 krpano 操作或表达式。
此输入框还包含以下特殊命令：

clearlog - 清除当前日志。
clearhistory - 清除日志和输入历史记录。

debugkeys ​

  • 类型 Boolean
  • 默认值 true

INFO

启用或禁用特殊的调试键盘按键。这些按键仅在启用调试模式且 krpano 日志当前打开时才有效。
调试按键如下：
R - 启用或禁用自动旋转模式。
C - 更改控制模式（移动到/拖动）。
T - 启用或禁用立体渲染。
G - 启用或禁用立体图像渲染。
U - 解锁任何视野和可视范围限制。
P - 显示或隐藏全景图像的轮廓或线框。
H - 显示或隐藏热点元素的轮廓。
L - 显示或隐藏图层元素的轮廓。
SHIFT + logkey - 打开一个输入字段，用于输入 krpano 操作或表达式。

debugkeeplog ​

  • 类型 Boolean
  • 默认值 true

INFO

保留/存储日志输入历史记录。这意味着即使重新加载页面，调试输入字段中的先前输入内容仍会保留。日志仅存储在本地（浏览器的 localStorage 内存中），因此仅在当前浏览器和当前域/源中有效。 注意：此功能仅在启用调试模式设置时有效。

debugjsactions ​

  • 类型 Boolean
  • 默认值 true

INFO

允许对 action 动作 type="Javascript"的代码 进行浏览器调试。 启用此选项后，krpano 将不会捕获 Javascript 错误，这些错误将由浏览器正常处理。这有助于开发，例如定位错误，但对于正常使用，此设置应保持禁用状态！

debugjsplugins ​

  • 类型 Boolean
  • 默认值 true

INFO

允许对 Javascript 插件 进行浏览器调试。 启用此功能后，krpano 将不会捕获 Javascript 错误，这些错误将由浏览器正常处理。这有助于开发过程中定位错误，但对于日常使用，此设置应保持禁用状态！

deprecatedwarnings ​

  • 类型 Boolean
  • 默认值 true

INFO

当使用已过时且未来版本可能不再支持的操作时， 显示已弃用警告。