Acrobat 3D Capture Utility for Unix use

Supplement to the Acrobat 3D Capture Utility README file (Unix)

What’s Covered

General Notes

Localization Notes

Capturing I-DEAS software on SunOS

Tested and supported CAD applications

Known issues

This document is a supplement to the README file included with the Acrobat 3D Capture utility for Unix.

General Notes

The installation requires at least 50 MB of free disk space in the /tmp directory.

To auto-detect the capture settings for VisView, VisMockup, NX2, or NX3, set the environment variable R3D_APPNAME in the environment of the CAD application. Use the appropriate value from the following list:

– VisView

– VisMockup

– NX2

– NX3

On IBM, AIX 5.2, set the soft stack segment size to unlimited (stack=-1), in the /etc/security/limits file if NX fails to start when it is wrapped.

On AIX, saving a capture to PDF may fail for very large 3D databases. To solve this problem, you must do the following:

– Set the LDR_CNTRL environment variable to “MAXDATA=0×60000000@DSA”.

– Set the soft data segment size to unlimited (see /etc/security/limits).

Declaration of R3D_CAPTUREFILE must be set in the “Acrobat 3D Capture Utility” environment to use the associated functionality.

If you encounter problem saving the PDF file, then please make sure your virtual memory is set to “on”, and modify the amount of virtual memory it as needed (this should be at least 1 GB).

For wrapping VisView and VisMockup CAD applications, a special environment variable is set. This variable can cause the warning message “Using Debug libraries from …/lib/ …” to display when you start the CAD application. You can safely ignore this warning.

After a re-installation in a user account, you should restore the capture settings to the default values. You can reset these values using the Acrobat 3D Capture Utility user interface or by deleting the .r3drc and .r3d_custom_settings files located in the $HOME directory.

Note: Deleting the .r3drc and .r3d_custom_settings files will delete any capture settings that the user has previously modified.

The Acrobat 3D Capture Utility does not support Catia V4 using the PHIGS driver on IBM.

On IBM, AIX 5.2, set the soft stack segment size to unlimited (stack=-1), in the /etc/security/limits file if NX fails to start when it is wrapped.

When you use Catia V5 and DMU on HP-UX, Adobe recommends that you configure your X server to use the R3D_ASYNC_TRACKING environment variable to improve performance. Make the following configuration changes with the R3D_ASYNC_TRACKING variable on your X server:

– Change the XServer “AccelerateIndirectRendering” option to true in the /etc/X11/XF86Config file.

– Export CAT_DisplayLists=0 when launching the CAD application

– Declare the R3D_ASYNC_TRACKING in the Acrobat 3D Capture Utility environment

– Declare the R3D_ASYNC_TRACKING in the CAD application environment

– Launch the CAD application first, then launch the Acrobat 3D Capture Utility

Note: These settings are only supported for Catia V5 and DMU on HP-UX.

If you copy the Acrobat 3D Capture Utility CD to a Unix system while the CD is in the CD drive of a Window system, then you must set the permissions on the Acro3d.run executable in order to install the Acrobat 3D Capture Utilty properly on the Unix system. To set permissions: Type chmod a+x Acro3d.run on the command line.

Localization issues

The Acrobat 3D Capture Utility Installer does not support KANJI paths.

Set the LC_ALL and LANG variables to the language you are using before you start the installer and the Capture Utility.

We recommend that you use the localized version of the Acrobat 3D capture utility in the corresponding localized system, especially for Japanese systems.

ISO8859-1 encoding is supported for French and German versions of the Capture Utility. eucJP and UTF-8 encodings are supported for Japanese versions.

The following table indicates locales you can use for each type of Unix system:

	IBM AIX	HP-UX	SUN Solaris	SGI Irix64
ENGLISH	en_US	en_US.iso88591	en_US	en_US
FRENCH	fr_FR.ISO8859-1	fr_FR.iso88591	fr_FR.ISO8859-1	fr_FR.ISO8859-15
GERMAN	de_DE.ISO8859-1	de_DE.iso88591	de_DE.ISO8859-1	de_DE.ISO8859-15
JAPANESE	ja_JP or ja_JP.IBM-eucJP	ja_JP.eucJP	ja_JP.eucJP or ja.JP_UTF-8	ja_JP.EUC

Capturing I-DEAS software on SunOS

Under SunOS, due to the setuid nature of the I-DEAS application, the operating system won’t allow the Acrobat 3D Capture Utility capture libraries to interpose and watch the OpenGL instructions flow. So you need one extra step in the Acrobat 3D Capture Utility installation process to be able to capture the I-DEAS application.

You will need to log in as root and copy the following files from the Acrobat 3D Capture Utility installation lib directory to the associated /usr/lib directory:

– libGL.so.0 to /usr/lib/secure

– sparcv9/libGL.so.0 to /usr/lib/secure/64

To start the I-DEAS application in the capture environment use the following scripts included with the application:

– Type r3dwrapsunideas [/path/to/ideas/executable] and then press Enter for a 32-bit install ation of I-DEAS . F or example, type r3dwrapsunideas /usr/local/ideas/ms7 .

– Type r3dwrapsunideas64 [/path/to/ideas/executable] and then press Enter for a 64-bit install ation of I-DEAS . For example, type r3dwrapsunideas 64 /usr/local/ideas/ms7 .

Tested and supported CAD applications

The following table indicates what type of operating system (32-bit or 64-bit) has been tested and is supported with each CAD application.

	IBM AIX	HP-UX	Sun Solaris	SGI
Catia v4	-	32	32	32
Catia 4D Navigator	32	32	32	32
Catia v5 R14	32	32	32	32
Catia DMU R14	32	32	32	32
Catia v5 R15	32	32	32	32
Catia DMU R15	32	32	32	32
TeamCenter Visview	32	-	64	32
TeamCenter VisMockup	32	-	64	32
UGS NX2	-	-	-	32
UGS NX3	32	-	32	-
I-DEAS	-	32	64	-

The environmental variables needed to capture these CAD application s are described in r3dwrapstarter script. You can use it as a sample to set the environment variables that are used for each application.

Known issues

The following are known issues with the Acrobat 3D capture utility:

– On HP-UX, CATIA V4 models are captured with white colors.

– On HP-UX the capture of VisView, VisMockup, and NX products are not supported.

– On IBM-AIX and SGI, I-DEAS is not supported.

– The capture of textures is not well supported for VisView and VisMockup.