큰 PDF에서 단위로 헤더와 푸터 추가
매우 큰 PDF에 한 번에 헤더와 푸터를 추가하는 것은 느릴 수 있습니다. 문서를 고정 크기의 페이지 단위로 처리한 후 결과를 병합하면 페이지 번호를 문서 전체에 걸쳐 계속 유지하면서 렌더링 시간을 줄일 수 있습니다.
해결책
1. 페이지 인덱스를 배치로 나누기
단위 크기를 선택하고 문서의 페이지 인덱스를 고정 크기의 배치로 그룹화합니다 (아래는 300페이지씩). 이것이 각 렌더링 패스가 처리해야 하는 페이지 수를 결정합니다.
2. 각 배치를 별도의 문서로 복사하기
CopyPages 을 사용하여 현재 배치의 페이지를 추출하면 각 단위가 독립적인 PdfDocument 이 됩니다.
3. 연속 번호로 헤더와 푸터 추가
FirstPageNumber 을 단위의 시작 페이지로 설정합니다. 그렇게 하면 페이지 번호가 각 단위에서 1로 다시 시작하지 않고 문서 전체에 걸쳐 유지됩니다.
4. 각 청크 저장 및 삭제
각 단위를 임시 파일로 작성하여 삭제합니다. 다음 배치 전에 단위를 해제하면 메모리를 적절히 유지할 수 있습니다.
5. 단위를 병합하여 최종 PDF 저장
임시 파일을 다시 열고, AppendPdf 을 사용하여 순서대로 추가한 후, 결과를 저장하고 임시 파일을 삭제합니다.
using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
string headerHtml = "<div style='font-size:10px;'>Header</div>";
string footerHtml = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>";
int chunkSize = 300;
var pageChunks = Enumerable.Range(0, pdf.PageCount)
.GroupBy(i => i / chunkSize)
.Select(g => g.ToArray())
.ToList();
var tempFiles = new List<string>();
foreach (var indexes in pageChunks)
{
var chunkPdf = pdf.CopyPages(indexes);
int globalStartPage = indexes.First() + 1;
chunkPdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
FirstPageNumber = globalStartPage, // keeps numbering continuous
HtmlHeader = new HtmlHeaderFooter { HtmlFragment = headerHtml, MaxHeight = 40 },
HtmlFooter = new HtmlHeaderFooter { HtmlFragment = footerHtml, MaxHeight = 40 }
});
string tempFile = Path.GetTempFileName() + ".pdf";
chunkPdf.SaveAs(tempFile);
chunkPdf.Dispose();
tempFiles.Add(tempFile);
}
// Merge the chunks back into one document.
var finalPdf = new PdfDocument(tempFiles.First());
foreach (var file in tempFiles.Skip(1))
{
using var part = new PdfDocument(file);
finalPdf.AppendPdf(part);
}
finalPdf.SaveAs("output.pdf");
finalPdf.Dispose();
// Clean up temp files.
foreach (var file in tempFiles)
File.Delete(file);Imports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextImports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextglobalStartPage 는 각 배치의 첫 번째 인덱스에서 유도되므로, FirstPageNumber 는 이전 단위가 끝난 지점에서 정확히 이어집니다.
참고 사항 및 제한 사항
- 연속 번호:
FirstPageNumber는 페이지 번호를 단위 간에 유지하는 역할을 합니다. 없으면 각 단위에서 페이지 1로 다시 시작됩니다. - 단위 크기는 조정 가능: 300은 시작점입니다; 단위화를 시작해서 효과를 발휘하는 크기는 작업량에 따라 다릅니다.
- 병합은 하나의 패스를 추가: 총 시간은 단위당 렌더링 시간에 최종 병합 시간을 합한 것입니다.
- 매우 큰 작업: 병합 중 주기적으로 가비지 수집을 강제하고, 브라우저 풀(
BrowserPool.MaxIdleTabs,MaxDynamicHFPagesPerBatch)을 조정하여 메모리를 적절히 유지할 수 있습니다.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.