CentraDoc 7.2.4 - Summary of Changes since 7.1.3

Introduction

These are the changes to CentraDoc since the Version 7.1.3 release 2022-03-01.

GYP

Generate-Your-Projects is a build system originally used for Chromium and V8 (which has moved on to GN - Generate Ninja). GYP is still in use by the node.js project, as gyp-next: https://github.com/nodejs/gyp-next

GYP can be used to build Visual Studio projects for Windows and XCode projects for Mac, as well as Makefiles for Linux. GYP can also generate CMake and Ninja build files, although this doesn't work on all platforms. FYI, the Ninja build on Linux is very fast.

This makes it easier to produce the build you need, e.g.:

• Which version of Visual Studio?
• Static or Dynamic Runtime library?
• OpenSSL included or not?

etc.

Prebuilt projects are available in cdoc/build. The older builds in cdoc/ps will go away. The scripts that use GYP to build are in cdoc/src:

• gyp-linux
• gyp-macos
• gyp-win.cmd

as are most of the .gyp files. The gyp files use a Python program to expand wildcards (cdoc/src/tools/exp.py) which isn't built in to gyp. GYP is not used to compile the .lidl IDL files, which are shipped precompiled. The various lidl tools are in cdoc/src/tools, including the Liberty cross platform build engine (build.py), which can be used to run lidl. The cdoc/src/tools folder wasn't previously included in the drop.

PDF

C#

C# wrappers updated for signatures and the PDF-on-PDF / JSON stamp logic

• #2471 JSG stroke & fill objects didn't register in stamp bounds
• #2455 Add GCO.IsDebugBuild & explorer version debug & assemblyinfo debug markers
• #2431 change signature API for consistency and thread safe trust store
• #2411 Improved out of memory handling, other miscellaneous fixes; BestPPI API
• #2410 Improved exception handling, fix for FirstAndLastPage API
• #2407 * C# API requires clarifying semantics of Close operations for Pdf, PdfDoc, and PdfUpd classes in C API * C# API PdfStampPages::AllPages didn't work * C# API add GCO FailureHandler, WarningHandler

Preview SDK

• no ticket Added VERSIONINFO resource to Preview SDK DLL.

RIP enhancements

• #2444 RIP changes for PostScript page handling

Knowing the PostScript page size requires executing the PostScript code. PostScript can set the page size while executing, and change it for later pages. This led to some issues when using the RIP. There are some new workarounds for this.

First:

// Query if source is PostScript, if we need special handling
// returns TRUE or FALSE
int CDocRIP_IsPostScript(CDocRIPPtr self)

And:

// get the page size for the next page
// returns ESimpleError
int CDocRIP_GetNextPageBBox(CDocRIPPtr self, double oBBox[4])

CDocRIP_GetNextPageBBox will run the PostScript from it's current location until it gets a setpagedevice specifying the actual page size (which may or may not be there). PDF sources have direct access to this information.

Also:

// turn on auto targeting
void CDocRIP_AutoTarget(CDocRIPPtr self, const char *name, const RIPTargetSpec *spec);

The RIP can automatically create the appropriate sized page buffer based on the input page size and requested PPI. This is especially helpful when running CDocRIP_MTAutoRun, the thread-per-page RIP. See the threadrip.cpp example.

RIP multiple threads and examples

• Added -mp # option for multithreaded RIP by page instead of by band, only works for PDF files with multiple pages. threadrip.cpp example.
• RIP example minirip.cpp, much simpler than riptest.cpp, which has examples of lots of features, including the multithreaded band approach.

Multithreading & Stability

• #2441 requesting too large an image buffer should fail more cleanly. Previous (intermediate) error logic for other cases was incorrect.
• #2439 SSL_SetPersistence for testing. The OpenSSL library will not start up again if shut down, this enables repeated shutdown testing that leaves the OpenSSL library up and running.
• #2434 Threads created outside of the CentraDoc library that call CentraDoc must call the Thread_Cleanup function to free thread local storage before exiting.
• #2422 S_PdfRW_LoadJBIG2Into Return from inside ERR_TRY block, linux crash
• #2412 Generic logging engine. See rt_log.lidl & updated examples.
• #2408 Exceptions bypassing critical section unlocks in some cases could leave locks permanently locked, leaving multithreaded program hung
• #2402 Multithreaded RIP fixes and enhancement Some unsafe global accesses broke multithreading safety, fixed. GCO object reference counts used Atomic Increment/Decrement for Safety.
• #2386 More safety checks in the setjmp based ERR/exception module. By default, Windows uses SEH instead of setjmp, and Linux/other builds use setjmp, which has restrictions on what's allowed inside the ERR_TRY block. It's possible to test the setjmp logic on Windows by changing rt_except.h and commenting out the logic that turns on SEH, here:

#if defined(_MSC_VER) || defined(__BORLANDC__)
    #define USE_SEH     /* Structured Exception Handling */
#endif

Miscellaneous

• Support for GYP builds
• #2470 FFS_IsUnbounded(ffs) provides better detection of unbounded PostScript data sources for DvImgGrab
• #2461 Automatically generated Cython interface definitions, provides substrate for building Python extensions.
• #2453 Axial shader divide by zero on "difficult" inputs
• #2451 Improved axial function digest, affects RIP rendering and custom driver implementations of gradients. Integrated Type 4 via resampling.
• #2427 ImageResizerMaxWH=# to automatically downscale large images
• #2316 More cleanup of compiler warnings & odd constructs
• #1631 Add Windows default mapping for Helvetica-Narrow font as Arial Narrow.
• GCO C+++ HClass wrappers removed in preference for the GCO COM wrappers. Here is an example accessing FFs classes using the GCO COM wrappers:

#include "ffsstd.h"

void main() {
    IFFsStdFactory *ffsStdFactory = GetIFFsStdFactory();
    IFFs *out = ffsStdFactory->NewOut();
    out->WriteCStr("Hello world\n");
    out->Release();

    IFFsOSFactory *ffsOSFactory = GetIFFsOSFactory();
    out = ffsOSFactory->New("TESTFILE.TXT", FFS_WRITE);
    out->WriteCStr("Hello world\n");
    out->Release();
}

• Some of the code examples added to the distribution:
  • pdfdoc/ut
    • pdfobject.c - for inspecting objects in a pdf file
    • pdfstream.c - for inspecting streams in a pdf file
  • pdfupd/examples - various create examples
    • pdfcreate1.c
    • pdfFormExample.c
    • pdflayers.c
    • pdftrimesh.c
    • pdftype1font.c
    • pdftype3font.c
  • pdfupd/examples/docs - pretty printed versions of above
  • pdfupd/ut
    • pdfcp.c - pdf file copy
    • pdfmarkscmd.c - pdf marks command line utility
    • pdfpgcpy.c - pdf page copy
    • pdfrestr.c - pdf replace stream (re: pdfstream.c above)
    • pdfupdobj.c - pdf update object (re: pdfobject above)
    • pdfxpc.c - generate transparency example files
  • ut/
    • minirip.cpp - tiny RIP
    • riptest.cpp - extensive RIP
    • threadrip.cpp - multithreaded RIP
    • ps2pdf.c - distiller
  • ut/docs - pretty printed versions of above

Third-party libraries

• AntiGrain - 2.4
• FreeType - 2.12.1 UPDATED
• JPEG - JPEG-9e
• LCMS - 2.12
• libdmtx - 0.7.7 UPDATED
• libpng - 1.6.38 UPDATED
• OpenJPEG - 2.5.0 UPDATED
• QR-Code-generator-c - ~2018
• sha2 - 1.0.1
• YAJL - 2.0.1
• ZLib - 1.2.13 UPDATED

References

• Liberty Technology Systems

• Anti-Grain Geometry

• Little cms

• The FreeType Project

• Independent JPEG Group

• OpenJPEG / OpenJP2

• zlib compression library

• libng Portable Network Graphics library

• OpenSSL Cryptography Toolkit

• Adobe PostScript language specifications

• Adobe PDF Reference and Adobe Extensions to the PDF Specification

• ISO 32000-1:2008

• ISO 32000-2:2017

• Doxygen