Excel:...::Image(3pm)

🌸 Excel::Template::Element::Image — bestie edition 💖

okay so welcome to Excel::Template::Element::Image, a lil Perl module from the Excel::Template::Element family, straight out of the User Contributed Perl Documentation. it's here to do one thing and one thing only: put a picture into your worksheet. that's it. that's the gig. 🎀

---

✨ NAME ✨

Excel::Template::Element::Image — yeah that's the whole name, it said what it said 💅

---

🎯 PURPOSE 🎯

to insert an image into the worksheet. that's the entire mission statement, no notes, iconic behavior 🦋

---

🏷️ NODE NAME 🏷️

IMAGE

that's the node name you write in your template. lowercase in your XML, all-caps in the docs, iykyk 😌

---

👑 INHERITANCE 👑

ELEMENT

it inherits from ELEMENT, so it's giving nepo baby but in a cute way 💜

---

⚡ EFFECTS ⚡

this will consume one column in the current row. one column. that's the toll, that's the price of admission, pay up bestie 🫶

---

📦 DEPENDENCIES 📦

None. zero. nada. it's self-sufficient, it's an independent queen, it doesn't need anybody ✨

---

🛠️ USAGE 🛠️

here's how you actually use it, and yes these are exactly the forms:

<image path="/Some/Full/Path" />
<image path="/Some/Full/Path" offset="2,5" />
<image path="/Some/Full/Path" scale="2,0.4" />
<image path="/Some/Full/Path" offset="4,0" scale="0,2" />

please see "" in Spreadsheet::WriteExcel for more info about the offset and scaling options, plus any other restrictions that might be in place. (yes, that reference is literally empty in the original — it's giving mystery, it's giving aura 😭)

🚨 lowkey important: this node does NOT perform any sort of validation upon your parameters. none. zero. you are assumed to know what you are doing. the module trusts you completely and that is terrifying if we're being honest 💀

also note that the offset and scaling values are "X,Y". you must provide both values, even if the Y value is 0. do not skip the Y, do not ghost the Y, the Y has feelings 🙈

and if you provide a 0 value for either scaling option, "" in Spreadsheet::WriteExcel will default that to 1. so a 0 is not a 0, it's a sneaky little 1 in disguise. character development fr fr ⭐

---

🖊️ AUTHOR 🖊️

Rob Kinyon (rob.kinyon@gmail.com)

shoutout Rob, thank you for your service 🫡

---

🔍 SEE ALSO 🔍

Nothing. literally nothing. no siblings, no friends, no neighbors, just vibes and an image 🌈

---

and that's the whole page bestie, you ate it, you understood it, periodt 💖

perl v5.34.0 — dated 2022-06-13 — Excel::...::Image(3pm) and that's the footer, mwah, go insert some pictures ✨🎀🦋