Difference between revisions of "Function:FocusStack"

From CUVI Wiki
 
(8 intermediate revisions by the same user not shown)
Line 3: Line 3:
===Function===
===Function===
{|
{|
<pre style="background-color:#f7f7f7; color:#2f3337;">
|style="font-size:100%;"|
<syntaxhighlight lang="C">
CuviStatus focusStack(const CuviImage* ImgArr, const int numImages, CuviImage& sharpImage, CuviFilter denoiseFilter, const CuviStream& stream = CuviStream());
CuviStatus focusStack(const CuviImage* ImgArr, const int numImages, CuviImage& sharpImage, CuviFilter denoiseFilter, const CuviStream& stream = CuviStream());
</pre>
</syntaxhighlight>
|}
|}


===Parameters===
===Parameters===
 
{|
|style="font-size:75%;"|
{|class="wikitable"
{|class="wikitable"
|-
|-
Line 35: Line 37:
| const CuviStream&
| const CuviStream&
| GPU stream ID for execution
| GPU stream ID for execution
 
|}
|}
|}


===Image Type Support===
====Image Type Support====
 
{|
{| class="wikitable"
|style="font-size:75%;"|
{|class="wikitable"
|-
|-
! Input
! Input
Line 50: Line 53:
| 16uC3 x N
| 16uC3 x N
| 16uC3
| 16uC3
|}
|}
|}


===Samples===
====Samples====
{|
[[File:Fs-in-1.jpg|none|frame| Input image with foreground focused]]
|-
<br/>
|[[File:Fs-in-1.jpg|frame| Input image with foreground focused]]
[[File:Fs-in-2.jpg|none|frame| Input image with background focused]]
|[[File:Fs-in-2.jpg|frame| Input image with background focused]]
<br/>
|-
[[File:Focused.jpg|none|frame| Focus-Stacked Image]]
|[[File:Focused.jpg|frame| Focus-Stacked Image]]
<br/>
|}


===Example===
====Code Example====
{|
{|
<pre style="background-color:#f7f7f7; color:#2f3337;">
|style="font-size:100%;"|
<syntaxhighlight lang="C">


std::string path = "D:/dataset/fs/imageFolder/";
std::string path = "D:/dataset/fs/imageFolder/";
Line 94: Line 98:
cuvi::io::saveImage(focusImage, result);
cuvi::io::saveImage(focusImage, result);


</pre>
</syntaxhighlight>
|}
|}

Latest revision as of 22:23, 18 October 2022

Stacks multiple images into a single image. Images need to be aligned.

Function

CuviStatus focusStack(const CuviImage* ImgArr, const int numImages, CuviImage& sharpImage, CuviFilter denoiseFilter, const CuviStream& stream = CuviStream());

Parameters

Name Type Description
ImgArr const CuviImage* Input images array
numImages const int Number of images
sharpImage CuviImage& Resultant image
denoiseFilter CuviFilter Filter to remove noise
stream const CuviStream& GPU stream ID for execution

Image Type Support

Input Output
8uC3 x N 8uC3
16uC3 x N 16uC3

Samples

Error creating thumbnail: Unable to save thumbnail to destination
Input image with foreground focused


Error creating thumbnail: Unable to save thumbnail to destination
Input image with background focused


Error creating thumbnail: Unable to save thumbnail to destination
Focus-Stacked Image


Code Example

std::string path = "D:/dataset/fs/imageFolder/";
std::string result = "D:/dataset/fs/focused.png";


for (const auto& entry : fs::directory_iterator(path))
	{
		if (entry.path().has_extension() && isSupportedExtension(entry.path().extension().string()))
			vec.push_back(entry.path().string());
	}

int numImages = vec.size();
vector<CuviImage> ImgArr(numImages);
//Sort filesnames to read in order. THIS IS VERY IMPORTANT FOR FOCUS STACKING
sort(vec.begin(), vec.end(), lessFirst);

for (int i = 0; i < numImages; i++)
	{
		ImgArr[i].create(vec[i], CUVI_LOAD_IMAGE_COLOR_KEEP_DEPTH);
		cout << vec[i]<< std::endl;
	}


CuviImage focusImage;
CuviFilter denoiseFilter = CuviSpecialFilters::gaussian(CuviSize(11, 11), 15.0f);
cuvi::computerVision::focusStack(ImgArr.data(), numImages, focusImage, denoiseFilter);

printf("\nSaving to disk..");
cuvi::io::saveImage(focusImage, result);