feat(shape): add rotate to modify-shape-helper

Author: singerla

__tests__/modify-shapes-rotate.test.ts

@@ -0,0 +1,22 @@
+import Automizer, { modify } from '../src/index';
+
+test('Add and rotate a shape.', async () => {
+  const automizer = new Automizer({
+    templateDir: `${__dirname}/pptx-templates`,
+    outputDir: `${__dirname}/pptx-output`,
+  });
+
+  const pres = automizer
+    .loadRoot(`RootTemplate.pptx`)
+    .load(`SlideWithShapes.pptx`, 'shapes');
+
+  const result = await pres
+    .addSlide('shapes', 2, (slide) => {
+      slide.modifyElement('Drum', [modify.rotateShape(45)]);
+      slide.modifyElement('Cloud', [modify.rotateShape(-45)]);
+      slide.modifyElement('Arrow', [modify.rotateShape(180)]);
+    })
+    .write(`modify-shapes-rotate.test.pptx`);
+
+  expect(result.slides).toBe(2);
+});

src/dev.ts

@@ -1,29 +1,4 @@
-import { vd } from './helper/general-helper';
-import Automizer, { modify, ModifyTextHelper, XmlHelper } from './index';
-import { XmlElement } from './types/xml-types';
-
-// const automizer = (outputName) =>
-//   new Automizer({
-//     templateDir: `${__dirname}/../__tests__/pptx-templates`,
-//     outputDir: `${__dirname}/../__tests__/pptx-output`,
-//     // You can enable 'archiveType' and set mode: 'fs'
-//     // This will extract all templates and output to disk.
-//     // It will not improve performance, but it can help debugging:
-//     // You don't have to manually extract pptx contents, which can
-//     // be annoying if you need to look inside your files.
-//     archiveType: {
-//       mode: 'fs',
-//       baseDir: `${__dirname}/../__tests__/pptx-cache`,
-//       workDir: outputName,
-//       // cleanupWorkDir: true,
-//     },
-//     rootTemplate: 'RootTemplate.pptx',
-//     presTemplates: [`SlidesWithAdditionalMaster.pptx`],
-//     removeExistingSlides: true,
-//     autoImportSlideMasters: true,
-//     cleanup: false,
-//     compression: 0,
-//   });
+import Automizer, { modify } from './index';
 
 const run = async () => {
   const automizer = new Automizer({
@@ -33,24 +8,19 @@ const run = async () => {
     showIntegrityInfo: true,
     assertRelatedContents: true,
     useCreationIds: true,
-    // archiveType: {
-    //   mode: 'fs',
-    //   baseDir: `${__dirname}/../__tests__/pptx-cache`,
-    //   workDir: `add-slide-master-auto-import.test.pptx`,
-    //   // cleanupWorkDir: true,
-    // },
   });
 
-  const pres = await automizer
-    .loadRoot(`EmptyTemplate.pptx`)
-    .load('SlideMasters.pptx')
-    .load('SlidesWithAdditionalMaster.pptx')
+  const pres = automizer
+    .loadRoot(`RootTemplate.pptx`)
+    .load(`SlideWithShapes.pptx`, 'shapes');
 
-    .addSlide('SlidesWithAdditionalMaster.pptx', 1, (slide) => {
-      slide.useSlideLayout('Leer');
+  const result = await pres
+    .addSlide('shapes', 2, (slide) => {
+      slide.modifyElement('Drum', [modify.rotateShape(45)]);
+      slide.modifyElement('Cloud', [modify.rotateShape(-45)]);
+      slide.modifyElement('Arrow', [modify.rotateShape(180)]);
     })
-
-    .write(`add-slide-master-auto-import.test.pptx`);
+    .write(`modify-shapes-rotate.test.pptx`);
 };
 
 run().catch((error) => {

src/helper/modify-shape-helper.ts

@@ -4,6 +4,7 @@ import { GeneralHelper } from './general-helper';
 import TextReplaceHelper from './text-replace-helper';
 import ModifyTextHelper from './modify-text-helper';
 import { XmlDocument, XmlElement } from '../types/xml-types';
+import { XmlHelper } from './xml-helper';
 
 const map = {
   x: { tag: 'a:off', attribute: 'x' },
@@ -101,4 +102,21 @@ export default class ModifyShapeHelper {
           .setAttribute(map[key].attribute, value);
       });
     };
+
+  /**
+   * Rotate a shape by a given value. Use e.g. 180 to flip a shape.
+   * A negative value will rotate counter clockwise.
+   * @param degrees Rotate by °
+   */
+  static rotate =
+    (degrees: number) =>
+    (element: XmlDocument | XmlElement): void => {
+      const spPr = element.getElementsByTagName('p:spPr');
+
+      if (spPr) {
+        const xfrm = spPr.item(0).getElementsByTagName('a:xfrm').item(0);
+        degrees = degrees < 0 ? 360 + degrees : degrees;
+        xfrm.setAttribute('rot', String(Math.round(degrees * 60000)));
+      }
+    };
 }

src/index.ts

@@ -42,6 +42,7 @@ const setText = ModifyShapeHelper.setText;
 const replaceText = ModifyShapeHelper.replaceText;
 const setPosition = ModifyShapeHelper.setPosition;
 const updatePosition = ModifyShapeHelper.updatePosition;
+const rotateShape = ModifyShapeHelper.rotate;
 
 const setTableData = ModifyTableHelper.setTableData;
 const adjustHeight = ModifyTableHelper.adjustHeight;
@@ -98,6 +99,7 @@ export const modify = {
   replaceText,
   setPosition,
   updatePosition,
+  rotateShape,
   setTableData,
   adjustHeight,
   adjustWidth,