PDF::F...::Line(3pm)

📦
version 0.34 · 2 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 PDF::F...::Line — bestie edition 💖

okay so this is PDF::FromHTML::Template::Element::Line, a Perl module, and its whole personality is drawing lines. that's it. that's the job. and honestly? iconic. 🎀

(also the manual name is PDF::F...::Line(3pm) if you were wondering — yes the ellipsis is load-bearing, no I will not explain, iykyk ✨)

✨ NAME ✨

PDF::FromHTML::Template::Element::Line — to draw lines. literally just lines. slay. 🦋

🌸 NODE NAME 🌸

LINE

that's the node name. that's what you call it. periodt. 💅

🧬 INHERITANCE 🧬

PDF::FromHTML::Template::Element

so this one's a child of that one, it inherits the family vibes. 👑

🎀 ATTRIBUTES 🎀

  • X1 / X2 / Y1 / Y2 — the line goes from (X1,Y1) to (X2,Y2). that's the whole journey fr fr.
    • if neither X1 nor X2 is set, then X1 gets set to the lefthand margin, and X2 gets set to X1 + W. so it just vibes across the page on its own 🫶
    • if only one of them is set, the other one gets set to the first one +/- W. math is happening, we love to see it.
    • if either of the Y values isn't set, it gets set to the current Y value. easy.
  • W — this is the width of the line to be drawn. heads up: it's only used when calculating X1/X2/Y1/Y2, and only if it's actually needed (see above, q.v.). defaults to the distance between the left and right margins. (q.v. PAGEDEF for more info on those parameters — it's got the lore ✨)
  • WIDTH — this is the thickness of the line to be drawn. yes W and WIDTH are different things, don't @ me, defaults to 1 pixel. 😭
  • COLOR — the color to draw the line in. defaults to black. classic. 🖤

👶 CHILDREN 👶

PDF::FromHTML::Template::Element::HorizontalRule

it can have this one as a child. cute family dynamic honestly. 💜

💀 AFFECTS 💀

Nothing

it affects nothing. zero impact. it's just out here drawing lines and minding its business. 🙈

🧚 DEPENDENCIES 🧚

None

no dependencies, fully independent queen. no cap. 👑

⭐ USAGE ⭐

<line X1="1i" Y1="1i" X2="3i" Y2="2i" WIDTH="3" COLOR="0,0,255"/>

so what does this actually do?? it draws a blue line, 3 pixels thick, starting from the spot 1" in from the left and 1" from the top, and ending at the spot 3" from the left and 2" from the top. diagonal moment. ate. 🔥

🌈 AUTHOR 🌈

Rob Kinyon (rkinyon@columbus.rr.com)

thank you Rob, the line-drawing legend himself. 🫡

👀 SEE ALSO 👀

PAGEDEF, HR

go read those too bestie, they're in the group chat. 💬

okay that's the whole page!! no notes, no skipped details, every flag and default accounted for. 🍓

and for the record: this was perl v5.38.2, dated 2024-07-28 — so if you're reading this, hi from the archive, hope your lines are straight and your margins are clean 💖✨

mwah, bye bestie 💅🎀

📦 where this page comes from