Struct opencv::imgproc::LineIterator

pub struct LineIterator { /* private fields */ }

Class for iterating over all pixels on a raster line segment.

The class LineIterator is used to get each pixel of a raster line connecting two specified points. It can be treated as a versatile implementation of the Bresenham algorithm where you can stop at each pixel and do some extra processing, for example, grab pixel values along the line or draw a line with an effect (for example, with XOR operation).

The number of pixels along the line is stored in LineIterator::count. The method LineIterator::pos returns the current position in the image:

// grabs pixels along the line (pt1, pt2)
// from 8-bit 3-channel image to the buffer
LineIterator it(img, pt1, pt2, 8);
LineIterator it2 = it;
vector<Vec3b> buf(it.count);
 
for(int i = 0; i < it.count; i++, ++it)
   buf[i] = *(const Vec3b*)*it;
 
// alternative way of iterating through the line
for(int i = 0; i < it2.count; i++, ++it2)
{
   Vec3b val = img.at<Vec3b>(it2.pos());
   CV_Assert(buf[i] == val);
}

Implementations

impl LineIterator

pub fn new(
    img: &Mat,
    pt1: Point,
    pt2: Point,
    connectivity: i32,
    left_to_right: bool
) -> Result<LineIterator>

Initializes iterator object for the given line and image.

The returned iterator can be used to traverse all pixels on a line that connects the given two points. The line will be clipped on the image boundaries.

Parameters

• img: Underlying image.
• pt1: First endpoint of the line.
• pt2: The other endpoint of the line.
• connectivity: Pixel connectivity of the iterator. Valid values are 4 (iterator can move up, down, left and right) and 8 (iterator can also move diagonally).
• leftToRight: If true, the line is traversed from the leftmost endpoint to the rightmost endpoint. Otherwise, the line is traversed from \p pt1 to \p pt2.

C++ default parameters

• connectivity: 8
• left_to_right: false

pub fn new_1(
    pt1: Point,
    pt2: Point,
    connectivity: i32,
    left_to_right: bool
) -> Result<LineIterator>

C++ default parameters

• connectivity: 8
• left_to_right: false

pub fn new_2(
    bounding_area_size: Size,
    pt1: Point,
    pt2: Point,
    connectivity: i32,
    left_to_right: bool
) -> Result<LineIterator>

C++ default parameters

• connectivity: 8
• left_to_right: false

pub fn new_3(
    bounding_area_rect: Rect,
    pt1: Point,
    pt2: Point,
    connectivity: i32,
    left_to_right: bool
) -> Result<LineIterator>

C++ default parameters

• connectivity: 8
• left_to_right: false

Trait Implementations

impl Boxed for LineIterator

unsafe fn from_raw(ptr: *mut c_void) -> Self

Wrap the specified raw pointer

fn into_raw(self) -> *mut c_void

Return an the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> *const c_void

Return the underlying raw pointer.

fn as_raw_mut(&mut self) -> *mut c_void

Return the underlying mutable raw pointer

impl Drop for LineIterator

fn drop(&mut self)

Executes the destructor for this type.

impl LineIteratorTrait for LineIterator

fn as_raw_mut_LineIterator(&mut self) -> *mut c_void

fn ptr(&mut self) -> *mut u8

unsafe fn set_ptr(&mut self, val: *mut u8)

fn set_step(&mut self, val: i32)

fn set_elem_size(&mut self, val: i32)

fn set_err(&mut self, val: i32)

fn set_count(&mut self, val: i32)

fn set_minus_delta(&mut self, val: i32)

fn set_plus_delta(&mut self, val: i32)

fn set_minus_step(&mut self, val: i32)

fn set_plus_step(&mut self, val: i32)

fn set_minus_shift(&mut self, val: i32)

fn set_plus_shift(&mut self, val: i32)

fn set_p(&mut self, val: Point)

fn set_ptmode(&mut self, val: bool)

fn init(
    &mut self,
    img: &Mat,
    bounding_area_rect: Rect,
    pt1: Point,
    pt2: Point,
    connectivity: i32,
    left_to_right: bool
) -> Result<()>

fn try_deref_mut(&mut self) -> Result<*mut u8>

Returns pointer to the current pixel.

fn incr(&mut self) -> Result<LineIterator>

Moves iterator to the next pixel on the line.

impl LineIteratorTraitConst for LineIterator

fn as_raw_LineIterator(&self) -> *const c_void

fn ptr0(&self) -> *const u8

fn step(&self) -> i32

fn elem_size(&self) -> i32

fn err(&self) -> i32

fn count(&self) -> i32

fn minus_delta(&self) -> i32

fn plus_delta(&self) -> i32

fn minus_step(&self) -> i32

fn plus_step(&self) -> i32

fn minus_shift(&self) -> i32

fn plus_shift(&self) -> i32

fn p(&self) -> Point

fn ptmode(&self) -> bool

fn pos(&self) -> Result<Point>

Returns coordinates of the current pixel.

impl Send for LineIterator