如何使用 Ruby 将 PDF 文件转换为 PNG、JPEG、BMP 和 TIFF 图像

如何使用 Ruby 将 PDF 文件转换为 PNG、JPEG、BMP 和 TIFF 图像

PDF 文件非常有用，可以替代许多不同类型的数据来存储文档。但是，在某些情况下，您必须将 PDF 文件转换为其他文件格式。对于这种情况，本文介绍了如何将 PDF 文件转换为流行的图像格式。特别是，您将学习如何使用 Ruby 将 PDF 文件转换为 PNG、JPEG、BMP 和 TIFF 图像。我们的图像转换器提供比许多其他 PDF 到图像转换器更好的图像质量。

本文应涵盖以下主题：

PDF 文档到图像转换器 API – 安装

为了将 PNG、JPEG、BMP 和 TIFF 图像转换为 Ruby，我们将使用 GroupDocs.Conversion Cloud API 的 Ruby SDK。您可以在控制台中使用以下命令安装它：

gem install groupdocs_conversion_cloud

首先，从仪表板获取您的客户端 ID 和密码，然后再执行以下提到的步骤。获得 ID 和密码后，在您的应用程序中添加以下代码，如下所示：

# 在你的 ruby 应用程序中为 http://api.groupdocs.cloud 加载 gem
require 'groupdocs_conversion_cloud'

# 免费注册后，从 https://dashboard.groupdocs.cloud 获取您的 client_id 和 client_secret。
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
@storage_name = "Default-Storage"

如何在 Ruby 中将 PDF 文档转换为 PNG 图像

我们可以按照下面给出的步骤以编程方式将 PDF 转换为 PNG 格式。首先，您需要使用 以下代码示例 将 pdf 文档上传到云端。因此，上传的文件将在云上仪表板的 文件部分 中可用。

  • 创建 ConvertApi 的实例。
  • 接下来，创建 ConvertSettings 的实例
  • 然后，设置存储名称和pdf文件路径
  • 另外，将“png”设置为输出图像格式
  • 创建 PdfLoadOptions 的实例
  • 设置pdf文件密码和load\options
  • 创建 PngConvertOptions 的实例
  • 定义灰度、from\page、pages\count、quality、rotate\angle和use\pdf值
  • 将 convertOptions 设置为设置
  • 现在，提供输出文件路径
  • 之后，使用 ConvertSettings 作为参数创建 ConvertDocumentRequest
  • 最后用ConvertDocumentRequest调用ConvertApi.convert\document()方法保存转换后的文件

以下代码示例显示了如何在 Ruby 中使用 REST API 将 PDF 转换为 PNG 格式：

# 如何使用 REST API 将 pdf 转换为 png
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

# 创建转换设置的实例
@settings = GroupDocsConversionCloud::ConvertSettings.new()
@settings.storage_name = @storage_name
@settings.file_path = "pdf-to-images/test-file.pdf"
@settings.format = "png"

# 设置和创建 PDF LoadOptions
@loadOptions = GroupDocsConversionCloud::PdfLoadOptions.new()
@loadOptions.password = "password"
@settings.load_options = @loadOptions

@convertOptions = GroupDocsConversionCloud::PngConvertOptions.new()
@convertOptions.grayscale = true
@convertOptions.from_page = 1
@convertOptions.pages_count = 1
@convertOptions.quality = 100
@convertOptions.rotate_angle = 90
@convertOptions.use_pdf = false

@settings.convert_options = @convertOptions
@settings.output_path = "pdf-to-images"

@request = GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings)

@response = @apiInstance.convert_document(@request)
puts("PDF file successfully converted to png file format. " + (@response).to_s)

上面的代码示例会将转换后的 PNG 文件保存在云端。您也可以通过将 下载文件 代码添加到您的应用程序来下载它。

如何在 Ruby 中将 PDF 文件转换为 JPEG 图像格式

您可以按照以下步骤以编程方式将 PDF 转换为 JPEG 格式：

  • 首先，创建一个 ConvertApi 的实例
  • 接下来，创建 ConvertSettings 的实例
  • 然后，设置pdf文件路径和存储名称
  • 此外，将“jpeg”指定为输出图像格式
  • 创建 PdfLoadOptions 的实例
  • 设置pdf文件密码和load\options
  • 创建 JpegConvertOptions 的实例
  • 定义灰度、from\page、pages\count、quality、rotate\angle和use\pdf值 etc
  • 将 convertOptions 设置为设置
  • 现在，提供输出文件路径
  • 之后，使用 ConvertSettings 作为参数创建 ConvertDocumentRequest。
  • 最后用ConvertDocumentRequest调用ConvertApi.convert\document()方法保存转换后的文件。

以下代码示例展示了如何在 Ruby 中使用 REST API 将 PDF 文档转换为 JPEG 图像：

# 如何使用 REST API 将 pdf 文档转换为 jpeg 图像
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

# 初始化并设置转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new()
@settings.storage_name = @storage_name
@settings.file_path = "pdf-to-images/test-file.pdf"
@settings.format = "jpeg"

# 设置 PDF 加载选项
@loadOptions = GroupDocsConversionCloud::PdfLoadOptions.new()
@loadOptions.password = "password"
@settings.load_options = @loadOptions

@convertOptions = GroupDocsConversionCloud::JpegConvertOptions.new()
@convertOptions.grayscale = true
@convertOptions.from_page = 1
@convertOptions.pages_count = 1
@convertOptions.quality = 100
@convertOptions.rotate_angle = 90
@convertOptions.use_pdf = false

@settings.convert_options = @convertOptions
@settings.output_path = "pdf-to-images"

@request = GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings)

# 转换为bmp文件格式
@result = @apiInstance.convert_document(@request)
puts("Successfully converted PDF to jpeg image. " + (@result).to_s)

在 Ruby 中使用 REST API 将 PDF 转换为 BMP

我们可以按照以下步骤使用高级设置以编程方式将 PDF 转换为 BMP 格式：

  • 创建 ConvertApi 的实例
  • 然后，创建 ConvertSettings 的实例
  • 另外，设置存储名称和pdf文件路径
  • 将“bmp”设置为输出图像格式
  • 创建 PdfLoadOptions 的实例
  • 设置pdf文件密码和load\options
  • 创建 BmpConvertOptions 的实例
  • 定义 from\page 和 pages\count 值
  • 将 convertOptions 设置为设置
  • 现在，提供输出文件路径
  • 之后，使用 ConvertSettings 作为参数创建 ConvertDocumentRequest
  • 最后用ConvertDocumentRequest调用ConvertApi.convert\document()方法保存转换后的文件

以下代码示例显示了如何使用高级转换选项将 PDF 转换为 BMP 图像：

# 如何使用高级选项 REST API 将 pdf 转换为 bmp
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

# 初始化 bmp 格式转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.storage_name = @storage_name
@settings.file_path = "pdf-to-images/test-file.pdf"
@settings.format = "bmp"

# 设置 PDF 加载选项
@loadOptions = GroupDocsConversionCloud::PdfLoadOptions.new()
@loadOptions.password = "password"
@settings.load_options = @loadOptions

# 设置 Bmp 转换选项
@convertOptions = GroupDocsConversionCloud::BmpConvertOptions.new
@convertOptions.from_page = 1
@convertOptions.pages_count = 2
@convertOptions.use_pdf = false
@convertOptions.rotate_angle = 90

@settings.convert_options = @convertOptions
@settings.output_path = "pdf-to-images"

@request = GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings)

# 转换为bmp文件格式
@response = @apiInstance.convert_document(@request)
puts("Successfully converted PDF to bmp format. " + (@response).to_s)

在 Ruby 中将 PDF 文档转换为 TIFF 格式

我们可以按照以下步骤以编程方式将 PDF 转换为 TIFF：

  • 创建 ConvertApi 的实例
  • 接下来，创建 ConvertSettings 的实例
  • 然后，设置pdf文件路径和存储名称
  • 另外，将“tiff”设置为输出图像格式
  • 创建 PdfLoadOptions 的实例
  • 设置pdf文件密码和load\options
  • 创建 TiffConvertOptions 的实例
  • 定义灰度、from\page、pages\count、quality、rotate\angle和use\pdf值
  • 将 convertOptions 设置为设置
  • 现在，提供输出文件路径
  • 之后，使用 ConvertSettings 作为参数创建 ConvertDocumentRequest
  • 最后用ConvertDocumentRequest调用ConvertApi.convert\document()方法保存转换后的文件

以下代码示例展示了如何在 Ruby 中使用 REST API 将 PDF 转换为 TIFF 文件。请按照前面提到的步骤上传文件：

# 如何使用 REST API 将 pdf 转换为 tiff
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

# 初始化转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new()
@settings.storage_name = @storage_name
@settings.file_path = "pdf-to-images/test-file.pdf"
@settings.format = "tiff"

# 设置 PDF 加载选项
@loadOptions = GroupDocsConversionCloud::PdfLoadOptions.new()
@loadOptions.password = "password"
@settings.load_options = @loadOptions

@convertOptions = GroupDocsConversionCloud::TiffConvertOptions.new()
@convertOptions.from_page = 1
@convertOptions.pages_count = 1
@convertOptions.rotate_angle = 90
@convertOptions.grayscale = true
# 如果为真，输入首先转换为 PDF，然后转换为所需格式
@convertOptions.use_pdf = false

@settings.convert_options = @convertOptions
@settings.output_path = "pdf-to-images"

@request = GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings)
# 转换为 tiff 文件格式
@result = @apiInstance.convert_document(@request)
puts("Successfully converted PDF to tiff format. " + (@result).to_s)

免费在线 PDF 到图像转换器

请试用以下免费在线 PNG、JPEG、BMP 和 TIFF 图像转换工具，它是使用上述 API 开发的 https://products.aspose.app/pdf/convert-pdf-to-image。

结论

在本文中，我们学习了如何：

  • 在 Ruby 中使用 REST API 将 PDF 文件转换为 PNG 格式
  • 在 Ruby 中将 PDF 文档转换为 JPEG 图像格式
  • 在 Ruby 中使用 REST API 将 PDF 文档转换为 BMP
  • 在 Ruby 中将 PDF 文件转换为 TIFF 文件格式

您可以使用 文档 了解有关 GroupDocs.Conversion Cloud API 的更多信息。我们还提供了一个 API 参考 部分，让您可以直接通过浏览器可视化我们的 API 并与之交互。

问一个问题

如果您对 PDF 到图像转换器有任何疑问，请随时在 论坛 上向我们提问。

也可以看看