Struct Extend 

pub struct Extend { /* private fields */ }

Add top, right, bottom and left pixels around an image.

Like crate::Resize, an instance belongs to one graph edge: copy, repeat and mirror wrap around the input’s size, which is bound when the op is chained, and chaining the same instance onto a differently sized image is a PixelsError::Graph.

Implementations

impl Extend

pub const fn new(top: u32, right: u32, bottom: u32, left: u32) -> Extend

Margins of top, right, bottom and left pixels, filled with opaque black, sharp’s default.

pub const fn uniform(margin: u32) -> Extend

The same margin on every side (sharp’s extend(n)).

pub const fn extend_with(self, with: ExtendWith) -> Extend

Fill the margin by with instead of the background colour.

pub const fn with_background(self, rgba: [u8; 4]) -> Extend

The RGBA colour ExtendWith::Background paints. Grey formats take its luma, and formats without alpha ignore its alpha.

pub const fn margins(&self) -> (u32, u32, u32, u32)

The margins, as (top, right, bottom, left).

pub const fn method(&self) -> ExtendWith

How the margin is filled.

pub const fn background(&self) -> [u8; 4]

The background colour.

Trait Implementations

impl Clone for Extend

fn clone(&self) -> Extend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Extend

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

Formats the value using the given formatter.

impl Op for Extend

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

Never rescaled: the margins are in output pixels, and a margin of 10 around a source decoded eight times smaller would be 80 at full size.

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, inputs: &[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.