Conversion Options – Aspose.HTML Cloud SDK

Aspose.HTML Cloud presents the simplest API to convert an HTML page to one of the fixed-layout document formats including PDF, XPS, DOC, DOCX; to MD and MHTML formats; to one of the raster image formats such as JPEG, PNG, TIFF, BMP, and GIF.

Aspose.HTML Cloud SDK family provides a set of classes that represent the conversion options. Conversion options allow you to customize the conversion process. You can specify the file page size, margins, etc. This article describes a set of classes that represent conversion options for PDF, XPS and Images.

PDF Conversion Options

1var options = new PDFConversionOptions()
2   .SetHeight(11.7)
3   .SetWidth(8.3)
4   .SetLeftMargin(0.5)
5   .SetRightMargin(0.5)
6   .SetBottomMargin(0.5)
7   .SetTopMargin(0.5);

Name	Type	Description	Notes
Width	Number	Resulting document page width in inches.	[optional]
Height	Number	Resulting document page height in inches.	[optional]
LeftMargin	Number	Left resulting document page margin in inches.	[optional]
RightMargin	Number	Right resulting document page margin in inches.	[optional]
TopMargin	Number	Top resulting document page margin in inches.	[optional]
BottomMargin	Number	Bottom resulting document page margin inches.	[optional]

Java

1PDFConversionOptions opt_A5 = new PDFConversionOptions()
2    .setWidth(5.8)
3    .setHeight(8.3)
4    .setTopMargin(0.5)
5    .setBottomMargin(0.5)
6    .setLeftMargin(0.5)
7    .setRightMargin(0.5)
8    .setQuality(95);

Name	Type	Description	Notes
width	Optional<Double>	Resulting document page width in inches.	[optional]
height	Optional<Double>	Resulting document page height in inches.	[optional]
leftMargin	Optional<Double>	Left resulting document page margin in inches.	[optional]
rightMargin	Optional<Double>	Right resulting document page margin in inches.	[optional]
topMargin	Optional<Double>	Top resulting document page margin in inches.	[optional]
bottomMargin	Optional<Double>	Bottom resulting document page margin in inches.	[optional]
jpegQuality	Optional<Integer>	Quality of jpeg compression in percent.	[optional]

C++

1    std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
2    opts->setWidth(8.3)
3        ->setHeight(11.7)
4        ->setLeftMargin(0.2)
5        ->setRightMargin(0.2)
6        ->setTopMargin(0.2)
7        ->setBottomMargin(0.2)
8        ->setJpegQuality(95);

Method	Description	Note
*ConversionOptions ConversionOptions::setWidth(double value)**	Width in inches.	[optional]
*ConversionOptions ConversionOptions::setHeight(double value)**	Height in inches.	[optional]
*ConversionOptions ConversionOptions::setLeftMargin(double value)**	Left margin in inches.	[optional]
*ConversionOptions ConversionOptions::setRightMargin(double value)**	Right margin in inches.	[optional]
*ConversionOptions ConversionOptions::setTopMargin(double value)**	Top margin in inches.	[optional]
*ConversionOptions ConversionOptions::setBottomMargin(double value)**	Bottom margin in inches.	[optional]
*ConversionOptions ConversionOptions::setJpegQuality(int value)**	Quality in percent.	[optional]

Python

1options = {
2    'width': 8.3,
3    'height': 11.7,
4    'topmargin': 0.2,
5    'bottommargin': 0.2,
6    'leftmargin': 0.2,
7    'rightmargin': 0.2,
8    'jpegquality': 95
9}

Field	Type	Description	Note
width	float	Width in inches	Optional
height	float	Height in inches	Optional
leftmargin	float	Left margin in inches	Optional
rightmargin	float	Right margin in inches	Optional
topmargin	float	Top margin in inches	Optional
bottommargin	float	Bottom margin in inches	Optional
jpegquality	int	Quality in percent	Optional
background	str	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

PHP

1$options_a4 = [
2    'width' => 8.3,
3    'height' => 11.7,
4    'left_margin' => 0.2,
5    'right_margin' => 0.2,
6    'top_margin' => 0.2,
7    'bottom_margin' => 0.2
8];

Field	Type	Description	Note
width	float	Width in inches	Optional
height	float	Height in inches	Optional
left_margin	float	Left margin in inches	Optional
right_margin	float	Right margin in inches	Optional
top_margin	float	Top margin in inches	Optional
bottom_margin	float	Bottom margin in inches	Optional
jpeg_quality	int	Quality in percent	Optional
background	str	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Ruby

1opts = { 
2  width: 8.3,
3  height: 11.7,
4  left_margin: 0.2,
5  right_margin: 0.2,
6  top_margin: 0.2,
7  bottom_margin: 0.2
8}

Field	Type	Description	Note
width	Float	Width in inches	Optional
height	Float	Height in inches	Optional
left_margin	Float	Left margin in inches	Optional
right_margin	Float	Right margin in inches	Optional
top_margin	Float	Top margin in inches	Optional
bottom_margin	Float	Bottom margin in inches	Optional
jpeg_quality	Integer	Quality in percent	Optional
background	String	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Node.js

1var opts_A4 = {
2    'width': 8.3,
3    'height': 11.7,
4    'leftMargin': 0.2,
5    'rightMargin': 0.2,
6    'topMargin': 0.2,
7    'bottomMargin': 0.2,
8    'jpegquality': 95
9};

Field	Type	Description	Note
width	Number	Width in inches	Optional
height	Number	Height in inches	Optional
leftmargin	Number	Left margin in inches	Optional
rightmargin	Number	Right margin in inches	Optional
topmargin	Number	Top margin in inches	Optional
bottommargin	Number	Bottom margin in inches	Optional
jpegquality	Number	Quality in percent	Optional
background	String	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Swift

1let options = Options(width: 8.3, height: 11.7, leftMargin: 0.2,
2        rightMargin: 0.2, topMargin: 0.2, bottomMargin: 0.2)

Name	Type	Description	Notes
width	Float32?	Resulting width in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
height	Float32?	Resulting height in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
leftMargin	Float32?	Left margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
rightMargin	Float32?	Right margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
topMargin	Float32?	Top margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
bottomMargin	Float32?	Bottom margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
jpegquality	Int32?	JPEG quality images in percent for PDF output format.	[optional]
background	String?	CSS background like ‘#FF0000’. For conversion from SVG only.	[optional]

Java/Android

1PDFConversionOptions opt_A5 = new PDFConversionOptions()
2    .setWidth(5.8)
3    .setHeight(8.3)
4    .setTopMargin(0.5)
5    .setBottomMargin(0.5)
6    .setLeftMargin(0.5)
7    .setRightMargin(0.5)
8    .setQuality(95);

Name	Type	Description	Notes
width	Optional<Double>	Resulting document page width in inches.	[optional]
height	Optional<Double>	Resulting document page height in inches.	[optional]
leftMargin	Optional<Double>	Left resulting document page margin in inches.	[optional]
rightMargin	Optional<Double>	Right resulting document page margin in inches.	[optional]
topMargin	Optional<Double>	Top resulting document page margin in inches.	[optional]
bottomMargin	Optional<Double>	Bottom resulting document page margin in inches.	[optional]
jpegQuality	Optional<Integer>	Quality of jpeg compression in percent.	[optional]

How to apply conversion options to convert HTML to PDF is described in the SDK examples in the Convert HTML to PDF article.

XPS Conversion Options

1var options = new XPSConversionOptions()
2   .SetHeight(8.3)
3   .SetWidth(5.8)
4   .SetLeftMargin(0.5)
5   .SetRightMargin(0.5)
6   .SetBottomMargin(0.5)
7   .SetTopMargin(0.5);

Name	Type	Description	Notes
Width	Number	Resulting document page width in inches.	[optional]
Height	Number	Resulting document page height in inches.	[optional]
LeftMargin	Number	Left resulting document page margin in inches.	[optional]
RightMargin	Number	Right resulting document page margin in inches.	[optional]
TopMargin	Number	Top resulting document page margin in inches.	[optional]
BottomMargin	Number	Bottom resulting document page margin inches.	[optional]

Java

1XPSConversionOptions xpsOpts_A5 = new XPSConversionOptions()
2    .setHeight(8.3)
3    .setWidth(5.8)
4    .setLeftMargin(0.5)
5    .setRightMargin(0.5)
6    .setBottomMargin(0.5)
7    .setTopMargin(0.5);

Name	Type	Description	Notes
width	Optional<Double>	Resulting document page width in inches.	[optional]
height	Optional<Double>	Resulting document page height in inches.	[optional]
leftMargin	Optional<Double>	Left resulting document page margin in inches.	[optional]
rightMargin	Optional<Double>	Right resulting document page margin in inches.	[optional]
topMargin	Optional<Double>	Top resulting document page margin in inches.	[optional]
bottomMargin	Optional<Double>	Bottom resulting document page margin in inches.	[optional]

C++

1    std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
2    opts->setWidth(8.3)
3        ->setHeight(11.7)
4        ->setLeftMargin(0.2)
5        ->setRightMargin(0.2)
6        ->setTopMargin(0.2)
7        ->setBottomMargin(0.2);

Method	Description	Note
*ConversionOptions ConversionOptions::setWidth(double value)**	Width in inches.	[optional]
*ConversionOptions ConversionOptions::setHeight(double value)**	Height in inches.	[optional]
*ConversionOptions ConversionOptions::setLeftMargin(double value)**	Left margin in inches.	[optional]
*ConversionOptions ConversionOptions::setRightMargin(double value)**	Right margin in inches.	[optional]
*ConversionOptions ConversionOptions::setTopMargin(double value)**	Top margin in inches.	[optional]
*ConversionOptions ConversionOptions::setBottomMargin(double value)**	Bottom margin in inches.	[optional]

Python

1options = {
2    'width': 8.3,
3    'height': 11.7,
4    'topmargin': 0.2,
5    'bottommargin': 0.2,
6    'leftmargin': 0.2,
7    'rightmargin': 0.2
8}

Field	Type	Description	Note
width	float	Width in inches	Optional
height	float	Height in inches	Optional
leftmargin	float	Left margin in inches	Optional
rightmargin	float	Right margin in inches	Optional
topmargin	float	Top margin in inches	Optional
bottommargin	float	Bottom margin in inches	Optional

PHP

1$options_a4 = [
2    'width' => 8.3,
3    'height' => 11.7,
4    'left_margin' => 0.2,
5    'right_margin' => 0.2,
6    'top_margin' => 0.2,
7    'bottom_margin' => 0.2
8];

Field	Type	Description	Note
width	float	Width in inches	Optional
height	float	Height in inches	Optional
left_margin	float	Left margin in inches	Optional
right_margin	float	Right margin in inches	Optional
top_margin	float	Top margin in inches	Optional
bottom_margin	float	Bottom margin in inches	Optional

Ruby

1opts = { 
2  width: 8.3,
3  height: 11.7,
4  left_margin: 0.2,
5  right_margin: 0.2,
6  top_margin: 0.2,
7  bottom_margin: 0.2
8}

Field	Type	Description	Note
width	Float	Width in inches	Optional
height	Float	Height in inches	Optional
left_margin	Float	Left margin in inches	Optional
right_margin	Float	Right margin in inches	Optional
top_margin	Float	Top margin in inches	Optional
bottom_margin	Float	Bottom margin in inches	Optional

Node.js

1var opts_A4 = {
2    'width': 8.3,
3    'height': 11.7,
4    'leftMargin': 0.2,
5    'rightMargin': 0.2,
6    'topMargin': 0.2,
7    'bottomMargin': 0.2
8};

Field	Type	Description	Note
width	Number	Width in inches	Optional
height	Number	Height in inches	Optional
leftmargin	Number	Left margin in inches	Optional
rightmargin	Number	Right margin in inches	Optional
topmargin	Number	Top margin in inches	Optional
bottommargin	Number	Bottom margin in inches	Optional

Swift

1let options = Options(width: 8.3, height: 11.7, leftMargin: 0.2,
2        rightMargin: 0.2, topMargin: 0.2, bottomMargin: 0.2)

Name	Type	Description	Notes
width	Float32?	Resulting width in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
height	Float32?	Resulting height in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
leftMargin	Float32?	Left margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
rightMargin	Float32?	Right margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
topMargin	Float32?	Top margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
bottomMargin	Float32?	Bottom margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]

Java/Android

1XPSConversionOptions xpsOpts_A5 = new XPSConversionOptions()
2    .setHeight(8.3)
3    .setWidth(5.8)
4    .setLeftMargin(0.5)
5    .setRightMargin(0.5)
6    .setBottomMargin(0.5)
7    .setTopMargin(0.5);

Name	Type	Description	Notes
width	Optional<Double>	Resulting document page width in inches.	[optional]
height	Optional<Double>	Resulting document page height in inches.	[optional]
leftMargin	Optional<Double>	Left resulting document page margin in inches.	[optional]
rightMargin	Optional<Double>	Right resulting document page margin in inches.	[optional]
topMargin	Optional<Double>	Top resulting document page margin in inches.	[optional]
bottomMargin	Optional<Double>	Bottom resulting document page margin in inches.	[optional]

How to apply conversion options to convert HTML to XPS is described in the SDK examples in the Convert HTML to XPS article.

Image Conversion Options

1var options = new ImageConversionOptions()
2   .SetHeight(800)
3   .SetWidth(1000)
4   .SetLeftMargin(10)
5   .SetRightMargin(10)
6   .SetBottomMargin(10)
7   .SetTopMargin(10);

Name	Type	Description	Notes
Width	Number	Resulting document page width in pixels.	[optional]
Height	Number	Resulting document page height in pixels.	[optional]
LeftMargin	Number	Left resulting document page margin in pixels.	[optional]
RightMargin	Number	Right resulting document page margin in pixels.	[optional]
TopMargin	Number	Top resulting document page margin in pixels.	[optional]
BottomMargin	Number	Bottom resulting document page margin pixels.	[optional]

Java

1ImageConversionOptions opts = new ImageConversionOptions()
2    .setHeight(800)
3    .setWidth(1000)
4    .setLeftMargin(10)
5    .setRightMargin(10)
6    .setBottomMargin(10)
7    .setTopMargin(10);

Name	Type	Description	Notes
width	Optional<Integer>	Resulting document page width in pixels.	[optional]
height	Optional<Integer>	Resulting document page height in pixels.	[optional]
leftMargin	Optional<Integer>	Left resulting document page margin in pixels.	[optional]
rightMargin	Optional<Integer>	Right resulting document page margin in pixels.	[optional]
topMargin	Optional<Integer>	Top resulting document page margin in pixels.	[optional]
bottomMargin	Optional<Integer>	Bottom resulting document page margin in pixels.	[optional]

C++

1    std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
2    opts->setWidth(800)
3        ->setHeight(600)
4        ->setLeftMargin(20)
5        ->setRightMargin(20)
6        ->setTopMargin(20)
7        ->setBottomMargin(20);

Method	Description	Note
*ConversionOptions ConversionOptions::setWidth(double value)**	Width in pixels.	[optional]
*ConversionOptions ConversionOptions::setHeight(double value)**	Height in pixels.	[optional]
*ConversionOptions ConversionOptions::setLeftMargin(double value)**	Left margin in pixels.	[optional]
*ConversionOptions ConversionOptions::setRightMargin(double value)**	Right margin in pixels.	[optional]
*ConversionOptions ConversionOptions::setTopMargin(double value)**	Top margin in pixels.	[optional]
*ConversionOptions ConversionOptions::setBottomMargin(double value)**	Bottom margin in pixels.	[optional]

Python

1options = {
2    'width': 600,
3    'height': 900,
4    'topmargin': 20,
5    'bottommargin': 20,
6    'leftmargin': 20,
7    'rightmargin': 20,
8    'jpegquality': 95
9}

Field	Type	Description	Note
width	int	Width in pixel	Optional
height	int	Height in pixel	Optional
leftmargin	int	Left margin in pixel	Optional
rightmargin	int	Right margin in pixel	Optional
topmargin	int	Top margin in pixel	Optional
bottommargin	int	Bottom margin in pixel	Optional
background	str	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

PHP

1$options = [
2    'width' => 800,
3    'height' => 600,
4    'left_margin' => 20,
5    'right_margin' => 20,
6    'top_margin' => 20,
7    'bottom_margin' => 20
8];

Field	Type	Description	Note
width	int	Width in pixel	Optional
height	int	Height in pixel	Optional
left_margin	int	Left margin in pixel	Optional
right_margin	int	Right margin in pixel	Optional
top_margin	int	Top margin in pixel	Optional
bottom_margin	int	Bottom margin in pixel	Optional
background	str	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Ruby

1opts = { 
2  width: 700,
3  height: 1000,
4  left_margin: 40,
5  right_margin: 40,
6  top_margin: 50,
7  bottom_margin: 50
8}

Field	Type	Description	Note
width	Integer	Width in pixel	Optional
height	Integer	Height in pixel	Optional
left_margin	Integer	Left margin in pixel	Optional
right_margin	Integer	Right margin in pixel	Optional
top_margin	Integer	Top margin in pixel	Optional
bottom_margin	Integer	Bottom margin in pixel	Optional
background	String	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Node.js

1var opts = {
2    'width': 600,
3    'height': 800,
4    'leftMargin': 10,
5    'rightMargin': 20,
6    'topMargin': 30,
7    'bottomMargin': 40
8};

Field	Type	Description	Note
width	Number	Width in pixel	Optional
height	Number	Height in pixel	Optional
leftmargin	Number	Left margin in pixel	Optional
rightmargin	Number	Right margin in pixel	Optional
topmargin	Number	Top margin in pixel	Optional
bottommargin	Number	Bottom margin in pixel	Optional
background	String	CSS background like ‘#FF0000’. For conversion from SVG only	Optional

Swift

1let options = Options(width: 800, height: 1200, leftMargin: 20,
2        rightMargin: 20, topMargin: 20, bottomMargin: 20)

Name	Type	Description	Notes
width	Float32?	Resulting width in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
height	Float32?	Resulting height in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
leftMargin	Float32?	Left margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
rightMargin	Float32?	Right margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
topMargin	Float32?	Top margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
bottomMargin	Float32?	Bottom margin in pixels for images and in inches for PDF, XPS, DOCX formats.	[optional]
background	String?	CSS background like ‘#FF0000’. For conversion from SVG only.	[optional]

Java/Android

1ImageConversionOptions opts = new ImageConversionOptions()
2    .setHeight(800)
3    .setWidth(1000)
4    .setLeftMargin(10)
5    .setRightMargin(10)
6    .setBottomMargin(10)
7    .setTopMargin(10);

Name	Type	Description	Notes
width	Optional<Integer>	Resulting document page width in pixels.	[optional]
height	Optional<Integer>	Resulting document page height in pixels.	[optional]
leftMargin	Optional<Integer>	Left resulting document page margin in pixels.	[optional]
rightMargin	Optional<Integer>	Right resulting document page margin in pixels.	[optional]
topMargin	Optional<Integer>	Top resulting document page margin in pixels.	[optional]
bottomMargin	Optional<Integer>	Bottom resulting document page margin in pixels.	[optional]

How to apply conversion options to convert HTML to Image is described in the SDK examples in the Convert HTML to Image article.

XHTML Converter