krpano Tools(命令行)使用指南

 🧑‍🎓 个人主页:《爱蹦跶的大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:

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
  • -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格式。

✨ 结语

        

  • 2
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值