Struct Element

pub struct Element { /* private fields */ }

Represents either a character or image tile, along with its luminance and pixel characteristics used for comparison and matching.

Implementations

impl Element

pub fn new( characteristics: Vec<f64>, luminance: f64, character: Option<char>, image: Option<DynamicImage>, ) -> Self

Constructs a new Element with the given characteristics and metadata.

pub fn characteristics(&self) -> &[f64]

Returns the pixel intensity values of the element.

pub fn luminance(&self) -> f64

Returns the average luminance of the element.

pub fn character(&self) -> Option<char>

Returns the character associated with this element, if any.

pub fn image(&self) -> Option<&DynamicImage>

Returns a reference to the image of this element, if available.

pub fn from_char( font: &FontArc, character: char, scale: PxScale, ) -> Result<Self>

Creates an element by rendering a character into an image using the provided font and scale, then converting it into luminance data.

pub fn from_image(image: DynamicImage) -> Result<Self>

Creates an element from an image tile by calculating its luminance characteristics.

pub fn normalized(&mut self, min: f64, max: f64) -> Result<()>

Normalizes the element’s pixel characteristics and luminance to fall within the given luminance range.

Trait Implementations

impl Clone for Element

fn clone(&self) -> Element

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.

impl Default for Element

fn default() -> Element

Returns the “default value” for a type.

impl PartialEq for Element

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Element