krpano 1.19-pr14 (生成 2017-12-01)

krpanotools 配置文件参考

krpanotools makepano 工具 (以及从它派生的水滴如使全景, 使 VTOUR) 将由外部配置 (. config) 文件配置。 调用 krpanotools makepano 工具时, 必须指定此类. config 文件的路径。 配置文件本身只是简单的文本文件, 可以使用任何文本编辑器进行编辑。

语法

配置文件的语法非常简单。 配置文件是按行读取的。 每行可以是一个设置或注释或包含。 空或空白行将被忽略。
  • 设置
    要设置设置, 只需写入: 
    setting=value
    每行都以设置的名称开头, 然后遵循赋值字符 (=) 和此设置的值。
  • 评论
    当一行以 # 字符开头时, 该行被视为注释, 将被忽略。 
    # this line is a comment and will be ignored
  • 包括
    可以包含其他配置文件。 只写包含和文件的名称: 
    include name-of-the-other-file

有关文件路径的说明

定义输出文件的路径时, 可以使用占位符来引用输入路径和全景名称。

这些占位符可用:
  • %INPUTPATH%
    这是当前输入文件的完整路径。 它可用于在与输入文件相同的文件夹中生成输出文件。
  • basename%
    这是输入图像的 "basename"。 它是没有文件路径且没有文件扩展名的文件名。 表示多维数据集端的前置修复程序也被删除。
    当输入文件的名称不允许生成 basename 时, basename 将是 ' 全景 # # ', 在那里 # # # 是一个按0000开始的序号。

所有配置设置

输入图像设置 stereos设置 处理设置 格式转换设置 (SPHERE/CYLINDER) 多分辨率图像设置 输出图像/平铺路径设置 预览全景设置 自定义多维数据集图像 缩略图图像设置 XML 输出设置 XML 模板/外观设置 XML 图像设置 HTML 输出设置 HTML 模板设置 保护设置 基本/设置设置 图像筛选/压缩设置

设置文档

输入图像设置 
panotype=autodetect
  • 输入图像的全景类型。
  • 可能的设置:
    • autodetect-imagesize/方面将检测到该类型:
      • 2:1 方面 = 球形全景
      • 1:1 个方面和六个文件具有相同的 "basename" = 立方体全景
      • 其他方面-询问用户
    • sphere-假设输入是一个完整的球面360x180 图像
    • cylinder-假设输入为 360x * 缸
    • flat-假设输入是平面图像
    • partialsphere-强制假设一个部分SPHERE (需要 hfov设置)
    • partialcylinder-强制假定部分CYLINDER ( hfov设置需要)
hfov=360
vfov=auto
voffset=0
  • spherical/cylinder全景图的预定义设置。
  • hfov-设置输入图像的水平视野。
  • vfov-设置输入图像的垂直视野。 使用 "自动" 可以自动计算此值。
  • voffset-将图像垂直向上或向下移离地平线/中心 (+/度)。

立体声设置 
stereosupport=true
  • 当有一个立体输入图像时, 将生成启用 (true) 立体声 (左/右) 图像。
  • 如果禁用 (false), 全景将仅为立体输入图像的左映像生成。
  • 这可用于通过 customimage设置为虚拟现实的立体查看构建用于正常查看和特殊较小尺寸图像的大型 monoscopic 图像。
stereolabels=1|2
  • 生成立体输出图像时左右图像的标签。

处理设置 
makescenes=false
  • 为每个输入图像生成一个具有 < 场景 > 元素的单个 xml 文件。 < 场景 > 就像一个 "内联 xml"。 这可用于自动生成虚拟旅游。
  • 如果禁用, 将生成每个输入映像的 xml 文件。
frames=false
  • 启用 "多帧"/"对象" 帕诺斯。
  • 每个输入图像被视为电影或动画的单帧。
  • 对于此情况, 所有输入图像都需要具有相同的图像大小。
  • tilepath需要使用当前帧编号的 "%f" 占位符。

格式转换设置 (SPHERE/CYLINDER到多维数据集) 
converttocube=true
  • 将球面和圆柱形图像自动转换为立方体图像。
  • 立方体图像提供了更好的显示质量和更好的渲染性能。
  • 立方体图像是 HTML5 使用所必需的。
converttocubelimit=360x120
  • 当全景图像应转换为立方体时, 设置全景的 "视野范围"。 当全景范围超过这个限制时, 它将是 convereted, 当下面没有。
  • 目前只有 360x * 图像可以转换。
converttocubeformat=kro
  • 临时转换的多维数据集图像的图像文件格式。
  • 可能的设置:
    • kro = Kolor RAW (无限制, 默认, 推荐)
    • tif, tiff = tiff (最大 filesize 4GB)
    • btf、tf8、bigtiff = bigtiff (无限制)
    • psd = Photoshop 文档 (最大 imagesize 30.000x30.000)
    • psb (最大 imagesize 300.000x300.000)
    • jpg, jpeg = jpeg (最大 imagesize 30.000x30.000)
tempcubepath=%INPUTPATH%/%BASENAME%_cube%UID%
  • 临时到多维数据集转换的图像的路径和名称 (不带文件扩展名)。
  • 处理后, 临时多维数据集映像将自动删除。
  • 有关文件路径占位符的详细信息, 请参阅 有关文件路径的说明。
  • 此处附加%UID% 占位符用于生成唯一 id。 当文件夹中的文件同名时, 应使用此方法避免出现问题。 
waitafterconvert=false
  • 在转换为多维数据集映像后等待用户 keypress。
  • 这允许在最终处理之前编辑多维数据集映像。

多分辨率图像设置 
multires=true
  • 如果该工具生成多分辨率图像或 "正常" 不平铺的单个图像。
tilesize=auto
  • 多分辨率平铺图像的大小。
  • 应该介于256和1024之间。
  • 使用 ' 自动 ', 让工具自动找到一个良好的价值 "对称瓷砖分裂", 这可以提高Flash渲染性能。
  • 一个今天的建议, 以期对未来版本的 GPU 渲染和 HTML5 将使用512作为 tilesize。
  • 注意-tilesize 影响加载和解码时间以及渲染性能。 
levels=auto
  • 要生成的多分辨率级别的数目。
  • 使用 "自动" 可让工具自动计算所需的级别。
  • 自动级别的数目取决于全景图的图像大小和 minsize和 maxsize设置。
levelstep=2
  • 每个多分辨率级别将由上一个分辨率级别的 "levelstep" 因子降低。
  • 示例-levelstep 和级别大小:
    levelstep = 2.0: 10000x5000, 5000x2500, 2500x1250
    levelstep = 2.5: 10000x5000, 4000x2000, 1600x850 
levelsizes=...
  • 用逗号分隔的列表设置手动级别大小。
  • 仅设置宽度大小, 将按比例计算高度。
  • 设置此设置时将忽略级别和 levelstep 设置。
  • 例如:
    levelsizes=512, 1024, 2048, 4096, 8192 
adjustlevelsizes=true
  • 自动调整某些级别的大小, 使其更好地被 tilesize 整除。
  • 这将避免非常窄的平铺图像, 并可以提高加载和渲染性能。
adjustlevelsizesformipmapping=true
  • 自动调整/优化级别大小, 使其更适合使用启用的 mipmapping 呈现。
  • 这可以提高加载和渲染性能。
  • 只有在启用 adjustlevelsizes设置时, 才会应用此设置。
minsize=auto
  • 多分辨率级别的最小大小 (高度)。
  • 当水平 = 自动然后水平将被生成到这个大小。
  • 使用 "自动" 可让工具自动选择最小大小。
maxsize=auto
  • 多分辨率级别的最大大小 (高度)。
  • 当输入图像大于此大小时, 将缩减像素取样到此大小。
  • 使用 "自动" 可使用输入图像的最大大小。
maxcubesize=auto
  • 多维数据集图像的最大大小 (宽度/高度)。
  • 使用 "自动" 可使用输入图像的最大大小。

输出图像/平铺路径设置 
tilepath=%INPUTPATH%/%BASENAME%.tiles/l%Al[_c]_%Av_%Ah.jpg
  • 输出平铺图像的路径和名称模板。
  • 有关文件路径占位符的详细信息, 请参阅 有关文件路径的注释。
  • tilepath 有几个占位符用于平铺索引:
    • %l-当前多分辨率级别的索引/数字
    • %h-水平平铺索引 (也可能:%x、%c、%u)
    • %v-垂直瓦片索引 (也可能:%y,%r)
    • [c]-"c" 将被 cubeside 字符替换, 在 [和] 之间的其他一切将保留, 因为它是为立方体帕诺斯和被删除为其他全景类型。
    • %f 帧索引 (用于多帧输入)
  • 格式选项:
    • 在 "%" 和占位符之间插入一个或多个 ' 0 ' 字符或一个 ' A ', 以 "填满" 具有 "0" 字符的数字作为统一填充。
    • ' A ' 意味着 ' 自动 '-在这里, 多达0个字符的需要, 将添加到一个统一的填充所有瓷砖。
  • 每个占位符可以多次使用, 也可用于文件名和存在 foldername。 将自动创建新文件夹。
  • 注意-对于非常大的帕诺斯组织瓷砖到几个文件夹, 以保持 ' 每个文件夹的文件数量 ' 低-这是更好地为良好的服务器性能! 
tilepathxml=[PATH]
  • xml 中路径的模板。
  • 可用于预先或后缀路径。
indexbase=1
  • 平铺索引的起始/基准指数编号。

预览全景设置 
preview=true
  • 生成一个小而平滑的预览图像。
  • 预览图像的平滑度使图像的压缩变得很好, 使 filesize 非常小。 这允许快速加载。
  • 在加载过程中, 预览图像将显示在正常全景的后面。
cspreview=true
  • 可能时生成 cubestrip 预览图像。
  • 立方图像具有更好、更准确的显示质量。
  • 在 HTML5 中, cubestrip 预览图像是唯一支持的预览图像格式。
graypreview=false
  • 使预览图像 grayscaled。
previewsmooth=25
  • 预览图像的平滑度。
  • 0-100 (更高的值更平滑)
previewspsize=1024
  • 球面预览图像的大小 (宽度)。
  • 默认为1024⇒1024x512。
previewcssize=256
  • cubestrip 的大小 (宽度) ( cspreview = true) 预览图像。
  • 默认为256⇒256x1536。
previewpath=%INPUTPATH%/%BASENAME%.tiles/preview.jpg
previewpathxml=[PATH]
  • xml 中路径的模板。
  • 可用于预先或后缀路径。

自定义多维数据集图像 
customimage[name].path=...
  • 生成较小尺寸的多维数据集图像。
  • [name] 是任何内部唯一名称。
  • 自定义多维数据集图像的路径和文件名。 该名称需要包含多维数据集端占位符 "%s"。
  • 有关文件路径占位符的详细信息, 请参阅 有关文件路径的注释。
customimage[name].size=1024
  • 自定义多维数据集图像的分辨率/大小。
  • 当正常的全景大小已经小于此大小时, 将不会生成自定义图像。
customimage[name].imagesettings=...
customimage[name].stereosupport=...
  • 当输入为立体声图像时生成立体声图像。
  • 可能的设置: true 或 false 或 "未设置"。 当 "未设置" 时, 将使用 stereosupport设置。 
customimage[name].xml=...
  • 自定义多维数据集图像的 XML 模板。
  • 可能的占位符:
    • [PATH]-自定义多维数据集图像的路径
    • [TAB]-制表缩进
    • [NL]-新线
customimage[name].xmllevel=...
  • 定义插入自定义图像 xml 的位置。
  • 可能的设置:
    • 图像-在 < 图像 > 元素中添加 xml。
    • 在根级别添加 xml (如 < krpano > 或 < 场景 >)。
customimage[name].xmlsceneparameters=...
  • 将添加自定义图像时将添加到 < 场景 > 元素中的参数/属性。
customimage[name].xmlimageparameters=...
  • 将添加自定义图像时将添加到 < 图像 > 元素中的参数/属性。
自定义多维数据集图像示例

用于为移动设备生成1024x1024 多维数据集图像的示例: 
customimage[mobile].path=%INPUTPATH%/%BASENAME%.tiles/mobile_%s.jpg
customimage[mobile].res=1024
customimage[mobile].imagesettings=jpegquality=82 jpegsubsamp=444 jpegoptimize=true
customimage[mobile].xml=<mobile>[NL][TAB]<cube url="[PATH]" />[NL]</mobile>


缩略图图像设置 
makethumb=false
  • 自动生成小缩略图图像。
  • 对于多维数据集帕诺斯, 此缩略图将基于前面的立方体侧面图像, 对于所有其他帕诺斯, 整个图像本身将被使用。
thumbsize=80
  • 缩略图图像的平方像素大小。
thumbpath=%INPUTPATH%/%BASENAME%.tiles/thumb.jpg
thumbpathxml=[PATH]
  • xml 中路径的模板。
  • 可用于预先或后缀路径。

XML 输出设置 
xml=true
  • 生成 xml 文件。
  • xmltemplate文件将用作生成 xml 文件的模板/基。
xmlpath="%INPUTPATH%/%BASENAME%.xml

XML 模板/外观设置 
xmltemplate=...
  • 模板文件输出 xml 文件。
  • 可能的占位符:
    • [name]-(未 筛选) basename 全景
    • [BASENAME]-( 筛选) BASENAME 全景
    • [prview]- < prview >元素的位置
    • [image]- < image >元素的位置
    • [scene]- < scene >元素的位置
    • [view]- < view >元素的位置 (基于 xmltemplate_view )
    • [PARTIALPANO]-部分帕诺斯的 ispartialpano = "true"的占位符
    • [VIEWLIMITS]-部分帕诺斯的查看限制的占位符
    • [hotspot]- < hotspot >元素的位置 (基于 xmltemplate_hotspot )
    • [thumb]-缩略图 thumburl = "..."属性的位置
    • [device]-non-html5-compatible 帕诺斯的 device = "Flash"的占位符
    • [HAVEGPS]-插入 true或 false取决于输入图像是否包含 GPS 信息
    • [GPS]- lat = "[lat]" lng = "[lng]" title = "[title]"的快捷方式
    • [LAT]-GPS 纬度值
    • [LNG]-GPS 经度值
    • [HEADING]-GPS 朝向
    • [...] -任何由 xmltemplate_var定义的占位符 
xmltemplate_var=name:value
  • xmltemplate xml 文件的自定义占位符。
  • 具有 [name]的占位符将被给定的 value替换。
  • 此设置可多次使用以添加多个自定义占位符。
xmltemplate_additional_file=...
  • xmltemplate xml 的其他文件。
  • 此设置可多次使用以添加多个文件。
  • 所有给定的文件将直接复制到输出文件夹。
xmltemplate_scene=...
  • [scene] 占位符的模板文件。
  • 可以使用与 xmltemplate中相同的占位符.
xmltemplate_view=...
  • [view] 占位符的模板文件。
xmltemplate_hotspot=...
  • [hotspot] 占位符的模板文件。

XML 图像设置 
xmlimageparameters=
  • 在 xml < image >节点中设置其他参数。
  • 可用于设置不同的 multiresthreshold .

HTML 输出设置 
html=true
  • 生成全景播放器嵌入的输出 html 文件。
  • htmltemplate文件将用作生成 html 文件的模板/基。
htmlpath=%INPUTPATH%/%BASENAME%.html

HTML 模板设置 
htmltemplate=...
  • 模板文件输出 html 文件。
  • 可能的占位符:
    • [XML]-生成的 XML 文件的路径
    • [name] 或 [BASENAME]-全景的 "BASENAME"
    • [SWF]-生成的 SWF 文件的路径
    • [JS]-到播放器嵌入脚本的路径 ( htmltemplate_js )
    • [HTML5]- htmltemplate_html5设置的值或 从不
    • [...] -任何自定义占位符由 htmltemplate_var设置 
htmltemplate_js=...
  • 播放器嵌入脚本的路径。
  • 将插入 htmltemplate html 文件中的 [JS] 占位符中。
htmltemplate_html5=...
  • htmltemplate html 文件中 [HTML5] 占位符的值。
  • 当 HTML5-Output 可用时 (= 可用许可证和兼容图像), 则将设置给定的值, 但当 HTML5 不可用时, 则将设置值 永不。
htmltemplate_var=name:value
  • htmltemplate html 文件的自定义占位符。
  • 具有 [name]的占位符将被给定的 value替换。
  • 此设置可多次使用以添加多个自定义占位符。
htmltemplate_additional_file=...
  • htmltemplate html 页的其他文件。
  • 此设置可多次使用以添加多个文件。
  • 所有给定的文件将直接复制到输出文件夹。

保护设置 
kprotectclparameters=...
  • 创建播放器文件时内部 保护工具的附加参数。
  • Avialable 参数为:
    • -domain = #... 添加域名限制
    • -noep... 禁用外部参数
    • -nojs... 禁用 javascript 接口
    • -nolu... 禁用本地/离线使用
    • -noex... 禁止从其他域加载外部 xml/插件文件
    • -pxml 只允许私下加密的 xml 文件
    • -expire = 年月日-DD..。
    • -expiredurl = #... 在到期日打开的 url
    • -swfsize = #... 设置 swf 的独立大小 (WIDTHxHEIGHT)
    • -fs... 从全屏模式开始 (仅限独立 Flashplayer)
    • -nomb... 没有菜单栏 (仅限独立 Flashplayer)
    • -nobf 无品牌免费输出 (忽略品牌免费许可)

基本/设置设置 
html5=true
  • HTML5 支持-真或假。
flash=true
  • Flash支持-真或假。
profile=convert
  • 嵌入的颜色配置文件处理-设置:
    • skip-跳过/忽略嵌入的颜色配置文件。
    • copy-将颜色配置文件从输入复制到输出图像。
    • convert-将图像颜色从嵌入的颜色配置文件转换为 sRGB 颜色配置文件, 但不要在输出图像中嵌入 sRGB 配置文件 (默认值)。
    • sRGB -将图像颜色从嵌入的颜色配置文件转换为 sRGB 颜色配置文件, 并在输出图像中嵌入 sRGB 配置文件 (用于最佳兼容性和颜色配置文件支持, 但图像文件略大, 图像解码速度较慢)。 
parsegps=true
  • 分析了 EXIF GPS 信息的输入图像。
  • 这可用于创建自动地理标记的帕诺斯。
  • GPS 位置将在 xml 模板中通过占位符提供。
autolevel=remap
  • 分析用于 EXIF 或 XMP 定向/调配信息的输入图像。
  • 可用于自动调配理光θ图像。
  • 可能的设置:
    • 映射 = 重新映射 (旋转) 图像本身以使其水平。
    • prealign = 保留图像, 但在 xml 中添加 prealign设置以对其进行级别。
    • 不要对图像进行等级。
prealignheading=true
  • 启用 EXIF 或 GPS 方向信息后, 将使用 prealign设置将图像旋转到 "标题" 方向的 < 图像 > xml 元素。
filterbasename=true
  • 从 BASENAME中筛选出空白、非 ASCII 和特殊字符, 并用下划线 (_) 字符替换它们。
  • 这将避免跨不同字符编码系统的路径问题。
cubeshortsyntax=true
  • 使用较短的 < 多维数据集 url = "pano_%s"/> 语法, 而不是为每个多维数据集端定义单独的 xml 标记 (< 左 url = "pano_l"/> 下的 url = "_pano_d. jpg"/<)。 
ignorelayers=false
  • 当 PSD/公安局文件包含图层并允许使用此类文件作为输入时, 请忽略。
  • 警告: 此类 PSD/公安局文件应保存在 Photoshop 中的 "最大化兼容性" 中, 以便能够正确加载。
sortinput=true
  • 按字母顺序对输入文件进行排序。
askforxmloverwrite=true
  • 在覆盖现有 xml 文件之前询问。
quiet=false
  • 无控制台输出, 进程无提示。
  • 只会显示错误。
waitkey=false
  • 处理后等待 keypress。
tempdir=...
  • 设置应存储临时文件 (交换出内存) 的路径。
  • 如果未设置, 将使用系统默认值。
  • 注意-临时多维数据集映像 ( tempcubepath) 不会存储在那里。

图像筛选/压缩设置 
filter=LANCZOS
  • 设置向下采样筛选器, 以生成较低分辨率级别和图像。
  • 可能的设置:
    • POINT = 简单点过滤 (质量差)
    • LINEAR = 线性过滤 (更好, 但仍然坏质量)
    • CUBIC = 立方过滤 (软, 细节损失)
    • HAMMING = 汉明过滤器 (好, 只有一点点损失的细节)
    • GAUSS = 高斯过滤 (好, 只少许损失细节)
    • MITCHELL = 米切尔过滤 (好质量为上升-取样)
    • LANCZOS = 窗口 sinc 过滤器 (最佳质量, 保留最详细信息)
jpegquality=85
  • 设置 JPEG 压缩质量。
  • 设置: 1-100
    • 低值-更糟的图像质量和较小的文件
    • 更高的值-更好的图像质量和更大的文件
  • 注意-使用超过95的质量设置不会被推荐用于 web 使用! 最小增加的图像质量不值得大大增加文件大小, 因此方式更长的下载时间。 
jpegsubsamp=422
  • 使用 JPEG 色度抽样减少 filesize。
  • 详细信息: 维基百科-色度抽样
  • 可能的设置:
    • 444 = 无色度抽样 (最佳质量)
    • 422 = 水平 (1/2) 色度抽样
    • 420 = 水平 (1/2) 和垂直 (1/2) 色度抽样 (jpeg 默认值)
    • 411 = 水平 (1/4) 和垂直 (1/2) 色度抽样 (最佳压缩)
jpegoptimize=true
  • 优化 JPEG 霍夫曼压缩表。
  • 这会使 JPEG 图像变小, 并且在大多数情况下都应该启用。
  • 当需要启用更多工作内存 (RAM) 时, 因为每个映像必须保存在内存中, 直到完成。 对于非常大的输入图像和32位系统, 此内存使用量可能太大-应该禁用它。 
jpegprogressive=false
  • 使用渐进式 JPEG 编码。
  • 渐进式 JPEG 图像可以较小, 但它们通常较慢解码。
manualjpegcompression=false
  • 而不是 JPEG 图像, 将创建无损耗的 TIFF 图像。
  • 这些 TIFF 图像需要手动转换为 JPEG 图像。 在这里, 可以使用自定义工具和 jpeg 转换设置。
  • 在 XML 本身中, 将使用普通的 JPEG 文件名。