Конвертируйте EPUB в изображение с помощью Cloud SDK – Aspose.HTML

Aspose.HTML Cloud предоставляет простейший API для преобразования документов EPUB в форматы файлов изображений с высоким качеством, просто и быстро.

Формат EPUB приобрел популярность как формат электронных книг на основе XML и предназначен для адаптации представления контента к устройству чтения. EPUB, формат цифровых книг на основе XML, широко совместим с такими устройствами, как смартфоны, планшеты и компьютеры. Он реализован в виде архивного файла, состоящего из файлов XHTML, несущих контент, изображения и другие вспомогательные файлы. Иногда требуется получить изображение вместо документов EPUB, например сделать их портативными и легко обмениваться ими на различных устройствах, создать галерею изображений из электронных книг и т. д.

В статье с помощью набора примеров кода объясняется, как преобразовать документ EPUB в форматы файлов изображений, такие как JPEG, PNG, GIF, TIFF или BMP с использованием Aspose.HTML Cloud SDK и вызовов REST API. SDK доступны на PHP, C++, Python, C#, Ruby, Java, Android, Swift и Node.js. Мы рассмотрим несколько сценариев преобразования EPUB в изображения:

Преобразуйте локальный файл EPUB в изображение и сохраните результат в локальной файловой системе. В этом сценарии мы рассмотрим преобразование с параметрами преобразования по умолчанию и явно заданными параметрами.
Конвертируйте EPUB в изображение в облачном хранилище с параметрами преобразования по умолчанию.

Примеры SDK для преобразования EPUB в изображения

Широко распространенным вариантом использования функций Aspose.HTML Cloud SDK является обработка и преобразование файлов. Cloud SDK позволяет вам получить документ EPUB из места хранения по его имени или из локального файла на вашем диске, преобразовать его в указанный формат и сохранить в хранилище или на локальном диске. В следующих примерах кода показано, как преобразовать EPUB в изображение для различных случаев с использованием доступных SDK.

Пример 1. Конвертировать EPUB в JPG

JPG – один из наиболее часто используемых форматов изображений. Его уникальность – контролируемая потеря качества при сжатии. Поэтому он широко используется для хранения и отправки графического контента (фотографии, сканированные копии, оцифрованные изображения) через Интернет.

Рассмотрите возможность преобразования документа EPUB, изначально расположенного в локальной файловой системе, в формат JPG. Полученный файл затем сохраняется обратно в локальную файловую систему. Преобразование происходит с параметрами преобразования по умолчанию.

В следующем примере демонстрируется самый простой способ преобразования EPUB в JPG с применением языка C#. Вы можете скачать C# SDK из репозитория GitHub.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert EPUB to JPG
5var result = await api.ConvertAsync("test.epub", "test.jpg");

Java

В следующем примере показано, как преобразовать EPUB в JPG с применением языка Java. Вы можете загрузить Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.epub")
 8                .saveToLocal("output.jpeg");
 9
10OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать EPUB в JPG с применением языка C++. Локальный EPUB конвертируется в JPG и сохраняется по локальному пути.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"test.epub";
23utility::string_t dst = w_cur_dir + L"result.jpeg";
24
25// Conversion
26auto result = api->convertLocalToLocal(src, dst);
27
28// Check the result file
29auto re = result->getFile();
30std::ifstream f(re.c_str());
31if(!f.good())
32{
33    throw std::runtime_error("Conversion failed");
34}

Python

В следующем примере показано, как преобразовать EPUB в JPG с применением языка Python. Вы можете скачать Python SDK из репозитория GitHub.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_local_to_local(input_file="test.epub", output_file="test.jpeg")
16except ApiException as ex:
17    print("Exception")
18    print("Info: " + str(ex))
19    raise ex

PHP

В следующем примере показано, как преобразовать EPUB в JPG с помощью языка PHP. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.epub';
15$dst = 'output.jpeg';
16
17try {
18    // Request to server Api
19    $result = $api_html->convertLocalToLocal($src, $dst);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
23}
24
25?>

Ruby

В следующем примере показано, как преобразовать EPUB в JPG используя Ruby. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8CONFIG = {
 9    "basePath":"https://api.aspose.cloud/v4.0",
10    "authPath":"https://api.aspose.cloud/connect/token",
11    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
13    "debug":true
14}
15
16api_instance = AsposeHtml::HtmlApi.new CONFIG
17
18src = "test.epub"  # String | Full path to the input file.
19dst = "test.jpeg"  # String | Full path to the result.
20
21begin
22  #Convert the document from the local file and save result to the local file.
23  result = api_instance.convert_local_to_local(src, dst)
24  p result
25rescue AsposeHtml::ApiError => e
26  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
27end

Node.js

В следующем примере показано, как преобразовать EPUB в JPG с применением языка Node.js. Локальный EPUB конвертируется в JPG и сохраняется по локальному пути.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/test.epub"; // {String} Source document.
19var dst = "/path/to/dst/test.jpeg"; // {String} Result document.
20var opts = null;
21
22var callback = function(error, data, response) {
23  if (error) {
24    console.error(error);
25  } else {
26    console.log(data);
27  }
28};
29
30conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

В следующем примере показано, как преобразовать EPUB в JPG на Swift. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "test.epub"
27let format = "jpeg"
28let src = url(forResource: fileName).absoluteString
29
30let expectation = self.expectation(description: "testConvert to \(format)")
31let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
32HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: nil) { (data, error) in
33
34	guard error == nil else {
35		XCTFail("Error convert epub to \(format)). Error=\(error!.localizedDescription)")
36		return
37	}
38	let resultPath = data!.file!
39	XCTAssertTrue(fileExist(name: resultPath))
40	expectation.fulfill()
41}
42self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать EPUB в JPG используя Java/Android. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.epub")
 8                .saveToLocal("output.jpeg");
 9
10OperationResult result = api.convert(builder);

CURL

Загрузите локальный файл в хранилище с помощью Storage API.
Вызовите REST API для выполнения преобразования (в примере ниже).
Загрузите результат преобразования обратно из хранилища с помощью Storage API.

В следующем примере показано, как преобразовать EPUB в JPG с применением REST API. Сделайте несколько обязательных шагов:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/epub-jpg" \
3    -d "{'InputPath': '/testpage.epub', 'OutputFile': 'test.jpg'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Преобразование EPUB в JPG происходит с использованием параметров преобразования по умолчанию: ширина и высота результирующего документа JPG соответствуют формату A4, а все поля имеют нулевое значение.

Пример 2. Преобразование EPUB в PNG с явно заданными параметрами

Формат изображений PNG широко используется для передачи изображений по сети, отображения фотографий и графики на веб-страницах и резервирования в облачных хранилищах. Преобразование EPUB в PNG может потребоваться, например, если вы хотите добавить веб-страницу в презентацию PowerPoint, вставить ее в блог для своих читателей или отправить по электронной почте. В примере ниже показано, как преобразовать EPUB в PNG с явно заданными параметрами и сохранить результат обратно в локальную файловую систему.

В следующем примере SDK показано, как преобразовать EPUB в PNG с применением языка C#. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете скачать C# SDK из репозитория GitHub.

 1// Initialize SDK API
 2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
 3
 4// Create an options instance and specify options for EPUB to PNG conversion
 5var options = new ImageConversionOptions()
 6                .SetHeight(800)
 7                .SetWidth(1000)
 8                .SetLeftMargin(10)
 9                .SetRightMargin(10)
10                .SetBottomMargin(10)
11                .SetTopMargin(10);
12
13// Convert EPUB to PNG
14var result = await api.ConvertAsync("test.epub", "test.png", options);

Java

В следующем примере показано, как преобразовать EPUB в PNG с применением языка Java. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете загрузить Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6ImageConversionOptions opt = new ImageConversionOptions()
 7                        .setWidth(600)
 8                        .setHeight(900)
 9                        .setTopMargin(20)
10                        .setBottomMargin(20)
11                        .setLeftMargin(20)
12                        .setRightMargin(20);
13
14JobBuilder builder = new ConverterBuilder()
15                .fromLocalFile("input.epub")
16                .useOptions(opt)
17                .saveToLocal("output.png");
18
19OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать EPUB в PNG на языке C++. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"test.epub";
23utility::string_t dst = w_cur_dir + L"result.png";
24
25std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
26opts->setWidth(800)
27    ->setHeight(600)
28    ->setLeftMargin(10)
29    ->setRightMargin(10)
30    ->setTopMargin(10)
31    ->setBottomMargin(10);
32
33// Conversion
34auto result = api->convertLocalToLocal(src, dst, opts);
35
36// Check the result file
37auto re = result->getFile();
38std::ifstream f(re.c_str());
39if(!f.good())
40{
41    throw std::runtime_error("Conversion failed");
42}

Python

В следующем примере показано, как преобразовать EPUB в PNG с использованием языка Python. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете скачать Python SDK из репозитория GitHub.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14options = {
15    'width': 600,
16    'height': 900,
17    'topmargin': 20,
18    'bottommargin': 20,
19    'leftmargin': 20,
20    'rightmargin': 20
21}
22
23try:
24    res = html_api.convertApi.convert_local_to_local(input_file="test.epub", output_file="test.png", options=options)
25except ApiException as ex:
26    print("Exception")
27    print("Info: " + str(ex))
28    raise ex

PHP

В следующем примере показано, как преобразовать EPUB в PNG с применением языка PHP. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется в локальный файл. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.epub';
15$dst = 'output.png';
16
17$options = [
18    'width' => 800,
19    'height' => 600,
20    'left_margin' => 20,
21    'right_margin' => 20,
22    'top_margin' => 20,
23    'bottom_margin' => 20
24];
25
26
27try {
28    // Request to server Api
29    $result = $api_html->convertLocalToLocal($src, $dst, $options);
30    print_r($result);
31} catch (Exception $e) {
32    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
33}
34?>

Ruby

В следующем примере показано, как преобразовать EPUB в PNG используя Ruby. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "test.epub" # String | Source file.
20dst = "test.png"  # String | Result file.
21
22opts = { 
23  width: 700,       # Float | Resulting image width in pixels. 
24  height: 1000,     # Float | Resulting image height in pixels. 
25  left_margin: 40,  # Float | Left resulting image margin in pixels.
26  right_margin: 40, # Float | Right resulting image margin in pixels.
27  top_margin: 50,   # Float | Top resulting image margin in pixels.
28  bottom_margin: 50 # Float | Bottom resulting image margin in pixels.
29}
30
31begin
32  #Convert the HTML file from the local file and save result to the local file.
33  result = api_instance.convert_local_to_local(src, dst, opts)
34  p result
35rescue AsposeHtml::ApiError => e
36  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
37end

Node.js

В следующем примере показано, как преобразовать EPUB в PNG с помощью языка Node.js. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется в локальный файл.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/test.epub"; // {String} Source document.
19var dst = "/path/to/dst/test.png"; // {String} Result document.
20var opts = {
21    'width': 600,
22    'height': 800,
23    'leftMargin': 10,
24    'rightMargin': 20,
25    'topMargin': 30,
26    'bottomMargin': 40
27};
28
29var callback = function(error, data, response) {
30  if (error) {
31    console.error(error);
32  } else {
33    console.log(data);
34  }
35};
36
37conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

В следующем примере показано, как преобразовать EPUB в PNG на Swift. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "test.epub"
27let format = "png"
28let src = url(forResource: fileName).absoluteString
29let options = Options(width: 800, height: 600, leftMargin: 10,
30        rightMargin: 10, topMargin: 10, bottomMargin: 10)
31
32
33let expectation = self.expectation(description: "testConvert to \(format)")
34let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
35HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: options) { (data, error) in
36
37	guard error == nil else {
38		XCTFail("Error convert epub to \(format)). Error=\(error!.localizedDescription)")
39		return
40	}
41	let resultPath = data!.file!
42	XCTAssertTrue(fileExist(name: resultPath))
43	expectation.fulfill()
44}
45self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать EPUB в PNG используя Java/Android. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6ImageConversionOptions opt = new ImageConversionOptions()
 7                        .setWidth(600)
 8                        .setHeight(900)
 9                        .setTopMargin(20)
10                        .setBottomMargin(20)
11                        .setLeftMargin(20)
12                        .setRightMargin(20);
13
14JobBuilder builder = new ConverterBuilder()
15                .fromLocalFile("input.epub")
16                .useOptions(opt)
17                .saveToLocal("output.png");
18
19OperationResult result = api.convert(builder);

CURL

Загрузите локальный файл в хранилище с помощью Storage API.
Вызовите REST API для выполнения преобразования (в примере ниже).
Загрузите результат преобразования обратно из хранилища с помощью Storage API. В следующем примере показано, как преобразовать EPUB в PNG с помощью REST API. EPUB берется из локальной файловой системы, преобразуется в PNG и сохраняется на локальном диске. Пожалуйста, сделайте несколько шагов:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/epub-png" \
3    -d "{'InputPath': '/testpage.epub', 'OutputFile': 'test.png', 'Options': {'Width':1000, 'Height': 800, 'LeftMargin': 10, 'RightMargin': 10, 'TopMargin': 10, 'BottomMargin': 10}}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization: bearer <token>"

Более подробную информацию о доступных параметрах преобразования для файлов EPUB можно найти в статье Параметры конвертации.

Пример 3. Преобразование EPUB в GIF в облачном хранилище

Для тех, кому необходимо преобразовать файл EPUB, хранящийся в облачном хранилище, в формат изображения GIF, процесс выглядит следующим образом. Доступ к файлу EPUB осуществляется из облачного хранилища, он преобразуется в формат GIF, а затем сохраняется обратно в то же место в облачном хранилище.

В следующем примере показано, как преобразовать EPUB в GIF с применением языка C#. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать C# SDK из репозитория GitHub.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert EPUB to GIF
5var builder = new ConverterBuilder()
6                .FromStorageFile("/test.epub")
7                .ToStorageFile("/test.gif");
8                
9var result = await api.ConvertAsync(builder);

Java

В следующем примере показано, как преобразовать EPUB в GIF с применением языка Java. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать Java SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.epub")
 8                .saveToStorage("output.gif");
 9
10OperationResult result = api.convert(builder);

C++

В следующем примере показано, как преобразовать EPUB в GIF с помощью языка C++. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище.

 1const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 2const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 3const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
 4const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
 5
 6// Create configuration for authorization
 7std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
 8
 9// Create client from configuration
10std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
11
12// Create ConversionApi
13std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
14
15// File name for conversion
16utility::string_t src = L"file/in/storage/index.epub";
17utility::string_t dst = L"result/in/storage/result.gif";
18
19// Conversion
20auto result = api->convertStorageToStorage(src, dst);

Python

В следующем примере показано, как преобразовать EPUB в GIF с помощью языка Python. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать Python SDK из репозитория GitHub.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_storage_to_storage(input_file="test.epub", output_file="test.gif",
16                                                         storage_name=None)
17except ApiException as ex:
18    print("Exception")
19    print("Info: " + str(ex))
20    raise ex

PHP

В следующем примере показано, как преобразовать EPUB в GIF с помощью языка PHP. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать PHP SDK из репозитория GitHub.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$configuration = array(
 5    "basePath" => "https://api.aspose.cloud/v4.0",
 6    "authPath" => "https://api.aspose.cloud/connect/token",
 7    "apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8    "appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9    "defaultUserAgent" => "Webkit"
10);
11
12$api_html = new HtmlApi($configuration);
13
14$src = "FolderInStorage/test.epub";
15$dst = 'FolderInStorage/test.gif';
16$options = null;
17
18try {
19    $result = $api_html->convertStorageToStorage($src, $dst, null, $options);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling $api_html->convertStorageToStorage: ', $e->getMessage(), PHP_EOL;
23}
24?>

Ruby

В следующем примере показано, как преобразовать EPUB в GIF на Ruby. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать Ruby SDK из репозитория GitHub.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "FolderInStorage/test.epub" # String | Source file.
20dst = "FolderInStorage/test.gif"  # String | Result file.
21storage = nil
22
23begin
24  #Convert the file from the storage and save result to the storage.
25  result = api_instance.convert_storage_to_storage(src, dst, storage)
26  p result
27rescue AsposeHtml::ApiError => e
28  puts "Exception when calling api_instance.convert_storage_to_storage: #{e}"
29end

Node.js

В следующем примере показано, как преобразовать EPUB в GIF с помощью языка Node.js. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "FolderInStorage/test.epub"; // {String} Source document.
19var dst = "FolderInStorage/test.gif"; // {String} Result document.
20var opts = null;
21var storage = null;
22
23var callback = function(error, data, response) {
24  if (error) {
25    console.error(error);
26  } else {
27    console.log(data);
28  }
29};
30
31conversionApi.convertStorageToStorage(src, dst, storage, opts, callback);

Swift

В следующем примере показано, как преобразовать EPUB в GIF на Swift. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете скачать Swift SDK из репозитория GitHub.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6ClientAPI.setConfig(
 7	basePath: "https://api.aspose.cloud/v4.0",
 8	authPath: "https://api.aspose.cloud/connect/token",
 9	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
10	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
11	debugging: true
12)
13
14let src = "FolderInStorage/test.epub"
15let dst = "FolderInStorage/test.gif"
16
17let expectation = self.expectation(description: "testConvert to gif")
18
19HtmlAPI.convertStorageToStorage(src: src, dst: dst, storage: nil, options: nil) { (data, error) in
20
21    guard error == nil else {
22        XCTFail("Error convert epub to gif. Error=\(error!.localizedDescription)")
23        return
24    }
25
26    let resultPath = data!.file!
27
28    StorageAPI.objectExists(path: resultPath, storageName: nil, versionId: nil) {(data, error) in
29        guard error == nil else {
30            XCTFail("Error objectExists exist. Error=\(error!.localizedDescription)")
31            return
32        }
33
34        XCTAssertTrue(data!.exists)
35        XCTAssertFalse(data!.isFolder)
36        expectation.fulfill()
37    }
38}
39self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

В следующем примере показано, как преобразовать EPUB в GIF с помощью Java/Android. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище. Вы можете загрузить Java/Android SDK из репозитория GitHub.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.epub")
 8                .saveToStorage("output.gif");
 9
10OperationResult result = api.convert(builder);

CURL

В следующем примере показано, как преобразовать EPUB в GIF с помощью REST API. Файл EPUB находится в облачном хранилище, преобразуется в GIF и сохраняется обратно в облачное хранилище.

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/epub-gif" \
3    -d "{'InputPath': '/test.epub', 'OutputFile': '/test.gif'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Смотрите также

Статья Доступные SDK знакомит вас с возможностями Aspose.HTML Cloud использовать SDK на различных языках программирования, таких как C#, Java, Python, Ruby, PHP, Node.js, Swift, Android и C++.
В статье Параметры конвертации описан набор классов, которые представляют параметры преобразования исходного документа на основе HTML в PDF, XPS и изображения.
Облачный API Aspose.HTML можно вызвать непосредственно из браузера, открыв Справочник по API.
Aspose.HTML предлагает бесплатный онлайн EPUB в Image Конвертер, который быстро и качественно преобразует EPUB в изображения. Просто загрузите файлы, конвертируйте их и получите результат за считанные секунды!

Конвертировать EPUB в DOCX MHTML Конвертер