How to Linearize PDFs

Un PDF linearizado, también conocido como "Vista Web Rápida" o "PDF optimizado para la web", se reorganiza estructuralmente para la transmisión por internet. Esto permite que un visor compatible muestre la primera página de un documento casi al instante, mucho antes de que haya terminado de descargarse el archivo completo.

En aplicaciones críticas para la misión o sensibles al tiempo, esta función es especialmente útil. Elimina los tiempos de carga frustrantes para documentos grandes, especialmente en redes lentas o móviles, permitiendo a los usuarios interactuar con el contenido de inmediato. Esto facilita la toma de decisiones más rápida y mejora la productividad en entornos profesionales.

En este artículo instructivo, exploraremos las opciones que IronPDF ofrece a los desarrolladores para exportar sus documentos como PDFs linearizados.

Inicio rápido: Lineariza tu PDF para una visualización web más rápida

Comienza con IronPDF para linearizar tus PDFs sin esfuerzo. Este ejemplo de código simple muestra cómo optimizar un PDF para una carga más rápida en navegadores web usando el método LinearizePdf de IronPDF. Mejora la experiencia del usuario permitiendo que las páginas se muestren mientras se cargan, en lugar de esperar a que se descargue todo el documento. Sigue los pasos a continuación para optimizar tus PDFs y hacerlos más eficientes para compartir en línea.

Guardar como PDF linealizado

Guardar un documento como un PDF linearizado con IronPDF es un proceso rápido y sencillo. En este ejemplo, renderizaremos una cadena HTML a un PDF utilizando RenderHtmlAsPdf. Después, guardaremos el objeto PdfDocument como un PDF linearizado usando el método de instancia SaveAsLinearized. Este método toma un argumento de cadena para la ruta del archivo de salida.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

class="content-img-align-center">

style="width=50%">

Guardar como PDF linealizado bytes

Además de guardar un objeto PdfDocument directamente, IronPDF también permite a los usuarios convertir un arreglo de bytes de PDF en un PDF linearizado. En este ejemplo, demostraremos la renderización de una cadena HTML en un objeto PdfDocument, obteniendo su arreglo de bytes y luego guardando esos datos como un PDF linearizado. Este método SaveAsLinearized también acepta un tercer parámetro de cadena opcional para una contraseña si el documento de origen está encriptado.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-bytes.cs

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

Este es el archivo que produjo el código:

Guardar como PDF linealizado MemoryStream

El método SaveAsLinearized también puede aceptar objetos Stream como entrada. En este ejemplo, convertiremos un objeto PdfDocument en un arreglo de bytes, lo escribiremos en un MemoryStream y luego guardaremos el flujo como un PDF linearizado para demostrar esta capacidad.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-stream.cs

using IronPdf;
using System.IO;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Transform PDF bytes to a MemoryStream
MemoryStream memoryStream = new MemoryStream(pdfBytes);

// Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Este es el archivo que produjo el código:

---

Verificar si un PDF está linealizado

Además de revisar las propiedades del documento en un visor PDF, como Adobe Acrobat, para ver si un PDF está linearizado, IronPDF también proporciona una forma de verificar esto programáticamente con el método IsLinearized. El método toma un parámetro de cadena para la ruta del archivo y un segundo parámetro de cadena opcional para la contraseña si el PDF está encriptado.

En este ejemplo, utilizaremos los archivos de salida de los tres ejemplos anteriores para probar si están linearizados e incluiremos un cuarto PDF no linearizado para mostrar el comportamiento del método.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-test.cs

using IronPdf;
using System;

// First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"));

// Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"));

// Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"));

// Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"));

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

class="content-img-align-center">

style="width=50%">

Como puedes ver, los tres primeros ejemplos devuelven true, mientras que el último PDF, que no está linealizado, devuelve false.

Por favor notaNo hay ningún método para verificar si un objeto PdfDocument en sí está linearizado. Esto se debe a que cuando un archivo PDF se abre y se carga en un objeto, su estructura especial linearizada se pierde. Por la misma razón, no hay ningún método para devolver un PDF linearizado como un arreglo de bytes. Esta característica linearizada solo existe como un archivo guardado en disco.