Enable Python access to plLayer and ImageLibMod textures.

[Deledrius]

In order to facilitate the expansion of existing Ages as well as adding new Fan Ages, this PR provides a way to modify textures dynamically through Python scripts. It is especially ideal for otherwise-identical meshes whose appearance can be easily changed with only a texture swap. Book covers and Linking Panels are the primary intended targets.

Planned uses:

• Random selection of backdrop images on the StartUp menu screen, showcasing Ages from interesting perspectives.
• Adding new books to the Nexus with minimal modifications. Currently, to add a new Age to the Nexus, an entire new copy of the book mesh and animations is required, with extensive and error-prone wiring and material duplication. This PR allows the entire book machine jumble to be simplified into a single book and an ImageLibMod containing the linking panels which can then be assigned based on the current selection.
• Adding new books to Relto with minimal modifications. The Relto Bookshelf's selection of books is currently hard coded, making it difficult to add, remove, or change books. This PR would allow dummy books to be skinned with different covers depending on dynamic conditions (player-vault-based data, for instance).
• Adding new books to Chiso with minimal modifications. Chiso Preniv's many books could likewise be more easily assigned and updated with only a minor script update and a new image added to an ImageLibMod, simplifying new-Age-related updates.

This PR:

• Adds Python access to plLayer textures.
• Adds Python access to ImageLibMods through their plSceneObject.
• Adds a new ptAttrib for assigning plLayers in PlasmaMax PFMs.
• Provides a small demonstration function added to the StartUp Age to show the simplicity of using the new features. (Draft only, not intended for merge outside of Gehn).

Questions for reviewers:

• Is this the best way to accomplish these goals? Is this safe?
• Is this sufficiently complete? More access to the plLayer is possible, though more would not necessarily be useful.

[Hoikas]

I think we should probably toss the whole BUILDING_PYPLASMA thing from the new code. It makes things hard to follow.

[Deledrius]

I think we should probably toss the whole BUILDING_PYPLASMA thing from the new code. It makes things hard to follow.

I agree, and was thinking the same thing (which is why I asked about it in the chat last week). It's useless to us, unfortunately, and just makes everything harder to read. I'll remove it from this one.

Doing all of pfPython was going to affect a lot of files though, so I haven't done it yet. Will probably open a separate PR for that.

[Hoikas]

Still waiting on:

• Enable Python access to plLayer and ImageLibMod textures. #1360 (comment)
• Enable Python access to plLayer and ImageLibMod textures. #1360 (comment)

[Hoikas]

What is the status here?

[Deledrius]

What is the status here?

Working on a few things to get it finished up, but my time has been limited. I hope we can finish this one soon. :)

Stale

[Hoikas]

@Deledrius I've done a pass on everything to fix a few nits. I also added two new helpers: PtFindImage and PtFindLayer to help in the case of layer attributes not being present. I was able to successfully test the branch by adding this to the startup python file:

            layer = PtFindLayer("Map #38", age="GUI", page="GUIDialog04a")
            tex = PtFindImage("xavatarcustom")
            PtDebugPrint(f"hello {layer=}, {tex=}")
            layer.setTexture(next(iter(tex)))

Let me know if you have any concerns. I'm OK with merging the start up changes as-is without a corresponding assets PR.