Struct opencv::core::RNG

pub struct RNG { /* fields omitted */ }

Random Number Generator

Random number generator. It encapsulates the state (currently, a 64-bit integer) and has methods to return scalar random values and to fill arrays with random values. Currently it supports uniform and Gaussian (normal) distributions. The generator uses Multiply-With-Carry algorithm, introduced by G. Marsaglia ( http://en.wikipedia.org/wiki/Multiply-with-carry ). Gaussian-distribution random numbers are generated using the Ziggurat algorithm ( http://en.wikipedia.org/wiki/Ziggurat_algorithm ), introduced by G. Marsaglia and W. W. Tsang.

Implementations

impl RNG

pub fn as_raw_RNG(&self) -> *const c_void

pub fn as_raw_mut_RNG(&mut self) -> *mut c_void

impl RNG

pub fn default() -> Result<RNG>

constructor

These are the RNG constructors. The first form sets the state to some pre-defined value, equal to 2**32-1 in the current implementation. The second form sets the state to the specified value. If you passed state=0 , the constructor uses the above default value instead to avoid the singular random number sequence, consisting of all zeros.

pub fn new(state: u64) -> Result<RNG>

constructor

These are the RNG constructors. The first form sets the state to some pre-defined value, equal to 2**32-1 in the current implementation. The second form sets the state to the specified value. If you passed state=0 , the constructor uses the above default value instead to avoid the singular random number sequence, consisting of all zeros.

Overloaded parameters

Parameters

• state: 64-bit value used to initialize the RNG.

Trait Implementations

impl Boxed for RNG

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

Wrap the specified raw pointer

pub fn into_raw(self) -> *mut c_void

Return an the underlying raw pointer while consuming this wrapper.

pub fn as_raw(&self) -> *const c_void

Return the underlying raw pointer.

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

Return the underlying mutable raw pointer

impl Drop for RNG

pub fn drop(&mut self)

Executes the destructor for this type.

impl RNGTrait for RNG

pub fn as_raw_RNG(&self) -> *const c_void

pub fn as_raw_mut_RNG(&mut self) -> *mut c_void

pub fn state(&self) -> u64

pub fn set_state(&mut self, val: u64)

pub fn next(&mut self) -> Result<u32>

The method updates the state using the MWC algorithm and returns the next 32-bit random number.

pub fn to_u8(&mut self) -> Result<u8>

Each of the methods updates the state using the MWC algorithm and returns the next random number of the specified type. In case of integer types, the returned number is from the available value range for the specified type. In case of floating-point types, the returned value is from [0,1) range.

pub fn to_i8(&mut self) -> Result<i8>

pub fn to_u16(&mut self) -> Result<u16>

pub fn to_i16(&mut self) -> Result<i16>

pub fn to_u32(&mut self) -> Result<u32>

pub fn to_i32(&mut self) -> Result<i32>

pub fn to_f32(&mut self) -> Result<f32>

pub fn to_f64(&mut self) -> Result<f64>

pub fn uniform(&mut self, a: i32, b: i32) -> Result<i32>

returns uniformly distributed integer random number from [a,b) range

pub fn uniform_1(&mut self, a: f32, b: f32) -> Result<f32>

returns uniformly distributed integer random number from [a,b) range

pub fn uniform_2(&mut self, a: f64, b: f64) -> Result<f64>

returns uniformly distributed integer random number from [a,b) range

pub fn fill(
    &mut self,
    mat: &mut dyn ToInputOutputArray,
    dist_type: i32,
    a: &dyn ToInputArray,
    b: &dyn ToInputArray,
    saturate_range: bool
) -> Result<()>

Fills arrays with random numbers.

pub fn gaussian(&mut self, sigma: f64) -> Result<f64>

Returns the next random number sampled from the Gaussian distribution

impl Send for RNG