codec

type AV1Config struct {
	// Required
	Width  int
	Height int // Height is the target frame height in pixels.

	// Bitrate control
	Bitrate     uint32          // Target bitrate in bps
	MaxBitrate  uint32          // Max bitrate for VBR
	RateControl RateControlMode // RateControl selects CBR, VBR, or CQ mode.

	// Quality
	FPS         float64    // Target framerate
	KeyInterval int        // Keyframe interval in frames
	Profile     AV1Profile // AV1 profile
	CQ          int        // Quality level for CQ mode (0-63)
	Speed       int        // Encoding speed (0-10, higher = faster)

	// Features
	Threads       int  // Encoding threads
	TileColumns   int  // Tile columns (log2)
	TileRows      int  // Tile rows (log2)
	FrameParallel bool // Enable frame parallel features
	LowDelay      bool // Low latency mode
	PreferHW      bool // Prefer hardware encoder
	ScreenContent bool // Optimize for screen content

	// SVC/Simulcast (AV1 has excellent native SVC support)
	SVC *SVCConfig // SVC configuration (nil = disabled, use SVCPreset* helpers)
}

type AV1Profile int

type H264Config struct {
	// Required
	Width  int
	Height int // Height is the target frame height in pixels.

	// Bitrate control
	Bitrate     uint32          // Target bitrate in bps (0 = auto based on resolution)
	MaxBitrate  uint32          // Max bitrate for VBR mode (0 = 1.5x Bitrate)
	MinBitrate  uint32          // Min bitrate for VBR mode (0 = 0.5x Bitrate)
	RateControl RateControlMode // RateControl selects CBR, VBR, or CQ mode.

	// Quality
	FPS         float64     // Target framerate (0 = 30)
	KeyInterval int         // Keyframe interval in frames (0 = 2 seconds worth)
	Profile     H264Profile // H.264 profile (empty = ConstrainedBaseline)
	Level       string      // H.264 level (empty = auto)
	CRF         int         // Quality for CQ mode (0-51, lower = better, 0 = lossless)

	// Performance
	Threads     int  // Encoding threads (0 = auto)
	LowDelay    bool // Optimize for low latency
	ZeroLatency bool // Ultra low latency mode (disables B-frames, lookahead)
	PreferHW    bool // Prefer hardware encoder if available

	// Simulcast (H.264 doesn't support true SVC, only simulcast)
	Simulcast *SVCConfig // Simulcast configuration (nil = disabled)
}

type H264FMTP struct {
	LevelAsymmetryAllowed string // LevelAsymmetryAllowed mirrors the SDP level-asymmetry-allowed flag.
	PacketizationMode     int    // PacketizationMode is the SDP packetization-mode value.
	ProfileLevelID        string // ProfileLevelID is the canonical six-byte profile-level-id value.
}

type H264Profile string

type OpusApplication int

type OpusBandwidth int

type OpusConfig struct {
	// Audio format
	SampleRate int // 8000, 12000, 16000, 24000, or 48000
	Channels   int // 1 (mono) or 2 (stereo)

	// Bitrate
	Bitrate     uint32 // Target bitrate in bps (6000-510000)
	VBR         bool   // Variable bitrate (default: true)
	Constrained bool   // Constrained VBR (useful for streaming)

	// Quality
	Application OpusApplication // VoIP, Audio, or LowDelay
	Bandwidth   OpusBandwidth   // Audio bandwidth
	Complexity  int             // Encoding complexity (0-10, higher = better quality)
	FrameSize   float64         // Frame size in ms: 2.5, 5, 10, 20, 40, 60

	// Features
	FEC        bool // Forward Error Correction
	DTX        bool // Discontinuous transmission (silence suppression)
	InBandFEC  bool // In-band FEC for packet loss recovery
	PacketLoss int  // Expected packet loss percentage (for FEC tuning)
}

type RateControlMode int

type SVCConfig struct {
	Mode   SVCMode          // SVC/simulcast mode
	Layers []SVCLayerConfig // Per-layer configuration. Simulcast helpers require one explicit entry per spatial layer.
}

type SVCLayerConfig struct {
	RID        string  // RID identifies the simulcast RTP stream. Leave empty for non-simulcast SVC-only layers.
	Width      int     // Resolution width in pixels.
	Height     int     // Resolution height in pixels.
	Bitrate    uint32  // Target bitrate for this layer
	MaxBitrate uint32  // Max bitrate for this layer
	FPS        float64 // Framerate for this layer (0 = same as base)
	Active     bool    // Whether this layer is active
}

type SVCMode int

type Type int

type VP8Config struct {
	// Required
	Width  int
	Height int // Height is the target frame height in pixels.

	// Bitrate control
	Bitrate     uint32          // Target bitrate in bps
	MaxBitrate  uint32          // Max bitrate for VBR
	RateControl RateControlMode // RateControl selects CBR, VBR, or CQ mode.

	// Quality
	FPS         float64 // Target framerate
	KeyInterval int     // Keyframe interval in frames
	CQ          int     // Quality level for CQ mode (0-63, lower = better)
	Deadline    int     // Encoding deadline: 0=best, 1=good, 2=realtime

	// Performance
	Threads        int  // Encoding threads
	LowDelay       bool // Low latency mode
	PreferHW       bool // Prefer hardware encoder
	ErrorResilient bool // Enable error resilience features
}

type VP9Config struct {
	// Required
	Width  int
	Height int // Height is the target frame height in pixels.

	// Bitrate control
	Bitrate     uint32          // Target bitrate in bps
	MaxBitrate  uint32          // Max bitrate for VBR
	RateControl RateControlMode // RateControl selects CBR, VBR, or CQ mode.

	// Quality
	FPS         float64    // Target framerate
	KeyInterval int        // Keyframe interval in frames
	Profile     VP9Profile // VP9 profile (0-3)
	CQ          int        // Quality level for CQ mode (0-63)
	Speed       int        // Encoding speed (0-9, higher = faster)

	// Features
	Threads       int  // Encoding threads
	TileColumns   int  // Tile columns (log2)
	TileRows      int  // Tile rows (log2)
	FrameParallel bool // Enable frame parallel decoding
	LowDelay      bool // Low latency mode
	PreferHW      bool // Prefer hardware encoder

	// SVC/Simulcast (VP9 has native SVC support)
	SVC *SVCConfig // SVC configuration (nil = disabled, use SVCPreset* helpers)
}

type VP9Profile int