Ни fax gateway, ни архивный pipeline, который хранит миллион счетов со сканоподобным видом, ни OCR front-end, который порогово переводит все в черно-белое еще до распознавания символов, не хотят ваш 24-битный render страницы. Всем троим нужно одно и то же: чистый 1-битный bitmap, один bit на пиксель, где каждая точка - либо чернила, либо бумага. Дайте им полноцветный BMP, и они все равно выбросят 23 бита на пиксель, как правило, с худшим dithering pass, чем вы могли бы сделать сами. Интересный вопрос здесь в том, где именно должно происходить это down-conversion, и ответ у PDF Library for Delphi говорит кое-что полезное о том, как расширять renderer, который вы совершенно не хотите переписывать
PDF Library for Delphi - нативная Object Pascal PDF-библиотека для Delphi и C++Builder. Ее rendering core растеризует страницу в bitmap и умеет выдавать BMP, PNG, JPEG, WMF и еще несколько форматов. Выдача настоящего monochrome bitmap и рендер только части страницы доступны начиная с v3.83.0, и оба режима построены как тонкие convenience layer поверх существующего renderer, а не как изменение самого rasterizer. Именно это ограничение и является всей историей
Почему down-convert нужно после rendering, а не внутри renderer
Очевидный способ получить 1-битное изображение - заставить rasterizer рисовать сразу в 1-bit. И это же самый короткий путь все сломать. Внутренний bitmap renderer создается с жестко заданным PixelFormat := pf24bit в конструкторе PDFlibRenderer , и эта 24-битная поверхность используется всеми render path: PNG export, preview через device context, JPEG output, всем подряд. Переключите ее на pf1bit в источнике, и вы не добавите monochrome feature, а ухудшите fidelity цвета для каждого вызывающего кода в библиотеке и подпишетесь под отладкой целого ряда downstream regression
Поэтому RenderPageToMonochromeFile идет от обратного. Сначала он рендерит страницу нормально, во временный 24-bit BMP, и только потом схлопывает его в 1-bit как post-processing step. Сам renderer не трогается. Весь monochrome behavior живет внутри convenience method, а значит, никак не затрагивает тех, кто его не вызывает. Такой компромисс стоит назвать прямо: post-process стоит одного дополнительного выделения bitmap и temp file, а взамен держит несущую core-часть полностью вне области риска. Для функции, которая нужна fax и archival edge case, это правильная сторона баланса
var
Pdf: TPDFlib;
begin
Pdf := TPDFlib.Create;
try
Pdf.LoadFromFile('invoice.pdf');
// 200 DPI — классическое разрешение факса Group 4; индекс страницы отсчитывается с единицы
Pdf.RenderPageToMonochromeFile(200, 1, 'invoice-page1.bmp');
finally
Pdf.Free;
end;
end;
Как именно происходит схлопывание в 1-bit
Down-conversion опирается на GDI, а не на самописный threshold loop, и этот выбор важен для качества output. Внутри метода временный 24-битный bitmap загружается в TBitmap , затем создается второй TBitmap с PixelFormat := pf1bit и теми же размерами, а пиксели переносятся одним blit:
// внутри RenderPageToMonochromeFile, после загрузки 24-битного ColorBmp
MonoBmp.PixelFormat := pf1bit;
MonoBmp.Width := ColorBmp.Width;
MonoBmp.Height := ColorBmp.Height;
// HALFTONE указывает GDI применить дизеринг при переводе 24-битного источника в 1-bit
SetStretchBltMode(MonoBmp.Canvas.Handle, HALFTONE);
StretchBlt(MonoBmp.Canvas.Handle, 0, 0, MonoBmp.Width, MonoBmp.Height,
ColorBmp.Canvas.Handle, 0, 0, ColorBmp.Width, ColorBmp.Height, SRCCOPY);
MonoBmp.SaveToFile('out.bmp');
Фокус тут в SetStretchBltMode с HALFTONE . Несмотря на то что source и destination одинакового размера и масштабирования как будто не происходит, режим stretch все равно определяет, как GDI отображает цвета в 1-bit palette. HALFTONE заставляет его применять halftone dithering, превращая серые области и сглаженные кромки текста в узоры из черных и белых точек, а не в жесткую обрезку к ближайшему из двух цветов. Если убрать этот вызов или оставить default BLACKONWHITE , содержимое в градациях серого постеризуется в грубые пороговые формы. Для scanned-document и OCR-preprocessing output dithering почти всегда дает именно тот результат, который нужен
Одна деталь здесь абсолютно не обсуждается: временный render обязан быть BMP. RenderPageToMonochromeFile вызывает общий renderer с options code 0 , а это BMP. Аргумент options у RenderPageToFile - это небольшой integer enum, и значения в нем не взаимозаменяемы: 0 - BMP, 1 JPEG, 2 WMF, 3 EMF, 5 PNG и так далее. Затем down-converter делает TBitmap.LoadFromStream на temp file. Если вместо BMP подать WMF, передав 2 , загрузка рухнет с "Bitmap image is not valid" , потому что Windows Metafile - это vector record stream, а не DIB. Monochrome down-conversion является raster operation от начала до конца, поэтому промежуточный формат тоже обязан быть raster
Рендер только подрегиона страницы
Второй метод, RenderPageRegionToFile , рендерит не всю страницу, а только ее прямоугольный фрагмент. Сценарии здесь легко узнать каждому, кто когда-либо делал document viewer: вырезать блок с подписью из договора, сгенерировать tile для увеличенной карты большого чертежа или вытащить один штампованный регион в thumbnail, не оплачивая rasterize всей страницы на высоком DPI. Сигнатура здесь вполне прямолинейна:
// Clip — это "Left,Top,Width,Height" в PDF-пунктах (72 pt = 1 дюйм)
// Здесь: прямоугольник 2.5 x 1 дюйм, на дюйм от верхнего левого угла страницы
Pdf.RenderPageRegionToFile(150, 1, '72,72,180,72', 'sig-block.bmp');
Строка clip представляет собой четыре double в PDF points, разделенные запятыми, и вручную парсится внутри метода, чтобы обойти locale и quirks DelimitedText . По width и height метод вычисляет размер выходного bitmap как Round(Width * DPI / 72) на Round(Height * DPI / 72) , выделяет in-memory bitmap pf24bit ровно такого размера и рендерит в его device context через RenderPageToDCClip . В результирующий файл попадает только clipped rectangle, и его размер соответствует именно региону, а не всей странице
Как rectangle Clip добирается до device context
Путь региона опирается на RenderPageToDCClip и его параметр Clip, который вызов передает вниз в TPDFPageTree.RenderPageToDC. Ловушка слоистого API вроде этого — параметр, который принимают наверху и роняют где-то по дороге вниз: вызывающий передает какой угодно rectangle и молча получает назад целую страницу, а в зависимости от layout никто этого не замечает
RenderPageToDC парсит тот же rectangle "Left,Top,Width,Height" в points и применяет его как реальную GDI clip region к target device context перед тем, как renderer начнет рисовать. Преобразование из points в device pixels идет по обычному scale factor DPI / 72 и применяется ко всем четырем краям. Последовательность вокруг render — стандартный танец save/clip/restore:
// внутри TPDFPageTree.RenderPageToDC, когда Clip не пуст
ScaleFactor := DPI / 72;
SaveDC(TargetDC);
IntersectClipRect(TargetDC,
Round(ClipLeft * ScaleFactor),
Round(ClipTop * ScaleFactor),
Round((ClipLeft + ClipWidth) * ScaleFactor),
Round((ClipTop + ClipHeight) * ScaleFactor));
// ... здесь renderer рисует страницу ...
// в блоке finally:
RestoreDC(TargetDC, -1);
Пара SaveDC / RestoreDC(-1) и делает вызов безопасным при многократном использовании: clip region кладется в стек состояния DC, затем страница рисуется, а исходный clip возвращается независимо от того, как именно завершился render. RestoreDC(TargetDC, -1) восстанавливает последнее сохраненное состояние, и это стандартная idiom для balanced save/restore. Пропустите restore, и вызывающий код, который использует тот же DC для следующего full-page render, внезапно обнаружит, что он mysteriously clipped к последнему региону. RenderPageRegionToFile получает то же поведение бесплатно, потому что идет ровно через тот же path
Один behavioral момент важно усвоить: clip обрезает , а не масштабирует . Страница по-прежнему растеризуется при запрошенном DPI и в своем обычном положении, а clip region просто выбрасывает все, что лежит вне rectangle. Вы не растягиваете регион так, чтобы он заполнил output; вы вырезаете окно из full-resolution render. Если нужен увеличенный регион, поднимайте DPI. Координаты rectangle интерпретируются в device space после scaling из points в pixels и измеряются от верхнего левого угла render surface, поэтому планируйте Left и Top сверху страницы вниз. Более глубокий разбор того, как PDF Library for Delphi управляет device context при on-screen output, есть в сопутствующем материале о print preview and device-context output , который проходит по той же DC plumbing уже со стороны display
Формат вывода: несжатый 1-bit BMP
RenderPageToMonochromeFile производит несжатый pf1bit BMP: правильный pixel format, уже dithered и готовый. Большинство fax, archival или OCR toolchain спокойно его проглотят либо сами преобразуют его в CCITT Group 4 TIFF еще одним downstream step, поэтому если ваш fax workflow или TIFF archive ожидает G4, планируйте стадию compression в собственном pipeline
Оба метода намеренно маленькие, и это и есть главный design lesson со всей страницы: convenience API, сидящий поверх renderer, может добавить реальную возможность, monochrome output и region crop, не лезя внутрь rasterizer и не дестабилизируя всех остальных caller. А если вам нужно выбирать между несколькими rendering engine под самим rasterization, подробный обзор multi-engine PDF rendering in Delphi разбирает все компромиссы подробно. Чтобы увидеть полный rendering surface и остальной API, смотрите PDF Library for Delphi Delphi PDF Library - на странице продукта собрана полная картина