‍ 个人主页：《爱蹦跶的大A阿》

当前正在更新专栏：《VUE》 、《JavaScript保姆级教程》、《krpano》、《Krpano中文文档》

​ 

​

krpanotools可执行文件是处理图像(例如球体/立方体转换，调整大小和平铺)以及与许可处理相关的所有内容的核心工具。
可以从命令行、批处理/脚本文件或其他应用程序调用它。

krpanotools应用程序提供以下功能:

• makepano - 制作一个基于模板的全景图或全景图。
• maketiles - 制作或合并平铺图像。也可用于转换和调整大小。
• convert - 转换或调整图像大小。
• makepreview - 制作平滑的全景预览图像。
• spheretocube - 将球面图像转换为立方体全景图像。
• cubetosphere - 将立方体图像转换为球形全景图像。
• protect - 创建具有自定义保护设置的查看器文件。
• encrypt - 加密文件。
• testserver - krpano测试服务器。
• register - License注册工具。

Makepano Tool

• 一个自动制作现成的全景图和全景图的工具。
• 自动图像准备最佳的观看性能(球体到立方体转换，平铺多分辨率图像，预览图像)。
• 基于模板的HTML和XML生成，完全可定制。

语法:

krpanotools makepano [-config=###] [OPTIONS] inputfiles ...

config:

• config 文件的路径。
• 默认情况下，templates/vtour-multires。使用配置文件。
• 配置文件是一个简单的文本文件，其中有几个关于如何处理输入图像的设置。

Options:

• 设置或覆盖配置文件中的任何设置。
• 可多次使用。
• 语法:-nameofthesetting =value。

Inputfiles:

• 一个或多个图像文件名 (supported image file formats).
• 支持全景格式/图像投影:
  • 球形/等矩形/ 360 × 180图像
  • 圆柱形图像(360x*)
  • 任意视场的部分球形或圆柱形图像。
  • 具有六个独立图像文件的立方体图像(每个立方体边一个图像)。
  • 立方体图像(立方体面顺序和对齐将通过图像内容分析自动检测)。
• 支持的立体全景格式:
  • 一张12x1或1x12立体立方体图像(=两个并排的6x1立方体或两个自上而下的1x6立方体)。
  • 一个单一的图像与两个球形360 × 180图像并排或自上而下的安排。
  • 两个6x1立方体图像具有相同的'basename'和一些左/右标记用于侧面检测(例如文件名中的_l和_r)。
  • 两个球形360x180图像，具有相同的'basename'和一些左/右标签用于侧面检测(例如文件名中的_l和_r)。
• 使用像*.tif这样的通配符是可能的，并且应该在尝试一次传递更多图像时使用。
• 立方体图像的文件名中应该有像_l， _f， _r， _b， _u， _d这样的后缀，或者像左，前，右，后，上，下这样的名称，以便自动检测相关的立方体侧。
• 带有分隔的侧面图像的立体图像应该具有相同的“basename”和允许识别侧面的前缀或后缀(例如_l和_r或左、右或类似的东西)。

Maketiles / Convert Tool

• 将大图像分割成小图像块。
• 合并磁贴。
• 转换图像文件格式。
• 调整图像大小(支持360度边缘翘曲)。
• 优化非常低的内存需求，可以处理任何大小的图像。

语法:

krpanotools maketiles inputfile outputfile [tilesize] [OPTIONS]

Inputfile:

• 输入图像的文件名或平铺模板 (supported image file formats).

Outputfile:

• 输出图像的文件名或平铺模板。

Tile Template Syntax:

• 平铺模板可以包含几个占位符来处理实际的平铺:
• %h -用于水平tile索引。
• %v -用于垂直平铺索引。
• 可选的%和h或v之间的一个或多个0字符可以用作数字填充。

Tilesize:

• 瓷砖大小。
• 对于非四边形瓷砖，使用WIDTHxHEIGHT。
• 当输入图像不能被平铺大小完全分割时，右列和底行平铺将小于平铺大小。
• 通过使用0或跳过该设置来禁用平铺。

Options:

• -indexbase=#
  • 设置tile的start-index, default=1。
• -jpegquality=#
  • 设置JPEG压缩质量，0到100，默认值=85。
• -jpegsubsamp=#
  • 设置JPEG颜色子采样，444,420,420,411，默认=444。
• -jpegoptimize
  • 优化JPEG霍夫曼压缩表。
  • 可以减少一点文件大小，对于非常大的输入图像(十亿像素以上)，这可以明显增加内存需求并减慢处理速度。
• -jpegprogressive
  • 使用渐进式JPEG压缩格式。
• -tiffcompress=#
  • 设置TIFF压缩方法，无，lzw, zip或jpeg, default=lzw。
• -dpi=#
  • 写一个自定义的DPI大小到图像头。
• -profile=#
  • 嵌入式颜色配置文件(ICC)设置:
  • 复制-将颜色配置文件从输入图像复制到输出图像。
  • CONVERT -转换为sRGB颜色配置文件，但不嵌入配置文件(默认)。
  • sRGB -转换为sRGB颜色配置文件，并嵌入一个非常小的sRGB配置文件。
  • 跳过-跳过/忽略嵌入的颜色配置文件。
• -noalpha
  • 删除alpha通道(如果有的话)。
• -8bit
  • 将输出图像转换为8位(用于16位输入)。
• -hmirror
  • 水平镜像图像。
• -q
  • 安静模式，无控制台输出。

平铺输入图像的选项:

• -insize=#
  • 输入图像的总大小:WIDTHxHEIGHT。
• -intilesize=#
  • 输入图像的平铺大小:SIZE或WIDTHxHEIGHT。
• -inindexbase=#
  • 设置输入图像的平铺起始索引，默认=1。

调整图像大小的选项:

• -resize=#x#
  • 将图像大小调整为WIDTHxHEIGHT。
  • 使用*为宽度或高度按比例调整大小。
• -scale=# or -scale=#x#
  • 按给定的因子缩放图像。
• -keepaspect
  • 在调整大小时保持原始图像的外观。
  • 这意味着图像将被调整大小以适应给定的宽度或高度。
• -hwrap
  • 在过滤时水平环绕(用于360x * panos)。
• -filter=#
  • 设置要使用的大小调整过滤器:
  • POINT
  • LINEAR
  • GAUSS
  • CUBIC
  • HAMMING
  • MITCHELL
  • LANCZOS (默认，质量最好)

Maketiles / Convert工具的示例

1. 转换图像文件格式:

krpanotools convert image.tif resized.jpg

2.调整图像大小:

krpanotools convert image.jpg small.jpg -resize=1000x500

3. 按比例调整为固定宽度:

krpanotools convert image.jpg small.jpg -resize=1000x*

4. 按比例调整大小，使其始终在1000x1000范围内，例如，根据输入大小，结果大小为1000x700或600x1000:

krpanotools convert image.jpg small.jpg -resize=1000x1000 -keepaspect

5. 平铺图像:

krpanotools maketiles image.jpg tile_%v_%h.jpg 512

6. 将瓷砖合并在一起(需要知道总大小):

krpanotools maketiles tile_%v_%h.jpg image.jpg -insize=5000x5000 -intilesize=512

Makepreview工具

• 制作一个平滑的小预览全景图像。
• 以获得更快的加载体验。
• 平滑/模糊将是均匀的球形分布(图像编辑器中的正常图像模糊会在最低点/天顶区域产生伪影)。

语法:

krpanotools makepreview inputfiles [-o=outputfile] [OPTIONS]

Inputfiles:

• 球形或立方体全景图像(支持的图像文件格式)。
• 立方体图像的文件名中应该有像_l， _f， _r， _b， _u， _d这样的后缀，或者像左，前，右，后，上，下这样的名称，以便自动检测相关的立方体侧。
• 另外，也可以使用-l=### -f=### -r=### -b=### -u=## -d=###手动指定cubesides的文件名。

Options:

• -o=###
  • 设置输出映像的名称。
  • 默认情况下，它将是*preview.jpg，其中*是基本输入文件名。
• -cs
  • 制作一个立方体预览全景图像。
  • 以获得更好的质量和更好的浏览器支持。
• -gray
  • 制作灰度预览图像。
• -size=#x#
  • 设置预览图像的大小。
  • 默认情况下，球面为1024x512，立方体为256x256。
• -smooth=#
  • 平滑/模糊系数，0到100，默认值=77。
• -jpegquality=#
  • 设置JPEG压缩质量，0到100，默认值=85。
• -jpegsubsamp=#
  • 设置JPEG颜色子采样，444,420,420,411，默认=422。
• -tiffcompress=#
  • 设置TIFF压缩方法，无，lzw, zip或jpeg, default=lzw。
• -profile=#
  • 嵌入式颜色配置文件(ICC)设置:
  • 复制-将颜色配置文件从输入图像复制到输出图像。
  • CONVERT -转换为sRGB颜色配置文件，但不嵌入配置文件(默认)。
  • sRGB -转换为sRGB颜色配置文件，并嵌入一个非常小的sRGB配置文件。
  • 跳过-跳过/忽略嵌入的颜色配置文件。
• -q
  • 安静模式，无控制台输出。

SphereToCube工具

• 将球形或圆柱形全景图像转换为立方体格式。
• 也可用于呈现直线视图。
• 当输入图像具有嵌入的颜色配置文件时，它将被复制到输出图像中。

语法:

krpanotools spheretocube MODE inputfile outputfile [OPTIONS]

Mode:

• CUBE - 输出6个单独的立方体面图像。
• HCUBE - 输出水平图像条。
• VCUBE - 输出一个垂直图像条。
• CUBE32 - 输出一个3x2排列图像条。
• CUBE23 - 输出2x3排列图像条。
• VIEW - 输出一个直线视图

Inputfile:

• 球面或圆柱形输入图像 (supported image file formats).
• 对于圆柱形映像，需要添加-圆柱形选项。
• 对于部分全景图像，需要添加-infov=###选项。
• 特殊情况-使用平铺图像作为输入:
  • 输入语法:tiiled:tile_%v_%h.jpg:WIDTH:HEIGHT:TILESIZE
  • 理想的低内存使用和快速处理巨大的图像。这意味着首先使用maketiles工具平铺输入图像，然后将其转换为立方体。

Outputfile:

• 立方输出映像的名称。
• 在CUBE模式下，将向文件名中添加立方体端后缀。

部分全景图像的选项:

• -infov=HFOVxVFOV/VOFFSET
  • HFOV - 以度为单位的水平视野
  • VFOV - 垂直视场度(可选)。
  • HFOV - 垂直偏移度(可选)。
• -cylinder
  • 定义输入图像为圆柱全景图像。

VIEW模式的选项:

• -fov=#
  • 直线视图图像的垂直视场度。
• -lookat=H,V,R
  • 在krpano查看器形式中设置观看旋转，通过俯视，俯视，旋转。
• -rotate=ORDER,X,Y,Z
  • 设置自定义观看旋转。
  • ORDER - 轴的旋转顺序，可以是XYZ、XZY、YXZ、YZX、ZXY、ZYX。
  • X,Y,Z - 绕轴旋转的角度，以度为单位。

一般选择:

• -outsize=#
  • 设置自定义输出大小。
  • 默认情况下，大小将根据输入图像的大小来计算。
  • 对于VIEW模式，需要使用-outsize=WIDTHxHEIGHT。
• -noautolevel
  • 默认情况下，当有EXIF方向信息时，输入图像将自动调平(例如，来自一次性全景相机)。
  • 有了这个设置，水平可以被禁用。
• -profile=#
  • 嵌入式颜色配置文件(ICC)设置:
  • COPY - 将颜色配置文件从输入图像复制到输出图像(默认)。
  • CONVERT - 转换为sRGB颜色配置文件，但不嵌入配置文件。
  • sRGB - 转换为sRGB颜色配置文件，并嵌入一个非常小的sRGB配置文件。
  • SKIP - skip / ignore 嵌入的颜色配置文件。
• -fast
  • 处理速度更快，但质量更差。
• -jpegquality=#
  • 设置JPEG压缩质量，0到100，默认值=85。
• -jpegsubsamp=#
  • 设置JPEG颜色子采样，444,420,420,411，默认=444。
• -jpegoptimize
  • 优化JPEG霍夫曼压缩表(推荐)。
• -jpegprogressive
  • 使用渐进式JPEG压缩格式。
• -tiffcompress=#
  • 设置TIFF压缩方法，无，lzw, zip或jpeg, default=lzw。
• -cachesize=#
  • 内存缓存大小，单位为MB，默认=256。
• -tempdir=###
  • 为临时文件设置自定义目录。
• -q
  • 安静模式，无控制台输出。

CubeToSphere工具

• 将立方体全景图像转换回球形全景图像。
• 当输入图像具有嵌入的颜色配置文件时，它将被复制到输出图像中。

语法:

krpanotools cubetosphere inputfiles -o=outputfile [OPTIONS]

Inputfiles:

• 一个立方体的六幅图像 (supported image file formats).
• 图像应该有后缀，如_l， _f， _r， _b， _u， _d或名称，如左，前，右，后，上，下，在他们的文件名允许自动检测相关的立方体侧。
• 另外，也可以使用-l=### -f=### -r=### -b=### -u=## -d=###手动指定cubesides的文件名。

Options:

• -o=###
  • 设置输出映像的名称。
  • 默认情况下，它将是*_sphere.tif，其中*是基本输入文件名。
• -size=#x#
  • 输出图像的大小(WIDTHxHEIGHT)
  • 默认值:width = cubesize * PI, height = width / 2。
• -fast
  • 处理速度更快，但质量更差。
• -jpegquality=#
  • 设置JPEG压缩质量，0到100，默认值=85。
• -jpegsubsamp=#
  • 设置JPEG颜色子采样，444,420,420,411，默认=444。
• -jpegoptimize=#
  • 优化JPEG霍夫曼压缩表，true or false, 默认= true.
• -tiffcompress=#
  • 设置TIFF压缩方法，none，lzw, zip或jpeg, 默认=lzw。
• -tempdir=###
  • 为临时文件设置自定义目录。
• -q
  • 安静模式，无控制台输出。

保护工具

• 生成带有自定义保护设置的注册krpano查看器文件。

语法:

krpanotools protect -o=outputfilename [OPTIONS]

Outputfilename:

• Path/filename 的输出krpano.js查看器文件。

Options:

• -domain=###
  • 限制对给定域的使用。
  • 可多次使用。
• -expire=YYYY-MM-DD
  • 设置过期日期。
  • 在该日期之后，查看器将停止工作并显示过期信息。
• -expiredurl=###
  • 在过期日期之后 Open/redirect 到给定的url。
• -nolu
  • Local / offline 不允许使用。
• -noep
  • 没有外部参数-在查看器嵌入期间，将不可能向krpano查看器传递参数/变量。
• -nojs
  • 没有Javascript接口-它将不可能通过其 Javascript API 查看器通信。
• -noex
  • 禁止从其他域加载外部xml和插件。
• -noee
  • 阻止查看器嵌入到外部(跨域)iframe中。
• -pxml
  • 只允许加载私有加密的xml文件。
  • 未加密或公开加密的文件将无法加载。
• -pplg
  • 只允许加载私有加密的插件文件。
  • 未加密或公开加密的文件将无法加载。
• -bf
  • 生成一个无商标krpano查看器 (需要一个商标免费许可证).
• -demo
  • 生成未注册的演示水印krpano查看器(即使注册了krpano许可证)。
• -q
  • 安静模式，无控制台输出。

加密工具

• 加密文件。
• 只有krpano查看器才能加载这样的加密文件。
• 作为“私有”加密密钥，krpano许可证将被使用。这意味着只有注册了相同许可证的krpano查看器才能加载加密文件。

语法:

krpanotools encrypt [OPTIONS] inputfiles

Inputfiles:

• 任何文件(允许占位符*)。
• 支持的文件格式:xml、js、json、stl、depth、obj、mtl、txt。
• 默认情况下，文件名中会添加.encrypted后缀。

Options:

• -p
  • 使用“公共”加密密钥。
  • 每个人都可以加载加密文件。
• -ow
  • 覆盖原始输入文件。
• -bk
  • 覆盖原始输入文件，但之前要做备份。
• -in=### and -out=###
  • 手动设置输入和输出文件名。
  • 当使用stdout作为输出文件名时，加密的文件数据将被写入控制台。
• -q
  • 安静模式，无控制台输出。

注册工具

• 注册krpano许可代码或显示或删除已注册的许可。

语法:

krpanotools register [PARAMETER]

Parameter:

• ###
  • 在系统上注册给定的krpano许可代码。
• show
  • 显示当前注册信息。
• remove
  • 从系统中删除注册信息。

特殊许可证使用

• 对于一些特殊的用例，使用krpano许可证还有额外的参数。
• 例如，当存储许可证是不需要的或不起作用时，可以在web服务器上使用。

语法:

krpanotools ... -license=### -needlicense

Parameters:

• -license=###
  • 对当前调用使用给定的krpano许可代码。
  • 该许可证将不会在系统上注册，并且仅用于当前呼叫。
• -needlicense
  • 强制使用有效的许可证(通常注册的或通过license参数注册的)。
  • 当没有有效的krpano许可证时，工具将停止，退出/返回代码为1。

支持的图像文件格式

krpano工具支持以下图像文件格式:

• TIFF (.tif, .tiff)
  • Limitations: TIFF文件的文件大小限制为2 gb。
• BigTIFF (.btf, .tf8, .bigtiff)
  • Limitations: none.
• JPEG (.jpg, .jpeg)
  • Limitations: 最大图像大小为65535×65535px。
• PNG (.png)
  • Limitations: 目前只支持作为输入图像。
• Photoshop Document (.psd)
  • Limitations: 最大图像尺寸为30000x30000px。
• Photoshop Big Document (.psb)
  • Limitations: 最大图像尺寸为300000x300000px。
• Kolor RAW (.kro)
  • Limitations: none.

所有格式仅支持8位或16位RGB或RGBA格式。

​

结语

        

​