🧑🎓 个人主页:《爱蹦跶的大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:
- 输出图像的文件名或平铺模板。
- 平铺模板可以包含几个占位符来处理实际的平铺:
- %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格式。
✨ 结语