This section will highlight different aspects of customization provided. It is recommended to look into the previous section regarding the export first.
Branding the viewer
If you want to provide your own company branding simply copy and edit
- Register specific callbacks.
- Access document parameters.
- Create you own controls.
To that extent, some elements must be present in the source page:
<head> section must reference the correct stylesheets:
The page body must declare a
<div> with the corresponding attributes and immediately include the API scripts:
beacon in the viewer file but after['MONOLITHICHTML_END']
beacon). To set those, useHoops.WebViewerOptions<tt>variable that contains everything handled. Some options are specific to the 3D annotations and can be found inModelViewerOptions` subsection.
Inside PDF files, metadata are stored in the file information structure. By default, when exporting the PDF to web format the metadata will be stored in
<meta> HTML tags with their name and content.
Though, Hoops Publish offers a way to edit them during the process of exporting to web format. When calling A3DConvertPDFToWebFormat, you may fill A3DRWParamsExportHtmlData with additional parameters :
- m_pOutputDocumentMetaTags : is a C array of A3DRwHtmlMetaTag elements which are composed of a name and a content string.
- m_uiOutputDocumentMetaTagsCount : the number of A3DRwHtmlMetaTag elements in the C array.
To add a meta information, create and insert A3DRwHtmlMetaTag element in the C array.
To edit an existing meta information inside the PDF, create and insert A3DRwHtmlMetaTag element with the same name of the meta information to edit but with a different content string.
To remove an existing meta information inside the PDF, create and insert A3DRwHtmlMetaTag element with the same name of the meta information to remove but with a NULL content.
Title of the web page
Hoops Publish offers a way to entitle the web page. To do so, feed the title name to m_pcOutputDocumentTitle.
If no title is given to m_pcOutputDocumentTitle, Hoops Publish looks into the metadata for one named 'title'.
If no title is given to m_pcOutputDocumentTitle and no meta data with the name 'title' has been found, the title will be the name of the PDF file.