Main Content

cdflib.setCompression

指定压缩设置

语法

cdflib.setCompression(cdfId,ctype,cparms)

说明

cdflib.setCompression(cdfId,ctype,cparms) 指定常用数据格式 (CDF) 文件的压缩设置。

此函数设置对 CDF 文件自身的压缩,而不是对该文件中的任何变量的压缩。

输入参数

cdfId

CDF 文件的标识符,通过调用 cdflib.createcdflib.open 返回。

ctype

以下用于指定压缩类型的字符向量或字符串标量之一或其等效数值。

压缩类型
'NO_COMPRESSION'无压缩
'RLE_COMPRESSION'行程长度编码压缩
'HUFF_COMPRESSION'Huffman 压缩
'AHUFF_COMPRESSION'自适应 Huffman 压缩
'GZIP_COMPRESSION'GNU 的 zip 压缩

要获取与这些常量等效的数值,请使用 cdflib.getConstantValue 函数。

cparms

可选参数,用于指定压缩类型所需的任何其他参数。当前,使用此参数的唯一压缩类型为 'GZIP_COMPRESSION'。对于此压缩类型,使用 cparms 将压缩级别指定为介于 1 和 9 之间的数值。

示例

创建一个 CDF 文件并设置该文件的压缩设置。要运行此示例,当前文件夹必须是可写的。

cdfId = cdflib.create("your_file.cdf");

% Determine the file's default compression setting
[ctype,cparms,cpercent] = cdflib.getCompression(cdfId)
ctype =

    'NO_COMPRESSION'


cparms =

     []


cpercent =

   100
% Specify new compression setting
cdflib.setCompression(cdfId,"HUFF_COMPRESSION")

% Check the file's compression setting
[ctype,cparms,cpercent] = cdflib.getCompression(cdfId)
ctype =

    'HUFF_COMPRESSION'


cparms =

    'OPTIMAL_ENCODING_TREES'


cpercent =

     0
% Clean up
cdflib.delete(cdfId)
clear cdfId

参考

此函数对应于 CDF 库的 C API 例程 CDFsetCompression

要使用此函数,必须熟悉 CDF C 接口。您可以在 CDF 网站上访问 CDF 文档。