ACIS Release Notes
From DocR21
This service pack is a collection of new features and updates that fix issues reported against the ACIS R21 release and incorporates all of the ACIS R21 content.
Important: The service pack is standalone and must be installed into a directory that does NOT contain prior releases.
This service pack is not a required upgrade; however, if you are currently running ACIS R21, we encourage you to download this service pack to ensure that you are running the most current, up-to-date version of ACIS.
Note: This ACIS service pack should be used with the same service pack level of InterOp.
Contents |
Release Notes R21 SP1
| IMPORTANT |
|---|
| This Service Pack is standalone and must be installed into a directory that does NOT contain prior releases. |
No interface changes for ACIS R21 SP1.
Resolved Issues
For any issues you have submitted, log into the Support area at the Spatial Web site to check their status.
Platform Support
R21 GA Release Date: May 2010
| Compiler Build | Tested OS | Processor |
|---|---|---|
| Microsoft Windows | ||
|
Microsoft Visual C++ 2005 32-bit |
Windows XP Professional 32-bit SP3 | x86-64 |
| Red Hat Enterprise Linux1 | ||
| GNU C++ gcc 4.1.2 32-bit GNU C++ gcc 4.1.2 64-bit |
Red Hat Enterprise Linux Version 4.0 Update 7 | x86-64 |
| IBM AIX | ||
| VisualAge C++ Professional Version 8.0 32-bit VisualAge C++ Professional Version 8.0 64-bit | AIX Version 6.1 (TL02) | RS/6000 |
| Apple Macintosh | ||
| gcc 4.0.1 compiler (included with XCode 2.3) 32-bit | OS X 10.4.7 | Intel-based Macintosh |
1 Linux is built on RHEL4.0 Update 7 and links to glibc 2.3.4-2, thus the minimum OS for runtime is RHEL4.0.
Note: Spatial has been informed that when a customer application links against and initializes PHL V5, the Microsoft debug runtime reports leaks after their application exits. Refer to Understanding False Memory Leaks Reported in ACIS-based MFC Applications for more details.
End of Life Notifications
R20 was the last version for ACIS/InterOp binaries on HP-UX and Solaris platforms. Starting with R21, ACIS/InterOp binaries are not provided for Hewlett-Packard HP-UX nor for SUN Solaris operating systems. Contact Spatial Support for any additional information.
Installation Notes
The following sections explain the installation procedure for supported platforms and the resulting directory structure post-installation:
Note: The Spatial installation software does not need to be run separately for each Spatial product or supported platform. You may extract packages for both the 3D Modeling and Visualization Product Suite and the 3D InterOp Product Suite across multiple platforms into one directory and run the installer once. However, you must not extract UNIX and Windows packages into the same directory.
Installing on Windows
- Download the product ZIP file from Spatial's Online Support Center.
- Extract the product ZIP file by double-clicking the file and specifying the desired installation directory.
- Double-click the setup.exe file in the specified installation directory.
- At the Welcome screen, click Next to continue to the License Agreement screen. Select Yes to accept the license terms.
- The next screen prompts you for the destination folder. Select the top-level directory of your 3D Modeling and Visualization Product Suite installation. The installation then occurs in the selected location.
Important Runtime Installation Instructions for Windows
Note: The following instructions apply only to customers who build their application using the Microsoft Visual Studio .NET 2005 (SP1) compiler.
After you install your Spatial products, you must install the executable (for 32-bit or 64-bit) provided with your Spatial products installation package.
During the Spatial products installation process, two executable files are placed in a folder called redist, located in the Spatial products installation directory; for example:
<install_dir> \redist
.
.
.
VC8\vcredist_x86.exe (32-bit)
VC8\vcredist_x64.exe (64-bit)
where <install_dir> is the confirmed location of your Spatial products installation directory.
Note: The following instructions apply only to customers who build their application using the Microsoft Visual Studio .NET 2008 compiler.
After you install your Spatial products, you must install the executable (for 32-bit or 64-bit) provided with your Spatial products installation package.
During the Spatial products installation process, two executable files are placed in a folder called redist, located in the Spatial products installation directory; for example:
<install_dir> \redist
.
.
.
VC9\vcredist_x86.exe (32-bit)
VC9\vcredist_x64.exe (64-bit)
where <install_dir> is the confirmed location of your Spatial products installation directory.
Installing on UNIX and Macintosh
- Download the product TAR file from Spatial's Online Support Center.
- Extract the product TAR file to the desired location.
- Run the installation program acis_install.
- At the first screen, review the details about navigating the installation program. Press <Enter> to continue with the installation process.
- The License Agreement appears on the next screen. If you accept these terms and conditions, select Y and press <Enter>; otherwise, select N, and the program quits the installation process.
- The last screen prompts you to verify the top-level installation directory <install_dir> where the product is to be installed. All products will be installed into this directory. After entering Y to confirm the location of the installation directory, the installation program completes the installation process.
Directory Structure
The directory structure is divided into subdirectories as detailed below:
| Directory | Description |
|---|---|
| bin | The bin directory contains all 3D Modeling and Visualization Product Suite executables, shared libraries, and DLLs within its subdirectories. For each platform you install, bin contains two arch subdirectories: one for the release mode architecture, and one for the debug mode architecture. |
| docs | The docs directory contains the ReadMe files. |
| include | The include directory contains 3D Modeling and Visualization Product Suite header files. |
| lib | The lib directory contains all 3D Modeling and Visualization Product Suite static archives and Windows import libraries (.lib files) within its subdirectories. For each platform you install, lib contains two arch subdirectories: one for the release mode architecture, and one for the debug mode architecture. |
| scm | The scm directory contains code for Scheme AIDE (Scheme interpreter, Scheme extensions, Scheme scripts and projects for building Scheme AIDE), and example projects and makefiles for rebuilding Scheme AIDE. |
| src | The src directory contains source code (such as examples) that is shipped with the 3D Modeling and Visualization Product Suite. |
| redist | The redist directory contains Microsoft redistributable packages. All customers using Spatial CATIA V5 translators need to install redist when developing/executing their application in a Windows environment. |
Digital Signatures
Spatial products on Windows Operating System with Microsoft Visual C++ 2005 compiler are digitally signed for identification purposes. Digital signatures for Spatial products have been issued by VeriSign and recipients can use this to authenticate the identity of Spatial products.
Important Notes about Building Your Application with This Release
Understanding False Memory Leaks Reported in ACIS-based MFC Applications
False memory leaks are reports of leaks by memory management systems that can be proven to be erroneous. In this case Spatial specifically refers to the leak reports generated by the Microsoft debug CRT when an ACIS-based MFC application exits.
Faulty leak reports are generated when the runtime library that was loaded last exits, not when the runtime library that was loaded first exits. In other words, the faulty leaks are reported when the first runtime library exits, not when the last one exits. (This is a bug that has been acknowledged by Microsoft.) Moreover, other libraries may be unloaded after the first runtime library exits. These other libraries may free memory when they unload, which is the case with ACIS libraries. These deallocations can occur after the leak report has already been generated, in which case they are incorrectly reported as leaks.
No faulty leaks are reported when all runtime libraries are loaded before other libraries during application startup. This desirable behavior can be achieved by managing link order and by managing the types of run-times used by the application.
Libraries specified as additional dependencies in the project settings are loaded in the order specified before all other libraries. (This is referred to as "explicit linkage".) Adding the appropriate MFC runtime library to the beginning of the link dependencies should remove erroneous leaks in most cases. Additionally, you can load all libraries with the use of pragmas. This is the suggested way to link ACIS libraries into your application. (This is referred to as "implicit linkage".) From our experience, applications that link libraries implicitly are less likely to encounter faulty leak reports. Note that pragmas added to source code will, therefore, require project rebuilds.
Faulty leak reports can also occur when mixed versions of runtime libraries are loaded because of dependencies from other libraries. For example, a typical MFC application may use MFC80D.DLL and have dependencies on other libraries that use MFC80UD.DLL. The latter library may be loaded after other libraries have been loaded, specifically after ACIS libraries are loaded. This is a scenario for faulty leak reports since libraries are unloaded in reverse load order. This cannot be solved with explicit linkage because of link errors (such as multiply defined symbols) and mixed runtime issues. The best solution is to manage the types of run-times used by the application by using the same ones whenever possible.
Update Tool
In versions prior to and including R12, an Update Tool was provided with 3D Modeling and Visualization Product Suite to assist in migrating customer code to the new version. This tool primarily implemented changes in header file path references. R13 through R18 have no such changes, therefore no Update Tool has been included with these versions. If you are migrating from a version of 3D Modeling and Visualization Product Suite older than R12, contact Spatial Customer Support to obtain the appropriate version of the Update Tool.
HOOPS/ACIS Bridge Libraries
Graphics Card Information
The HOOPS 3D Application Framework supports a large number of graphics cards. However, with the large number of graphics cards and machines available today, it is possible that you may encounter a display problem when running the HOOPS-enabled applications such as the ACIS Scheme AIDE. If you are having problems, ensure you have done the following:
- Ensure that you are running the latest version of ACIS.
- Check the Tech Soft 3D site for updated information on your video card.
- Contact your graphics card provider. Your graphics card provider should be able to provide information, suggestions and even updated drivers to help solve the problem.
If you are still experiencing problems, contact our Spatial Support Services department or visit the Online Support Center.
Windows Library Naming Conventions
The table below illustrates how the DLL and Import Libraries for SpaACIS are named on the Windows platform.
| Platform | Library Names |
|---|---|
| Windows Release | SpaACIS.lib, SpaACIS.dll |
| Windows Debug | SpaACISd.lib, SpaACISd.dll |
Library Extension on AIX Platform
In order to comply with standard naming conventions for shared libraries, all libraries on the AIX platform have an .a rather than a .so extension.
Licensing Information
Note: Application Licensing and Registration are supported on Windows operating systems only.
In order to better protect the use of its intellectual property and gain a more accurate understanding of their use, Spatial products now require a license. Because Spatial does not sell end-user applications, Spatial has ensured that the licensing process is seamless to the end user. Refer to Licensing and Registration for more details.
Use of this Spatial software and the associated documentation is governed by the license agreement between the parties. If you do not have such a written license agreement for this software, do not use this software or documentation. If you do not have a valid license, contact your sales representative or productsales_spatial@3ds.com to purchase a license.
Any use of this Spatial software or documentation without a valid license is illegal and is strictly prohibited.
© 2010 Spatial Corp., a Dassault Systèmes S.A. company. All rights reserved.
ACIS and SAT are registered trademarks of Spatial Corp. All other names and products are trademarks of their respective owners.
