vision.Deinterlacer

Remove motion artifacts by deinterlacing input video signal

Description

To remove motion artifacts by deinterlacing input video signal.

To track a set of points:

1. Create the vision.Deinterlacer object and set its properties.

2. Call the object with arguments, as if it were a function.

To learn more about how System objects work, see What Are System Objects?

Creation

Syntax

Hdeinterlacer = vision.Deinterlacer

Hdeinterlacer = vision.Deinterlacer(Name,Value)

Description

Hdeinterlacer = vision.Deinterlacer returns a deinterlacing System object, Hdeinterlacer, that removes motion artifacts from images composed of weaved top and bottom fields of an interlaced signal.

Hdeinterlacer = vision.Deinterlacer(Name,Value) sets properties using one or more name-value pairs. Enclose each property name in quotes. For example, varObj = vision.Deinterlacer('Method','Line repetition')

Properties

Unless otherwise indicated, properties are nontunable, which means you cannot change their values after calling the object. Objects lock when you call them, and the release function unlocks them.

If a property is tunable, you can change its value at any time.

For more information on changing property values, see System Design in MATLAB Using System Objects.

Method — Method used to deinterlace input video

'Line repetition' (default) | 'Linear interpolation' | 'Vertical temporal median filtering'

Method used to deinterlace input video, specified as 'Line repetition', 'Linear interpolation' , 'Vertical temporal median filtering'.

TransposedInput — Indicate if input data is in row-major order

false (default) | true

Indicate if input data is in row-major order, specified as true or false. Set this property to true if the input buffer contains data elements from the first row first, then the second row second, and so on.

Fixed-Point Properties

RoundingMethod — Rounding method for fixed-point operations

'Floor' (default) | 'Ceiling' | 'Convergent' | 'Nearest''Round' | 'Simplest''Zero'

Rounding method for fixed-point operations, specified as 'Floor', 'Ceiling', 'Convergent', 'Nearest' , 'Round' , 'Simplest' , or 'Zero'.

OverflowAction — Action to take when integer input is out-of-range

'Wrap' (default) | 'Saturate'

Action to take when integer input is out-of-range, specified as 'Wrap' or 'Saturate'.

ProductDataType — Product data type

'Same as input' (default) | 'Custom'

Product data type, specified as 'Same as input' or 'Custom'.

CustomProductDataType — Product word and fraction lengths

numerictype(true,32,30) (default) | scaled numerictype object

Product word and fraction lengths, specified as a scaled numerictype (Fixed-Point Designer) object. This property applies only when you set the AccumulatorDataType property to 'Custom'.

AccumulatorDataType — Data type of accumulator

'Same as product' (default) | 'Same as input' | 'Custom'

Data type of accumulator, specified as 'Same as product', 'Same as input', or 'Custom'.

CustomAccumulatorDataType — Accumulator word and fraction lengths

numerictype(true,32,30) (default) | scaled numerictype object

Accumulator word and fraction lengths, specified as a scaled numerictype (Fixed-Point Designer) object. This property applies only when you set the AccumulatorDataType property to 'Custom'.

Usage

Syntax

value = Hdeinterlacer(input)

Description

value = Hdeinterlacer(input)deinterlaces the input according to the algorithm set in the Method property

Input Arguments

input — Input data

top and bottom fields of interlaced video

Input data, specified as a combination of top and bottom fields of interlaced video.

Output Arguments

value — Frames of deinterlaced video

top and bottom fields of interlaced video

Frames of deinterlaced video, returned as the same data type as the input

Object Functions

To use an object function, specify the System object™ as the first input argument. For example, to release system resources of a System object named obj, use this syntax:

release(obj)

Common to All System Objects

step	Run System object algorithm
release	Release resources and allow changes to System object property values and input characteristics
reset	Reset internal states of System object

Examples

Remove Motion Artifacts From Image

Create a deinterlacer object.

hdinterlacer = vision.Deinterlacer;

Read an image with motion artifacts.

I = imread('vipinterlace.png');

Apply the deinterlacer to the image.

clearimage = hdinterlacer(I);

Display the results.

imshow(I); 
title('Original Image');

figure, imshow(clearimage); 
title('Image after deinterlacing');

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• See System Objects in MATLAB Code Generation (MATLAB Coder).

Version History

Introduced in R2012a