[−][src]Trait opencv::bioinspired::Retina

pub trait Retina: AlgorithmTrait {
    pub fn as_raw_Retina(&self) -> *const c_void;
    pub fn as_raw_mut_Retina(&mut self) -> *mut c_void;

    pub fn get_input_size(&mut self) -> Result<Size> { ... }
    pub fn get_output_size(&mut self) -> Result<Size> { ... }
    pub fn setup_from_file(
        &mut self, 
        retina_parameter_file: &str, 
        apply_default_setup_on_failure: bool
    ) -> Result<()> { ... }
    pub fn setup_from_storage(
        &mut self, 
        fs: &mut FileStorage, 
        apply_default_setup_on_failure: bool
    ) -> Result<()> { ... }
    pub fn setup(&mut self, new_parameters: RetinaParameters) -> Result<()> { ... }
    pub fn get_parameters(&mut self) -> Result<RetinaParameters> { ... }
    pub fn print_setup(&mut self) -> Result<String> { ... }
    pub fn write(&self, fs: &str) -> Result<()> { ... }
    pub fn write_to_storage(&self, fs: &mut FileStorage) -> Result<()> { ... }
    pub fn setup_op_land_ipl_parvo_channel(
        &mut self, 
        color_mode: bool, 
        normalise_output: bool, 
        photoreceptors_local_adaptation_sensitivity: f32, 
        photoreceptors_temporal_constant: f32, 
        photoreceptors_spatial_constant: f32, 
        horizontal_cells_gain: f32, 
        hcells_temporal_constant: f32, 
        hcells_spatial_constant: f32, 
        ganglion_cells_sensitivity: f32
    ) -> Result<()> { ... }
    pub fn setup_ipl_magno_channel(
        &mut self, 
        normalise_output: bool, 
        parasol_cells_beta: f32, 
        parasol_cells_tau: f32, 
        parasol_cells_k: f32, 
        amacrin_cells_temporal_cut_frequency: f32, 
        v0_compression_parameter: f32, 
        local_adaptintegration_tau: f32, 
        local_adaptintegration_k: f32
    ) -> Result<()> { ... }
    pub fn run(&mut self, input_image: &dyn ToInputArray) -> Result<()> { ... }
    pub fn apply_fast_tone_mapping(
        &mut self, 
        input_image: &dyn ToInputArray, 
        output_tone_mapped_image: &mut dyn ToOutputArray
    ) -> Result<()> { ... }
    pub fn get_parvo(
        &mut self, 
        retina_output_parvo: &mut dyn ToOutputArray
    ) -> Result<()> { ... }
    pub fn get_parvo_raw_to(
        &mut self, 
        retina_output_parvo: &mut dyn ToOutputArray
    ) -> Result<()> { ... }
    pub fn get_magno(
        &mut self, 
        retina_output_magno: &mut dyn ToOutputArray
    ) -> Result<()> { ... }
    pub fn get_magno_raw_to(
        &mut self, 
        retina_output_magno: &mut dyn ToOutputArray
    ) -> Result<()> { ... }
    pub fn get_magno_raw(&self) -> Result<Mat> { ... }
    pub fn get_parvo_raw(&self) -> Result<Mat> { ... }
    pub fn set_color_saturation(
        &mut self, 
        saturate_colors: bool, 
        color_saturation_value: f32
    ) -> Result<()> { ... }
    pub fn clear_buffers(&mut self) -> Result<()> { ... }
    pub fn activate_moving_contours_processing(
        &mut self, 
        activate: bool
    ) -> Result<()> { ... }
    pub fn activate_contours_processing(&mut self, activate: bool) -> Result<()> { ... }
}

class which allows the Gipsa/Listic Labs model to be used with OpenCV.

This retina model allows spatio-temporal image processing (applied on still images, video sequences). As a summary, these are the retina model properties:

It applies a spectral whithening (mid-frequency details enhancement)
high frequency spatio-temporal noise reduction
low frequency luminance to be reduced (luminance range compression)
local logarithmic luminance compression allows details to be enhanced in low light conditions

USE : this model can be used basically for spatio-temporal video effects but also for : _using the getParvo method output matrix : texture analysiswith enhanced signal to noise ratio and enhanced details robust against input images luminance ranges _using the getMagno method output matrix : motion analysis also with the previously cited properties

for more information, reer to the following papers : Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011 Vision: Images, Signals and Neural Networks: Models of Neural Processing in Visual Perception (Progress in Neural Processing),By: Jeanny Herault, ISBN: 9814273686. WAPI (Tower ID): 113266891.

The retina filter includes the research contributions of phd/research collegues from which code has been redrawn by the author : take a look at the retinacolor.hpp module to discover Brice Chaix de Lavarene color mosaicing/demosaicing and the reference paper: B. Chaix de Lavarene, D. Alleysson, B. Durette, J. Herault (2007). "Efficient demosaicing through recursive filtering", IEEE International Conference on Image Processing ICIP 2007 take a look at imagelogpolprojection.hpp to discover retina spatial log sampling which originates from Barthelemy Durette phd with Jeanny Herault. A Retina / V1 cortex projection is also proposed and originates from Jeanny's discussions. more informations in the above cited Jeanny Heraults's book.

Required methods

`pub fn as_raw_Retina(&self) -> *const c_void`[src]

`pub fn as_raw_mut_Retina(&mut self) -> *mut c_void`[src]

Loading content...

Provided methods

`pub fn get_input_size(&mut self) -> Result<Size>`[src]

Retreive retina input buffer size

Returns

the retina input buffer size

`pub fn get_output_size(&mut self) -> Result<Size>`[src]

Retreive retina output buffer size that can be different from the input if a spatial log transformation is applied

Returns

the retina output buffer size

`pub fn setup_from_file( &mut self, retina_parameter_file: &str, apply_default_setup_on_failure: bool ) -> Result<()>`[src]

Try to open an XML retina parameters file to adjust current retina instance setup

if the xml file does not exist, then default setup is applied
warning, Exceptions are thrown if read XML file is not valid

[−][src]Trait opencv::bioinspired::Retina

Required methods

pub fn as_raw_Retina(&self) -> *const c_void[src]

pub fn as_raw_mut_Retina(&mut self) -> *mut c_void[src]

Provided methods

pub fn get_input_size(&mut self) -> Result<Size>[src]

pub fn get_output_size(&mut self) -> Result<Size>[src]

pub fn setup_from_file( &mut self, retina_parameter_file: &str, apply_default_setup_on_failure: bool) -> Result<()>[src]

pub fn setup_from_storage( &mut self, fs: &mut FileStorage, apply_default_setup_on_failure: bool) -> Result<()>[src]

pub fn setup(&mut self, new_parameters: RetinaParameters) -> Result<()>[src]

pub fn get_parameters(&mut self) -> Result<RetinaParameters>[src]

pub fn print_setup(&mut self) -> Result<String>[src]

pub fn write(&self, fs: &str) -> Result<()>[src]

pub fn write_to_storage(&self, fs: &mut FileStorage) -> Result<()>[src]

pub fn setup_ipl_magno_channel( &mut self, normalise_output: bool, parasol_cells_beta: f32, parasol_cells_tau: f32, parasol_cells_k: f32, amacrin_cells_temporal_cut_frequency: f32, v0_compression_parameter: f32, local_adaptintegration_tau: f32, local_adaptintegration_k: f32) -> Result<()>[src]

pub fn run(&mut self, input_image: &dyn ToInputArray) -> Result<()>[src]

pub fn apply_fast_tone_mapping( &mut self, input_image: &dyn ToInputArray, output_tone_mapped_image: &mut dyn ToOutputArray) -> Result<()>[src]

pub fn get_parvo( &mut self, retina_output_parvo: &mut dyn ToOutputArray) -> Result<()>[src]

pub fn get_parvo_raw_to( &mut self, retina_output_parvo: &mut dyn ToOutputArray) -> Result<()>[src]

pub fn get_magno( &mut self, retina_output_magno: &mut dyn ToOutputArray) -> Result<()>[src]

pub fn get_magno_raw_to( &mut self, retina_output_magno: &mut dyn ToOutputArray) -> Result<()>[src]

pub fn get_magno_raw(&self) -> Result<Mat>[src]

pub fn get_parvo_raw(&self) -> Result<Mat>[src]

pub fn set_color_saturation( &mut self, saturate_colors: bool, color_saturation_value: f32) -> Result<()>[src]

pub fn clear_buffers(&mut self) -> Result<()>[src]

pub fn activate_moving_contours_processing( &mut self, activate: bool) -> Result<()>[src]

pub fn activate_contours_processing(&mut self, activate: bool) -> Result<()>[src]

Implementations

impl<'_> dyn Retina + '_[src]

pub fn create(input_size: Size) -> Result<Ptr<dyn Retina>>[src]

pub fn create_ext( input_size: Size, color_mode: bool, color_sampling_method: i32, use_retina_log_sampling: bool, reduction_factor: f32, sampling_strength: f32) -> Result<Ptr<dyn Retina>>[src]

Implementors

impl Retina for PtrOfRetina[src]

pub fn as_raw_Retina(&self) -> *const c_void[src]

pub fn as_raw_mut_Retina(&mut self) -> *mut c_void[src]

`pub fn as_raw_Retina(&self) -> *const c_void`[src]

`pub fn as_raw_mut_Retina(&mut self) -> *mut c_void`[src]

`pub fn get_input_size(&mut self) -> Result<Size>`[src]

`pub fn get_output_size(&mut self) -> Result<Size>`[src]

`pub fn setup_from_file( &mut self, retina_parameter_file: &str, apply_default_setup_on_failure: bool ) -> Result<()>`[src]

`pub fn setup_from_storage( &mut self, fs: &mut FileStorage, apply_default_setup_on_failure: bool ) -> Result<()>`[src]

`pub fn setup(&mut self, new_parameters: RetinaParameters) -> Result<()>`[src]

`pub fn get_parameters(&mut self) -> Result<RetinaParameters>`[src]

`pub fn print_setup(&mut self) -> Result<String>`[src]

`pub fn write(&self, fs: &str) -> Result<()>`[src]

`pub fn write_to_storage(&self, fs: &mut FileStorage) -> Result<()>`[src]

`pub fn setup_ipl_magno_channel( &mut self, normalise_output: bool, parasol_cells_beta: f32, parasol_cells_tau: f32, parasol_cells_k: f32, amacrin_cells_temporal_cut_frequency: f32, v0_compression_parameter: f32, local_adaptintegration_tau: f32, local_adaptintegration_k: f32 ) -> Result<()>`[src]

`pub fn run(&mut self, input_image: &dyn ToInputArray) -> Result<()>`[src]

`pub fn apply_fast_tone_mapping( &mut self, input_image: &dyn ToInputArray, output_tone_mapped_image: &mut dyn ToOutputArray ) -> Result<()>`[src]

`pub fn get_parvo( &mut self, retina_output_parvo: &mut dyn ToOutputArray ) -> Result<()>`[src]

`pub fn get_parvo_raw_to( &mut self, retina_output_parvo: &mut dyn ToOutputArray ) -> Result<()>`[src]

`pub fn get_magno( &mut self, retina_output_magno: &mut dyn ToOutputArray ) -> Result<()>`[src]

`pub fn get_magno_raw_to( &mut self, retina_output_magno: &mut dyn ToOutputArray ) -> Result<()>`[src]

`pub fn get_magno_raw(&self) -> Result<Mat>`[src]

`pub fn get_parvo_raw(&self) -> Result<Mat>`[src]

`pub fn set_color_saturation( &mut self, saturate_colors: bool, color_saturation_value: f32 ) -> Result<()>`[src]

`pub fn clear_buffers(&mut self) -> Result<()>`[src]

`pub fn activate_moving_contours_processing( &mut self, activate: bool ) -> Result<()>`[src]

`pub fn activate_contours_processing(&mut self, activate: bool) -> Result<()>`[src]

`impl<'_> dyn Retina + '_`[src]

`pub fn create(input_size: Size) -> Result<Ptr<dyn Retina>>`[src]

`pub fn create_ext( input_size: Size, color_mode: bool, color_sampling_method: i32, use_retina_log_sampling: bool, reduction_factor: f32, sampling_strength: f32 ) -> Result<Ptr<dyn Retina>>`[src]

`impl Retina for PtrOfRetina`[src]

`pub fn as_raw_Retina(&self) -> *const c_void`[src]

`pub fn as_raw_mut_Retina(&mut self) -> *mut c_void`[src]