Export Control
The Export Control can be used to reference a ShapeDiver Export component (Download Export or Email Export) in an App built with the App Builder components. The component links to an Export component using its name and allows overriding several of the properties defining the control in the final App.
The created control can then be included in a Controls Widget within the App.
First example
In the example below, we show a minimal definition including one Download Export component called “Export3dm” controlling the export of a 3dm file of the created Sphere:
Using the App Builder components, we create an App with a single Container on the right. In this container, we define a single Controls Widget, which itself contains one single Export Control.
The Export Control references the “Export3dm” export component by its name and defines a tooltip for the control in the App. The resulting App looks like this using the default template:
Properties
In addition to the Name input, the following inputs can be used to customize the control:
Display Name (optional): Defines a custom name for this export control in the App
Tooltip (optional): Add a tooltip to this parameter control in the App
SessionId (optional): The Id of the App session this parameter is linked to. Leave empty when using a single session.
Parameter Values (optional): A list of parameter value objects (created with the Parameter Value component) to include in the export request. See next section for an example.
Set custom parameter values
Using the “Parameter Values” input of the component, it is possible to specify a list of parameters which should be updated to a specific value when requesting the export. The specified parameters are not updated in the App, they are only used when triggering the export.
Consider the example below, where a slider called “UV Count” controls the number of faces of the created sphere:
The created App does not show this slider; as a consequence, it keeps its default value in the App (5), showing a coarser mesh optimized for display. However, we make use of a Parameter Value component with the Export Control in order to specify that, when requesting the export, the “UV Count” parameter should be set to a higher value (20).