如何在 Ruby 中使用 REST API 将 Word 转换为图像格式

如何使用 REST API 将 DOCX 转换为图像文件类型?

Word 是用于共享和打印文档的流行格式之一。我们经常需要将word文档转换成不同的图像格式。最好使用已经开发的专用工具,这些工具可以提供易于维护、灵活的转换解决方案来满足您的需求。 GroupDocs.Conversion 的 Ruby SDK 提供了在几秒钟内将 Word DOCX 转换为 JPG、PNG 和 GIF 文件的最佳方式。它是 100% 免费、安全且易于使用的用于文件转换的 Ruby SDK。它允许将 支持的格式 的文档以编程方式转换为云上的图像

在本文中,我们将学习如何在 Ruby 中使用 REST API 将文字转换为图像。本文应涵盖以下主题:

高性能文字到图像转换 REST API 和 Ruby SDK

为了将 JPGPNGGIF 图像转换为 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 = "my-local-storage"

在 Ruby 中使用 REST API 将 Word 转换为 JPEG

我们可以按照下面给出的简单步骤将 word 转换为图像: 首先,您需要使用以下代码示例将 docx 文件 上传 到云端: 结果,上传的文件将在 云上仪表板的文件部分。现在,您可以按照以下步骤以编程方式将 Word 转换为 JPEG 格式:

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

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

# 如何将 word docx 转换为 jpeg
# 获取 ConvertAPI 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

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

# 设置 Docx 加载选项
@loadOptions = GroupDocsConversionCloud::DocxLoadOptions.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 = "word-to-images"

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

@result = @apiInstance.convert_document(@request)
puts("Word doc successfully converted to jpeg. " + (@result).to_s)

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

如何使用高级选项将 Word 转换为 JPG

我们可以按照以下给出的步骤,以编程方式使用高级设置将 Word Doc 转换为 JPG 格式:

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

以下代码示例显示如何使用高级转换选项将 word 转换为 JPG 图像。

# 如何将word docx转换为jpg
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# 初始化图像转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.storage_name = @storage_name
@settings.file_path = "word-to-images/one-page.docx"
@settings.format = "jpg"

@convertOptions = GroupDocsConversionCloud::JpgConvertOptions.new
@convertOptions.from_page = 1
@convertOptions.pages_count = 2

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

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

# 转换为 jpg
@response = @apiInstance.convert_document(@request)
puts("Word docx successfully converted to jpg format.")

如何在 Ruby 中使用 REST API 将 DOCX 转换为 PNG

您可以按照以下步骤以编程方式将 Word Docx 转换为 PNG 格式:

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

下面的代码示例展示了如何在 Ruby 中使用 REST API 将 word 转换为 PNG 格式。

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

# 初始化转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new()
@settings.storage_name = @storage_name
@settings.file_path = "word-to-images/one-page.docx"
@settings.format = "png"

# 设置 Word Docx 加载选项
@loadOptions = GroupDocsConversionCloud::DocxLoadOptions.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 = "word-to-images"

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

@result = @apiInstance.convert_document(@request)
puts("Word Docx successfully converted to png image. ")

使用 REST API 在 Ruby 中将 Word DOCX 转换为 GIF

我们可以按照以下步骤以编程方式将 Word Docx 转换为 JPG:

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

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

# 如何将word docx转换为gif
# 获取转换 API 的实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)

# 初始化转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new()
@settings.storage_name = @storage_name
@settings.file_path = "word-to-images/one-page.docx"
@settings.format = "gif"

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

@convertOptions = GroupDocsConversionCloud::GifConvertOptions.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 = "word-to-images"

@request = GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings)
@result = @apiInstance.convert_document(@request)
puts("Word Docx successfully converted to gif format. ")

免费的在线文字到图像转换器

请试用以下免费的在线 JPG、PNG 和 GIF 转换工具,它是使用上述 API 开发的 https://products.aspose.app/words/conversion/docx-to-image

结论

在本文中,我们学习了如何在云端将文字格式转换为图片格式。现在您知道如何:

  • 使用 ruby 中的 REST API 将 word 文档转换为 jpeg/jpg
  • 如何使用ruby将word docx转换为png图像格式
  • 使用 ruby 中的 REST API 将 word docx 转换为 gif 文件格式

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

问一个问题

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

也可以看看