Captura项目命令行参数详解：--source参数的使用指南

Captura项目命令行参数详解：--source参数的使用指南

Captura Capture Screen, Audio, Cursor, Mouse Clicks and Keystrokes 项目地址: https://gitcode.com/gh_mirrors/ca/Captura

概述

Captura是一款功能强大的屏幕录制工具，其命令行版本提供了丰富的参数选项来控制录制过程。本文将重点介绍--source参数的使用方法，这是控制录制源的核心参数，能够帮助用户精确指定需要捕获的内容区域或设备。

参数详解

1. 桌面捕获（默认选项）

使用方式：--source desktop

这是默认的捕获模式，会录制整个桌面区域。无论使用captura-cli start开始录制，还是captura-cli shot进行截图，都可以使用此参数。

技术细节：

• 当不指定--source参数时，系统会自动采用此模式
• 适用于需要录制整个桌面活动的场景
• 在多显示器环境下，会捕获所有显示器的合并区域

示例：

captura-cli start --source desktop

2. 区域捕获

使用方式：--source left,top,width,height

通过指定左上角坐标和宽高尺寸，可以精确捕获屏幕上的特定区域。参数值需要以逗号分隔。

技术细节：

• 所有尺寸参数必须为偶数，如果不是会自动减1调整为偶数
• 适用于需要录制固定区域内容的场景
• 坐标原点(0,0)位于屏幕左上角

示例（捕获从屏幕(100,100)位置开始，宽300像素，高400像素的区域）：

captura-cli shot --source 100,100,300,400

3. 特定显示器捕获

使用方式：--source screen:index

在多显示器环境下，可以通过索引值指定要捕获的特定显示器。

技术细节：

• 索引从0开始计数
• 可使用captura-cli list命令查看所有可用显示器及其索引
• 适用于多显示器工作环境下的选择性录制

示例（捕获索引为1的显示器）：

captura-cli start --source screen:1

4. 无视频录制

使用方式：--source none

此模式仅适用于captura-cli start命令，用于纯音频录制场景。

技术细节：

• 必须配合音频参数使用（如--speaker或--microphone）
• 适用于只需要录制声音不需要画面的场景
• 可以显著减少输出文件大小

示例（仅录制扬声器输出）：

captura-cli start --source none --speaker 0

5. 窗口捕获

使用方式：--source win:hWnd

通过指定窗口句柄，可以精确捕获特定窗口的内容。

技术细节：

• hWnd是Windows系统的窗口句柄标识
• 使用captura-cli list命令可查看当前可见窗口的句柄列表
• 录制模式下，窗口必须保持可见状态

6. 摄像头捕获

使用方式：--source webcam

此模式仅适用于captura-cli start命令，用于捕获摄像头画面。

技术细节：

• 需要配合--webcam参数指定摄像头设备
• 可使用captura-cli list查看可用摄像头列表
• 适用于需要录制摄像头画面的场景

示例（使用索引为0的摄像头）：

captura-cli start --source webcam --webcam 0

使用建议

1. 在使用前，建议先用captura-cli list命令查看可用的录制源
2. 对于固定区域的录制，区域捕获模式最为精确
3. 纯音频录制时使用none模式可以节省系统资源
4. 在多显示器环境下，明确指定显示器索引可以避免混淆
5. 窗口捕获模式适合录制特定应用程序界面

通过灵活组合这些参数，Captura可以满足各种屏幕录制和截图的需求，为用户提供强大的多媒体捕获能力。

Captura Capture Screen, Audio, Cursor, Mouse Clicks and Keystrokes 项目地址: https://gitcode.com/gh_mirrors/ca/Captura