Home Search

DriveWorks Pro 24
Duplicate Document Decal

Send Feedback

Duplicate Document Decal

Will duplicate the given decal in the DriveWorks 3D Document displayed in the given 3D Preview control.

The decal being duplicated must exist in the DriveWorks 3D Document displayed in the given 3D Preview control.

The task will duplicate a decal with the name specified in the task.

This task works on a 3D Document displayed in a 3D Preview Control.

In order to save changes made by this task the Save 3D Document task is required to be used.

We recommend applying the Save 3D Document task at the end of a Specification.

This task does not work on 3D Previews running in File mode or Autopilot mode.

Properties

Property NameDescription
Preview Control NameName of the 3D Preview control.
Source Decal NameThe name of the decal to duplicate.
Target Decal NameThe name of the destination decal.
OverwriteTRUE to replace an existing decal (if one exists).

Examples

Property NameExample RuleMeaning
Preview Control Name3DPreviewControlWill duplicate the decal from the DriveWorks 3D document displayed in the 3D Preview control named 3DPreviewControl.
Source Decal NameDoorSignWill duplicate the existing decal named DoorSign.
Target Decal NameDoorSignNewWill name the duplicated decal DoorSignNew.
OverwriteTrueWill replace an existing decal named DoorSignNew, if one exists.

If set to False and an existing decal exists the source decal will not be duplicated.

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs.

The status output navigation is as follows:

Success

  • Task ran successfully.

Success with Warnings

  • N/A - Should never be fulfilled

Failed

  • Unable to find a 3D Preview Control with the name <control name>.
  • Unable to delete the decal, the Preview Control must be previewing a 3D Document.
  • Unable to find the source decal with the name <decal name>.
  • The target decal name <decal name> is invalid. A valid name should be provided for the new decal.
  • An decal with the name <decal name> already exists. Decal names must be unique.