ClikaRT::processor

namespace

Namespaces

Name	Description
`ClikaRT::processor::processor_defaults`	Default knob values the `from_args` factories apply when an argument is left `{}` (the documented HuggingFace/PIL defaults). Named here so callers see them in the header, `arg.value_or(kImageDefault…)`, without reading the docs. The library `static_assert`s each against its internal default, so these and the internal defaults are one source of truth (a drift is a compile error).

Classes

Name	Description
`AudioProcessOptions`	Per-call overrides for `AudioProcessor::process`. Only the knobs the pipeline reads fresh each call are here; nothing that would invalidate the processor's precomputed window / DFT / mel-filterbank tensors or its output-shape contract (sampling rate, FFT/window geometry, mel-bank geometry, feature type). A set field replaces the loaded config's value for THAT call only. `norm_mean`/`norm_std` are scalar operands (element `[0]` is read); both fields OWN their values.
`AudioProcessor`	A config-driven audio feature processor. Move-only.
`AudioProcessorConfig`	Settable configuration for an `AudioProcessor` (raw waveform / log-mel / filterbank). Default-constructed to the log-mel defaults; tune the STFT/mel knobs, or round-trip a `preprocessor_config.json` through `from_json` / `to_json`. Move-only.
`ImageProcessOptions`	Per-call overrides for `ImageProcessor::process` / `process_batch`. Every field is optional: a set field replaces the loaded config's value for THAT call only; an unset field keeps the config. Resolution is field-wise; setting `resize` does not flip `do_resize` (mirror of the HuggingFace per-call kwargs). The per-image dynamic-resize path (a target computed from the input image, e.g. an aspect-preserving patch-budget fit) rides `resize`.
`ImageProcessor`	A config-driven static image preprocessor. Move-only.
`ImageProcessorConfig`	Settable configuration for an `ImageProcessor` (convert-rgb → resize → center-crop → rescale → normalize → pad). Default-constructed to the documented HuggingFace defaults (resize + rescale by 1/255 + normalize on; crop + pad off); tune with the fluent setters, or round-trip a `preprocessor_config.json` through `from_json` / `to_json`. Move-only.
`ProcessedVideo`	A processed clip PLUS the sampling metadata a timestamp/alignment video model needs upstream (which frames were sampled, at what times). Returned by `VideoProcessor::process_with_indices`, the generic seam that lets a model build grid_thw / timestamp tokens from `frame_indices` + `pts_seconds` without folding any model-specific logic into ClikaRT.
`Processor`	A multimodal preprocessor bundle: the OPTIONAL per-modality sub-processors a model directory provides (a tokenizer + one media processor: audio / image / video). Move-only.
`VideoMetadata`	Timing metadata for a decoded clip (only `fps`-based sampling consults it).
`VideoProcessOptions`	Per-call overrides for `VideoProcessor::process`: the temporal sampling knobs, plus per-frame spatial overrides forwarded to the inner image pipeline. A set field replaces the loaded config's value for THAT call only.
`VideoProcessor`	A config-driven video preprocessor: temporal frame sampling composed over the channels-last image pipeline. Move-only.
`VideoProcessorConfig`	Settable configuration for a `VideoProcessor`: the per-frame `ImageProcessorConfig` plus temporal sampling (`num_frames` / `fps`). Move-only.

Enumerations

enum ImageResample

enum class ImageResample : std::uint8_t

Resampling filter for the image resize step, in the PIL/HuggingFace resample vocabulary. Enum values ARE the PIL codes a preprocessor_config.json carries, so a config round-trips exactly.

Enumerator	Value	Description
`Nearest`	`0`	PIL NEAREST.
`Bilinear`	`2`	PIL BILINEAR.
`Bicubic`	`3`	PIL BICUBIC (the HuggingFace default).

Declared in ClikaRT/processor/config.h, line 36

enum AudioFeatureType

enum class AudioFeatureType : std::uint8_t

Which standard feature pipeline an AudioProcessor runs.

Enumerator	Value	Description
`Raw`	`0`	raw mono waveform `[1, S]` + normalization
`LogMel`		log-mel spectrogram `[1, T, n_mels]`
`KaldiFbank`		kaldi-style log-mel filterbank `[1, T, n_mels]`

Declared in ClikaRT/processor/config.h, line 146

enum MelScale

enum class MelScale : std::uint8_t

Mel-scale hertz↔mel mapping (the analytic curve behind the filterbank).

Enumerator	Value	Description
`Htk`	`0`
`Slaney`
`Kaldi`

Declared in ClikaRT/processor/config.h, line 153

enum MelNorm

enum class MelNorm : std::uint8_t

Mel filterbank area normalization.

Enumerator	Value	Description
`None`	`0`
`Slaney`

Declared in ClikaRT/processor/config.h, line 156

enum LogMode

enum class LogMode : std::uint8_t

How the mel/power spectrum is compressed before normalization.

Enumerator	Value	Description
`None`	`0`	leave the (linear) power/mel spectrum
`Log`		natural log
`Log10`		base-10 log
`Db`		10·log10 (power → decibels)

Declared in ClikaRT/processor/config.h, line 159

enum WindowFunction

enum class WindowFunction : std::uint8_t

STFT analysis window function (rectangular = None).

Enumerator	Value	Description
`Hann`	`0`	Hann cosine window (the default).
`Hamming`		Hamming window.
`None`		rectangular (no windowing)
`Povey`		Kaldi's Povey window (a Hann-family power variant).

Declared in ClikaRT/processor/config.h, line 167

enum StftPadStyle

enum class StftPadStyle : std::uint8_t

How the center pad distributes around the signal: symmetric n_fft/2 each side (the torch STFT convention), or LEFT-only n_fft/2 (semicausal, a streaming front-end sees no future samples).

Enumerator	Value	Description
`Center`	`0`
`Semicausal`

Declared in ClikaRT/processor/config.h, line 177

enum LogFloorMode

enum class LogFloorMode : std::uint8_t

How the mel floor guards the log: clamp to the floor (log(max(x, floor))) or add it (log(x + floor)).

Enumerator	Value	Description
`Clamp`	`0`
`Additive`

Declared in ClikaRT/processor/config.h, line 181

enum AudioNormKind

enum class AudioNormKind : std::uint8_t

Output normalization kind (operands set alongside).

Enumerator	Value	Description
`None`	`0`
`ZeroMeanUnitVar`		per-utterance zero-mean unit-variance
`GlobalMeanStd`		subtract `norm_mean`, divide by `norm_std` (scalar operands)

Declared in ClikaRT/processor/config.h, line 184