Struct Crop 

pub struct Crop { /* private fields */ }

Extract a rectangular window of an image.

Crop is a coordinate remap, not a copy: it shifts the origin of the region its input is asked for, so under the M2 scheduler no pixel outside the window is ever decoded or computed. Cropping the corner off a huge image costs the corner, not the image.

Implementations

impl Crop

pub fn new(window: Region) -> Result<Crop, PixelsError>

Crop to window, in input image coordinates.

The window is validated against the actual input when the op is chained onto an image, not here, since the input shape is not yet known.

Errors

Returns PixelsError::InvalidArgument if the window is empty.

pub fn at(x: u32, y: u32, width: u32, height: u32) -> Result<Crop, PixelsError>

Crop to a window given as origin and size.

Errors

As Crop::new.

pub const fn window(&self) -> Region

The window this op extracts, in input coordinates.

Trait Implementations

impl Clone for Crop

fn clone(&self) -> Crop

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Crop

impl Debug for Crop

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

Formats the value using the given formatter.

impl Eq for Crop

impl Op for Crop

fn rescaled(&self) -> Option<Arc<dyn Op>>

Never rescaled, and the most important of the exclusions: a crop window is given in input pixels. crop(1000, 1000, 100, 100) against a source decoded eight times smaller would return a different part of the picture — correctly shaped, and the wrong content.

fn name(&self) -> &'static str

A short, stable name for this op, used in diagnostics.

fn output_descriptor( &self, inputs: &[ImageDescriptor], ) -> Result<ImageDescriptor, PixelsError>

Compute the output shape from the input shapes.

fn input_regions( &self, output: Region, _: &[ImageDescriptor], ) -> Result<Vec<Region>, PixelsError>

The input regions needed to produce output.

fn access_pattern(&self) -> AccessPattern

How this op reads its inputs; drives tile negotiation (ADR-0003).

fn compute( &self, inputs: &[Tile<'_>], output: &mut TileMut<'_>, ) -> Result<(), PixelsError>

Fill output from inputs — the kernel entry point.

fn arity(&self) -> usize

The number of inputs this op consumes.

impl PartialEq for Crop

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Crop