Occurrences.addFromConfiguration Method

Parent Object: Occurrences

PreviewThis functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.


Defined in namespace "adsk::fusion" and the header file is <Fusion/Components/Occurrences.h>

Description

Method that inserts a configuration from a configured design. The insert will fail if the configured design being used is not from the same project as the file it is being inserted into.

Syntax

"occurrences_var" is a variable referencing an Occurrences object.
returnValue = occurrences_var.addFromConfiguration(configurationRow, transform)
"occurrences_var" is a variable referencing an Occurrences object.

#include <Fusion/Components/Occurrences.h>

returnValue = occurrences_var->addFromConfiguration(configurationRow, transform);

Return Value

Type Description
Occurrence Returns the newly created occurrence or null if the add failed.

Parameters

Name Type Description
configurationRow ConfigurationRow The row that specifies which configuration to use.
transform Matrix3D A transform that defines the location for the new occurrence.

Version

Introduced in version January 2024