ScaleImageToShapeSize

HtmlSaveOptions.ScaleImageToShapeSize property

Especifica si Aspose.Words escala las imágenes al tamaño de la forma delimitadora al exportar a HTML, MHTML o EPUB. El valor predeterminado esverdadero .

public bool ScaleImageToShapeSize { get; set; }

Observaciones

Una imagen en un documento de Microsoft Word es una forma. La forma tiene un tamaño y la imagen tiene su propio tamaño. Los tamaños no están directamente relacionados. Por ejemplo, la imagen puede tener 1024x786 píxeles, pero la forma que muestra esta imagen puede tener 400x300 puntos.

Para mostrar una imagen en el navegador, se debe escalar al tamaño de la forma. ElScaleImageToShapeSize La propiedad controla dónde se realiza la escala de image : en Aspose.Words durante la exportación a HTML o en el navegador al mostrar el documento.

CuandoScaleImageToShapeSize esverdadero , Aspose.Words escala la imagen utilizando un escalado de alta calidad durante la exportación a HTML. CuandoScaleImageToShapeSize esFALSO, la imagen se genera con su tamaño original y el navegador tiene que escalarla.

En general, los navegadores realizan un escalado rápido y de mala calidad. Como resultado, normalmente obtendrá una mejor calidad de visualización en el navegador y un tamaño de archivo más pequeño cuandoScaleImageToShapeSize esverdadero , pero mejor calidad de impresión y conversión más rápida cuandoScaleImageToShapeSize esFALSO.

Además de las formas que contienen imágenes rasterizadas individuales, esta opción también afecta a las formas grupales que consisten de imágenes rasterizadas. SiScaleImageToShapeSize esFALSO y una forma de grupo contiene imágenes rasterizadas cuya resolución intrínseca es mayor que el valor especificado enImageResolution, Aspose.Words aumentará la resolución de renderizado para ese grupo. Esto permite preservar mejor la calidad de las imágenes agrupadas de alta resolución al guardarlas en HTML.

Ejemplos

Muestra cómo deshabilitar la escala de imágenes a sus dimensiones de forma principal al guardarlas en .html.

Document doc = new Document();
            DocumentBuilder builder = new DocumentBuilder(doc);

            // Inserta una forma que contenga una imagen y luego haz esa forma considerablemente más pequeña que la imagen.
#if NET48 || JAVA
            Image image = Image.FromFile(ImageDir + "Transparent background logo.png");

            Assert.AreEqual(400, image.Size.Width);
            Assert.AreEqual(400, image.Size.Height);
#elif NET5_0_OR_GREATER
            SKBitmap image = SKBitmap.Decode(ImageDir + "Transparent background logo.png");

            Assert.AreEqual(400, image.Width);
            Assert.AreEqual(400, image.Height);
#endif

            Shape imageShape = builder.InsertImage(image);
            imageShape.Width = 50;
            imageShape.Height = 50;

            // Guardar un documento que contiene formas con imágenes en HTML creará un archivo de imagen en el sistema de archivos local
            // para cada una de esas formas. El documento HTML de salida utilizará <image> etiquetas para vincular y mostrar estas imágenes.
            // Cuando guardamos el documento en HTML, podemos pasar un objeto SaveOptions para determinar
            // si escalar todas las imágenes que están dentro de las formas al tamaño de sus formas.
            // Establecer el indicador "ScaleImageToShapeSize" en "true" reducirá cada imagen
            // al tamaño de la forma que lo contiene, de modo que ninguna imagen guardada sea más grande de lo que el documento requiere.
            // Establecer el indicador "ScaleImageToShapeSize" en "falso" preservará los tamaños originales de estas imágenes,
            // que ocupará más espacio a cambio de preservar la calidad de la imagen.
            HtmlSaveOptions options = new HtmlSaveOptions { ScaleImageToShapeSize = scaleImageToShapeSize };

            doc.Save(ArtifactsDir + "HtmlSaveOptions.ScaleImageToShapeSize.html", options);

            FileInfo fileInfo = new FileInfo(ArtifactsDir + "HtmlSaveOptions.ScaleImageToShapeSize.001.png");

#if NET48 || JAVA
        if (scaleImageToShapeSize)
            Assert.That(3000, Is.AtLeast(fileInfo.Length));
        else
            Assert.That(20000, Is.LessThan(fileInfo.Length));
#elif NET5_0_OR_GREATER
        if (scaleImageToShapeSize)
            Assert.That(10000, Is.AtLeast(fileInfo.Length));
        else
            Assert.That(30000, Is.LessThan(fileInfo.Length));
#endif

Ver también

HtmlSaveOptions.SaveFormat HtmlSaveOptions.TableWidthOutputMode