Difference between revisions of "Function:OpticalFlowHS"

From CUVI Wiki
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
===Function===
====Function====
{|
{|
|style="font-size:150%;"|
|style="font-size:100%;"|
<syntaxhighlight lang="cpp">
<syntaxhighlight lang="C">
CuviStatus opticalFlowHS(CuviImage* previousImage,
CuviStatus opticalFlowHS(const CuviImage& previous,
                         CuviImage* nextImage,
                         const CuviImage& next,
                         Cuvi32f* velocityX,
                         Cuvi32f* flowX,
                         Cuvi32f* velocityY,
                         Cuvi32f* flowY,
                         Cuvi32s usePrevious = 0,
                         const bool usePrevious,
                         Cuvi32f lambda = 1.0f ,
                         const Cuvi32f lambda = 1.0f ,
                         Cuvi32s iterations = 1,
                         const Cuvi32s iterations = 1,
                         CuviStream* stream = NULL);
                         const CuviStream& stream = CuviStream());
</syntaxhighlight>
</syntaxhighlight>
|}
|}


 
====Parameters====
 
{|
 
|style="font-size:75%;"|
===Parameters===
{|class="wikitable"
{|class="wikitable"
|-
|-
Line 25: Line 24:
! Description
! Description
|-
|-
| previousImage
| previous
| CuviImage*
| const CuviImage&
| The first image whose features are to be tracked
| The first image whose features are to be tracked
|-
|-
| nextImage
| next
| CuviImage*
| const CuviImage&
| Second image, in which to look for features of first image
| Second image, in which to look for features of first image
|-
|-
| velocityX
| flowX
| Cuvi32f*
| Cuvi32f*
| Horizontal velocity vector
| Horizontal velocity vector
|-
|-
| velocityY
| flowY
| Cuvi32f*
| Cuvi32f*
| Vertical velocity vector
| Vertical velocity vector
|-
|-
| usePrevious
| usePrevious
| Cuvi32s
| bool
| use previous (input) velocity field
| use previous (input) velocity field
|-
|-
| lambda
| lambda
| Cuvi32f  
| const Cuvi32f  
| Lagrangian multiplier
| Lagrangian multiplier
|-
|-
| iterations  
| iterations  
| Cuvi32s
| const Cuvi32s
| Maximum number of iterations
| Maximum number of iterations
|-
|-
Line 56: Line 55:
| CuviStream*
| CuviStream*
| GPU stream ID for execution
| GPU stream ID for execution
 
|}
|}
|}


 
====Image Type Support====
===Image Type Support===
{|
 
|style="font-size:75%;"|
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 69: Line 68:
| 8uC1
| 8uC1
| 32fC1
| 32fC1
|}
|}
|}


====Sample====
[[File:Flow_hs.jpg]]


====Example====
{|
|style="font-size:100%;"|
<syntaxhighlight lang="cpp">
//Create two 8-bit Grays-scale CuviImage
CuviImage gimg1 = cuvi::io::loadImage(path,CUVI_LOAD_IMAGE_GRAYSCALE);
CuviImage gimg2 = cuvi::io::loadImage(path,CUVI_LOAD_IMAGE_GRAYSCALE);


===Sample===
 
[[File:Flow_hs.jpg]]
//Create output memory
Cuvi32f* u = new Cuvi32f[gimg.width() * gimg.height()];
Cuvi32f* v = new Cuvi32f[gimg.width() * gimg.height()];
 
//Calculates flow of each image pixel in two frames using Horn–Schunck method
cuvi::computerVision::opticalFlowHS(gimg1,gimg2,u,v,false);
 
 
</syntaxhighlight>
|}

Latest revision as of 22:15, 18 October 2022

Function

CuviStatus opticalFlowHS(const CuviImage& previous,
                         const CuviImage& next,
                         Cuvi32f* flowX,
                         Cuvi32f* flowY,
                         const bool usePrevious,
                         const Cuvi32f lambda = 1.0f ,
                         const Cuvi32s iterations = 1,
                         const CuviStream& stream = CuviStream());

Parameters

Name Type Description
previous const CuviImage& The first image whose features are to be tracked
next const CuviImage& Second image, in which to look for features of first image
flowX Cuvi32f* Horizontal velocity vector
flowY Cuvi32f* Vertical velocity vector
usePrevious bool use previous (input) velocity field
lambda const Cuvi32f Lagrangian multiplier
iterations const Cuvi32s Maximum number of iterations
stream CuviStream* GPU stream ID for execution

Image Type Support

Input Output
8uC1 32fC1

Sample

Error creating thumbnail: Unable to save thumbnail to destination

Example

//Create two 8-bit Grays-scale CuviImage
CuviImage gimg1 = cuvi::io::loadImage(path,CUVI_LOAD_IMAGE_GRAYSCALE);
CuviImage gimg2 = cuvi::io::loadImage(path,CUVI_LOAD_IMAGE_GRAYSCALE);


//Create output memory
Cuvi32f* u = new Cuvi32f[gimg.width() * gimg.height()];
Cuvi32f* v = new Cuvi32f[gimg.width() * gimg.height()];

//Calculates flow of each image pixel in two frames using Horn–Schunck method
cuvi::computerVision::opticalFlowHS(gimg1,gimg2,u,v,false);