Bamboo/better error handling for media assets

.nvmrc

@@ -0,0 +1 @@
+17

README.md

@@ -277,3 +277,12 @@ If you find this library useful, please consider sponsoring us through a [donati
 Copyright © 2015-present [Brent Ely](https://github.com/gitbrent/PptxGenJS)
 
 [MIT](https://github.com/gitbrent/PptxGenJS/blob/master/LICENSE)
+
+---
+
+# How to run your branch locally
+
+- Make sure you are using the correct node version (Check .nvmrc file)
+- Run the command `npm run ship` to bundle your changes
+- On your terminal, `cd` into `demos` folder then run `node browser_server.mjs`
+- Open [http://localhost:8000/browser/index.html](http://localhost:8000/browser/index.html) on your browser and test your changes in the sandbox

demos/browser/index.html

@@ -743,6 +743,14 @@ <h6 class="text-primary">Slide 4: Source URLs</h6>
 									<li>Source: URL variables</li>
 								</ul>
 							</div>
+							<div class="col">
+								<h6 class="text-primary">Slide 5: Image Shadows</h6>
+								<ul class="mb-0">
+									<li>Type: Outer</li>
+									<li>Type: None</li>
+									<li>Type: Inner</li>
+								</ul>
+							</div>
 						</div>
 					</div>
 					<div class="card-footer text-center">

demos/modules/demo_chart.mjs

@@ -1135,6 +1135,7 @@ function genSlide12(pptx) {
 		dataLabelColor: "FFFFFF",
 		dataLabelFontSize: 14,
 		dataLabelPosition: "bestFit", // 'bestFit' | 'outEnd' | 'inEnd' | 'ctr'
+		chartPieExplosion: 50
 	});
 
 	// TOP-MIDDLE

demos/modules/demo_image.mjs

@@ -27,6 +27,7 @@ export function genSlides_Image(pptx) {
 	genSlide02(pptx);
 	genSlide03(pptx);
 	genSlide04(pptx);
+	genSlide05(pptx);
 }
 
 /**
@@ -279,3 +280,29 @@ function genSlide04(pptx) {
 	);
 	slide.addImage({ path: IMAGE_PATHS.sydneyBridge.path, x: 0.5, y: 5.16, h: 1.8, w: 12.33 });
 }
+
+/**
+ * SLIDE 5: Image Shadow
+ * @param {PptxGenJS} pptx
+ */
+ function genSlide05(pptx) {
+	let slide = pptx.addSlide({ sectionTitle: "Images" });
+
+	slide.addTable([[{ text: "Image Examples: Shadows", options: BASE_TEXT_OPTS_L }, BASE_TEXT_OPTS_R]], BASE_TABLE_OPTS);
+	slide.addNotes("API Docs: https://gitbrent.github.io/PptxGenJS/docs/api-images.html");
+	slide.slideNumber = { x: "50%", y: "95%", w: 1, h: 1, color: COLOR_BLUE };
+
+	// EXAMPLES
+
+	// OUTER SHADOW
+	slide.addText("Shadow: `type:outer`, `opacity:0.5`, `blur:20`, `color:000000`, `offset:20`, `angle:270`", { x: 0.5, y: 0.6, w: 6.0, h: 0.3, color: COLOR_BLUE });
+	slide.addImage({ path: IMAGE_PATHS.tokyoSubway.path, x: 0.78, y: 2.46, w: 3.3, h: 2, shadow: {type: 'outer', opacity: 0.5, blur: 20, color: '000000', offset: 20, angle: 270} });
+
+	// NO SHADOW
+	slide.addText("Shadow: `type:none`", { x: 5, y: 1.2, w: 6.0, h: 0.3, color: COLOR_BLUE });
+	slide.addImage({ path: IMAGE_PATHS.tokyoSubway.path, x: 4.52, y: 2.46, w: 3.3, h: 2, shadow: {type: 'none'} });
+
+	// INNER SHADOW
+	slide.addText("Shadow: `type:inner`, `opacity:1`, `blur:20`, `color:000000`, `offset:20`, `angle:270`", { x: 8, y: 0.6, w: 6.0, h: 0.3, color: COLOR_BLUE });
+	slide.addImage({ path: IMAGE_PATHS.tokyoSubway.path, x: 8.42, y: 2.46, w: 3.3, h: 2, shadow: {type: 'inner', opacity: 1, blur: 20, color: '000000', offset: 20, angle: 270} });
+}