Geo::G...:Folder(3pm)

💖 Geo::G...:Folder(3pm) 💖

okay bestie, this is a page from the User Contributed Perl Documentation, and it's all about the cutest little folder object in the Google Earth-verse. let's get into it 🎀

---

✨ NAME ✨

Geo::GoogleEarth::Pluggable::Folder — it's giving Geo::GoogleEarth::Pluggable::Folder object. that's it, that's the name, no notes 💅

---

🌸 SYNOPSIS 🌸

so here's the whole vibe in three lines, look at her go:

use Geo::GoogleEarth::Pluggable;
my $document=Geo::GoogleEarth::Pluggable->new;
my $folder=$document->Folder(name=>"My Folder");

---

🦋 DESCRIPTION 🦋

Geo::GoogleEarth::Pluggable::Folder is literally a Geo::GoogleEarth::Pluggable::Base with a few other methods sprinkled on top. iconic behavior honestly 💖

---

🌈 USAGE 🌈

the whole point: make folders, nest folders, live your truth ✨

my $folder=$document->Folder();  #add folder to $document
my $subfolder=$folder->Folder(); #add folder to $folder

---

👑 METHODS 👑

💜 initialize

we overide the default initialize method (yes bestie, the original says "overide", we don't fix typos in here, we respect the source 💀) — and the reason is so we can append the plugins method from Module::Pluggable onto the packages list of the Method::Autoload package.

here's the tea:

• the packages property? that's what the Method::Autoload package needs.
• the plugins method? that's what Module::Pluggable provides.

so like... the Folder package now has every single method in the Plugins folder available to it at runtime. main character energy, no cap 👑

💖 Folder

Constructs a brand new Folder object and appends it to the parent folder object. Returns the object reference if you need to make any setting changes after construction. so thoughtful of her 🫶

my $folder=$folder->Folder(name=>"My Folder");
$folder->Folder(name=>"My Folder");

🦋 NetworkLink

Constructs a new NetworkLink object and appends it to the parent folder object. Returns the object reference if you need to make any setting changes after construction. same energy, different object 💅

$folder->NetworkLink(name=>"My NetworkLink", url=>"./anotherdoc.kml");

✨ LookAt

Constructs a new LookAt object and returns the object reference so you can assign it to other objects' "lookat" properties. this is the where am I pointing one 🔥

$document->LookAt(
                  latitude  => $lat,    #decimal degrees
                  longitude => $lon,    #decimal degrees
                  range     => $range,  #meters
                  tilt      => $tilt,   #decimal degrees from veritical
                  heading   => $header, #decimal degrees from North
                 );

ngl the comments say veritical and the variable is $header — that's exactly what the original says, so we keep it fr fr 🙈

🌸 type

Returns the object type. short, sweet, slay.

my $type=$folder->type;

⭐ node

(no description here bestie, it just exists. mysterious. love that for her.)

🍓 data

Pushes arguments onto the data array and returns an array or reference that holds the folder object content. It's a list of objects that supports a type and structure method. ✨

my $data=$folder->data;
my @data=$folder->data;
$folder->data($placemark);

💀 open

(also no description. the silence is loud. moving on.)

---

😭 BUGS 😭

Please log on RT and send to the geo-perl email list. be a good citizen about it okay 🫶

---

🙈 LIMITATIONS 🙈

Due to limitations in Perl hashes, it is not possible to specify the order of certain elements and attributes in the XML. it's not her fault, it's the hashes' fault 💀

---

🎀 TODO 🎀

(empty. nothing to do. a whole mood.)

---

🧚 SUPPORT 🧚

Try geo-perl email list. that's the move bestie 💖

---

💜 AUTHOR 💜

Michael R. Davis (mrdvt92)
CPAN ID: MRDVT

---

⭐ COPYRIGHT ⭐

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the LICENSE file included with this module. 📜

---

🌈 SEE ALSO 🌈

• Geo::GoogleEarth::Pluggable
• Module::Pluggable
• Method::Autoload
• XML::LibXML::LazyBuilder

---

and that's the whole page bestie!! 💖 this was perl v5.32.1 documentation from 2021-11-28, filed under Geo::G...:Folder(3pm) in the User Contributed Perl Documentation — go forth and nest those folders, you absolute icon 👑✨🎀