SAP 3D Visual Enterprise, Third-Party Plug-Ins fileThe SAP 3D Visual Enterprise, third-party plug-ins Guide consists of the following main sections:

ADMINISTRATION GUIDE | PUBLICDocument Version: 2.0.0 – 2018-11-30

SAP 3D Visual Enterprise, Third-Party Plug-InsSAP 3D Visual Enterprise

© 2

018

SAP

SE o

r an

SAP affi

liate

com

pany

. All r

ight

s re

serv

ed.

THE BEST RUN

Content

1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1 About this Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Technical System Landscape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1 Supported Operating Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Autodesk 3ds MAX and 3ds MAX Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Maya. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Adobe Acrobat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 Installing the SAP 3D Visual Enterprise, third-party plug-ins. . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4 Autodesk 3ds Max and Autodesk Maya. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.1 Autodesk 3ds Max and Autodesk Maya Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

rh Export for 3dsMax/Design (Autodesk 3ds Max to SAP 3D Visual Enterprise Author). . . . . . . . . .7

rh Import for 3dsMax/Design (SAP 3D Visual Enterprise Author to Autodesk 3ds Max). . . . . . . . . 8

rh Export for Autodesk Maya (Autodesk Maya to SAP 3D Visual Enterprise Author). . . . . . . . . . . . 9

rh Import for Autodesk Maya (SAP 3D Visual Enterprise Author to Autodesk Maya). . . . . . . . . . . 10

4.2 Import and Export Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Import Options for Autodesk 3ds Max and Max Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Export Options for Autodesk 3ds Max and Max Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Import Options for Autodesk Maya. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Export Options for Autodesk Maya. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

5 3D PDF Template Designer plug-in for Adobe Acrobat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185.1 2D Annotation Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

5.2 3D Annotation Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

5.3 Animation Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

5.4 Model Views and Portfolio Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

5.5 PMI Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.6 Selection Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

5.7 Metadata Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.8 Standard View Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

5.9 Steps and Procedure Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

5.10 Layer Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.11 2D Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.12 Utility Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

2 P U B L I CSAP 3D Visual Enterprise, Third-Party Plug-Ins

Content

Document History

NoteBefore you start the implentation, make sure you have the latest version of the document. You can find the latest version at the following location: http://help.sap.com SAP 3D Visual Enterprise Third-Party Plug-Ins .

The following table provides an overview of the most important document changes.

Version Date Description

1.00 2013-05-28 First Version

1.10 2014-07-14 Added sections 3D PDF Template Designer and Reprise License Manager v11 for SAP 3D Visual Enterprise Author (RLM) for Release 2.0.

1.20 Minor updates to versions

1.30 2016-11-247 Minor updates to versions and download location

2.0 2018-11-20 Removed Reprise License Manager v11 for SAP 3D Visual Enterprise Author (RLM) section. This now forms a separate guide named SAP 3D Visual Enterprise Author License Manager v12. The original guide is called SAP 3D Visual Enterprise, third-party plug-ins.

SAP 3D Visual Enterprise, Third-Party Plug-InsDocument History P U B L I C 3

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com

1 Introduction

1.1 About this Document

Purpose

This Guide is the central source of information for the technical implementation of SAP 3D Visual Enterprise, third-party plug-ins. It provides information on the options available for the various third-party plug-ins available for use with SAP 3D Visual Enterprise.

The SAP 3D Visual Enterprise, third-party plug-ins Guide consists of the following main sections:

● .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya● 3D PDF Template Designer plug-in for Adobe Acrobat

For information on Reprise License Manager v11 for SAP 3D Visual Enterprise Author (RLM), see the accompanying guide.


Introduction

2 Technical System Landscape

2.1 Supported Operating Systems

This section lists the supported operating systems for Max and Maya.

2.1.1 Autodesk 3ds MAX and 3ds MAX Design

To work with Autodesk 3ds Max files using the .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya, you must have one of the following versions of Autodesk 3ds Max:

● 2016 (64 bit only)● 2017 (64 bit only)● 2018 (64 bit only)

2.1.2 Maya

To work with Autodesk Maya files using the .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya, you must have one of the following versions of Maya:

● 2016 (64 bit only)● 2017 (64 bit only)● 2018 (64 bit only)

2.1.3 Adobe Acrobat

To create custom PDF Templates using the 3D PDF Template Designer plug-in for Adobe Acrobat, you must have one of the following versions of Adobe Acrobat::

● Adobe Acrobat 3D v8● Adobe Acrobat Professional v8● Adobe Acrobat Professional v9● Adobe Acrobat X● Adobe Acrobat XI

SAP 3D Visual Enterprise, Third-Party Plug-InsTechnical System Landscape P U B L I C 5

3 Installing the SAP 3D Visual Enterprise, third-party plug-ins

You can download and install the SAP 3D Visual Enterprise, third-party plug-ins from the SAP Community Network Developer Center. Under Tools and SDKs, SAP 3D Visual Enterprise has a dedicated space for various offerings, including this one.

RecommendationBefore installing, we advise closing Autodesk 3ds Max, Autodesk Maya, and all SAP 3D Visual Enterprise Author applications.

Activities

Installing the SAP 3D Visual Enterprise, third-party plug-ins1. Download from the SAP Store: https://store.sap.com/sap/cp/ui/resources/store/html/

SolutionDetails.html?pid=0000012809.

2. Use Windows Explorer to locate the executable file.3. Double-click the VEPlugins_3.0.0.<build number>.exe file to start the installation.4. Select your third-party products.5. Follow the instructions as they appear on your screen.

Ensuring that .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya are loaded in Autodesk 3ds Max

1. Choose Customize Plug-In Manager from the Autodesk 3ds Max main menu.2. Search in the list for rh_max_XXXX.dlf, (where XXXX is the version number), and ensure that the plug-in

is checked as “Loaded”.

Ensuring that .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya are loaded in Autodesk Maya

1. Choose Window Settings/Preferences Plug-In Manager from the Autodesk Maya menu bar.2. Search in the list for rh_mayaXXXX.mll, (where XXXX is the version number), and ensure that it is

checked for “Loaded” and “Auto Load”.


Installing the SAP 3D Visual Enterprise, third-party plug-ins

4 Autodesk 3ds Max and Autodesk Maya

The .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya enable you to open RH Binary (.rh) files in a third-party application, (Autodesk 3ds Max or Autodesk Maya), and to save third-party files to the .rh format for use in SAP 3D Visual Enterprise Author and SAP 3D Visual Enterprise Generator.

This reference contains detailed information about all the features and capabilities of the .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya.

CautionAutodesk 3ds Max and Autodesk Maya 2014, 2015, and 2016 support only 64 bit installations, therefore the installer will only install a 64 bit plug-in for Autodesk 3ds Max and Autodesk Maya.

Version 2013 was the last 32 bit installation.

4.1 Autodesk 3ds Max and Autodesk Maya Support

The following features are supported in the .rh Import and Export plug-ins for Autodesk 3ds Max and Autodesk Maya.

NoteAny feature not listed here is considered to be unsupported.

4.1.1 rh Export for 3dsMax/Design (Autodesk 3ds Max to SAP 3D Visual Enterprise Author)

The following table shows the features available for Autodesk 3ds Max.

Supported Description

Nodes and Helpers ● Dummies● Bones

Layers All layers

SAP 3D Visual Enterprise, Third-Party Plug-InsAutodesk 3ds Max and Autodesk Maya P U B L I C 7


Materials ● XRef● VRay● Standard● Textures

Cameras ● Free● Target

Lights ● Spot● Direct● Ambient● Omni● Free● Target

Shapes All shapes

Geometry ● Tri-mesh (vertices, faces, vertex-normals, face-normals, texture-coordinates, materials)

● Poly-mesh (vertices, faces, texture coordinates, materials),

● Patch (vertices, faces, texture coordinates, materials + SubD level)

● NURBS● All other objects will convert to polygons or triangles if it

is possible

Animation ● Position● Rotation● Scale● Roll/FOV

Modifiers ● Morphs● Skins● SubD

4.1.2 rh Import for 3dsMax/Design (SAP 3D Visual Enterprise Author to Autodesk 3ds Max)

The following table shows the features available for Autodesk 3ds Max.


Autodesk 3ds Max and Autodesk Maya


Nodes All nodes

Layers All layers

Materials ● Standard● Textures

Cameras ● Free● Target

Lights ● Spot● Direct● Omni● Free● Target

Shapes All shapes

Meshes ● Tri-mesh (vertices, faces, vertex-normals, face-normals, texture-coordinates, materials)

● Poly-mesh (vertices, faces, texture coordinates, materials),

Animation ● Position● Rotation● Scale● Roll/FOV

Modifiers ● Skins

4.1.3 rh Export for Autodesk Maya (Autodesk Maya to SAP 3D Visual Enterprise Author)

The following table shows the features available for Autodesk Maya.


Nodes ● Helpers● Bones

Layers All layers

Materials ● Textures● Textures with multiple UV channels



Cameras ● Free● Perspective

Lights ● Ambient● Directional● Local● Spot● Target

Geometry ● Tri/Poly-meshes with:○ Vertices○ Faces○ Vertex-normals○ Vertex-colors○ Face-normals

● NURBS○ Curves○ Surfaces

Animation ● Translation● Rotation● Scale - as decomposition node matrix for each frame

Modifiers ● Morphs● Skins

4.1.4 rh Import for Autodesk Maya (SAP 3D Visual Enterprise Author to Autodesk Maya)

The following table shows the features available for Autodesk Maya.


Nodes All nodes

Layers All layers

Materials ● Phong● Blinn● Lambert● Textures




Cameras ● Perspective● Target● Free

Lights ● Point● Spot● Infinite/Direct

Meshes ● Tri-mesh (obtained, but not used - transferred like poly-mesh)

● Poly-meshes:○ Vertices○ Faces○ Textures○ Vertex-normals○ Vertex-colors○ Face Materials

● NURBS

NURBS All NURBS

Animation Position, Rotation, Scale over KFT

Modifiers Skin

4.2 Import and Export Options

The applications Autodesk 3ds Max and Autodesk Maya contain specific options for both import and export.

The following sections contain information on all available options for import and export. You can modify those properties using the Import RH Binary File and Export RH Binary File windows. Once you have modified the properties, those settings are applied to any subsequent file when it is opened, reloaded, or exported.

4.2.1 Import Options for Autodesk 3ds Max and Max Design

The RH Binary (.rh) format contains import options. You can use them to customize the way in which your .rh file is opened in Autodesk 3ds Max and Max Design.


Features

Fields and Checkboxes Functional Description

Triangulate Polygons Converts all polygons, if polygon faces have three or more sides, to triangles

Normals Imports all surface normals. Using this option creates larger files.

SubD Mode Establishes subdivision control mesh object settings

● Import Final Mesh: Imports a highly detailed and a high polygon count mesh

● Import Control Mesh: Imports a low detailed, low polygon count mesh. This mesh is sub-divisible.

Skins Transfers the skin information from the RH scene to the .max file. This option is only valid if there is skin information.

Lights Transfers lights created in the RH scene into the Max scene

Camera Transfers the camera objects created in the RH scene into the Max scene

Default Camera Transfers the “User” camera from the RH scene into the Max scene.

NoteThis setting is only available when the camera setting is checked.

Animation Transfers animation created in the RH scene to the Max scene when imported

Hide Dummy Nodes Hides dummy nodes created in the RH scene. Dummy nodes are group nodes, or nodes with no mesh.

Group Mode You can open and close groups to access the individual objects contained in them without dissolving the group. These commands maintain the integrity of the group.

● Create as Opened: Opens closed nodes in the RH scene and transfers the Scene Tree structure into the Max scene

● Create as Closed: Closes all grouped nodes and creates one object when transferred into the Max scene

● Do not Create: Ignores the scene tree in the RH scene, and transfers accordingly




Textures Transfers textures added in the RH scene into the Max scene. If Store in Folder is checked, this setting defines the location where textures are stored, if you save a Max file from the .rh file.

NoteThis option works in conjunction with Store in Folder.

Store in Folder Sets a save location for the texture file

Use Existing Materials Performs a check for existing materials and potential material matches with the RH scene. If a material exists in the Max scene and there is a material match in the incoming RH scene, the material is not transferred. Only non-matching materials are imported. If unchecked, all materials from the RH scene are brought into the Max scene regardless of whether is a matching material.

Convert Instances to Unique Converts objects in the Max scene that are instanced, into unique, independent objects

Metadata Transfers metadata from the .rh file format to the Max scene

Activities

Importing .rh Files into Autodesk 3ds Max or Max Design:

1. Choose File Import from the Autodesk 3ds Max menu bar.2. Select RH Binary (.rh) in the Files of Type field.3. Navigate to, select the .rh file you wish to import, and choose Open.4. Select the import options you require, and choose OK.

4.2.2 Export Options for Autodesk 3ds Max and Max Design

The RH Binary (.rh) format contains export options. You can use them to customize the way in which your .rh file is saved in Autodesk 3ds Max and Max Design.


Features


Apply Pivot Data to Nodes Performs a check as to whether the pivot point of the .max file is compatible with the .rh file format, If this is not the case, a new sub pivot point is generated for the object to be transferred into the .rh file format. This setting also controls the position of the pivot point. If unchecked, the position of the pivot point in Max is not transferred,

RecommendationWe recommend that this setting is checked for animation purposes.

Convert Patches to Mesh Converts patch mesh objects created in Max into polygonal mesh.

Convert NURBS to Mesh Converts NURBS surfaces created in Max into polygonal mesh

Use Skin Modifiers Transfers all skin, weights, and bones information linked with an animated skeleton to the .rh file format.

Animation Transfers all keyed animation on object(s) from the Max scene to the .rh format.

NoteThe settings Use Morph Modifiers, Sample Objects Animation, and Sample Vertex Animation are dependent on this setting.

Use Morph Modifiers Transfers morph modifiers applied to objects in the Max scene to the .rh file format

Sample Object Animations Samples each frame, and saves or "bakes" the object's position so that the animation is transferred across accurately to the .rh file format. If this setting is unchecked, animations between key frames are calculated with position and rotation calculation in SAP 3D Visual Enterprise Author. This produces a different result from the original Max file.

NoteThis setting works in conjunction with the setting Sample any animation every: [ ] frames.




Sample Vertex Animation Keys or “bakes” the position of each vertex in an animated object so that animation at vertex level is transferred across to the .rh file format.

Sample Any Animation Every [number] Frame Determines the rate at which the vertex animation is sampled.

Create Materials for Wire Colors Exports all wire colors in the Max scene, and creates RH materials for each.

Convert Instances to Unique Converts objects in the Max scene that are instanced, into unique, independent objects.

Metadata Transfers metadata from the Max scene to the .rh file format

RH Binary Establishes the .rh specific settings:

● Compression: Compresses the .rh file size, making the file size smaller

● File Version: Sets the .rh file format version to which you wish to export. Available versions are 3.5 and 4.0.

Activities

Exporting .rh Files from Autodesk 3ds Max or Max Design:

1. Choose File Export from the Autodesk 3ds Max menu bar.2. Select an export location and enter a name for the file.3. Select the .rh format in the Save as type field, and choose Save.4. Select the export options you require, and choose OK.

4.2.3 Import Options for Autodesk Maya

The RH Binary (.rh) format contains import options. You can use them to customize the way in which your .rh file is opened in Autodesk Maya.


Features


Tessellate NURBS Indicates whether to tessellate NURBS while importing to Autodesk Maya. This setting converts NURBS objects to triangulated meshes.

Import Skins Transfers the skin information from the RH scene to the Autodesk Maya file. This option is only valid if there is skin information.

Import Textures Transfers textures generated in the RH scene to the Autodesk Maya scene

Import Animation Transfers animation created in the RH scene to the Autodesk Maya scene when imported

Mark Surfaces as Double-Sided Adds an extra side to the object's faces. The amount of faces on the object doubles.

Maximum Vertices in Polygon Sets the number of vertices that control the shape of a face on a mesh object. The minimum is a value of 3 because the least amount of vertices a face can have is three to create a triangle.

Up Axis in Maya Selects the up axis when the file is imported to Autodesk Maya. You can nominate either the Y or the Z axis.

Activities

Importing .rh Files into Autodesk Maya

1. Choose File Import from the Autodesk Maya menu bar.2. Navigate to, select the .rh file you wish to import, and choose Import.3. Select the components you wish to import.4. Select the import options you require, and choose OK.

4.2.4 Export Options for Autodesk Maya

The RH Binary (.rh) format contains export options. You can use them to customize the way in which your .rh file is saved in Autodesk Maya.



Features


Tessellate NURBS Indicates whether to tessellate NURBS while exporting to Autodesk Maya format. This setting converts NURBS objects to triangulated meshes.

Export Lights Transfers lights from the Autodesk Maya scene to the .rh file format

NoteThis setting only transfers Spot Lights and Points Lights correctly from an Autodesk Maya scene. Other light-types custom to Autodesk Maya are not transferred.

Export Perspective Camera Transfers the perspective camera view into the RH scene

Export Animation Transfers animation created in the Autodesk Maya scene to the .rh file format

Sample Animation Every [number] Frames Determines the rate at which the vertex animation is sampled when exporting the file. The minimum is 1, and the maximum is 100.

Up Axis in Maya Selects the up axis when the file is exported to the .rh file format. You can nominate either the Y or the Z axis.

Activities

Exporting .rh Files from Autodesk Maya

1. Choose either File Export All , or File Export Selected from the Autodesk Maya menu bar.2. Select an export location and enter a name for the file.3. Select the .rh format in the Files of Type field.4. If you chose the Export Selected option, select the components you wish to export.5. Select the export options you require, and choose OK.


5 3D PDF Template Designer plug-in for Adobe Acrobat

The 3D PDF Template Designer is a plug-in to Adobe Acrobat 3D v8, Acrobat Professional v8, v9, or Acrobat-X and XI. It enables the creation of PDF Templates from any non-restricted PDF file. The .pdf file format (Portable Document Format), developed by Adobe, represents documents in a manner that is independent of the original application software, hardware, and operating system used to create those documents. A .pdf file can describe documents containing any combination of text, graphics, and images in a device independent and resolution-independent format.

A number of VE controls are installed to Acrobat 3D or Acrobat Professional when you install the 3D PDF Template Designer plug-in for Adobe Acrobat. These controls are used to edit the PDF Templates delivered with the PDF Publishing Module, or to create custom PDF Templates. The PDF Templates are used to publish PDF documents via the PDF Publishing Module. You can edit VE controls in the same way as you edit normal Adobe Acrobat objects.

VE controls are specific to the particular 2D and 3D workflows in which they are located; you should use VE controls in their related templates to ensure that they function correctly. For example, if you use the Step Description Block control in the Simple_Animation_Template, the control may not function correctly in a document primarily made with other controls. VE controls are pre-programmed Acrobat controls that provide specific 2D and 3D functionality in a PDF.

VE controls are located on the Advanced Editing toolbar within Acrobat 3D and Acrobat Professional. These buttons, text fields, list boxes, dropdown lists, and radio buttons are based on different PDF workflows. For example, available VE controls that may be required for producing PDF documents relating to an Assembly/Disassembly Stepped procedure are located in the Steps drop down menu.


3D PDF Template Designer plug-in for Adobe Acrobat

Activities

For Acrobat version 9 and beforeInserting a VE Control into your template

1. Click 3D PDF Template Designer (down arrow on right part of button) on the Advanced Editing toolbar).2. Click the control that you wish to use.3. Modify the control properties as required.4. Click OK.

Editing an existing VE Control or another PDF control

1. Click 3D PDF Template Designer (picture on left part of button) on the Advanced Editing toolbar.2. Click the control that you wish to use.3. Modify the control properties as required.4. Click OK.

For Acrobat-XInserting a VE Control into your template

Click the 3D PDF Template Designer button and select the appropriate control from the dropdown menu. Other actions behave as in previous versions of Acrobat.

Editing an existing VE Control

SAP 3D Visual Enterprise, Third-Party Plug-Ins3D PDF Template Designer plug-in for Adobe Acrobat P U B L I C 19

Select Edit Control Properties, then select the control that you wish to modify. When you click the VE Control, a Properties window displays. Modify the control properties as required and click OK.

5.1 2D Annotation Controls

Usage: Determines the content area for a 2D image.

Type: 2D annotation control.

Properties:

Properties

Property Functional Description

Width The width of the content area

Height The height of the content area

Layers The PDF layer at which this button applies

5.2 3D Annotation Controls

Usage: Determines the content area for a 3D scene.

Type: 3D annotation control.

Properties


Width The width of the content area

Height The height of the content area

Lock Camera The camera is locked in position, you cannot move the model.

Force Projection Type Controls the type of view

Default Render Mode Controls the way in which the graphic is displayed in the document

Default Light Mode Controls the lightning scheme that used with model




Default Selection Mode Controls the way in which the selected part of the graphic is displayed in the document

Default Selection Color Controls the color in which the graphic is displayed in the document

Outline Angle Controls how many lines are created in Illustration and Shaded Illustration Render Modes. High numbers mean fewer lines. The range is from 0 to 180, and is measured in degrees.

Override Background Color Controls the way in which the graphic background is displayed in the document.

● Use Acrobats Default: Use the default color settings in Acrobat

● Use Current from VEA/VEG: Use the default color settings in SAP 3D Visual Enterprise Author or Generator.

● Use Custom: Use custom colors

Background Color (Top) Used to set the color of the upper half of the background gradient

Background Color (Bottom) Used to set the color of the lower half of the background gradient

Default Camera Mode Used to set the default camera mode in the published PDF.

● Rotate: Sets the default camera mode to Rotate● Spin: Sets the default camera mode to Spin● Pan: Sets the default camera mode to Pan● Zoom: Sets the default camera mode to Zoom● Walk: Sets the default camera mode to Walk● Measure: Sets the default camera mode to Measure● Fly: Sets the default camera mode to Fly

Use Rotation/Zoom Limits Used to limit the rotation and allowed zooming of a model in the published PDF

Disable Rotation Restrictions Disables rotation restrictions for flat models. If selected, drawings can be rotated.

Layers N/A

3D Scenes are always on top of the PDF layer stack. 3D scenes cannot overlap within the 3D PDF Template.


5.3 Animation Controls

Animation buttons are used to control the way in which animation is handled in a PDF document.

Play Animation

Usage: Plays a simple animation.

Type: button.

Properties


3D Annotation Name Name of the target annotation (the viewer in which the animation plays)

Animation Ending Used to determine the way in which the animation ends:

● Stop at End● Repeat at End● Reverse at End


Pause Animation

Usage: Pauses a simple animation while playing.

Type: button.

Properties


3D Annotation Name Name of the target annotation


Rewind Animation

Usage: Rewinds a simple animation back to the first frame.

Type: button.



Properties




Forward Animation

Usage: Jumps to the last frame in a simple animation.

Type: button.

Properties




Animation Ending Options

Usage: Forwards to the end of an animation, and offers selection as to the method of ending the animation.

Type: radio-button.

Properties




Sequences Dropdown

Usage: Controls the sequences, and allows selection of an animation sequence associated with the model.

Type: Dropdown.


Properties



Play on Selection Automatically plays the selected sequence, when selected from the dropdown menu, or when the Play button is selected.


Named Sequence

Usage: Activate a named sequence.

Type: button.

Properties



Sequence Name The name of the sequence, displays on the button


Sequences List

Usage: Displays a list of all the sequences contained within the current file.

Type: list.

Properties



Play on Selection Automatically plays the selected sequence, when selected from the dropdown menu, or when the Play button is selected.




5.4 Model Views and Portfolio Controls

Model view controls are used to display different views of the 3D model in a PDF document.

Model View Dropdown

Usage: Lists the model views in a dropdown box and allows selection.

Type: Dropdown.

Properties



Allow Portfolio Change Allows you to change model-views set when portfolio changed


Named Model View

Usage: Allows you to assign a model view to a button to activate a 'named' view.

Type: button.

Properties



Model View Name The name of the customized model view, displays on the button


List Model Views

Usage: Displays a list of all the model views contained within the current file.

Type: list.


Properties



Auto Activate Automatically activates a first model view from list. This property is linked with Use Filter. When any scene part is selected, the list can be refreshed (looking for Use Filter). In this case, the first model view can be activated automatically or not activated.

Use Filter Use a filter to select only those model views that contain a selected part

Allow Portfolio Change Allows you to change model-views set when portfolio changed


Model View Name Block

Usage: Displays the customized name of the model view.

Type: text field.

Properties:

Use a filter to select only those model views that contain a selected part.

Properties




Model View Description Block

Usage: Displays the customized description of the model view.

Type: text field.

Properties






Disable Read-Only Allow show scroll bars for very long text. You can modify the field but cannot save it.


Model View Metadata

Usage: Displays the metadata content related to the model view metadata keyword.

Type: text field.

Properties



Metadata Property to Display Displays the metadata content related to a global or model view metadata keyword. That is, for the current file. If the keyword exists in the file, the related content is displayed. Otherwise, no content is displayed. To ensure that the content is displayed, you must name the object with the metadata keyword name; this name is located in the step description.

● PDF_CAMERA_MODE: Sets the camera to Walk, Pan, Rotate or Spin mode, depending on model view metadata content

● PDF_LAYERS_SET: Shows only this layer and hides all others

● PDF_LAYERS_SHOW: Shows layers, without hiding any currently visible layers

● PDF_LAYERS_HIDE: Hides layers, without showing any currently hidden layers

Use Global Metadata Determines whether global metadata is used. Set the value to No if you are using model view metadata




Portfolios Dropdown

Usage: Controls the procedures.

Type: Dropdown.

Properties




Named Portfolio

Usage: Activates the selected custom named procedure.

Type: button.

Properties



Procedure Name The custom name of the procedure.

NoteThis value is case-sensitive.


Portfolios List

Usage: Displays a list of all the procedures contained within the current file.

Type: list.

Properties






Portfolios Radio

Usage: Offers selection as to which procedure to display, up to a maximum of ten.

Type: radio-button.

Properties



Button Portfolio (10 fields) The name of the customized portfolio. This name displays next to the button.


NoteIf five portfolios are nominated, only five radio buttons display.

Portfolio Name Block

Usage: Displays the name of the procedure.

Type: text field.

Properties




Portfolio Description Block

Usage: Displays the customized description of the model view.

Type: text field.

Properties





Allow Formatted Text Allow using any text format tags



5.5 PMI Controls

PMI buttons are used to produce PDF documents relating to PMI workflows including BoM, and model views.

List BoM

Usage: Displays all parts and quantities from the parts list.

Type: list.

Properties



Show Parts Quantity Displays or hides the quantity of parts column

Show Visible Only Performs filtering of visible objects, when model-view or step is changed


List BoM with Metadata

Usage: Displays a list of all the PMI model views contained within the current file, for the selected part.

Type: list.



Properties



Show Header Row Displays or hides the header row

Insert Assembly Row Check and insert special row “…” associated to model assembly

Category/Property from (7 fields) Special values are:

● _PartName for part name● _Qty for quantity

Sort By Column Allow perform list sort by specified column

Sort Order Type of sorting:

● None● Ascending● Descending

Insert Column Symbol Inserts symbol | as column divider

Spaces Count Allows defining count of spaces between columns. Applies only if Insert Column Symbol is false.


List Callouts

Usage: Displays callouts lists (with quantities) that associated with active step or model view.

Type: list.

Properties



Show Parts IDs Displays or hides the ids of parts column




List Model Views (Reference)

This section is a reference to the control from the Model View Controls group.

PMI On/Off

Usage: Turns the current model view PMI data on or off.

Type: button.

Properties




PMI Part Metadata

Usage: Used to view the attributes and properties that are associated with parts when they are created, including surface tolerance data and title block information.

Type: text field.

Properties



Metadata Property Metadata Property The name of the applicable metadata to display in the text field:

● TITLE_BLOCK● NOTES● TOLERANCES


Parse Metadata from Line The line number from which to display the metadata

Parse Metadata to Line The line number to which to display the metadata






NoteThe setting -1 indicates Show all Metadata, or displays all metadata to the end of a metadata block.

Model Render Modes Control

Usage: Model render modes are used to display the 3D model in different rendering modes. This control allows you to select different render modes. These controls appear as three custom radio buttons.

Type: radio-button.

Properties



Button 1 Render Mode Name of the first render mode to display

Button 2 Render Mode Name of the second render mode to display

Button 3 Render Mode Name of the third render mode to display


NoteIf you require more than three available render modes in which to view the 3D scene, use this control twice, and nominate a further three.

5.6 Selection Controls

Selection controls are used to manage the way that different components display in the 3D model. For example, to hide certain parts of the model, or to show any metadata associated with a model.

Hide Selected

Usage: Hides the selected part in the 3D scene.


Type: button.

Properties




Hide Unselected

Usage: Hides all unselected parts in the 3D scene.

Type: button.

Properties




Show All

Usage: Show all 3D parts in the 3D scene.

Type: button.

Properties




Selected Part Name

Usage: Displays the name of the selected part in the 3D scene.

Type: text field.



Properties




Part Info

Usage: Launches a PDF of the selected part name.

Type: button.

Properties



Parts Directory The location of the directory in which the parts are located


NoteThe PDF which is launched must have the same name as the selected part (Partname.pdf) and placed in the Parts Directory. For example, exported.pdf is saved as C:\output\sample.pdf. All parts information is placed in C:\output\info\<part_name>.pdf. In this case, Parts Directory must be set to info and full file name for part body is C:\output\info\body.pdf.

Add to Cart

Usage: Add the selected part and associated metadata to a purchase order PDF.

Type: button.

Properties





Change Material

Usage: A control to change the diffuse RGB color of a material in a 3D scene.

Type: button.

Properties



Material Name Name of the target material

Diffuse Color RGB color of the target material


Part Metadata (Reference)

This section is a reference to control from Metadata group.

5.7 Metadata Controls

Metadata controls are used to manage the way that any metadata associated with a model displays in the document.

Metadata Category Dropdown

Usage: Displays a dropdown list of all the Metadata Categories.

Type: Dropdown.

Properties






Named Metadata Category

Usage: Changes the Category.

Type: button.

Properties



Category An option to give the category a specific name


Metadata Category List

Usage: Displays a list of all the Metadata Categories.

Type: list.

Properties




Metadata Category Radio

Usage: Displays the Metadata Categories as radio buttons.

Type: radio-button.

Properties



Button Metadata Category (5 fields) Name of the metadata category to display



Metadata Properties Dropdown

Usage: Displays a dropdown list of all Key Fields.

Type: Dropdown.

Properties



Metadata Category An option to give the category key a specific name

Collect All Properties An option to show all key names regardless of category


Named Metadata Property

Usage: Changes the Category Key used.

Type: button.

Properties



Metadata Category/Property An option to give the category and property a specific name

Show Metadata Category An option to display the category


Metadata Properties List

Usage: Displays a list of all the Metadata Field Keys.

Type: list.

Properties






Metadata Category An option to give the category a specific name

Show Metadata Values Displays the values next to the name in the list


Metadata Properties Radio

Usage: Displays the Metadata Category Keys as radio buttons.

Type: radio-button.

Properties



Button Metadata Property (5 fields) Name of the metadata key to display

Category of Button (5 fields) The associated metadata category


Part Metadata

Usage: Displays the Key field values.

Type: text field.

Properties



Metadata Category/Property Name of the part metadata.

RecommendationWe recommend that you use the <Category>/<Property> form of metadata name.

Parse Metadata From Line The line number from which to display the metadata




Allow Metadata Change An option to allow name change

Allow Drill-Down An option to allow drilldown on the metadata

Disable Read-Only Allows show scroll bars for very long text. You can modify the field but cannot save it.


NoteThe setting -1, indicates Show All Metadata, or displays all metadata to the end of a metadata block.

List BoM with Metadata (Reference)

This section is a reference to the control from the PMI group.

5.8 Standard View Controls

Standard view buttons are used to activate a specific model view of the 3D scene.

Left View

Usage: Displays the left view of a 3D scene.

Type: Button.

Properties






Right View

Usage: Displays the right view of a 3D scene.

Type: Button.

Properties




Top View

Usage: Displays the top view of a 3D scene.

Type: Button.

Properties




Bottom View

Usage: Displays the bottom view of a 3D scene.

Type: Button.

Properties




Front View

Usage: Displays the front view of a 3D scene.

Type: Button.


Properties




Aft View

Usage: Displays the rear view of a 3D scene.

Type: Button.

Properties




ISO View

Usage: Displays an isometric view of a 3D scene.

Type: Button.

Properties




5.9 Steps and Procedure Controls

Steps and Procedure buttons are used to produce PDF documents relating to step workflows. For example, the assembly or disassembly process of a 3D model.



First Step

Usage: Plays the first step of a procedure.

Type: Button.

Properties



Allow Procedure Change Allows change of steps set


Next Step

Usage: Plays the next step in the procedure.

Type: Button.

Properties





Play All Steps

Usage: Plays all steps of the procedure in a sequential order.

Type: Button.

Properties






Rewind All Steps

Usage: Resets all steps of the procedure.

Type: Button.

Properties





Previous Step

Usage: Plays the previous step in the procedure.

Type: Button.

Properties





Last Step

: Plays the last step in the procedure.

Type: Button.

Properties







Named Step

Usage: Activates the selected custom named step. To ensure that the step is activated, you must exactly match the Step Name within SAP 3D Visual Enterprise Author to the Step Name field in the control window.

Type: Button.

Properties



Step Name The custom name of the step.

NoteThe field value is case-sensitive.


Play Current Step

Usage: Plays the current step.

Type: Button.

Properties




Pause Current Step

Usage: Pauses the current step animation sequence.

Type: Button.

Properties





Rewind Current Step

Usage: Rewinds the current step animation sequence.

Type: Button.

Properties




Step Name Block

Usage: The custom name of the step.

Type: Text field.

Properties




Step Description Block

Usage: A detailed description of the step.

Type: Text field.

Properties



Allow Formatted Text Allows using any text format tags

Disable Read-Only Allows show scroll bars for very long text. You can modify the field but cannot save it.




Step Names Dropdown

Usage: A dropdown of step names.

Type: Dropdown

Properties





Step Names List

Usage: Lists step names only. That is, no numbers.

Type: List

Properties





Step Counter Block

Usage: A counter that shows the number of the current step.

Type: Text field

Properties






Step Numbers List

Usage: Displays the number of each step contained in the current file. These numbers are generated automatically. For example, the first step is “Step 1”, the second step is “Step 2”, and so on. When the file is saved into .pdf format, you select from a list of step numbers to display the related content.

Type: List

Properties





Step Metadata

Usage: Displays the metadata content related to the step metadata keyword.

Type: Text field

Properties






Metadata Property to Display Displays the metadata content related to a global or step metadata keyword (for the current file). If the keyword exists in the file, the related content is displayed. Otherwise, no content is displayed. To ensure that the content is displayed, you must name the object with the metadata keyword name; this name is located in the step description.

● PDF_CAMERA_MODE: Sets the camera to Walk, Pan, Rotate or Spin mode, depending on step metadata content.

NoteSpin mode is available for Acrobat 8.0 and 8.1 only.

● PDF_LAYERS_SET: Shows only this layer and hides all others.

● PDF_LAYERS_SHOW: Shows layers, without hiding any currently visible layers.

● PDF_LAYERS_HIDE: Hides layers, without showing any currently hidden layers.

Use Global Metadata Determines whether global metadata is used. If you are using step metadata, select No.

Disable Read-Only Allows displaying scroll bars for very long text. You can modify the field but cannot save it.


Step URL

Usage: Launches a web browser and opens a URL.

Type: Button



Find in Keywords Searches URL in simple form by keywords

Find In Description Searches URL in simple form by description



Procedures Dropdown

Usage: Controls the procedures.

Type: Dropdown

Properties



When Selected Searches URL in simple form by keywords


Named Procedure

Usage: Activates the selected custom named procedure.

Type: List

Properties


Procedure Name The custom name of the procedure.

NoteThe field value is case-sensitive.

When Selected Specifies the action of this control


Procedure List

Usage: Displays a list of all the procedures contained within the current file.

Type: List

Properties








Procedure Radio

Usage: Offers selection as to which procedure to display, up to a maximum of ten.

Type: Radio button

Properties




Button Procedure (ten fields) The name of the customized procedure. This name displays next to the button.


NoteIf five procedures are nominated, only five radio buttons display.

Procedure Name Block

Usage: Displays the name of the procedure.

Type: Text field

Properties





Procedure Description Block

Usage: Displays the customized description of the procedure.

Type: Text field

Properties



Allow Formatted Text Allows using any text format tags



5.10 Layer Controls

Layer controls are used to manage the way that model layers from SAP 3D Visual Enterprise Author can be seen and controlled in a PDF document.

Layers Dropdown

Usage: Controls the layers.

Type: Dropdown.

Properties




Named Layer

Usage: Activates a named layer.

Type: Button.



Properties



Layer Name The name of the customized layer. This name displays on the button.


Layers List

Usage: Displays a list of all the model layers contained within the current file.

Type: List.

Properties




Layers Radio

Usage: Offers selection as to which layer to display, up to a maximum of ten.

Type: Radio button.

Properties



Button Layer (10 fields) The name of the customized layer. This name displays next to the button.


Layers Description Block

Usage: Displays the customized description of the layer.

Type: Text field


Properties





5.11 2D Controls

2D controls are used to display 2D fields containing further information in the document. For example, the name of the author.

Static Metadata

Usage: Displays metadata relating to assemblies or scene.

Type: Text field

Properties



Metadata Category/Property Name of the scene metadata.

RecommendationThe Preferred form of metadata name is <Category>/<Property>.

Parse Metadata From Line The line number from which to display the metadata






Author Field

Usage: Displays the author of the PDF.

Type: Text field

Properties




Title Field

Usage: Displays the title of the PDF.

Type: Text field

Properties




Date Field

Usage: Displays the creation date of the PDF.

Type: Text field

Properties



Date/time type Date/time format of date (EN or US)


Scene Filename Field

Usage: Displays the name of the displayed file in the PDF.


Type: Text field

Properties




5.12 Utility Controls

You can use utility controls to manage the way that different components display in the document.

ExampleUse the page number control to insert a page number on each page of a multiple page document.

Page Number Control

Usage: Automatically displays the page number on each page.

Type: Text field

Properties


Extended Mode Allows the use of Count of pages value


NoteSet the Enable for Merge export option to true, otherwise this control may not work.

3D Navigation Help Control

Usage: Other fields are available to determine navigation options in a PDF document. Enables the 3D mouse controls.

Type: Picture



Properties




Important Disclaimers and Legal Information

HyperlinksSome links are classified by an icon and/or a mouseover text. These links provide additional information.About the icons:

● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements with SAP) to this:

● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any

damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.

Beta and Other Experimental FeaturesExperimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the experimental features in a live operating environment or with data that has not been sufficiently backed up.The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example CodeAny software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Gender-Related LanguageWe try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.


Important Disclaimers and Legal Information

SAP 3D Visual Enterprise, Third-Party Plug-InsImportant Disclaimers and Legal Information P U B L I C 59

www.sap.com/contactsap

© 2018 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice.

Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.

Please see https://www.sap.com/about/legal/trademark.html for additional trademark information and notices.

THE BEST RUN

https://www.sap.com/about/legal/trademark.html

Documents

SAP 3D Visual Enterprise, Third-Party Plug-Ins fileThe SAP 3D Visual Enterprise, third-party plug-ins Guide consists of the following main sections: