Feature Request: more Image formatting options

[benwa]

I'd like to be able to set an image to be behind text. For completeness, here are all the options I could find:

Option	MS Learn
In line with text	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.inline
Square	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.wrapsquare
Tight	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.wraptight
Through	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.wordprocessing.textwrappingvalues#documentformat-openxml-wordprocessing-textwrappingvalues-through
Top and bottom	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.wraptopbottom
Behind text (also in front of text)	https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.wrapnone

Additionally, the following is how you can change the image to a fixed position on page, which is generally a requirement for aligning background images. https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.wordprocessing.positionoffset

[iainbrighton]

Hi @benwa,

Unfortunately, I don't think this is likely to be implemented (at least by me!). PScribo was never intended to be a full-blown Word authoring tool. It's primarily intended to support generating and exporting multiple document formats in Windows PowerShell and Microsoft PowerShell (Core). Ensuring the number of image options works across all platforms and document formats, and is rendered consistently and correctly, seems daunting.

If you want advanced Word document authoring, I would look for a module that is solely focused on producing .docx files and doesn't have to worry about compatibility with other document formats, e.g. PSWriteWord.

Sorry this isn't what you want to hear,
Iain

[benwa]

This is mostly for automatically setting company branding images in the header, cover page, and footer for AsBuiltReport generated documents. Currently, I have it dumping the images into the main Word structure and then manually moving them and setting the options by hand. Was just hoping to have that part done automatically.