WmfImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.VectorImage, com.aspose.imaging.fileformats.emf.MetaImage

public class WmfImage extends MetaImage

使用我们的 API 操作 Microsoft Windows Metafile (WMF) 图像，能够无缝处理存储在可变长度记录中的矢量和位图数据。轻松调整图像大小、旋转和翻转，同时设置自定义图像调色板。将 WMF 文件转换为压缩的 WMZ 格式，或保存为栅格图像格式，以实现跨平台和应用的多用途使用。

构造函数

构造函数	描述
WmfImage()	创建 WmfImage 类的新实例，为进一步操作和处理 Windows Metafile (WMF) 图像数据进行初始化。
WmfImage(int width, int height)	实例化 WmfImage 类的新对象，可自定义宽度和高度参数，以便创建符合特定尺寸的空白 WMF 图像。

方法

方法	描述
isCached()	检索一个布尔值，指示对象的数据当前是否已缓存，从而消除额外读取数据的操作需求。
getBitsPerPixel()	检索图像的每像素位数，表示颜色深度或细粒度的水平。
getWidthF()	获取图像的宽度，表示水平轴上的像素数量。
getHeightF()	获取图像的高度，表示垂直轴上的像素数量。
getInch()	访问或修改 inch 属性，该属性表示通常用于在打印或显示环境中指定物理尺寸的度量单位。
setInch(int value)	访问或修改 inch 属性，该属性表示通常用于在打印或显示环境中指定物理尺寸的度量单位。
getFileFormat()	获取与图像关联的文件格式值，提供图像存储格式的信息。
getFrameBounds()	获取帧的边界，指示其在图像中的位置和尺寸。
cacheData()	高效缓存数据，消除从底层 DataStreamSupporter.DataStreamContainer(DataStreamSupporter.getDataStreamContainer) 进行额外加载的需求。
setPalette(IColorPalette palette, boolean updateColors)	将指定的调色板应用于图像，以实现颜色表示的自定义。
getUsedFonts()	检索元文件中使用的字体列表，提供对图像中所用字体资源的洞察。
resizeCanvas(Rectangle newRectangle)	调整图像的画布大小，在保持图像内容的同时修改其尺寸。
addRecord(WmfObject record)	将指定的记录对象合并到图像中，使用额外的数据或元数据丰富其内容。
getPostScript()	访问与图像关联的 PostScript 数据，提供有关其结构或内容的详细信息。
getOriginalOptions()	获取原始图像选项。

Example: This example shows how to load a WMF image from a file and convert it to SVG using WmfRasterizationOptions.

String dir = "c:\\temp\\";

// 使用 Aspose.Imaging.Image.Load 是加载包括 WMF 在内的所有类型图像的统一方式。
try (com.aspose.imaging.fileformats.wmf.WmfImage wmfImage = (com.aspose.imaging.fileformats.wmf.WmfImage)com.aspose.imaging.Image.load(dir + "test.wmf"))
{
    com.aspose.imaging.imageoptions.SvgOptions saveOptions = new com.aspose.imaging.imageoptions.SvgOptions();
                    
    // 文本将被转换为形状。
    saveOptions.setTextAsShapes(true);

    com.aspose.imaging.imageoptions.WmfRasterizationOptions rasterizationOptions = new com.aspose.imaging.imageoptions.WmfRasterizationOptions();

    // 绘图表面的背景颜色。
    rasterizationOptions.setBackgroundColor(com.aspose.imaging.Color.getWhiteSmoke());

    // 页面尺寸。
    rasterizationOptions.setPageSize(Size.to_SizeF(wmfImage.getSize()));

    // 如果存在嵌入的 emf，则渲染 emf；否则渲染 wmf。
    rasterizationOptions.setRenderMode(com.aspose.imaging.fileformats.wmf.WmfRenderMode.Auto);

    saveOptions.setVectorRasterizationOptions(rasterizationOptions);

    wmfImage.save(dir + "test.output.svg", saveOptions);
}

Example: The following example shows how to convert a compressed images (*.

以下示例展示了如何将压缩图像（.emz、.wmz、*.svgz）转换为光栅格式

String[] files = new String[]{ "example.emz", "example.wmz", "example.svgz" };
String baseFolder = "D:\\Compressed\\";
for(String file : files)
{
    String inputFile = (baseFolder + file);
    String outFile = inputFile + ".png";
    try (com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFile))
    {
        final com.aspose.imaging.imageoptions.VectorRasterizationOptions vectorRasterizationOptions = 
                (com.aspose.imaging.imageoptions.VectorRasterizationOptions) image.getDefaultOptions(new Object[]{Color.getWhite(), image.getWidth(), image.getHeight()});
        image.save(outFile, new com.aspose.imaging.imageoptions.PngOptions()
        {{
            setVectorRasterizationOptions(vectorRasterizationOptions);
        }});
    }
}

Example: The following example shows how to convert a wmz images to wmf format

String file = "example.wmz";
String baseFolder = "D:\\Compressed\\";
String inputFile = baseFolder + file;
String outFile = inputFile + ".wmf";
try (final com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFile))
{
    final com.aspose.imaging.imageoptions.VectorRasterizationOptions vectorRasterizationOptions = new com.aspose.imaging.imageoptions.WmfRasterizationOptions()
    {{
        setPageSize(com.aspose.imaging.Size.to_SizeF(image.getSize()));
    }};
                
    image.save(outFile, new com.aspose.imaging.imageoptions.WmfOptions()
    {{
        setVectorRasterizationOptions(vectorRasterizationOptions);
    }});
}

Example: The following example shows how to convert a wmf images to wmz format

String file = "castle.wmf";
String baseFolder = "D:\\Compressed\\";
String inputFile = baseFolder + file;
String outFile = inputFile + ".wmz";
try (com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFile))
{
    com.aspose.imaging.imageoptions.VectorRasterizationOptions vectorRasterizationOptions = new com.aspose.imaging.imageoptions.WmfRasterizationOptions();
    vectorRasterizationOptions.setPageSize(com.aspose.imaging.Size.to_SizeF(image.getSize()));
    com.aspose.imaging.imageoptions.WmfOptions options = new com.aspose.imaging.imageoptions.WmfOptions();
    options.setVectorRasterizationOptions(vectorRasterizationOptions);
    options.setCompress(true);
    image.save(outFile, options);
}

WmfImage()

public WmfImage()

创建 WmfImage 类的新实例，以便进一步操作和处理 Windows Metafile (WMF) 图像数据。此构造函数提供了用于处理 WMF 图像的基础对象，使 WMF 图像处理功能能够无缝集成到您的应用程序功能中。

WmfImage(int width, int height)

public WmfImage(int width, int height)

实例化 WmfImage 类的新对象，并提供可自定义的宽度和高度参数，以便创建符合特定尺寸的空白 WMF 图像。使用此构造函数可动态生成具有精确尺寸的 WMF 图像，实现应用程序中灵活的图像创建和操作。

Parameters:

参数	类型	描述
width	int	宽度。
height	int	高度。

isCached()

public boolean isCached()

检索一个布尔值，指示对象的数据是否已缓存，从而消除额外读取数据的操作。利用此属性通过判断对象的数据是否已随时可用，来优化性能，避免在应用程序中进行昂贵的数据检索过程。

Returns: boolean

getBitsPerPixel()

public int getBitsPerPixel()

检索图像的每像素位数，表示颜色深度或粒度水平。利用此属性确定图像的颜色表示和精度，以便在应用程序中进行兼容性检查和与颜色相关的处理。

Returns: int

getWidthF()

public float getWidthF()

访问图像的宽度，表示水平轴上的像素数量。利用此属性确定图像的空间尺寸和宽高比，从而在应用程序中实现精确的布局和渲染调整。

Returns: float - 图像宽度（像素）。

getHeightF()

public float getHeightF()

访问图像的高度，表示垂直轴上的像素数量。利用此属性确定图像的空间尺寸和宽高比，以便在应用程序中实现准确的布局和渲染调整。

Returns: float - 图像高度（像素）。

getInch()

public int getInch()

访问或修改 inch 属性，该属性表示通常用于在打印或显示环境中指定物理尺寸的计量单位。利用此属性设置或获取与图像关联的英寸值，以便在应用程序中准确表示物理尺寸。

Returns: int

setInch(int value)

public void setInch(int value)

访问或修改 inch 属性，该属性表示通常用于在打印或显示环境中指定物理尺寸的计量单位。利用此属性设置或获取与图像关联的英寸值，以便在应用程序中准确表示物理尺寸。

Parameters:

参数	类型	描述
值	int

getFileFormat()

public long getFileFormat()

访问与图像关联的文件格式值，提供图像存储格式的信息。利用此属性确定图像的文件格式，以便在应用程序中进行兼容性检查和特定格式的处理。

Returns: long

getFrameBounds()

public final Rectangle getFrameBounds()

访问帧的边界，指示其在图像中的位置和尺寸。利用此属性获取帧空间位置的详细信息，以实现应用程序中的精确操作和渲染。

Returns: Rectangle - the frame bounds.

cacheData()

public void cacheData()

高效地缓存数据，消除从底层 DataStreamSupporter.DataStreamContainer（DataStreamSupporter.getDataStreamContainer）额外加载的需求。使用此方法通过存储和访问本地数据缓存来优化性能并最小化应用程序的资源使用。

Example: This example shows how to load a WMF image from a file and list all of its records.

String dir = "c:\\temp\\";

// 使用 Aspose.Imaging.Image.Load 是加载包括 WMF 在内的所有类型图像的统一方式。
com.aspose.imaging.fileformats.wmf.WmfImage wmfImage = (com.aspose.imaging.fileformats.wmf.WmfImage) com.aspose.imaging.Image.load(dir + "test.wmf");
try {
    // 缓存数据以加载所有记录。
    wmfImage.cacheData();
    System.out.println("The total number of records: " + wmfImage.getRecords().size());

    // 键是记录类型，值是该类型在 WMF 图像中的记录数量。
    java.util.HashMap<Class, Integer> types = new java.util.HashMap<>();

    // 收集统计信息
    for (Object obj : wmfImage.getRecords()) {
        com.aspose.imaging.fileformats.wmf.objects.WmfObject wmfObj = (com.aspose.imaging.fileformats.wmf.objects.WmfObject) obj;

        Class objType = wmfObj.getClass();
        if (!types.containsKey(objType)) {
            types.put(objType, 1);
        } else {
            int n = types.get(objType);
            types.put(objType, n + 1);
        }
    }

    // 打印统计信息
    System.out.println("Record Type                              Count");
    System.out.println("----------------------------------------------");
    for (java.util.Map.Entry<Class, Integer> entry : types.entrySet()) {
        String objectType = entry.getKey().getSimpleName();
        int numberOfEntrances = entry.getValue();

        // 使用空格对齐输出
        int alignmentPos = 40;
        char[] chars = new char[alignmentPos - objectType.length()];
        java.util.Arrays.fill(chars, ' ');
        String gap = new String(chars);

        System.out.println(objectType + ":" + gap + numberOfEntrances);
    }
} finally {
    wmfImage.dispose();
}

//输出可能如下所示：
//记录总数：613
//记录类型                              数量
//----------------------------------------------
//WmfSetBkMode:                            1
//WmfSetTextAlign:                         1
//WmfSetRop2:                              1
//WmfSetWindowOrg:                         1
//WmfSetWindowExt:                         1
//WmfCreateBrushInDirect:                  119
//WmfSelectObject:                         240
//WmfCreatePenInDirect:                    119
//WmfSetPolyFillMode:                      1
//WmfPolyPolygon:                          114
//WmfPolyLine:                             7
//WmfSetTextColor:                         2
//WmfCreateFontInDirect:                   2
//WmfExtTextOut:                           2
//WmfDibStrechBlt:                         1
//WmfEof:                                  1

setPalette(IColorPalette palette, boolean updateColors)

public void setPalette(IColorPalette palette, boolean updateColors)

将指定的调色板应用于图像，以实现颜色表示的自定义。使用此方法可增强视觉渲染，并在您的应用程序中实现特定的颜色效果。

Parameters:

参数	类型	描述
palette	IColorPalette	要设置的调色板。
updateColors	boolean	如果设置为 true，颜色将根据新调色板进行更新；否则颜色索引保持不变。请注意，如果某些索引没有对应的调色板条目，未更改的索引可能在加载时导致图像崩溃。

getUsedFonts()

public String[] getUsedFonts()

检索元文件中使用的字体列表，提供对图像中使用的字体资源的洞察。使用此方法分析字体使用情况，并确保在您的应用程序中进行渲染或进一步处理时字体可用。

Returns: java.lang.String[] - 字体列表

resizeCanvas(Rectangle newRectangle)

public void resizeCanvas(Rectangle newRectangle)

调整图像的画布大小，在保持图像内容的同时改变其尺寸。使用此方法可在不更改内容的情况下修改画布大小，便于在您的应用程序中进行布局调整和构图更改。

Parameters:

参数	类型	描述
newRectangle	Rectangle	新的矩形。

addRecord(WmfObject record)

public int addRecord(WmfObject record)

将指定的记录对象合并到图像中，为其内容添加额外的数据或元数据。使用此方法可无缝地将记录对象集成到图像中，促进在您的应用程序中实现全面的数据存储和组织。

Parameters:

参数	类型	描述
record	WmfObject	记录。

Returns: int - 记录的数量。

getPostScript()

public final String getPostScript()

访问与图像关联的 PostScript 数据，提供有关其结构或内容的详细信息。利用此方法检索 PostScript 数据，以便在您的应用程序中进行进一步的分析或处理，从而实现与 PostScript 渲染或操作相关的高级功能。

Returns: java.lang.String - 后置脚本

getOriginalOptions()

public ImageOptionsBase getOriginalOptions()

获取原始图像选项。

Returns: ImageOptionsBase - The original image options.