@pptx-editor.dev/pro/drawing

@pptx-editor.dev/pro/drawing: advanced drawing rendering.

The free engine paints pictures, shapes with fills, gradients, patterns, lines and outer shadows, text, tables, and groups. This module adds:

- the shape and picture effects glow, inner shadow, reflection, soft edge, and blur (ECMA-376 Part 1, 20.1.8); - 3-D shapes (ECMA-376 Part 1, 20.1.5): bevels, contours, and, under a turned camera, the turned face and its extrusion; - charts, drawn from the values cached in their chart parts (ECMA-376 Part 1, 21.2): bar and column charts (clustered, stacked, and percent stacked), line, area, scatter, pie, doughnut, and radar charts, with titles, legends, axes, gridlines, data labels, and number formats. 3-D, of-pie, stock, bubble, and surface charts, and charts with trendlines or error bars, keep the placeholder. A chart becomes shapes and labels that the engine lays out like any other shape, so the editor and the PDF export draw one layout. Its part saves unchanged.

Without it, a chart shows a labeled placeholder, and a shape or picture paints without those effects, and the editor chrome does not offer them (Shape Effects shows only the outer shadows, Picture Styles only the frame styles). The effect commands still write them to the file, and save keeps them. PDF export (@pptx-editor.dev/pptx-to-pdf) always includes this module.

The renderers serve every editor and export in the process. Install them before any document opens; a later install logs a console warning once. The chrome controls refresh after an install.

Functions (2)

drawingModulefunctionSource ↗

The drawing module for createPptxEditor({ modules }) and the adapters' modules prop. Creating it installs the drawing renderers process-wide, as [installDrawing](installDrawing) does.

declare function drawingModule(options?: ProLicenseOptions): EditorModule;

installDrawingfunctionSource ↗

Install the drawing renderers (charts, glow, inner shadow, reflection, soft edge, blur, and 3-D) for every editor and export in this process, without an editor module: for headless rendering. Installing again is harmless. A host without the EigenPal Pro License leaves this call out; its charts then show placeholders, and its shapes and pictures paint without those effects.

declare function installDrawing(options?: ProLicenseOptions): void;

Interfaces (1)

ProLicenseOptionsinterfaceSource ↗

Accepted by every pro entry point.

interface ProLicenseOptions
MemberTypeSummary
licenseKey?stringYour license key. Optional: evaluation use is permitted, production use requires a commercial agreement under the EigenPal Pro License (see LICENSE.md).