> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/ios/get-started/samples/html2pdftest.md). # HTML2PDF Sample Obj-C code for using Apryse SDK to directly convert HTML pages to PDF using 'pdftron.PDF.HTML2PDF'. The HTML2PDF converter supports conversion from a string or URL and offers many options to co Sample Obj-C code for using Apryse SDK to directly convert HTML pages to PDF by using 'pdftron.PDF.HTML2PDF'. The HTML2PDF converter supports conversion from a string or URL and offers many options to control page size and formatting. Learn more about our [iOS SDK](/ios/guides.md) and [PDF Conversion Library](/core/conversion/conversion.md). {% tabs %} {% tab title="Obj-C" %} {% code lineNumbers="true" %} ```objc //--------------------------------------------------------------------------------------- // Copyright (c) 2001-2024 by Apryse Software Inc. All Rights Reserved. // Consult legal.txt regarding legal and license information. //--------------------------------------------------------------------------------------- #import #import //--------------------------------------------------------------------------------------- // The following sample illustrates how to convert HTML pages to PDF format using // the PTHTML2PDF class. // // 'pdftron.PDF.PTHTML2PDF' is an optional PDFNet Add-On utility class that can be // used to convert HTML web pages into PDF documents by using an external module (html2pdf). // // html2pdf modules can be downloaded from http://www.pdftron.com/pdfnet/downloads.html. // // Users can convert HTML pages to PDF using the following operations: // - Simple one line static method to convert a single web page to PDF. // - Convert HTML pages from URL or string, plus optional table of contents, in user defined order. // - Optionally configure settings for proxy, images, java script, and more for each HTML page. // - Optionally configure the PDF output, including page size, margins, orientation, and more. // - Optionally add table of contents, including setting the depth and appearance. //--------------------------------------------------------------------------------------- int main(int argc, char * argv[]) { @autoreleasepool { int ret = 0; // The first step in every application using PDFNet is to initialize the // library and set the path to common PDF resources. The library is usually // initialized only once, but calling Initialize() multiple times is also fine. [PTPDFNet Initialize: @"YOUR_PDFTRON_LICENSE_KEY"]; // For PTHTML2PDF we need to locate the PTHTML2PDF module. If placed with the // PDFNet library, or in the current working directory, it will be loaded // automatically. Otherwise, it must be set manually using PTHTML2PDF.SetModulePath. [PTHTML2PDF SetModulePath: @"../../../Lib"]; if( ![PTHTML2PDF IsModuleAvailable] ) { NSLog(@"\n"); NSLog(@"Unable to run HTMLPDFTest: Apryse SDK HTML2PDF module not available."); NSLog(@"---------------------------------------------------------------"); NSLog(@"The HTML2PDF module is an optional add-on, available for download"); NSLog(@"at https://www.pdftron.com/. If you have already downloaded this"); NSLog(@"module, ensure that the SDK is able to find the required files"); NSLog(@"using the HTML2PDF::SetModulePath() function."); return 1; } //-------------------------------------------------------------------------------- // Example 1) Simple conversion of a web page to a PDF doc. @try { PTPDFDoc *doc = [[PTPDFDoc alloc] init]; PTHTML2PDF *converter = [[PTHTML2PDF alloc] init]; [converter InsertFromURL: @"https://docs.apryse.com/"]; // now convert a web page, sending generated PDF pages to doc [converter Convert: doc]; [doc SaveToFile: @"../../TestFiles/Output/html2pdf_example_01.pdf" flags: e_ptlinearized]; } @catch (NSException *e) { NSLog(@"%@", e.reason); ret = 1; } //-------------------------------------------------------------------------------- // Example 2) Modify the settings of the generated PDF pages and attach to an // existing PDF document. @try { // open the existing PDF, and initialize the security handler PTPDFDoc *doc = [[PTPDFDoc alloc] initWithFilepath: @"../../TestFiles/numbered.pdf"]; [doc InitSecurityHandler]; // create the PTHTML2PDF converter object and modify the output of the PDF pages PTHTML2PDF *converter = [[PTHTML2PDF alloc] init]; [converter SetPaperSize: e_11x17]; // insert the web page to convert [converter InsertFromURL: @"https://docs.apryse.com/"]; // convert the web page, appending generated PDF pages to doc [converter Convert: doc]; [doc SaveToFile: @"../../TestFiles/Output/html2pdf_example_02.pdf" flags: e_ptlinearized]; } @catch (NSException *e) { NSLog(@"%@", e.reason); ret = 1; } //-------------------------------------------------------------------------------- // Example 3) Convert multiple web pages @try { // convert page 0 into pdf PTPDFDoc *doc = [[PTPDFDoc alloc] init]; PTHTML2PDF *converter = [[PTHTML2PDF alloc] init]; NSString *header = @"
PDFTRON HEADER EXAMPLE
of
"; NSString *footer = @"
PDFTRON FOOTER EXAMPLE
of
"; [converter SetHeader:header]; [converter SetFooter:footer]; [converter SetMargins : @"1cm" bottom:@"2cm" left:@".5cm" right:@"1.5cm"]; PTWebPageSettings *settings = [[PTWebPageSettings alloc] init]; [settings SetZoom : 0.5]; [converter InsertFromURLWithSettings: @"https://docs.apryse.com/" settings: settings]; [converter Convert:doc]; // convert page 1 with the same settings, appending generated PDF pages to doc [converter InsertFromURLWithSettings: @"https://docs.apryse.com/all-products/" settings: settings]; [converter Convert:doc]; // convert page 2 with different settings, appending generated PDF pages to doc PTHTML2PDF *another_converter = [[PTHTML2PDF alloc] init]; [another_converter SetLandscape : YES]; PTWebPageSettings *another_settings = [[PTWebPageSettings alloc] init]; [another_settings SetPrintBackground : NO]; [another_converter InsertFromURLWithSettings: @"https://docs.apryse.com/web/faq" settings: another_settings]; [another_converter Convert:doc]; [doc SaveToFile: @"../../TestFiles/Output/html2pdf_example_03.pdf" flags: e_ptlinearized]; } @catch (NSException *e) { NSLog(@"%@", e.reason); ret = 1; } //-------------------------------------------------------------------------------- // Example 4) Convert HTML string to PDF. @try { PTPDFDoc *doc = [[PTPDFDoc alloc] init]; PTHTML2PDF *converter = [[PTHTML2PDF alloc] init]; // Our HTML data NSString *html = @"

Heading

Paragraph.

"; // Add html data [converter InsertFromHtmlString: html]; // Note, InsertFromHtmlString can be mixed with the other Insert methods. [converter Convert: doc]; [doc SaveToFile: @"../../TestFiles/Output/html2pdf_example_04.pdf" flags: e_ptlinearized]; } @catch (NSException *e) { NSLog(@"%@", e.reason); ret = 1; } //-------------------------------------------------------------------------------- // Example 5) Set the location of the log file to be used during conversion. @try { PTPDFDoc *doc = [[PTPDFDoc alloc] init]; PTHTML2PDF *converter = [[PTHTML2PDF alloc] init]; [converter SetLogFilePath: @"../../TestFiles/Output/html2pdf.log"]; [converter InsertFromURL: @"https://docs.apryse.com/"]; [converter Convert: doc]; [doc SaveToFile: @"../../TestFiles/Output/html2pdf_example_05.pdf" flags: e_ptlinearized]; } @catch (NSException *e) { NSLog(@"%@", e.reason); ret = 1; } [PTPDFNet Terminate: 0]; return ret; } } ``` {% endcode %} {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.apryse.com/ios/get-started/samples/html2pdftest.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.