LFLytroDecodeImage-从原始lenslet图像解码Lytro光场

%LFLytroDecodeImage-从原始lenslet图像解码Lytro光场，由lfutildecoodelytrofolder调用
%
%用法：
% Usage:
%     [LF, LFMetadata, WhiteImageMetadata, LensletGridModel, DecodeOptions] = ...
%         LFLytroDecodeImage( InputFname, DecodeOptions )
%     [LF, LFMetadata, WhiteImageMetadata, LensletGridModel, DecodeOptions] = ...
%         LFLytroDecodeImage( InputFname )

%
%此函数将原始透镜图像解码为4D光场。其目的是为Lytro数据定制核心lenslet解码功能lfdecode lensletimagesimple。预计其他相机格式将
%以后有类似功能支持。
%
%例如，支持的文件格式包括Lytro LFP文件和使用LFP Reader v2.0.0提取的带有元数据的提取的.raw文件。有关详细信息，请参见LFToolbox.pdf。
%
%根据白色图像数据库选择适合于光场的白色图像，因此必须在执行此函数之前运行LFUtilProcessWhiteImages。
%
%LFUtilDecodeLytroFolder对于解码多个图像很有用。
%
%可选的DecodeOptions参数包括几个定义文件名模式的字段。它们与输入LFFnameBase相结合，以构建完整的文件名。文件名模式包括占位符'%s'，以表示基本文件名的位置。例如，原始输入文件LensletImageFnamePattern的defualt文件名模式是'%s\u frame.raw'。因此，形式为LFLytroDecodeImage（'IMG_0001'）的调用将查找原始输入文件'IMG_0001_frame.raw'。
%
%输入：
%
%InputFname：输入光字段的文件名——扩展名用于检测LFP或原始输入。
%
%[可选]解码选项：所有字段都是可选的，默认为LFP Reader v2.0.0命名
%.WhiteProcDataFnameExtension:来自LFUtilProcessWhiteImages的网格模型，默认为“Grid.json”
%.whiterawdatafname扩展名：白色图像文件扩展名，默认为“.RAW”
%.WhiteImageDatabasePath:白色图像数据库，默认为“Cameras/White image database.mat”
%
%为了与提取的.raw和.json文件兼容：
%.MetadataFnamePattern：包含光域元数据的JSON文件，默认为“_metadata.JSON”
%.SerialdataFnamePattern：包含序列号的JSON文件，默认为'\u private_metadata.JSON'
%
%输出：
%
%LF:5D数组，包含一个4通道（RGB+Weight）光场，索引在
%命令[j，i，l，k，channel]
%LFMetadata：元数据和串行元数据文件的内容
%white image metadata：白色图像元数据文件的元素
%Lenslet grid model：用于解码光场的Lenslet网格模型，由LFUtilProcessWhiteImages/LFBuildLensletGridModel根据白色图像构造
%decode选项：应用的选项，包括输入中省略的任何默认值
%
%
%示例：
%
%LF=LFLytroDecodeImage（'Images/F01/IMGu frame.raw'）；
%或者
%LF=LFLytroDecodeImage（'Images/Illum/LorikeetHiding.lfp'）；
%
%从光场的顶层运行采样将解码各自的原始光场或lfp光场。
%必须运行LFUtilProcessWhiteImages，解码才能工作。
%
%另请参见：lfutildecoodelytrofolder、LFUtilProcessWhiteImages、lfdecodelensTimeSimple、LFSelectFromDatabase
%2015年2月12日发布的LF工具箱v0.4的一部分
%版权所有（c）2013-2015 Donald G.Dansereau