Graphi...:Driver(3pm)

💖 Graphi...:Driver 💖

okay bestie, gather round 🫶 this one's Graphi...:Driver from section 3pm of the User Contributed Perl Documentation — yes the header really does abbreviate it like that, iconic of it honestly 💅

---

✨ NAME ✨

Graphics::Primitive::Driver — it's a Role for driver implementations 🎀

---

🌸 DESCRIPTION 🌸

so like… what is even the point of a library-agnostic intermediary representation of graphical components if you can't feed them to a library-specific implementation that actually turns them into drawings?? psht, none!! 😭 literally zero. the whole thing is giving "beautiful theory, no output" energy.

so yeah — to write a driver for Graphics::Primitive, you implement this role. that's the whole vibe. periodt. 👑

---

🦋 SYNOPSIS 🦋

my $c = Graphics::Primitive::Component->new({
  origin => Geometry::Primitive::Point->new({
      x => $x, y => $y
  }),
  width => 500, height => 350
});

---

🎨 CANVASES 🎨

when a path gets added to the internal list via do, it is stored in the paths attribute as a hashref. that hashref has two keys: path and op ✨

• the path is, well… the path. ground-breaking, i know 💀
• the op is the operation that was provided to do

and bc canvases are literally just lists of paths, you should also go read the next section, bestie. no skipping 🙈

---

🧚 PATHS AND HINTING 🧚

paths are lists of primitives 🌈 and primitives are all descendants of Geometry::Shape, which means they all have point_start and point_end. those two attributes are what let primitives chain together, like a little conga line of shapes 🫶

so to draw a path: iterate over the primitives, drawing each one. that's it, that's the job.

and when you pull each path from the arrayref, you should pull its accompanying hints via get_hint — the indexes match so like, they line up perfectly, no cap ✨ the hint may hand you some extra info:

🔥 PRIMITIVE HINTS 🔥

• contiguous — true if this primitive is contiguous with the previous one. example: it's used to determine if a new sub-path is needed for the Cairo driver 👀

💅 OPERATION HINTS 💅

• preserve

(yeah that's the whole entry bestie — the page lists preserve and does not elaborate. we simply do not invent lore here 🙈)

---

⚠️ WARNING ⚠️

Only this class or the driver itself should call methods starting with an underscore, because this interface may change. so like… hands off the underscore methods, bestie, they're not for you, they're private and they're volatile 😭 respect the boundary fr fr.

---

👑 METHODS 👑

• _do_stroke ($strokeop) — perform a stroke ✏️
• _do_fill ($fillop) — perform a fill 🎨
• _draw_arc ($arc) — draw an arc 🌈
• _draw_canvas ($canvas) — draw a canvas 🖼️
• _draw_component ($comp) — draw a component 🧩
• _draw_line ($line) — draw a line ➖
• _draw_rectangle ($rect) — draw a rectangle 🟦
• _draw_textbox — draw a textbox 💬
• _resize ($width, $height) — resize the current working surface to the size specified 📐
• _finish_page — finish the current 'page' and start a new one. some drivers that are not paginated may need to emulate this behaviour 🫠
• data — retrieve the results of this driver's operations 📦
• draw — draws the given Graphics::Primitive::Component. if the component is a container then all components therein are drawn, recursively 🌀
• get_text_bounding_box — given a Font and a string, returns a bounding box of the rendered text 🔤
• finalize — finalize the supplied component and any child components, recursively 🏁
• prepare — prepare the supplied component and any child components, recursively 🛠️
• write — write out the results of this driver's operations to the specified file 💾

---

💜 AUTHOR 💜

Cory Watson, "<gphat@cpan.org>" — ty for your service king 🫡

---

📜 COPYRIGHT & LICENSE 📜

Copyright 2008-2010 by Cory G Watson.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie!! 🎀 this was perl v5.34.0, dated 2022-06-14, served up fresh from the User Contributed Perl Documentation 💖 slay, go write a driver, you've got this 💅✨