libcupsfilters 2.1.0

Security bug fix release. Early release of 2.1.0 to fix CVE-2024-47076.

• cfGetPrinterAttributes5(): Validate response attributes before return
  The IPP print destination which we are querying can be corrupted or forged, so validate the response to strenghten security. Fixes CVE-2024-47076.
• Include cupsfilters/testfilters.sh in release tarball
  check_SCRIPTS is not automatically included, has to be added to EXTRA_DIST.

libcupsfilters 2.1b1

First beta release for libcupsfilters 2.1.0.

New features (more to come):

• Support for building with libcups3, CUPS library of CUPS 3.x.
• Support for building with libcups of CUPS 2.5.x (Issue #36)
• CI/build/unit testing of filter functions using a table of test cases, each with input file, input and output formats, option settings, allows especially to create regression test cases based on reported bugs
• Convert INSTALL to INSTALL.md
  (Pull request #45)
• Add GitHub workflow for Canonical Open Documentation Academy
  OpenPrinting is participating in Canonical's Open Documentation Academy, as an organization in need of documentation. The workflow is still experimental and serves for auto-forwarding documentation-related issues.

Bug fixes:

• Always use sRGB/sGray if driver is PWG/URF and RGB/Gray is requested
  PWG Raster and Apple Raster (URF) are for driverless printing abd require the sRGB and sGRay standard color profiles (Pull request #51).
• raster_base_header(): Several fixes on color space selection
  Internal (static) function to create a CUPS or PWG Raster header from scratch, without using data of a PPD file, only IPP attributes and command line options. Fixes are done to make sure a monochrome color space is used for monochrome printers, the actual color space seletions (if supported) is used for PWG Raster, not always sRGB 8-bit, and DeviceN can be selected also without specifying the depth (Issue #38).
• Fix content data stream concatenation mangling output in cfFilterPDFToPDF()
  In cfFilterPDFToPDF() add newline after each content stream in ::provideStreamData. When concatenating the data streams for the page's contents, add a new line at the end of each data stream to avoid cases where the concatenation might result in a corruption (Pull request #56).
• cfCatalogLoad(): Fix incorrect strncpy() limit calculation
  Preserve the new allocated size in a variable and use it instead of sizeof() (Pull request #49).
• Remove redundant data type definition in libcups2-private.h
  (Pull request #44)
• pdf-cm.cxx: Fix possible integer overflow
  (Issue #42, Pull request #43)
• cfImageCMYKToCMY(): Fixed copy-and-paste error
  (Issue #41)
• Fix compilation with clang and libc++
  Define _GLIBCXX_THROW to empty for C++ 11 and newer.
  (Issue #35, Pull request #47)
• Fix warnings reported by clang 17
  (Pull request #48)
• pkgconfig: Add '-I${includedir}' to Cflags
  This way, includes prefixed with the "cupsfilters/" directory path also work. Especially libppd build also without problem when libcupsfilters is installed in a non-default path (Pull request #57).
• .gitignore: Ignore temporary files created by the build tests
• INSTALL.md: Updated dependencies
  We also need: gettext, libcups2-dev, libqpdf-dev (Pull request #59)
• INSTALL.md: Tell that we have make check for build testing
  (Pull request #59)

libcupsfilters 2.0.0

Final 2.0.0 release with some last fixes

• cfFilterUniversal(): Support application/vnd.cups-postscript
  Some filters (like hpps from HPLIP) produce this MIME type, so if the client uses a classic driver/Printer Application and the server IPP Everywhere, jobs fail because the library is not able to find a suitable conversion (Pull request #31).
• CHANGES.md: Added reference to Chromium bug report.
• INSTALL: We need Ghostscript 10.01.1 to get all changes for Raster output

libcupsfilters 2.0rc2

Bug fixes following first bug reports from Ubuntu 23.04 and Fedora 38 users, first distros with libcupsfilters 2.0rc1:

• Ignore unsupported resolution values when preparing a Raster header via cfRasterPrepareHeader() function, to avoid rasterization with wrong resolution (Issue #29, Ubuntu bug: #2022929, Chromium issue #1448735).
• cfRasterPrepareHeader(): When taking default resolution from urf-supported printer IPP attribute, use first value (lowest) of the list, to match the ppdLoadAttributes() function of libppd.
• cfIPPAttrResolutionForPrinter(): List of resolutions is not IPP_TAG_RANGE, corrected the search to use IPP_TAG_ZERO.
• cfIEEE1284NormalizeMakeModel(): Do not consider "XPrinter" as made by Xerox, only "XPrint" is (OpenPrinting CUPS pull request #506).
• INSTALL: Recommend QPDF 11.4.0 as it fixes loss of content filled into interactive forms as (Issue #28).
• INSTALL: Fixed some typos.

libcupsfilters 2.0rc1

Release Candidate: DNS-SD URI API prepared for libcups3, fixed control of page orientation, printing text in landscape, image scaling attributes

• Make orientation-requested work correctly In the filter functions cfFilterImageToRaster(), cfFilterImageToPDF(), cfFilterTextToPDF(), and cfFilterPDFToPDF() supplying the attributes orientation-requested or (no)landscape do the expected, rotating content 0/90/180/270 degrees.
• Auto-rotation is always done in the printer's default direction, +90 or -90 degrees as described by the landscape-orientation-requested-preferred IPP attribute or by the "*LandscapeOrientation: ..." PPD keyword (via libppd).
• The ppi attribute works correctly now,no cropping and using more than one sheet if the image gets too large.
• If more than one image-scaling-related attribute is supplied, only the one with the highest priority is used, no mixing with unexpected results.
• Default is always print-scaling=auto.
• cfFilterTextToPDF() is now capable of printing text in landscape layout, controlled by the orientation-requested and landscape attributes.
• The prettyprint attribute of the cfFilterTextToPDF() now uses wider margins for binding/stitching/punching as originally designed. If the printer has even wider margins this is taken into account.
• cfFilterImageToRaster(), cfFilterImageToPDF(), cfFilterTextToPDF(), and cfFilterPDFToPDF() all work now correctly also with no printer attributes/capabilities supplied at all, and also with and without supplying a page size. With PDF input the input page sizes are used if applicable. As last mean we resort to US Letter page size (Issue #26).
• The cfFilterUniversal() filter function now considers the output of cfFilterImageToPDF() correctly as application/vnd.cups-pdf and not as application/pdf, avoiding duplicate application of margins or rotation.
• cfFilterImageToRaster() now produces 16-bit-per-color output if requested by the job/printer, and does not output a blank page any more (Issue #25, pull request #22).
• On 1-bit dithered output white got a grid of dots
  An off-by-one bug in cfOneBitLine() made white areas appear with a grid of black dots (1 per 16x16 square). This corrected now (Issue #20).
• DNS-SD device URI resolution: Cleaned API for upcoming libcups3 support.
  For resolving DNS-SD-service-name-based device URIs for IPP printers as CUPS uses them, libcups2 does not offer any useful API and we therefore ended up implementing 2 workarounds. As libcups3 has an API function for it we have adapted our API for its use (libcups3 support will get actually added in version 2.1.0).
• Cleaned up the image scaling and rotation code in cfFilterImage...(), removing duplicate code and doing some simplification.
• cfFilterImageToPDF() could crash when an image could not get loaded and print-scaling was set to fill or none, as a part of the image processing was not covered by the NULL check.
• cfFilterUniversal(): Added NULL checks for parameters, so that the function can get called without parameters.
• Added -std=c++17 C++ compiler flag (Pull request #18)
  Needed to build libcupsfilters with QPDF 11.
• Removed unneeded #include entries for libcups

libcupsfilters 2.0b4

Adaptation to QPDF 11, Coverity scan and fixes, several other bug fixes.

• Do not free cf_image_t data structure in _cfImageZoomDelete() (cups-filters issue #507)
  The library-internal _cfImageZoom...() API does not create the cf_image_t data structure, so it should not free it, to avoid double-free crashes. This made the cfFilterImageToRaster() filter function (imagetoraster CUPS filter) crash.
• cfImageOpenFP(): Removed leftover HAVE_LIBZ conditionals
  In the 3rd beta we have removed the dependency on libz from the build system as there is no explicit dependency on it in libcupsfilters. Having forgotten to remove HAVE_LIBZ from the conditionals in cfImageOpenFP() PNG images were rendered as blank pages. See cups-filters issue #465.
• Compatibility with QPDF 11 and later
  • Replaced deprecated PointerHolder with shared_ptr (PR #13)
  • cfFilterPDFToPDF(): Replaced deprecated QPDF function name replaceOrRemoveKey by replaceKey.
  • Set CXXFLAGS="-DPOINTERHOLDER_TRANSITION=0" to silence QPDF warnings.
• Coverity check done by Zdenek Dohnal for the inclusion of libppd in Fedora and Red Hat. Zdenek has fixed all the issues: Missing free(), files not closed, potential string overflows, ... Thanks a lot!
• configure.ac: Change deprecated AC_PROG_LIBTOOL for LT_INIT (PR #12)
• INSTALL: Explain dependencies (PR #10)

libcupsfilters 2.0b3

Fixes of bugs found while packaging for distros, mainly in the build system and the source code documentation

• cfFilterGhostscript(): Select correct ICC profile for PCL-XL. When using the cfFilterGhostscript() filter function to generate PCL-XL (PXL, PCL 6, Ghostscript output devices "pxlmono", "pxlcolor") output, always the color IPP profile srgb.c was used, also for monochrome output ("pxlmono") and this makes Ghostscript error out. Now we correctly select sgray.icc for monochrome output.
• cfGetPrinterAttributes(): Poll media-col-database separately if needed.
  Some printers are not able to handle a get-printer-attributes request querying both the all group attribute and the media-col-database attribute, so query the latter with a separate call in such cases.
• cfGenerateSizes(): Also parse the media-col-ready IPP attribute for page sizes and margins. This often reveals extra margin variants, like borderless.
• Removed public cfPDFOut...() API (cupsfilters/pdfutils.h). This API only makes sense if the API of fontembed is also public, but this we made private earlier.
• Build system, README.md: Remove unnecessary dependencies overlooked during the separation: zlib (only needed by libppd), Freetype (not needed any more after removal of pdftoopvp), Avahi and GLib (both only needed by cups-browsed). Thanks a lot, Zdenek Dohnal (Pull request #7).
• COPYING, NOTICE: Simplification for autotools-generated files.
  autotools-generated files can be included under the license of the upstream code, and FSF copyright added to upstream copyright list. Simplified COPYING appropriately.
• COPYING, NOTICE: Added copyright year 2023
• COPYING, NOTICE, AUTHORS: Added Jai Luthra and Vikrant Malik
• Makefile.am: Include LICENSE in distribution tarball

libcupsfilters 2.0b2

Second beta release of libcupsfilters 2.0.0: Language specification in cfCatalog...() API, correct media dimensions support for calling filter functions without supplying printer attributes/properties, tons of fixes in source code documentation and build system.

• Manage page dimensions when no printer properties are given.
  If a filter function is called without printer IPP attributes (classic CUPS filter wrapper without PPD file) any page size/media attributes given are accepted, when no page dimensions are given, US Letter is used, and when no margins are given, non-zero default margins are used.
• cfFilterTextToPDF(): If no output page dimensions specified, use US Letter. Before, the page dimensions were set to 0x0, ending up with one empty page per character in the input file being produced.
• cfFilterPDFToPDF(): Initialize output page dimensions to easily identify if no dimensions were supplied, to fall back to default size Letter. Otherwise we get invalid PDF output if we do not specify the output page dimensions (no printer IPP attributes) but need them (for print-scaling=fit/fill, number-up, booklet).
• cfFilterGhostscript(): Never supply -dDEVICEWIDTHPOINTS=0 -dDEVICEHEIGHTPOINTS=0, if no page size got requested with the job (page dimensions are zero in raster header) skip these arguments so that Ghostscript uses the page dimensions of the input page.
• cfCatalog...() API: Add support to specify the UI language/locale. Before, the functions only served for getting English human-readable strings for options and choices of options, not translations in a requested language. As the human-readable strings are taken from the translation tables of CUPS and also of IPP printers, language support is trivial, only adding a parameter to supply the desired language (in xx or xx_YY format) (PR #2, #3).
• cfCatalog...() API: Removed const qualifier from output string pointers as these strings get allocated by the functions.
• Let API header files catalog.h and ipp.h not include config.h.
• Fixed building libcupsfilters with and without libpoppler. By default, libpoppler is used, to not use it, supply the --disable-poppler option to ./configure.
• Without libpoppler the cfFilterUniversal() function requires Ghostscript to turn PDF input into any of the Raster formats, built with both--disable-poppler and --disable-ghostscript, the universal filter function is not able to rasterize PDF.
• The cfFilterPDFToRaster() gets non-functional when building libcupsfilters without libpoppler. Calling it simply produces an error message in the log.
• Unnecessary ./configure options for the former PDF-to-PostScript filter function (has moved to libppd as ppdFilterPDFToPS) which were forgotten during the separation, are removed now.
• All AC_DEFINE macro calls in configure.ac got corrected, setting the macros in config.h really to 1 after testing positive.
• libcupsfilters does not use glib, removed the check in configure.ac.
• libcupsfilters.pc.in: Added libqpdf under Libs.private.
• Makefile.am: Include NOTICE in distribution tarball
• configure.ac: Added foreign to to AM_INIT_AUTOMAKE() call. Makes automake not require a file named README.
• Cleaned up .gitignore
• Tons of fixes in the source code documentation: README.md, INSTALL, DEVELOPING.md, CONTRIBUTING.md, COPYING, NOTICE, ... Adapted to the libcupsfilters component, added links.

libcupsfilters 2.0b1

First beta release of libcupsfilters 2.0.0, part of the new generation/successor of cups-filters, for use in the New Architecture for printing and scanning.

• Introduced the filter functions concept converting filter executables into library functions with common call scheme, moving their core functionality into libcupsfilters and allowing easier use by Printer Applications. Common data about the printer and the job are supplied via a data structure, which is the same for each filter in a chain of filters. The data structure can be extended via named extensions.
• Converted nearly all filters to filter functions, only exceptions are rastertoescpx, rastertopclx, commandtoescpx, commandtopclx, and foomatic-rip. The latter is deeply involved with Foomatic PPDs and the others are legacy printer drivers. Filter functions which output PostScript are implemented in libppd.
• Converted CUPS' rastertopwg filter into the cfFilterRasterToPWG() filter function.
• Created new cfFilterPWGToRaster() filter function primarily to print raster input (PWG Raster, Apple Raster, images) to CUPS Raster drivers in driver-retro-fitting Printer Applications.
• Converted all filter functions to completely work without PPD files, using only printer and job IPP attributes and an option list for options not mappable to IPP attributes. For some filter functions there are also wrappers for a more comprehensive PPD file support in libppd.
• Added concept of callback functions for logging, for the filter functions not spitting their log to stderr.
• Added concept of callback functions for telling that a job is cancelled so that filter functions can return early. This change is to get more flexibility and especially to support the papplJobIsCanceled() of PAPPL.
• Added new streaming mode triggered by the boolean "filter-streaming-mode" option. In this mode a filter (function) is supposed to avoid everything which prevents the job data from streaming. Currently cfFilterGhostscript() and cfFilterPDFToPDF() got a streaming mode.
• Added raster-only PDF and PCLm output support to the cfFilterGhostscript() filter function.
• cfFilterPDFToPDF(): Introduced new "input-page-ranges" attribute (Issue #365, Pull request #444, #445).
• Added cfFilterChain() filter function to run several filter functions in a chain.
• Added filterPOpen() and filterPClose() functions which similar to popen() and pclose() create a file descriptor which either takes data to feed into a filter function or provides data coming out of a filter function.
• Added new cfFilterExternal() filter function which calls an external CUPS filter (or backend) executable specified in the parameters, for example a legacy or proprietary printer driver which cannot be converted into a filter function. Backends can be run both for job execution or in their discovery mode. The environment in which the external executable is running is resembling CUPS as best as possible.
• Added support for the back and side channels which CUPS uses for additional communication between the filters and the backend into the filter function infrastructure. Now filter functions can use these channels and also CUPS filters or backends called via the cfFilterExternal() function. Printer Applications can easily create the needed pipes via the new function cfFilterOpenBackAndSidePipes() and close them via cfFilterCloseBackAndSidePipes() and filter functions used as classic CUPS filters get the appropriate file descriptors supplied by ihe ppdFilterCUPSWrapper() function of libppd.
• Added the cfFilterUniversal() filter function which allows a single CUPS filter executable which auto-creates chains of filter function calls to convert any input data format into any other output data format. So CUPS can call a single filter for any conversion, taking up less resources. Thanks to Pranshu Kharkwal for this excellent GSoC project (Pull request #421).
• Added functions to read out IPP attributes from the job and check them against the IPP attributes (capabilities) of the printer: cfIPPAttrEnumValForPrinter(), cfIPPAttrIntValForPrinter(), cfIPPAttrResolutionForPrinter()
• Added functions cfGenerateSizes() and cfGetPageDimensions() to match input page sizes with the page sizes available on the printer according to printer IPP attributes.
• Moved IEEE1284-device-ID-related functions into the public API of libcupsfilters, also made the internal functions public and renamed them all to cfIEEE1284...().
• Extended cfIEEE1284NormalizeMakeAndModel() to a universal function to clean up and normalize make/model strings (also device IDs) to get human-readable, machine-readable, or easily sortable make/model strings. Also allow supplying a regular expression to extract driver information when the input string is a PPD's *NickName.
• When calling filters without having printer attributes, improved understanding of color mode options/attributes. Options "output-mode", "OutputMode", "print-color-mode", and choices "auto", "color", "auto-monochrome", "process-monochrome", and "bi-level" are supported now and default color mode is RGB 8-bit color and not 1-bit monochrome.
• When parsing IPP attributes/options map the color spaces the same way as in the PPD generator (Issue #326, Pull request #327).
• Added new oneBitToGrayLine() API function which converts a line of 1-bit monochrome pixels into 8-bit grayscale format (cupsfilters/bitmap.[ch]).
• Removed support for asymmetric image resolutions ("ppi=XXXxYYY") in cfFilterImageToPDF() and cfFilterImageToRaster() as CUPS does not support this (Issue #347, Pull request #361, OpenPrinting CUPS issue #115).
• Removed now obsolete apply_filters() API function to call a chain of external CUPS filter executables, as we have filter functions now and even can call one or another filter executable (or even backend) via cfFilterExternal().
• Build system, README: Require CUPS 2.2.2+ and QPDF 10.3.2+. Removed now unneeded ./configure switches for PCLm support in QPDF and for use of the urftopdf filter for old CUPS versions.
• Renamed function/data type/constant names to get a consistent API: Functions start with "cf" and the name is in camel-case, data types start with "cf_" and are all-lowercase with "_" separators, constants start with "CF_" and are all-uppercase, also with "_" separators.
• Bumped soname to 2, as we have a new API now.
• Several bug fixes.