|
Suporte melhorado de compressão ZLib
Visão geral
O HotPDF inclui agora suporte abrangente de compressão compatível com ZLib, suportado pelo zlib-ng incluído para fluxos e conteúdo PDF. A API compatível com zlib fornece compressão deflate/inflate eficiente, amplamente usada em documentos PDF para operações de filtro FlateDecode e compressão geral de dados
Funcionalidades principais
- API compatível com ZLib suportada por zlib-ng integrado
- Suporte de parâmetros PDF FlateDecode
- Compressão e descompressão baseadas em fluxos
- Capacidades melhoradas de tratamento de erros e depuração
- Processamento eficiente em memória para fluxos de dados grandes
- Ponte de compressão one-shot de imagem Win64 para segurança do ABI de comprimento do zlib-ng
- Despacho SIMD de runtime do zlib-ng Win64x e MSVC Win64 de diagnóstico com alternativas genéricas
- Ponte de alocação C alinhada a 32 bytes para buffers nativos compatíveis com SIMD
- Integração de biblioteca C multiplataforma
- Vários níveis de compressão (nenhuma, mais rápida, predefinida, máxima)
Implementação técnica
O suporte ZLib melhorado é implementado através do módulo HPDFZLib.pas, que fornece
- API ZLib completa: Implementação completa das funções ZLib
- Classes de fluxo: TCustomZStream e classes derivadas para processamento de fluxos
- PDF Integration: TPDFFlateParms for PDF-specific parameters
- Enhanced Functions: InflateStr, InflateStrParms for simplified usage
Os conjuntos de objectos zlib-ng de 64 bits incluem caminhos SSE2, SSSE3, SSE4.1, SSE4.2, PCLMULQDQ e AVX2 seleccionados em tempo de execução. O Win32 usa o conjunto de objectos zlib-ng genérico para manter a compatibilidade com a cadeia de ferramentas OMF do bcc32c, enquanto os objectos JPEG/TIFF de Win32 continuam no bcc32 clássico
Regression Coverage
O backend Flate de zlib-ng é coberto pelas suites automatizadas de regressão Delphi e C++Builder. O conjunto de validação actual passa 20 testes Delphi DUnitX em Win32 e 20 em Win64, mais 17 testes C++Builder GoogleTest em Win32 e 17 em Win64x. As recompilações nativas de objectos também passam a partir de saídas limpas: 206 objectos Win32, 205 objectos Win64x e 206 objectos MSVC Win64. Os fluxos de trabalho cobertos incluem compressão de streams de página, compressão de fontes incorporadas e de CMap ToUnicode, streams de imagem Flate, colocação de imagem JPEG standard, importação TIFF, saída com muitos códigos de barras, cenários de copiar / fundir / editar e PDFs gerados pelas demos
Compression Levels
- Z_NO_COMPRESSION (0): No compression
- Z_BEST_SPEED (1): Fastest compression
- Z_BEST_COMPRESSION (9): Maximum compression
- Z_DEFAULT_COMPRESSION (-1): equilíbrio predefinido entre velocidade e compressão
Exemplos de utilização
Basic String Compression/Decompression
// Delphi example - Basic string inflation
function DecompressString(const CompressedData: AnsiString): AnsiString;
begin
// Simple decompression
Result := InflateStr(CompressedData);
// With debug output enabled
Result := InflateStr(CompressedData, True);
end;
Stream-based Compression
// Delphi example - Stream-based decompression
procedure DecompressStream(InStream, OutStream: TStream);
begin
// Decompress from input stream to output stream
PLZDecompressStream(InStream, OutStream);
// For raw deflate data (without ZLib headers)
PLZDecompressStreamRaw(InStream, OutStream);
end;
PDF FlateDecode with Parameters
// Delphi example - PDF FlateDecode with parameters
function DecompressPDFStream(const CompressedData: AnsiString;
Predictor, Colors, BitsPerComponent, Columns: Integer): AnsiString;
var
Parms: TPDFFlateParms;
begin
// Configure PDF parameters
Parms.Predictor := Predictor;
Parms.Colors := Colors;
Parms.BitsPerComponent := BitsPerComponent;
Parms.Columns := Columns;
Parms.ExpandedTo8Bit := True;
Parms.ColorSpace := 'DeviceRGB';
// Decompress with PDF parameters
Result := InflateStrParms(CompressedData, Parms);
end;
Low-level ZLib Operations
// Delphi example - Low-level ZLib operations
procedure CompressData;
var
strm: z_stream;
ret: Integer;
input: AnsiString;
output: AnsiString;
begin
input := 'Data to compress';
SetLength(output, Length(input) * 2);
// Initialize stream
FillChar(strm, SizeOf(strm), 0);
ret := deflateInit(strm, Z_DEFAULT_COMPRESSION);
if ret = Z_OK then
try
// Set input
strm.next_in := PByte(PAnsiChar(input));
strm.avail_in := Length(input);
// Set output
strm.next_out := PByte(PAnsiChar(output));
strm.avail_out := Length(output);
// Compress
ret := deflate(strm, Z_FINISH);
if ret = Z_STREAM_END then
begin
// Compression successful
SetLength(output, Length(output) - strm.avail_out);
end;
finally
deflateEnd(strm);
end;
end;
PDF FlateDecode Parameters
TPDFFlateParms Structure
- Predictor: Predictor function (1=no prediction, 2=TIFF, 10-15=PNG)
- Colors: Number of color components
- BitsPerComponent: Bits per color component
- Columns: Number of samples per row
- ExpandedTo8Bit: Whether to expand to 8-bit components
- ColorSpace: Color space identifier
Enhanced Features
- Memory Management: Optimized memory allocation and deallocation
- Error Handling: Comprehensive error checking and reporting
- Debug Support: Optional debug output for troubleshooting
- Performance Optimization: Highly optimized compression algorithms
- Integração de fluxos: integração transparente com classes de fluxo Delphi
Performance Benefits
- Fast compression and decompression speeds
- Excellent compression ratios for text and simple graphics
- Low memory footprint during processing
- Optimized for PDF content streams
- Minimal CPU overhead
Standards Compliance
- RFC 1950 (ZLib format specification)
- RFC 1951 (Deflate compression algorithm)
- PDF FlateDecode filter specification
- PNG predictor algorithm support
- TIFF predictor algorithm support
Error Codes and Handling
- Z_OK (0): Success
- Z_STREAM_END (1): End of stream reached
- Z_NEED_DICT (2): Dictionary required
- Z_ERRNO (-1): File error
- Z_STREAM_ERROR (-2): Stream state error
- Z_DATA_ERROR (-3): Data integrity error
- Z_MEM_ERROR (-4): Memory allocation error
- Z_BUF_ERROR (-5): Buffer size error
Ver também
|