GetImage

GetImage(float, float)

返回带有自定义缩放的缩略图像对象。

public IImage GetImage(float scaleX, float scaleY)
参数类型描述
scaleXSingle用于在 x 轴方向缩放此缩略图的值。
scaleYSingle用于在 y 轴方向缩放此缩略图的值。

返回值

IImage 对象。

示例

以下示例演示如何从 PowerPoint 演示文稿生成缩略图。

[C#]
// 实例化表示演示文稿文件的 Presentation 类
using (Presentation pres = new Presentation("ThumbnailFromSlide.pptx"))
{
    // 访问第一个幻灯片
    ISlide sld = pres.Slides[0];
    // 创建一个全比例图片
    IImage bmp = sld.GetImage(1f, 1f);
    // 以 JPEG 格式将图像保存到磁盘
    bmp.Save("Thumbnail_out.jpg", ImageFormat.Jpeg);
}

以下示例演示如何将幻灯片转换为位图并以 PNG 格式保存图像。

[C#]
using (Presentation pres = new Presentation("Presentation.pptx"))
{
    // 将演示文稿中的第一个幻灯片转换为指定大小的 Bitmap 对象
    using (IImage bmp = pres.Slides[0].GetImage())
    {
        // 将图像保存为 PNG 格式
        bmp.Save("Slide_0.png", ImageFormat.Png);
    }
}

以下示例演示如何将 PowerPoint PPT/PPTX 转换为 JPG。

[C#]
using (Presentation pres = new Presentation("PowerPoint-Presentation.ppt"))
{
	foreach (ISlide sld in pres.Slides)
	{
		// 创建全比例图像
		IImage bmp = sld.GetImage(1f, 1f);
		// 以 JPEG 格式将图像保存到磁盘
		bmp.Save(string.Format("Slide_{0}.jpg", sld.SlideNumber), ImageFormat.Jpeg);
	}
}

以下示例演示如何使用自定义维度将 PowerPoint PPT/PPTX 转换为 JPG。

[C#]
using (Presentation pres = new Presentation("PowerPoint-Presentation.pptx"))
{
	// 定义尺寸
	int desiredX = 1200;
	int desiredY = 800;
	// 获取 X 和 Y 的缩放值
	float ScaleX = (float)(1.0 / pres.SlideSize.Size.Width) * desiredX;
	float ScaleY = (float)(1.0 / pres.SlideSize.Size.Height) * desiredY;
	foreach (ISlide sld in pres.Slides)
	{
		// 创建全比例图像
		IImage bmp = sld.GetImage(ScaleX, ScaleY);
		// 以 JPEG 格式将图像保存到磁盘
		bmp.Save(string.Format("Slide_{0}.jpg", sld.SlideNumber), ImageFormat.Jpeg);
	}
}

另请参见


GetImage()

返回缩略图像对象(实际大小的 20%)。

public IImage GetImage()

另请参见


GetImage(Size)

返回具有指定大小的缩略图像对象。

public IImage GetImage(Size imageSize)
参数类型描述
imageSizeSize要创建的图像的大小。

返回值

图像对象。

示例

以下示例演示如何使用 C# 将幻灯片转换为具有自定义大小的图像。

using (Presentation pres = new Presentation("Presentation.pptx"))
{
    // 将演示文稿中的第一个幻灯片转换为指定大小的 Bitmap
    using (IImage bmp = pres.Slides[0].GetImage(new Size(1820, 1040)))
    {
        // 将图像保存为 JPEG 格式
        bmp.Save("Slide_0.jpg", ImageFormat.Jpeg);
    }
}

另请参见


GetImage(ITiffOptions)

返回具有指定参数的缩略图 TIFF 图像对象。

public IImage GetImage(ITiffOptions options)
参数类型描述
optionsITiffOptionsTIFF 选项。

返回值

图像对象。

异常

异常条件
InvalidOperationException当 options.SlideLayoutOption 为 NotesCommentsLayoutingOptions,且其属性 NotesPosition 取值为 NotesPositions.BottomFull 时抛出。

另请参见


GetImage(IRenderingOptions)

返回缩略图像对象。

public IImage GetImage(IRenderingOptions options)
参数类型描述
optionsIRenderingOptions渲染选项。

返回值

图像对象。

异常

异常条件
InvalidOperationException当 notesCommentsLayouting.NotesPosition 取值为 NotesPositions.BottomFull 时抛出。

另请参见


GetImage(IRenderingOptions, float, float)

返回带有自定义缩放的缩略图像对象。

public IImage GetImage(IRenderingOptions options, float scaleX, float scaleY)
参数类型描述
optionsIRenderingOptions渲染选项。
scaleXSingle用于在 x 轴方向缩放此缩略图的值。
scaleYSingle用于在 y 轴方向缩放此缩略图的值。

返回值

位图对象。

异常

异常条件
InvalidOperationException当 notesCommentsLayouting.NotesPosition 取值为 NotesPositions.BottomFull 时抛出。

示例

以下示例演示如何使用 C# 将带有注释的幻灯片转换为图像。

using (Presentation pres = new Presentation("PresentationNotesComments.pptx"))
{
    // 创建渲染选项
    IRenderingOptions options = new RenderingOptions();
    // 创建注释布局选项
    NotesCommentsLayoutingOptions notesCommentsLayouting = new NotesCommentsLayoutingOptions();
    // 设置页面上注释的位置
    notesCommentsLayouting.NotesPosition = NotesPositions.BottomTruncated;
    // 设置页面上评论的位置
    notesCommentsLayouting.CommentsPosition = CommentsPositions.Right;
    // 设置评论输出区域的宽度
    notesCommentsLayouting.CommentsAreaWidth = 500;
    // 设置评论区域的颜色
    notesCommentsLayouting.CommentsAreaColor = Color.AntiqueWhite;
    // 设置渲染的布局选项
    options.SlidesLayoutOptions = notesCommentsLayouting;
    // 将演示文稿的第一个幻灯片转换为 IImage 对象
    IImage image = pres.Slides[0].GetImage(options, 2f, 2f);
    // 以 GIF 格式保存图像
    image.Save("Slide_Notes_Comments_0.gif", ImageFormat.Gif);
}

另请参见


GetImage(IRenderingOptions, Size)

返回具有指定大小的缩略图像对象。

public IImage GetImage(IRenderingOptions options, Size imageSize)
参数类型描述
optionsIRenderingOptions渲染选项。
imageSizeSize要创建的图像的大小。

返回值

图像对象。

异常

异常条件
InvalidOperationException当 options.SlideLayoutOption 为 NotesCommentsLayoutingOptions,且其属性 NotesPosition 取值为 NotesPositions.BottomFull 时抛出。

另请参见