HOOPS Publish Release Notes

Fixed Bugs List  |  Deprecated List


License Key

HOOPS Publish 2020 requires a license key specifically generated for 2020. Licenses generated for previous versions of HOOPS Publish will not work. Please visit the HOOPS Publish download page to generate a new key. Once you have generated a new CustomerKey and VariableKey, you should copy them into include/hoops_license.h.

The expiration date for the generated license key is tied to your contract with Tech Soft 3D. If you have signed a license agreement for HOOPS Publish, then the license key that is generated will be a perpetual (non-expiring) license key. If you are evaluating HOOPS Publish, then the license key will expire when your evaluation expires. Evaluation license keys will expire at the end of the evaluation period and are not suitable for production software. Any software that uses an evaluation license key will no longer work after the evaluation period.

HOOPS Publish releases are not binary compatible with older releases. You must recompile your application when updating to a new version of HOOPS Publish.


HOOPS Exchange 2020 SP2

Updated PDF Lib

We updated HOOPS Publish PDF Library dependencies to Datalogics Adobe PDF Library 18.0. The changes targets several vulnerability issues. This will impact the binary distribution of your deployements with removed and added library files.

See also

New behaviour with fonts and text management

With the release of HOOPS Publish 2019 SP2 we added a new enumeration for A3DPDFELanguage: kA3DPDFLangAutoDetect which avoids necessity of specifying a language and encoding. This enumeration is part of A3DPDFTextDataEx fields.

Now, this field can only be set to kA3DPDFLangAutoDetect.

See also

Checkbox columns for Datatables

A3DPDFScrollTableData columns can now have checkboxes as column types. This is done by setting the column type to kA3DPDFCheckBoxContent.

Moreover, it is possible to associate an instance of A3DPDFCheckBox to an A3DPDFScrollTable column of checkboxes in order to provide a "toggle all column" behaviour.

See also

Bug fixes

The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2020 SP1 U1

The U1 update is a bug fix release for HOOPS Exchange.


HOOPS Publish 2020 SP1

HTML Export API Changes

We changed the interface for HTML export on offline mode. Creating an offline single-file HTML output is now integrated into the API, thus removing the need for an external Python script.

As a consequence, the script convert_offline.py which served this purpose has been removed from the development package.

Please check our Programming Guide for more information.

See Also

New Navigate to model feature

We added a new feature for your PDF interfaces which allows an associated view to focus on a selected model. This is done by providing the user with a checkbox wich enables/disable this automatic focus mode.

For more information, see the A3DPDFCheckBoxSetForFitSelectedMode function.

Option to toggle transition animation

By default, transitionning from a view to another is animated by your PDF reader. It is now possible to deactivate the animation with the new A3DPDF3DViewListEnableViewTransitions function.

Bug fixes

The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2020 U1

Platform Fix

This release contains a bug fix addressed to the GNU/Linux package which corrects an incompatibility issue towards Centos 7 build tools.

Upgraded FreeType dependency

The FreeType library is upgraded from 2.8 to 2.10.1.

Bug fixes

The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2020

Removed ImageMagick and ICU 3.6

HOOPS Exchange does not require ImageMagick nor ICU 3.6 any longer. Thus the following libraries are not part of the package anymore and can be safely removed from your distribution:

Because of the removal of ImageMagick, the following image formats are not supported anymore by our readers:

See also

Bug fixes

The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2019 SP2 U2

We provide a new update for HOOPS Exchange, the core component of HOOPS Publish. This update provides mainly bug fixes for Exchange and no new content for Publish.


HOOPS Publish 2019 SP2 U1

The U1 update is a bug fix release. The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2019 SP2

Improvements in fonts and text management

We made improvements in how fonts can be used, allowing the use of system or installed fonts. Check out our page layout section in the Programming Guide:

Embed a video in a PDF

We added a new API for video embedding into PDF documents.

To support video embedding, we've created a new entity: A3DPDFRichMediaAnnot. With this object you will be able to customize the behavior and appearance of an integrated video.

Two new functions are also available:

See also

Controlling the dash pattern for graphics

The new A3DPDFDashPatternData structure allows a fine-grained configuration of the dash pattern when used in the following structures:

See also

Bug fixes

The list of fixed bugs can be found on the fixed bugs page.


HOOPS Publish 2019 SP1 U1

Binaries updates

ICU 58 is no longer required by our binaries. Thus icudt58.dll and icuuc58.dll can be safely removed from your binaries distribution.

Imagemagick has been updated to version 7.0.8-34.

See also

Fixed Bugs

A li st of fixed bugs can be found on the Fixed Bugs page.


HOOPS Publish 2019 SP1

API Changes

We fixed a typo in the \ref `A3DPDFPageData2` structure. `m_iPageHeigth` is now `m_iPageHeight`.

Bug fixes

The list of fixed bugs can be found on [the fixed bugs page](https://docs.techsoft3d.com/publish/latest/build/overview/fixed_bugs.html). \n

HOOPS Publish 2019 U1

HOOPS Publish 2019 Update 1 is a bug fix release only.



HOOPS Publish 2019

Web Format Export

We added a new feature for converting a PDF to an HTML document, which includes two new API functions:

The HTML document can be viewed online or offline from any compatible web browser. All the content of the 3D PDF document such as 3D annotations, widgets, controls and the various types of interactivity are managed and maintained in the resulting HTML document.

This function is available as part of HOOPS Publish Advanced module.

Please see the Programming Guide for more information.

New PDF Security Features

We added a new security-related function: A3DPDFDocumentSetPasswordSecurity().

This function can secure a PDF Document by requiring a password for reading it. In addition, PDF documents can be further secured by defining an owner password and a permissions field that give the document author the ability to control whether the document may be edited, saved, copied or printed.

As part of this change, the functions A3DPDFDocumentSetPassword() and A3DPDFDocumentSetDocumentPermissions() are now deprecated.

Please see the Programming Guide for more information.

Graphics Driver Selection

By default, HOOPS Publish tries selecting the graphics driver according to these priorities:

We added a new environment variable named A3DPOSTERDRV which can be set to one of:

Text Display Width Calculation

We added a new function named A3DPDFTextGetWidth(). It calculates the length of a string. It simplifies text insertion depending on an expected alignment.

Fixed Bugs

Issue NumberDescription
31589Fix PMI cross highlight issue when PMI is selected from a scroll table
32922Snapshots generation time improvement (call to API A3DPDFMakeSnapshotFromModelFile())

HOOPS Publish 2018 SP2 U2

HOOPS Publish 2018 SP2 U2 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
32629HTML Export: Fix server template
32433

PMI highlight: Fix issue

  



HOOPS Publish 2018 SP2 U1

HOOPS Publish 2018 SP2 U1 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
32169Fix Font size poster size in carousel buttons
31245Update documentation for A3DPDFDocumentUpdateData

HOOPS Publish 2018 SP2

New Features and Enhancements

Custom Actions in Data Model. Custom actions are now available for scroll tables. In the C++ code for defining Data Model interactivity, you can now add a custom Javascript action that will be activated whenever a user clicks on a cell.

For more information on how to implement custom actions, please see the Programming Guide.

Custom Colors in Scroll Tables. It is now possible to add background colors and border colors to tables and individual cells. Please see the Programming Guide for an example of how to do this.

Functional Changes

QT Dependency Removed. QT is no longer being used to draw the grid for scroll tables, and therefore it is no longer necessary for customers using scroll tables to install or distribute QT.

However, if you are using the deprecated slide tables or other html-based tables, TableToPDF and QT are still necessary.

Notification about the A3DMiscReferenceOnTopologyCreate function. As stated in previous release notes, creating a A3DMiscReferenceOnTopologyData on tessellated entities is not supported anymore. Customers should consider using the function A3DMiscReferenceOnTessCreate instead. Please refer to the new sample code in the CreatePRCCubes sample.

Fixed Bugs

Issue NumberDescription
31794Fix A3DPDF3DArtworkCreate2 issue with PMI Cross Highlight
30979Fix A3DPDFDocumentSetInformation issue when data fields are initialized but not set
31614Fix A3DPDF3DArtworkCreate2 crash with U3D input and PMI Cross Highlight
27514Fix regression on rendering mode used for PRC views
31418Enhancement of listbox (acrobat widget) to have a correct usage of slider




HOOPS Publish 2018 SP1 U1

HOOPS Publish 2018 SP1 U1 is a bug-fix release only.




HOOPS Publish 2018 SP1

New Features and Enhancements

Functionality Enhancements

Notification about the A3DMiscReferenceOnTopologyCreate function. Creating a A3DMiscReferenceOnTopologyData on tessellated entities will not be supported starting with the next release (2018 SP2). Customers should consider using the function A3DMiscReferenceOnTessCreate instead. Please refer to the new sample code in the CreatePRCCubes sample.

Fixed Bugs

Issue NumberDescription
30120Enables 3D PDF reports to be combined into single PDF document
30263A3DPDFDocumentAppendPageFromPDFFileEx causes uncatchable crash
30531Possibility to disable the automatic set of the default view by javascript at file opening
30737Enables saving the PDF document to a file without locking it
30861Reset color per view after PMI cross highlight



HOOPS Publish 2018 U3

HOOPS Publish 2018 U3 is a bug-fix release only.


HOOPS Publish 2018 U2

HOOPS Publish 2018 U2 is a bug-fix release only.


HOOPS Publish 2018 U1

HOOPS Publish 2018 U1 is a bug-fix release only.



<a id="toc_2018"class="anchor" id="2018_Changes">

HOOPS Publish 2018

New Features and Enhancements

Fixed Bugs

Issue NumberDescription
29285View in PDF is different between 2017 and 2017SP1
30051Adobe Reader/Acrobat crash when opening the published PDF

License Key Update

Important: A new license key specifically generated for HOOPS Publish 2018 and above is required. Licenses generated for previous versions will not work. Please visit the HOOPS Publish download page to generate a new key.

In addition, the header file downloaded from the Developer Zone has been renamed from A3DSDKLicenseKey.h to hoops_license.h. Please remove old A3DSDKLicenseKey.h files.

Lastly, A3DLicPutLicense(), A3DLicPutPRCLicense() and A3DLicPutLicenseFile() have been replaced by A3DLicPutUnifiedLicense(). Please note, the return type and parameters for A3DLicPutUnifiedLicense() are different from the functions it is replacing.

Visual Studio 2015

As mentioned in the 2017 SP1 release notes, we have discontinued the Visual Studio 2013 package. This does not mean that you have to use Visual Studio 2015 to compile your projects, since HOOPS Publish binaries and functions are dynamically linked with your application using GetProcAddress mechanisms. Therefore, you just need to make sure that the VS 2015 redistributable package is included with your application. Links to the redistributable packages are available in the Publish "Downloads" section of our Developer Zone.




<a id="toc_2017SP2U2"class="anchor" id="2017_SP2_U2_Changes">

HOOPS Publish 2017 SP2 U2

HOOPS Publish 2017 SP2 U2 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
29593Cyrillic characters get lost at Step Export
29735Color overwrite issue using markuplinked item



HOOPS Publish 2017 SP2 U1

HOOPS Publish 2017 SP2 U1 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
29639Font error issue in Adobe Acrobat



HOOPS Publish 2017 SP2

Functional Changes

Linked item transformations. If a Linked Item has a child element that is transformed in a View, the child element will now be transformed relative to its parent. Previously, child elements were transformed using World Space coordinates.

Enhancements

Images and buttons in the DataModel.

Pictures and buttons can now be managed like text and be interactively changed through the data model. This means it is now possible to:

Images and Icons on Buttons

Images and Icons can be created from files or from a buffer in memory. See the functions A3DPDFImageCreateFromFile, A3DPDFImageCreateFromStream, A3DPDFDocumentAddImageAsIcon2, and A3DPDFPageInsertImage2 .

Export

STL

Units. By default, there are no units in an STL file. Previously, HOOPS Publish assumed that the generated STL file would use the initial CAD model unit. There is now an option to force the implicit unit used. See A3DRWParamsExportStlData for more details.

Step

HOOPS Publish users can now:

Package Changes

The list of DLLs to distribute on 64-bit Windows has changed. sc_utils.dll is no longer mandatory for HOOPS Publish users who want to export 3D Data into HTML or SCS.

Last but not least, check out our new PDF showcase, LayerDataModelDemo.pdf in the INSTALL_DIR directory.



HOOPS Publish 2017 SP1 U2

Enhancement


HOOPS Publish 2017 SP1 U1

Fixed Bugs

Enhancements on Linux


HOOPS Publish 2017 SP1

New Functionality

View and Interrogate 3D Models in a Browser

HOOPS Publish can now be used to load 3D Models in a browser without installing any plug-ins.

See Viewing and Interrogating 3D Models in the Browser in our programming guide for more information.


Create Advanced Widgets in PDF Documents Using Layers

New functionality has been added to create and manage layers inside a PDF. Objects such as pictures, text, tables, fields, and lists can be included in these layers.

Also, widgets like the tab panel can typically be created using this functionality. See the Layer module in our API Reference or our new CMM sample for more information.

Enhancements

Data Model

We have made improvements to automatically initialize fields in PDF files that have been created using our Data Model.

Special Notes

Compilation update: const qualifiers have been removed from structure fields. This change may generate some compiler errors in your code and require some minor adjustments.

Packaging update: We now offer two packages on Windows for the following compilers:

Please note, the Visual Studio 2013 package will be discontinued in HOOPS Publish 2018 (to be released in November 2017).

We also offer two packages on Linux for the following operating systems and compilers:

The CentOS 5.11 package will be discontinued in HOOPS Publish 2018 (November 2017).

If you have any concerns with these changes, please contact our support team.




HOOPS Publish 2017 U2

HOOPS Publish 2017 U2 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
26075Publish template: fix issue with data field
26843SLW unit in Incremental load: fix issue
27764SLW Physical properties unit: fix issue
27799JT Brep face creation error: loading tessellation instead of B-Rep
28025ACIS Export: fix issue
28029Poster Generation Improvement in memory management
28116JT Brep face creation error: loading tessellation instead of B-Rep



HOOPS Publish 2017 U1

HOOPS Publish 2017 U1 is a bug-fix release only.

Fixed Bugs

Issue NumberDescription
26843Solidworks Config product occurrence importing in mm.
27764For SolidWorks files physical property can be given in the wrong unit.



HOOPS Publish 2017

Export

On top of creating PRC, U3D, and rich 3D PDF documents, HOOPS Publish can now export 3D data to the following standard 3D formats:

Packaging

HOOPS Publish functionality has been split into two categories: standard and advanced functionality. The advanced version provides more functionality in the area of 3D PDF creation. Our samples and documentation have been updated to distinguish between these two categories.

Data model

Functionality has been improved and new functionality has been added to easily create rich 3D documents that dynamically update the content displayed in the page depending on what's selected in the 3D model or in the different widgets that can be added in PDF document (e.g., buttons, listboxes, carousels, scroll tables, etc.).

Enhancements

Some enhancements have been made to better manage the association between PMI and geometry. This includes bug fixes and performance improvements.


HOOPS Publish 2016 SP2 U2

Enhancements

Fixed Bugs

Issue NumberDescription
27365Fixed an issue when attaching files with Russian names in a PDF.



HOOPS Publish 2016 SP2

Enhancements

New Functionalities


HOOPS Publish 2016 SP1 Update 3

Enhancements


HOOPS Publish 2016 SP1 Update 2

Enhancements


HOOPS Publish 2016 SP1

Enhancements

PMI Highlight

Publish can now generate files that highlight edges in Acrobat Reader when PMI is selected. This functionality can be activated setting the parameter A3DPDF3DArtworkData2::m_bAddAdditionalGeometry to true.

Ability to highlight 3D entities on table selection

A new functionality (See A3DPDFSlideTableLinkTo3DNodes) has been added to link a table (typically a bill of materials table) with the 3D scene so that 3D node gets highlighted when a line in the table is selected. The function to use to create links between a table and 3D node is A3DPDFSlideTableLinkTo3DNodes.

Draw in 2D PDF

New functionality has been included to draw lines (A3DPDFPageDrawLine), arcs (A3DPDFPageDrawArc), Bezier curves (A3DPDFPageDrawBezierCurve), rectangles (A3DPDFPageDrawRectangle) and composite paths (A3DPDFPageDrawCompositePath) in a 2D PDF.

Replace data in a 3D PDF file

New functionality has been included to replace data (3D and metadata) in 3D PDF files created by the Tetra 4D Enrich product; see A3DPDFDocumentUpdateData.


HOOPS Publish 2016

Enhancements


HOOPS Publish 2015 Service Pack 2

Functional Changes

Enhancements


HOOPS Publish 2015 Service Pack 1

Enhancements

Functional Changes


HOOPS Publish 2015 Update 1

Functional Changes

Bug fixes in slide table


HOOPS Publish 2015

Enhancements

Linux support

HOOPS Publish now works on Linux. All features are supported except the optional TableToPDF component.

Views

View-dependent colors are now supported.

PDF Widgets

In addition to text boxes and buttons, HOOPS Publish now supports check boxes, radio buttons, list boxes, drop down lists, and signature fields. View carousels can now display multiple rows and columns.

PMI

Two new end-user context menu options are available which facilitate highlighting data associated with PMI. "Highlight associated PMIs" and "Highlight associated datums"

Functional Changes

PDF Widgets

The function signature for inserting view carousels, A3DPDFDefineViewCarousel, has changed to accept one additional parameter.



HOOPS Publish - v7.20 Changes

Enhancements

PDF Widgets

Security

A new PDF security mechanism has been implemented, which allows the document author finer control over how a document is used.



HOOPS Publish - v7.10 Changes

Enhancements

Performance Optimizations for Animations containing many moving objects

We focused on optimizing animations which consist of many objects moving within the model. These are often used for simulating robots and/or assembly plants.



HOOPS Publish - v7.00 Changes

Enhancements

Further Performance Improvements for Animations

Significant post-processing of animations is now performed to improve the load time performance of animations created with HOOPS Publish.



HOOPS Publish - v6.10 Changes

Enhancements

Animation Support

A new set of APIs has been introduced which allows you to define an animation. The animation interface is based on the industry standard key-frame methodology and the animation is embedded in the exported PDF as Javascript code.

Semantic PMI display in Acrobat Model Info Box

You can now request that the semantic definition of PMI data is displayed in the Model Info box of Acrobat or Adobe Reader if a markup is selected.

Embedded Image Support

A new API has been introduced which allows you to embed images in the PDF file. These images can be later retrieved for use in JavaScript. This functionality allows developers to implement advanced functionality like a carousel for navigating different views in a model.

Remove BREP information in PRC/PDF export

Developers can now easily remove the BREP definition prior to export to PRC ro PDF. This allows developers to potentially sensitive information independent of the import settings.



HOOPS Publish - v6.00 Changes

New Import Formats

Format Supported Versions
PDF All

Note, in the current implementation PDF is not supported via the standard read API (i.e. A3DAsmModelFileLoadFromFile()). Instead Developers must first use the function A3DGet3DPDFStreams() to extract the PRC/U3D data from the PDF document and then provide this data to appropriate Exchange or Publish API. An example of using this API is provided in the samples\publish\publishsource\DemoFunctionalities sample.

Removed Import Formats

Format
STEP
STL

Interface Changes

Access to full HOOPS Exchange API

Developers can now access the full HOOPS Exchange API in HOOPS Publish. This means they can fully query the B-rep definition of the model and request for the tessellation of supported import files. For full details on the Exchange API, including a Programming Guide, please refer to the HOOPS Exchange Documentation.

Ability to query form fields

Developers can now open a PDF document and dynamically query the names of the form fields contained therein. Please refer to the <hoops_publish>\samples\publish\publishsource\DemoFunctionalities sample for an example of how to use this API.

More granular control over 3D annotation display settings

New APIs were added to provide Developers with more advanced control over the display settings assigned to particular views. Much of this new functionality is used in the existing samples included in the media.



HOOPS Publish - v5.30 Changes

Interface Changes

PMI cross-highlighting

This is the ability for a user to click on a PMI in order to find the associated geometry. HOOPS Publish automatizes the developer task to reproduce this behavior by only needing to activate one Boolean. Only supported with Acrobat 11 and later. See the API reference for m_bActivatePMICrossHighlight.

3D PDF views in perspective mode

HOOPS Publish now can create 3D PDF camera views in a perspective projection. Before that only orthographic projection were supported. See the API reference for A3DPDFViewData.

Table support

Enhancements have been made to the table implementation. Now customers are able to define tables of very rich aspect, and precisely position any number of tables on a page. For more information, visit the Table Module in the API reference section. A usage example can be found in the 'ResultsReporting' code sample.

Link

New functions have been added to create links on a PDF page. A link is a rectangle zone on which the user clicks to trigger an action. Applied upon tables, this allows to simply define actions on table cells: when clicking inside a cell of the table, the user can activate a 3D view, or highlight some 3D data. For more information, visit the Link Module in the API reference manual. A usage example can be found in the 'ResultsReporting' code sample.

Enhancements

Poster generation

Several issues have been fixed upon the poster generation.

Views and PMI support

Several issues have been fixed regarding the treatment of views and PMI read from native files.

New Samples

Two new samples have been added.

CreatePRCMarkup

Sample which demonstrates how to easily create a PRC markup using the API. This sample is using a set of C++ classes wrapping the HOOPS Publish API.

ResultsReporting

Sample which demonstrates the creation of tables on a PDF page. Also, some table cells can be clicked in order to activate some particular 3D views that present some specific PMI.

top_level:0