namespace TeamAAS.Camera.Enums
{
    /// <summary>
    /// 相机触发模式。
    /// 各品牌 SDK 能力不同，相机通过 <c>ICamera.SupportedTriggerModes</c> 声明自己支持哪些，
    /// 调用方（属性页 / 流程插件）据此动态生成可选项，不支持的模式下发会被拒绝。
    /// </summary>
    public enum CameraTriggerMode
    {
        /// <summary>
        /// 不下发任何触发设置，沿用相机自身当前配置。
        /// 作为默认值：既保证既有流程/旧存档行为不变，也避免多个节点共用一台相机时互相改写触发设置。
        /// </summary>
        跟随相机 = 0,

        /// <summary>自由运行：TriggerMode=Off，相机按自身帧率连续出图。</summary>
        连续采集 = 1,

        /// <summary>
        /// 软件触发：TriggerMode=On + TriggerSource=Software。
        /// 每次取相由软件发一条 TriggerSoftware 命令，相机才出一帧。
        /// </summary>
        软触发 = 2,

        /// <summary>
        /// 硬件触发（上升沿）：TriggerMode=On + TriggerSource=Line0 + TriggerActivation=Rising。
        /// 相机等外部信号（PLC/光电）上升沿出图；无信号时取相会超时。
        /// </summary>
        硬触发上升沿 = 3,

        /// <summary>
        /// 硬件触发（下降沿）：TriggerMode=On + TriggerSource=Line0 + TriggerActivation=Falling。
        /// </summary>
        硬触发下降沿 = 4,
    }
}