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
- property ImageResolution
- class HtmlSaveOptions
- espacio de nombres Aspose.Words.Saving
- asamblea Aspose.Words