cee::rep::ReportCreatorPowerPoint

class ReportCreatorPowerPoint

Report creator for a PowerPoint report.

The report creator contains the necessary information and data to create a PowerPoint report based on a given template.

The report creator object must be given a repository and a template file name upon creation. Additional settings such as a reference repository, generic snapshots indices, media type in the generated report and report images quality are also available.

After applying the necessary settings, the report is created using generate() specifying the name of the generated report.

For some scenarios it can be convenient to create a report using images instead of 3D models. For instance to compress the file size of the presentation, if the receiver is not able to install the Ceetron 3D Plugin or just a report where the plugin’s 3D interaction is not needed. Instead of having to create a new template using images, set setUse3dPlugin(false) and all plugin objects in the template will be replaced with snapshot if these are available within the VTFx file. Default is to use the 3D model for VTFx snapshots.

The VTFx model file is created in memory and embedded into the PowerPoint presentation.This enables you to easily share your Office document without being afraid of broken links. (The VTFx file will also be embedded into the repository file if this is saved.) If the user does not want to embed the VTFx files into the presentation, this feature can be turned off with setEmbedVTFx(false). Default is true.

Generic snapshots will default unroll for all snapshots with matching type in the repository. If only a sub-set of these should be used, you can specify this using setGenericSnapshotIndices().

Public Functions

ReportCreatorPowerPoint(Repository *repository, const Str &templateFile)

Creates a report creator for a PowerPoint document based on the given repository and template file.

bool generate(const Str &reportFile) const

Generates a report and save it to the file name given by reportFile.

Returns true if the report was successfully created. Returns false if an error occurred.

bool validate(Str *summary) const

Validates the template and creates a summery of the compatibility between the template and the repository.

void setReferenceRepository(Repository *repository)

Sets a reference repository to be used for this report generation.

void setGenericSnapshotIndices(const std::vector<unsigned int> &indices)

Sets the array of indices used for generic snapshots.

void setEmbedVTFx(bool embed)

Sets whether VTFx files should be embedded into the generated report files or not.

void setUse3dPlugin(bool use)

Sets whether the report should use the 3D plugin/cloud integration.

Setting use to false will replace all VTFx tagged objects in the template with images.

Public Static Functions

static bool summarize(const Str &templateFile, Str *summary)

Summarizes the content of the template file.