Difference between revisions of "Function:FocusStack"

From CUVI Wiki
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
Stacks multiple images into a single image. Images need to be aligned.
Stacks multiple images into a single, all focused image. The input images need to be aligned and in order. The function also returns a depth_info image that contains the information against each pixel where it was picked from the stack.  
===Function===
===Function===
{|
{|
|style="font-size:150%;"|
|style="font-size:100%;"|
<syntaxhighlight lang="cpp">
<syntaxhighlight lang="C">
CuviStatus focusStack(const CuviImage* ImgArr,
CUVI_EXPORTS CuviStatus focusStack(CuviImage* images, const int numImages, CuviImage& stack, CuviImage& depth_info, const CuviFilter denoiseFilter, const CuviStream& stream);
                  const int numImages
                  CuviImage& sharpImage,
                  CuviFilter denoiseFilter
                  const CuviStream& stream = CuviStream());
</syntaxhighlight>
</syntaxhighlight>
|}
|}


===Parameters===
===Parameters===
 
{|
|style="font-size:75%;"|
{|class="wikitable"
{|class="wikitable"
|-
|-
Line 21: Line 18:
! Description
! Description
|-
|-
| ImgArr
| images
| const CuviImage*
| const CuviImage*
| Input images array
| Input images array
Line 29: Line 26:
| Number of images  
| Number of images  
|-
|-
| sharpImage
| stack
| CuviImage&
| CuviImage&
| Resultant image
| Resultant image
|-
| depth_info
| CuviImage&
| Slice/Depth information against stacked image
|-
|-
| denoiseFilter
| denoiseFilter
Line 40: Line 41:
| 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 56: Line 58:
| 16uC3
| 16uC3
|}
|}
|}
====Samples====
[[File:Fs-in-1.jpg|none|frame| Input image with foreground focused]]
<br/>
[[File:Fs-in-2.jpg|none|frame| Input image with background focused]]
<br/>
[[File:Focused.jpg|none|frame| Focus-Stacked Image]]
<br/>


===Samples===
====Code Example====
{|
{|
|-
|style="font-size:100%;"|
|[[File:Fs-in-1.jpg|frame| Input image with foreground focused]]
<syntaxhighlight lang="C">
|[[File:Fs-in-2.jpg|frame| Input image with background focused]]
|-
|[[File:Resizein2.jpg|frame|Input Image (Width = W, Height = H)]]
|[[File:Resizeout2.jpg|frame| Resized Image (width = 1.2*W, height= 1.75*H)]]


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


===Example===
{|
|style="font-size:150%;"|
<syntaxhighlight lang="cpp">


CuviImage gimg = cuvi::io::loadImage(path);
for (const auto& entry : fs::directory_iterator(path))
{
if (entry.path().has_extension() && isSupportedExtension(entry.path().extension().string()))
vec.push_back(entry.path().string());
}


const Cuvi32f xScale = 0.5f, yScale = 0.7f;
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);


const Cuvi32s newWidth = static_cast<Cuvi32s>(gimg.width() * xScale);
for (int i = 0; i < numImages; i++)
const Cuvi32s newHeight = static_cast<Cuvi32s>(gimg.height() * yScale);
{
ImgArr[i].create(vec[i], CUVI_LOAD_IMAGE_COLOR_KEEP_DEPTH);
cout << vec[i]<< std::endl;
}


CuviImage gout(newWidth,newHeight,gimg.type());


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


//Re-sizing input image to fit output container using bicubic interpolation
printf("\nSaving to disk..");
cuvi::geometryTransforms::resize(gimg,gout, CUVI_INTER_CUBIC);
cuvi::io::saveImage(focusImage, result);


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

Latest revision as of 08:53, 18 November 2024

Stacks multiple images into a single, all focused image. The input images need to be aligned and in order. The function also returns a depth_info image that contains the information against each pixel where it was picked from the stack.

Function

CUVI_EXPORTS CuviStatus focusStack(CuviImage* images, const int numImages, CuviImage& stack, CuviImage& depth_info, const CuviFilter denoiseFilter, const CuviStream& stream);

Parameters

Name Type Description
images const CuviImage* Input images array
numImages const int Number of images
stack CuviImage& Resultant image
depth_info CuviImage& Slice/Depth information against stacked 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

Input image with foreground focused


Input image with background focused


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, slice_info;
CuviFilter denoiseFilter = CuviSpecialFilters::gaussian(CuviSize(11, 11), 15.0f);
cuvi::computerVision::focusStack(ImgArr.data(), numImages, focusImage, slice_info, denoiseFilter);

printf("\nSaving to disk..");
cuvi::io::saveImage(focusImage, result);
Retrieved from "https://wiki.cuvilib.com/index.php?title=Function:FocusStack&oldid=1785"