使用 C++ 将 XPS、OXPS 转换为 JPG 或 PNG 图像

XPSOXPS 文档类似于 PDF 文件,它们定义了文档的布局、外观和打印信息。在某些情况下,您可能需要将 XPS 和 OXPS 文档转换为 JPGPNG 图像格式。为此,本文将教您如何使用 C++ 将 XPS 和 OXPS 文档转换为 JPG 和 PNG 图像格式。

用于将 XPS、OXPS 文件转换为 JPG 或 PNG 格式的 C++ API

Aspose.Page for C++ 是一个用于渲染和操作 XPS 和 PostScript 文件的 C++ 库。它允许您创建、阅读和更新 XPS 文档。此外,API 支持将 XPS 和 OXPS 文档转换为 JPG 和 PNG 图像格式。您可以通过 NuGet 安装 API,也可以直接从 下载 部分下载。

PM> Install-Package Aspose.Page.Cpp

将 XPS/OXPS 文档转换为 JPG 格式

以下是将 XPS 和 OXPS 文档转换为 JPG 格式的步骤。

  • 使用源 XPS/OXPS 文件初始化流。
  • 使用 XPS/OXPS 流创建 XpsDocument 类的实例。
  • 创建 JpegSaveOptions 类的实例。
  • 指定 SmoothingModeResolution 等选项。
  • 创建 ImageDevice 类的实例。
  • 使用 [XpsDocument->Save(System::SharedPtr) 将 XPS/OXPS 文档保存到 ImageDevice设备,系统::SharedPtr选项)]15 方法。
  • 遍历文档分区。
  • 初始化输出流并保存 JPG 图像。

以下示例代码展示了如何使用 C++ 将 XPS/OXPS 文档转换为 JPG 格式。

// 输入文件
System::String inputFileName = u"SourceDirectory\\sample.xps";
//输出文件 
System::String outputFileName = u"OutputDirectory\\XPStoImage_out.jpeg";
// 初始化 XPS 输入流
{
	System::SharedPtr<System::IO::Stream> xpsStream = System::IO::File::Open(inputFileName, System::IO::FileMode::Open, System::IO::FileAccess::Read);
	// 在“使用”语句下清除资源
	System::Details::DisposeGuard<1> __dispose_guard_1({ xpsStream });
	// ------------------------------------------

	try
	{
		// 从流中加载 XPS 文档
		System::SharedPtr<XpsDocument> document = System::MakeObject<XpsDocument>(xpsStream, System::MakeObject<XpsLoadOptions>());
		// 或直接从文件加载 XPS 文档。那时不需要 xpsStream。
		// XpsDocument 文档 = new XpsDocument(inputFileName, new XpsLoadOptions());

		// 使用必要的参数初始化 JpegSaveOptions 对象。
		System::SharedPtr<JpegSaveOptions> options = [&] { 
			auto tmp_0 = System::MakeObject<JpegSaveOptions>(); 
			tmp_0->set_SmoothingMode(System::Drawing::Drawing2D::SmoothingMode::HighQuality); 
			tmp_0->set_Resolution(300); 
			tmp_0->set_PageNumbers(System::MakeArray<int32_t>({ 1, 2, 6 })); 
			return tmp_0; 
		}();

		// 为 JPG 格式创建渲染设备
		System::SharedPtr<ImageDevice> device = System::MakeObject<ImageDevice>();

		document->Save(device, options);

		// 遍历文档分区(固定文档,在 XPS 术语中)
		for (int32_t i = 0; i < device->get_Result()->get_Length(); i++)
		{
			for (int32_t j = 0; j < device->get_Result()[i]->get_Length(); j++)
			{
				// 初始化图像输出流
				{
					System::SharedPtr<System::IO::Stream> imageStream = System::IO::File::Open(System::IO::Path::GetDirectoryName(outputFileName) + u"\\" + System::IO::Path::GetFileNameWithoutExtension(outputFileName) + u"_" + (i + 1) + u"_" + (j + 1) + System::IO::Path::GetExtension(outputFileName), System::IO::FileMode::Create, System::IO::FileAccess::Write);
					// 在“使用”语句下清除资源
					System::Details::DisposeGuard<1> __dispose_guard_0({ imageStream });
					// ------------------------------------------

					try
					{
						imageStream->Write(device->get_Result()[i][j], 0, device->get_Result()[i][j]->get_Length());
					}
					catch (...)
					{
						__dispose_guard_0.SetCurrentException(std::current_exception());
					}
				}
			}
		}
	}
	catch (...)
	{
		__dispose_guard_1.SetCurrentException(std::current_exception());
	}
}
示例代码生成的JPG图片

示例代码生成的JPG图片

将 XPS/OXPS 文档转换为 PNG 格式

以下是将 XPS 和 OXPS 文档转换为 PNG 格式的步骤。

  • 使用源 XPS/OXPS 文件初始化流。
  • 使用 XPS/OXPS 流创建 XpsDocument 类的实例。
  • 创建 PngSaveOptions 类的实例。
  • 指定 SmoothingModeResolution 等选项。
  • 创建 ImageDevice 类的实例。
  • 使用 [XpsDocument->Save(System::SharedPtr) 将 XPS/OXPS 文档保存到 ImageDevice设备,系统::SharedPtr选项)]22 方法。
  • 遍历文档分区。
  • 初始化输出流并保存 PNG 图像。

以下示例代码展示了如何使用 C++ 将 XPS/OXPS 文档转换为 PNG 格式。

// 输入文件
System::String inputFileName = u"SourceDirectory\\sample.xps";
//输出文件 
System::String outputFileName = u"OutputDirectory\\XPStoImage_out.png";
// 初始化 XPS 输入流
{
	System::SharedPtr<System::IO::Stream> xpsStream = System::IO::File::Open(inputFileName, System::IO::FileMode::Open, System::IO::FileAccess::Read);
	// 在“使用”语句下清除资源
	System::Details::DisposeGuard<1> __dispose_guard_1({ xpsStream });
	// ------------------------------------------

	try
	{
		// 从流中加载 XPS 文档
		System::SharedPtr<XpsDocument> document = System::MakeObject<XpsDocument>(xpsStream, System::MakeObject<XpsLoadOptions>());
		// 或直接从文件加载 XPS 文档。那时不需要 xpsStream。
		// XpsDocument 文档 = new XpsDocument(inputFileName, new XpsLoadOptions());

		// 使用必要的参数初始化 PngSaveOptions 对象。
		System::SharedPtr<PngSaveOptions> options = [&] { 
			auto tmp_0 = System::MakeObject<PngSaveOptions>(); 
			tmp_0->set_SmoothingMode(System::Drawing::Drawing2D::SmoothingMode::HighQuality); 
			tmp_0->set_Resolution(300); 
			tmp_0->set_PageNumbers(System::MakeArray<int32_t>({ 1, 2, 6 })); 
			return tmp_0; 
		}();

		// 为 PNG 格式创建渲染设备
		System::SharedPtr<ImageDevice> device = System::MakeObject<ImageDevice>();

		document->Save(device, options);

		// 遍历文档分区(固定文档,在 XPS 术语中)
		for (int32_t i = 0; i < device->get_Result()->get_Length(); i++)
		{
			for (int32_t j = 0; j < device->get_Result()[i]->get_Length(); j++)
			{
				// 初始化图像输出流
				{
					System::SharedPtr<System::IO::Stream> imageStream = System::IO::File::Open(System::IO::Path::GetDirectoryName(outputFileName) + u"\\" + System::IO::Path::GetFileNameWithoutExtension(outputFileName) + u"_" + (i + 1) + u"_" + (j + 1) + System::IO::Path::GetExtension(outputFileName), System::IO::FileMode::Create, System::IO::FileAccess::Write);
					// 在“使用”语句下清除资源
					System::Details::DisposeGuard<1> __dispose_guard_0({ imageStream });
					// ------------------------------------------

					try
					{
						imageStream->Write(device->get_Result()[i][j], 0, device->get_Result()[i][j]->get_Length());
					}
					catch (...)
					{
						__dispose_guard_0.SetCurrentException(std::current_exception());
					}
				}
			}
		}
	}
	catch (...)
	{
		__dispose_guard_1.SetCurrentException(std::current_exception());
	}
}
示例代码生成的PNG图片

示例代码生成的PNG图片

获得免费许可证

您可以通过请求 免费的临时许可证 来试用该 API,而不受评估限制。

结论

在本文中,您学习了如何使用 C++ 将 XPS 和 OXPS 文档转换为 JPG 和 PNG 图像格式。此外,Aspose.Page for C++ API 提供了多种附加格式供您使用。您可以通过访问 官方文档 来详细探索 API。如有任何问题,请随时通过我们的 免费支持论坛 与我们联系。

也可以看看