Convertir Onenote a imagen en Java

Thu, 03 Sep 2026 19:34:37 +0000

Programáticamente convertir páginas de OneNote en archivos de imagen es una necesidad común al crear generadores de vistas previas o visores móviles. El SDK de Conholdate.Total for Java facilita la conversión de OneNote a imagen en Java sin requerir Microsoft Office en el servidor. En esta guía verá una implementación completa, segura para subprocesos, opciones de salida para PNG y JPEG, y consejos para el procesamiento en memoria.

Convertir Onenote a Imagen en Java - Guía Paso a Paso

Inicializar el flujo de trabajo de conversión: Cargue el archivo OneNote en un InputStream y cree una instancia de Converter, el núcleo del proceso de conversión de OneNote a imagen en Java.
```
InputStream fileStream = new BufferedInputStream(new FileInputStream("sample.one"));
Converter converter = new Converter(fileStream);
```
Determine cuántas páginas necesitan conversión: Recupere el recuento total de páginas del Converter.
```
int pageCount = converter.getPageCount();
```
Configurar opciones de imagen para cada página: Establezca el formato de salida, la calidad y el índice de página basado en cero usando ImageConvertOptions.

ImageConvertOptions options = new ImageConvertOptions();
options.setFormat(ImageSaveOptions.ImageFormat.PNG);
options.setQuality(90);
options.setPageNumber(pageIndex);

Convertir páginas en paralelo: Utilice un ExecutorService para ejecutar conversiones concurrentemente, escribiendo cada página en un archivo PNG separado.

ExecutorService executor = Executors.newFixedThreadPool(
        Runtime.getRuntime().availableProcessors());
executor.submit(() -> {
    // conversion logic per page
});

Conversión opcional en memoria: Para escenarios en los que necesite los bytes de la imagen directamente (p. ej., enviándolos a través de una red), convierta la primera página a un ByteArrayOutputStream.

ImageConvertOptions memOptions = new ImageConvertOptions();
memOptions.setFormat(ImageSaveOptions.ImageFormat.JPEG);
memOptions.setPageNumber(0);
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();
converter.convert(memoryStream, memOptions);

Para obtener más detalles sobre la clase Converter y sus métodos, consulte la referencia oficial de la API.

Ejemplo completo de funcionamiento para convertir OneNote a imagen en Java - Procesamiento paralelo de páginas

El siguiente código muestra una implementación completa de cómo convertir Onenote a imagen en Java usando Conholdate.Total.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageSaveOptions;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

public class ConvertOneNoteToImage {
    public static void main(String[] args) {
        String inputPath = "sample.one";
        String outputPattern = "output_page_%d.png";
        int imageQuality = 90; // 0-100

// Thread pool for parallel page conversion
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());

try (InputStream fileStream = new BufferedInputStream(new FileInputStream(inputPath));
             Converter converter = new Converter(fileStream)) {

int pageCount = converter.getPageCount();

for (int i = 0; i < pageCount; i++) {
                final int pageIndex = i;
                executor.submit(() -> {
                    ImageConvertOptions options = new ImageConvertOptions();
                    options.setFormat(ImageSaveOptions.ImageFormat.PNG);
                    options.setQuality(imageQuality);
                    options.setPageNumber(pageIndex); // zero‑based page index

String outputPath = String.format(outputPattern, pageIndex + 1);
                    try (OutputStream outStream = new BufferedOutputStream(new FileOutputStream(outputPath))) {
                        converter.convert(outStream, options);
                        System.out.println("Page " + (pageIndex + 1) + " saved to " + outputPath);
                    } catch (Exception e) {
                        System.err.println("Failed to convert page " + (pageIndex + 1) + ": " + e.getMessage());
                    }
                });
            }

// Example of in‑memory conversion for the first page
            ImageConvertOptions memOptions = new ImageConvertOptions();
            memOptions.setFormat(ImageSaveOptions.ImageFormat.JPEG);
            memOptions.setQuality(imageQuality);
            memOptions.setPageNumber(0);
            try (ByteArrayOutputStream memoryStream = new ByteArrayOutputStream()) {
                converter.convert(memoryStream, memOptions);
                byte[] imageBytes = memoryStream.toByteArray();
                System.out.println("In‑memory conversion produced " + imageBytes.length + " bytes for page 1.");
                // imageBytes can now be sent over network, stored in DB, etc.
            } catch (Exception e) {
                System.err.println("In‑memory conversion error: " + e.getMessage());
            }

} catch (IOException e) {
            System.err.println("File access error: " + e.getMessage());
        } catch (Exception e) {
            System.err.println("Conversion initialization error: " + e.getMessage());
        } finally {
            executor.shutdown();
            try {
                if (!executor.awaitTermination(60, TimeUnit.SECONDS)) {
                    executor.shutdownNow();
                }
            } catch (InterruptedException ie) {
                executor.shutdownNow();
                Thread.currentThread().interrupt();
            }
        }
    }
}

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de archivo (sample.one, output_page_%d.png, etc.) para que coincidan con sus ubicaciones reales, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Instalación y Configuración Conholdate.Total for Java

Agregue el repositorio Maven de Conholdate y la dependencia del SDK a su pom.xml:


    
        conholdate-repo
        Conholdate Maven Repository
        https://repository.conholdate.com/repo/
    



    com.conholdate
    conholdate-total
    24.9
    pom

Descargue el paquete binario más reciente desde la página de descarga. El SDK requiere Java 8 o superior y se ejecuta en cualquier JVM estándar. Para uso en producción, obtenga una licencia en la página de precios y actívela con una clave temporal en la página de licencia temporal.

Conclusión

Al seguir esta guía ahora tienes una base sólida para convertir OneNote a imagen en Java usando Conholdate.Total for Java. El ejemplo muestra una salida PNG página por página, procesamiento paralelo para mayor velocidad y una opción en memoria para una integración flexible. Recuerda configurar ImageConvertOptions para que coincida con el formato y la calidad de imagen que necesitas, y manejar los recursos con bloques try‑with‑resources como se muestra. Para proyectos comerciales, adquiere una licencia adecuada a través de la página de precios y prueba la conversión con archivos OneNote reales para asegurarte de que todo el contenido se renderiza correctamente. La amplia API y documentación del SDK hacen que sea sencillo ampliar esta solución a procesamiento por lotes o servicios basados en la nube.

Preguntas frecuentes

¿Puedo convertir Onenote a imagen en Java sin instalar Microsoft Office?
Sí. El SDK Conholdate.Total realiza todo el renderizado internamente, por lo que no se necesita instalar Microsoft Office en el servidor.
¿Qué formatos de imagen admite la conversión?
Puede exportar a PNG, JPEG, BMP, GIF, y TIFF estableciendo la propiedad ImageSaveOptions.ImageFormat.
¿Cómo mejorar el rendimiento para cuadernos grandes?
Utilice el pool de subprocesos incorporado como se muestra y prefiera la conversión en memoria cuando solo necesite los bytes de la imagen, evitando I/O de disco.
¿Dónde puedo encontrar más ejemplos y detalles de la API?
La documentación oficial proporciona guías extensas, y la referencia de la API enumera todas las clases y métodos.

note file conversion on Conholdate Blog

Convertir Onenote a imagen en Java