Skip to content

高级设置

Le Liu edited this page Nov 26, 2024 · 80 revisions

这些是没有提供用户界面的高级设置,请小心设置。

设置方法

  1. 打开 config.ini: 首选项 - 常规 - 配置文件存储位置 - 打开
  2. 相应的组(中括号内的即组名)下添加你所需的选项
    • 分号后面的为注释,无需添加
  3. 退出 Snipaste
  4. 保存并关闭 config.ini
  5. 启动 Snipaste

[General]

; 设置历史记录文件夹 (>= v1.8.2)
; Snipaste 不会为你自动创建文件夹,请自行确保文件夹存在,不存在将自动使用 ./history
; 斜杠请使用 / 或者 \\
; 支持使用环境变量,如 %username%
; 如路径中存在空格,无需使用引号; 不支持中文路径
; 相对路径示例:
; abc
; ./abc
; ../abc
; 绝对路径示例:
; D:/configs/sphistory
; D:\\abc def\\history

history_dir=c:/abc

; 隐藏托盘图标 (>= v1.8)
; 图标隐藏后,如需唤出首选项窗口,请在贴图上按 Ctrl + Shift + P (Windows/Linux) / Cmd + , (macOS)
; 有效值:true, false

hide_tray_icon=true

; 启用 GPU 硬件加速 (>= v2.8)
; 启用 GPU 硬件加速可以改善马赛克/高速模糊/阴影等效果的绘制效率。
; 有效值:
; 0: 禁用 1: 启用 2: 自动判断
; 默认值为 2,会自动判断 OpenGL 是否可用。
; 注意,Windows 系统下对 Intel/AMD/Mesa 显卡启用硬件加速可能会导致崩溃。
; 因此在默认设置下,如果检测到这些显卡,不会启用 GPU 硬件加速。

gpu_acceleration=0

; 设置进程的优先级 (>= v1.13.3)
; 有效值:
; 0: 正常 1: 高于正常  2: 高 3: 实时
; 当该选项未设置或使用了无效的值,将使用默认值:
; 如果 CPU 核数大于等于 2,默认值为 1,其他情况默认值为 0
; 此选项为 Windows 独占

process_priority=2

[Snip]

; 锚点自动隐藏的阈值 (>= v1.13)
; 如设为 100,那么在截图区域的宽度或高度小于 100 像素的时候,锚点会自动隐藏
; 设为 0 则表示始终不隐藏锚点
; 默认值为 80 * DPI 缩放率

anchors_threshold=80

; 将某些程序的窗口从窗口检测中排除 (>= v1.10.2)
; 例如,使用 LICEcap 进行屏幕录制的时候,LICEcap 自身的窗口会被检测到,
; 导致 Snipaste 无法检测到 LICEcap 底下窗口的元素,
; 这时可将 licecap.exe (大小写无关)加进这里
; 多个程序名称请以逗号分割
; 此选项为 Windows 独占

exclude_from_detection=a.exe, b.exe

; 对某些程序的窗口使用另一种界面元素检测算法 (>= v1.10.2)
; 对某些程序的窗口进行界面元素检测时,可能会导致 Snipaste 无响应或崩溃
; 这时可将它们的程序名称加进这里,Snipaste 会以另一种方法尝试进行元素检测
; 这种方法不太可能造成程序崩溃,但同时能检测到的元素略少一些
; 多个程序名称请以逗号分割
; 此选项为 Windows 独占

crashes=a.exe, b.exe

; 在检测窗口/界面元素时,是否使用过渡动画 (>= v2.10.2)
; 默认值为 true
; 有效值:true, false

animated_region_transition=false

[Paste]

; 将 HTML 转化成贴图时强制换行 (>= v1.13.2)
; 以符合“图片最大宽度”的设置值
; 有效值:true, false

force_html_wrap=true

; 指定贴图贴边吸附的距离阈值,以像素为单位 (>= v2.3)
; 默认值为 20 * DPI 缩放率

magnetic_attach_threshold=50

; 禁用贴图边缘缩放 (>= v2.3)
; 默认值为 false
; 有效值:true, false

disable_frame_resize=true

; 在多选贴图时,是否自动选中当前激活的窗口 (>= v2.4.1)
; 默认值为 false

include_active_window_for_multiselection=true

[Hotkey2]

; 交换 W A S D 按键和方向键的功能 (>= v1.13)
; 默认为 false,这时 WASD 用于移动光标位置,方向键用于移动截图区域或贴图窗口位置
; 如设为 true,则交换这两组按键的功能
; 注意,带修饰键的功能不受影响,即 Ctrl + → (扩大截图区域右边界) 依然是 Ctrl + →
; 有效值:true, false

exchange_wasd_and_arrow_keys=true

; 允许使用简单按键作为全局快捷键 (>= v2.2.4)
; 简单按键包括:
; 单独的字母键、数字键、标点符号键、方向键以及Esc、Enter 等常用按键
; 以及 Shift + 字母键、数字键、标点符号键
; 默认值为 false
; 有效值:true, false

allow_simple_hotkeys=true

[Annotate]

; 创建标注后自动选中它 (>= v2.2)
; 默认值为 true
; 有效值:true, false

auto_select_on_creation=true

[Interface]

; 隐藏标注工具条上的"输出选项"弹出菜单 (>= v2.10.3)
; 仅专业版可改变该设置
; 默认值为 false
; 有效值:true, false

hide_output_options=false

[Output]

; 保存时自动检测图像是否具有半透明像素,如果没有,移除移除其透明通道以减小文件大小 (>= v2.2)
; 默认值为 true
; 有效值:true, false

auto_alpha_channel_removal=true

[Misc]

; 为 Hex 颜色值使用大写字母 (>= v1.13.2)
; 有效值:true, false

uppercase_hex_color=true

; 设置自动下载图片(将网页中的图片拖拽到贴图上)的最大大小 (>= v2.1)
; 默认值为 20.0 (MB)

auto_download_max_image_size_mb=20

; 指定键盘按键双击的间隔,以毫秒为单位 (>= v2.3)
; 默认值为 400

double_tap_interval=500

; 保存图片时是否写入 Snipaste 相关的元数据 (>= v2.8.6)
; 仅专业版可改变该设置
; 默认值为 true
; 有效值:true, false

software_metadata=true

[Log]

; 设置日志文件名 (>= v1.12)

file=splog.txt

; 设置日志刷新间隔(秒) (>= v1.12)
; 默认值为 0,表示自动选择合适的时机,以获取最佳性能
; 注:当日志等级为“跟踪”或“调试”时,该设置无效

flush_interval=2

; 设置日志轮转数量 (>= v1.12)
; 0 为无轮转
; 默认值为 1

rotate=1

; 设置日志轮转大小 (>= v1.12)
; 默认值为 2.0 (MB)

rotate_size_mb=2.0

Home

docs.snipaste.com

Getting Started

PRO Features

Advanced Tips

Command Line Options

Advanced Configs

Troubleshooting

FAQ

Key Bindings

Changelog

Privacy Policy

EULA

Clone this wiki locally