api/lzma/filter.h

30  * \brief       Filter options
33  * options to liblzma. A few functions work with a single lzma_filter
57 	 * \brief       Pointer to filter-specific options structure
59 	 * If the filter doesn't need options, set this to NULL. If id is
60 	 * set to LZMA_VLI_UNKNOWN, options is ignored, and thus
63 	void *options;
76  * couldn't know what kind of options the filter would need.
95  * Copy the Filter IDs and filter-specific options from src to dest.
101  * Unless the filter-specific options is NULL, the Filter ID has to be
103  * filter-specific options structure. The filter-specific options are not
104  * validated. If options is NULL, any unsupported Filter IDs are copied
107  * Old filter-specific options in dest are not freed, so dest doesn't
115  *              - LZMA_OPTIONS_ERROR: Unsupported Filter ID and its options
211  *    the filter-specific options in the middle of encoding. The actual
213  *    it might become possible to change the filter options without
295  * \param       filter  Filter ID and options (the size of the properties may
296  *                      vary depending on the options)
303  *              necessarily validate the options. Thus, it is possible
314  * \param       filter  Filter ID and options
315  * \param       props   Buffer to hold the encoded options. The size of
323  * \note        Even this function won't validate more options than actually
325  *              succeeds but using the same options to initialize the encoder
341  *                          Filter ID. filter->options doesn't need to be
343  *                          decoded options will be stored to filter->options.
344  *                          filter->options is set to NULL if there are no
347  *                          options. Set to NULL to use the default malloc(),
370  * \param       filter  Filter ID and associated options whose encoded
374  *                guarantee that filter->options is valid, thus
376  *              - LZMA_OPTIONS_ERROR: Unknown Filter ID or unsupported options.
377  *              - LZMA_PROG_ERROR: Invalid options
393  * \param       filter      Filter ID and options to be encoded
400  *              - LZMA_OPTIONS_ERROR: Invalid or unsupported options.
401  *              - LZMA_PROG_ERROR: Invalid options or not enough output
414  * filter->options is not free()d.