Redimensionar documento PDF

Puedes cambiar el tamaño del documento escalando automáticamente el contenido en sus páginas. Puedes escalar todo el documento o páginas específicas. Hay tres métodos disponibles:

bool PdfFileEditor.ResizeContents(string source, string destination, int[] pages, ContentsResizeParameters parameters)
void PdfFileEditor.ResizeContents(Document source, int[] pages, ContentsResizeParameters parameters)
void PdfFileEditor.ResizeContents(Document source, ContentsResizeParameters parameters)

Descripción de la Clase de Opciones

Los parámetros de redimensionamiento se definen mediante la clase de opciones — PdfFileEditor.ContentsResizeParameters.

Propósito

Configurar márgenes alrededor del contenido, dimensiones del contenido objetivo y dimensiones de la página.
Soporte para unidades absolutas y porcentajes.
Ajustar opcionalmente el MediaBox para que coincida con el CropBox durante el redimensionamiento.

Entidades Principales

ContentsResizeParameters

Un contenedor de parámetros.

Propiedades:
- ChangeMediaBox: cuando está habilitado, el MediaBox se ajusta al CropBox actual durante el redimensionamiento.
- LeftMargin, RightMargin, TopMargin, BottomMargin: márgenes alrededor del contenido (absoluto o porcentaje).
- ContentsWidth, ContentsHeight: tamaño del área de contenido objetivo (absoluto o porcentaje).
Métodos de configuración estática (crear un nuevo objeto ContentsResizeParameters):
- Margins(left, right, top, bottom): márgenes en unidades absolutas de página.
- MarginsPercent(left, right, top, bottom): márgenes en porcentajes.
- ContentSize(width, height): tamaño del contenido objetivo en unidades absolutas.
- ContentSizePercent(width, height): tamaño del contenido objetivo en porcentajes.
- PageResize(width, height): cambiar el tamaño de la página en unidades absolutas.
- PageResizePct(widthPct, heightPct): cambiar el tamaño de la página en porcentajes.

Puedes crear un objeto ContentsResizeParameters utilizando cualquiera de los métodos estáticos anteriores y luego ajustar adicionalmente sus campos.

ContentsResizeValue

Un contenedor universal para un parámetro numérico.

Tipos de valor:
- Absoluto (Units)
- Porcentaje (Percents)
- Automático (Auto)
Campos/flags clave:
- Value: el valor numérico.
- IsPercent: indica la interpretación porcentual; si false — valor absoluto.
Métodos de fábrica:
- Units(value): crear un valor absoluto.
- Percents(value): crear un valor porcentual.
- Auto(): marcar el valor para cálculo automático.

Recomendaciones de Uso

Cuando los márgenes alrededor del contenido son importantes — usa Margins o MarginsPercent.
Cuando necesitas que el contenido coincida con dimensiones específicas — usa ContentSize o ContentSizePercent.
Cuando necesitas cambiar el tamaño de la página en sí — usa PageResize o PageResizePct.
Puedes combinar valores absolutos y porcentuales.
Habilita ChangeMediaBox si necesitas alinear la geometría de la página: el MediaBox se establecerá en el CropBox actual.
Marca los parámetros como Auto cuando quieras delegar el cálculo al algoritmo.

Ejemplos

Ejemplo de redimensionar una página

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizePage(Document document, int pageNumber, double targetWidth, double targetHeight, double width, double height)
{
    double marginWidth = (targetWidth - width) / 2;
    double marginHeight = (targetHeight - height) / 2;
   
    // Set the parameters
    var param =
        Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResize(width, height);
    param.TopMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.BottomMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.LeftMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.RightMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.ChangeMediaBox = true;
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, new int[] { pageNumber }, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizePage(Document document, int pageNumber, double targetWidth, double targetHeight, double width, double height)
{
    double marginWidth = (targetWidth - width) / 2;
    double marginHeight = (targetHeight - height) / 2;
   
    // Set the parameters
    var param =
        Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResize(width, height);
    param.TopMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.BottomMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.LeftMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.RightMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.ChangeMediaBox = true;
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, new int[] { pageNumber }, param);
}

Aumentar los márgenes de la página en un 10% en todos los lados:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddMargin(Document document)
{ 
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.MarginsPercent(10, 10, 10, 10);
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddMargin(Document document)
{ 
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.MarginsPercent(10, 10, 10, 10);
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

Establecer el tamaño del contenido a 500 x 700 en unidades de página y dejar los márgenes como automáticos:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeAndAutoMargin(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.ContentSize(500, 700);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeAndAutoMargin(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.ContentSize(500, 700);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

Escalar la página en un 120% de ancho y un 110% de altura:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeInPercents(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResizePct(120, 110);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeInPercents(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResizePct(120, 110);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

Notas

Los porcentajes se interpretan en relación con el tamaño original correspondiente.
Los valores absolutos se especifican en unidades de página (por ejemplo, puntos).
Cuando los márgenes y el tamaño del contenido objetivo se establecen juntos, los valores finales se calculan considerando todas las restricciones; los parámetros no especificados pueden ser calculados automáticamente.

Hacer NUp de archivos PDF