LFUtilProcessWhiteImages()函数

LFUtilProcessWhiteImages - process a folder/tree of white images by fitting a grid model to each
%
% Usage:
%
%     LFUtilProcessWhiteImages
%     LFUtilProcessWhiteImages( WhiteImagesPath )
%     LFUtilProcessWhiteImages( WhiteImagesPath, FileOptions, GridModelOptions )
%     LFUtilProcessWhiteImages( WhiteImagesPath, [], GridModelOptions )
%
%所有参数都是可选的，采用实现顶部“Defaults”部分中设置的默认值。因此，这可以作为函数调用，也可以通过编辑代码直接运行。当作为函数调用时，传递一个空数组“[]）以省略参数。
%
%发布时，默认值设置为与使用LFP Reader v2.0.0提取的Lytro文件相关联的命名约定相匹配。
%
%Lytro相机附带了一个白色图像数据库。这些是通过扩散器，并在不同的缩放和焦点设置。它们对于去除渐晕（图像边缘附近变暗）和在原始光场图像中定位透镜中心非常有用。
%
%此函数准备一组白色图像供LF工具箱使用。为此，它使用函数LFBuildLensletGridModel为每个白色图像拟合一个网格模型。它还构建了一个数据库，用于选择合适的白色图像来解码光场，如函数LFLytroDecodeImage/LFSelectFromDatabase。默认参数设置为处理从Lytro相机提取的白色图像。
%
%对于每个网格模型拟合，都会生成一个显示，允许以视觉方式确认网格拟合是否良好。这将每个估计的网格中心显示为白色图像顶部的一个红点。如果函数成功，每个红点都应该出现在透镜的中心，即每个白色凸起上最亮的点附近。图像边缘是否有几行没有红色标记的透镜并不重要。
%
%
%输入——所有都是可选的，有关默认值，请参见下面的代码：
%
%white images Path：包含白色图像的文件夹的路径——注意该函数递归操作，即它将搜索子文件夹。白色图像数据库将在此路径的顶层创建。一个典型的配置是创建一个“Cameras”文件夹，其中为每个正在使用的相机创建一个单独的白色图像子文件夹。传递到此函数的适当路径是“相机”文件夹的顶层。
%
%FileOptions:struct控制文件命名和保存
%.SaveResult:设置为false以执行“干运行”
%.ForceRedo：默认情况下，将跳过已处理的白色图像；将此设置为true将强制重新处理已处理的文件
%.WhiteImageDatabasePath：保存白色图像数据库的文件的名称。
%WhiteMetadataFilenamePattern：用于查找白色图像元数据文件的文件搜索模式
%.WhiteRawDataFnameExtension：原始白色图像文件的文件扩展名
%.ProcessedWhiteImagenamePattern:定义网格模型文件名的模式；必须包含一个%s，该%s将被白色图像基文件名替换
%.WhiteImageMinMeanIntensity：平均强度低于此阈值的图像将被丢弃；这是必要的，因为包括Lytro的一些白色图像非常暗，不适用于网格建模
%
%gridmodelpoptions:LFBuildLensletGridModel控制网格构造的结构
%.FilterDiskRadiusMult：用于预过滤用于定位透镜的白色图像的滤波器盘半径；相对于透镜间距表示；例如，值1/3表示半径为透镜间距1/3的磁盘滤波器
%.CropAmt:查找网格时要忽略的边缘像素
%.SkipStep：作为速度优化，并非所有的lenslet中心都有助于网格估计；<SkipStep>像素在使用的lenslet中心之间被跳过；值1表示使用所有
%
%输出采用保存的网格模型文件和白色图像数据库的形式。
%
%另请参见：LFBuildLensletGridModel、lfutildecoodelytrofolder、LFUtilProcessCalibration