Struct Region 

pub struct Region { /* private fields */ }

Normalized image edges. Zero-area regions are valid.

Implementations

impl Region

pub fn new(top: f64, bottom: f64, left: f64, right: f64) -> Result<Self, Error>

Validate finite edges in [0, 1], with top <= bottom and left <= right.

Errors

Returns InvalidArgument if an edge is nonfinite or outside [0, 1], if top exceeds bottom, or if left exceeds right. Zero-area regions are valid.

pub fn top(&self) -> f64

Top edge.

pub fn bottom(&self) -> f64

Bottom edge.

pub fn left(&self) -> f64

Left edge.

pub fn right(&self) -> f64

Right edge.

pub fn width(&self) -> f64

Normalized width.

pub fn height(&self) -> f64

Normalized height.

pub fn center(&self) -> (f64, f64)

Center as (x, y).

pub fn padded(&self, fraction: f64) -> Result<Self, Error>

Grow each side by a fraction of the region size, clipping to the image.

Errors

Returns InvalidArgument for nonfinite padding or resulting invalid edges, such as negative padding that shrinks past the opposite edge.

pub fn pixels( &self, width: u32, height: u32, ) -> Result<(u32, u32, u32, u32), Error>

Pixel edges (left, top, right, bottom), using ties-to-even rounding.

use semantic_operators::Region;
let region = Region::new(0.2, 0.6, 0.1, 0.5)?;
assert_eq!(region.pixels(1000, 500)?, (100, 100, 500, 300));

Errors

Returns InvalidArgument if either pixel dimension is zero.

Trait Implementations

impl AnswerType for Region

fn from_answer_value(v: &AnswerValue) -> Result<Self, Error>

Check and copy a heterogeneous value.

impl Clone for Region

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 Region

impl Debug for Region

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Region

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Region

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Region

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Region