Struct ConversionOptions 

#[non_exhaustive]
pub struct ConversionOptions {
    pub rendering: RenderOptions,
    pub engine: EngineOptions,
    pub homophone_window: ContextWindow,
    pub homophone_detection: HomophoneDetection,
    pub first_occurrence_window: ContextWindow,
    pub collapse_redundant_parens: bool,
    pub recovery: Recovery,
}

Consolidated option bag carried through the umbrella facade.

ConversionOptions is #[non_exhaustive] so additional knobs can be added without a breaking change. Construct it through Preset::options and adjust individual fields, or use the Builder helpers that mutate it for you.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

rendering: RenderOptions

How annotations are turned into concrete text or markup.

engine: EngineOptions

Options forwarded to the conversion engine (segmentation, initial sound law, numeral strategy).

homophone_window: ContextWindow

Context window over which homophone disambiguation is computed.

homophone_detection: HomophoneDetection

Strategy that decides which dictionary readings are treated as homophones needing a parenthesized hanja gloss in RenderMode::HangulOnly.

Defaults to HomophoneDetection::ContextLocal, which glosses a word only when a different-meaning homophone actually appears within the homophone_window. Switch to HomophoneDetection::DictionaryWide to also gloss readings shared by other entries anywhere in the dictionary.

first_occurrence_window: ContextWindow

Context window for clearing repeated require_hanja / require_hangul flags after the first occurrence of each hanja form.

collapse_redundant_parens: bool

Whether redundant parenthetical reading annotations are collapsed.

When enabled (the default), an explicit gloss such as 庫間(곳간) or 곳간(庫間) is recognised, the redundant parenthetical text is removed, and the surviving annotation is marked to show both scripts in every render mode. A parenthetical that pins an alternative reading (for example 數字(수자)) overrides the dictionary reading for that occurrence. See RedundantParenCollapser.

recovery: Recovery

How the engine handles reader-level errors.

Trait Implementations

impl Clone for ConversionOptions

fn clone(&self) -> ConversionOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ConversionOptions

impl Debug for ConversionOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConversionOptions

fn default() -> Self

Returns the “default value” for a type.