Struct SemanticOptions 

#[non_exhaustive]
pub struct SemanticOptions {
    pub mode: Option<DecodeMode>,
    pub content_region: Option<[f32; 4]>,
}

Runtime options of one semantic decode.

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.

mode: Option<DecodeMode>

Decode mode; None uses the model’s default.

content_region: Option<[f32; 4]>

Image content within the model input as normalized [xmin, ymin, xmax, ymax], as produced by a letterbox resize. The region is cropped and stretched over the whole class map. None means the image fills the input.

Implementations

impl SemanticOptions

pub fn new() -> Self

Default options: the model’s decode mode, the image filling the input.

pub fn with_mode(self, mode: DecodeMode) -> Self

Overrides the model’s decode mode.

pub fn with_content_region(self, region: [f32; 4]) -> Self

Sets the content region: where the image sits in the model input.

pub fn with_convert( self, convert: &impl ContentRegionSource, src: (usize, usize), dst: (usize, usize), ) -> DecoderResult<Self>

Sets the content region from the options of the convert that prepared the model input, so the class map uses exactly the geometry the convert painted. src is the source image and dst the model input, each (width, height). A stretch leaves the region unset.

Errors

DecoderError::InvalidConfig when the convert geometry does not resolve.

use edgefirst_decoder::semantic::SemanticOptions;
use edgefirst_tensor::PreprocessSpec;

let options = SemanticOptions::new().with_convert(&PreprocessSpec::new(), (1280, 720), (640, 640))?;
assert_eq!(options.content_region, Some([0.0, 0.21875, 1.0, 0.78125]));

Trait Implementations

impl Clone for SemanticOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SemanticOptions

impl Debug for SemanticOptions

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

Formats the value using the given formatter.

impl Default for SemanticOptions

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SemanticOptions

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SemanticOptions