Xceed Streaming Compression Library Documentation
Xceed Streaming Compression control reference / Compression Method objects / XceedDeflateCompressionMethod object / CompressionLevel property
In This Topic
    CompressionLevel property
    In This Topic

    Description

    The CompressionLevel property controls the amount of compression to be applied by the compression algorithm when compressing data. The greater the amount of compression applied, the greater the time it takes to perform the compression. The extent of this property's effects depend on the compression algorithm being affected.

    Data type

    EXCCompressionLevel

    Possible values

    You can specify any value between 1 and 9, however we recommend using one of the following values: 

    Enumeration Value Meaning
    cclLow Minimum compression. This setting takes the least amount of time to compress data, but when compared to the cclMedium setting, will usually give slightly larger compressed data.
    cclMedium Normal compression. This is the best balance between the time it takes to compress data and the compression ratio achieved.
    cclHigh Maximum compression. This setting achieves the best compression ratios that the compression algorithm is capable of producing. When compared to the cclMedium setting, this setting significantly increases compression time for only slightly smaller compressed files. We recommend that you use this setting only when you really need to achieve the smallest possible files and when compression time is totally unimportant.

    Default value

    cclMedium

    Applicable methods

    Compress, Decompress, ProcessFile, ReadFile, WriteFile