Clarify issue with pseudo-inline shapes and prepare for publish

Author: manfromarce

CHANGELOG.md

@@ -1,4 +1,4 @@
-## 0.15.0 - Not released yet
+## 0.15.0 - 2025.09.12
 
 - Support for shapes, lines and text boxes in DOCX to RTF converter.  
   Not everything is supported, see [Supported features](https://github.com/manfromarce/DocSharp/blob/main/documentation/Supported_features.MD) for reference.

documentation/Supported_features.MD

@@ -86,6 +86,7 @@ Only watermarks are not supported because they require full VML support in order
 [14]: Support for drawings is still incomplete:  
 - **Supported**: DrawingML shapes / lines / arrows (created by modern Word versions, unless in compatibility mode), text content, solid fill, gradient fill, picture/texture fill, line color, line style (dashed, dotted, double, cap, ...), line thickness
 - **Not supported**: VML (Word 2007 or compatibility mode), manual adjustments (corners / points adjustments and similar), freehand curve/polygon, some shapes that are not available in RTF and would require conversion to custom shapes, pattern fill, gradient/pattern for line, some advanced text layout options, effects, 3D effects, WordArt, diagrams, shape groups, drawing canvas
+- **Partially supported**: shapes in line with text (not floating) are preserved but not aligned properly.
 
 [15]: "Real" charts are not available in the RTF specification, so MS Word converts them to images or OLE objects.  
 This operation is complex and currently considered out-of-scope for this library.  

src/DocSharp.Docx/DocxToRtf/DocxToRtfConverter.DrawingML.cs

@@ -1191,6 +1191,10 @@ internal void ProcessTransform2D(A.Transform2D? transform2D, RtfStringWriter sb)
 
     internal void ProcessDrawingInline(Wp.Inline inline, RtfStringWriter sb)
     {
+        // TODO: for inline shapes with "fPseudoInline" in RTF, 
+        // we should also write a pict element of the same size as the shape, 
+        // otherwise RTF readers do not leave space for the shape and it overlaps with text, 
+        // also it's not vertically aligned with text baseline.
         var distT = inline.DistanceFromTop;
         var distB = inline.DistanceFromBottom;
         var distL = inline.DistanceFromLeft;
@@ -1215,28 +1219,36 @@ internal void ProcessDrawingInline(Wp.Inline inline, RtfStringWriter sb)
         }
         sb.WriteWordWithValue("shpright", extentXtwips);
         sb.WriteWordWithValue("shpbottom", extentYtwips);
+        sb.Write(@"\shpbxcolumn\shpbxignore\shpbypara\shpbyignore\shpwr3\shpwrk0\shpfblwtxt0\shpz0\shplockanchor");
 
         sb.WriteLine();
 
         sb.WriteShapeProperty("fUseShapeAnchor", false);
         sb.WriteShapeProperty("fPseudoInline", true);
-
-        if (distT != null)
-        {
-            sb.WriteShapeProperty("dyWrapDistTop", distT.Value);
-        }
-        if (distB != null)
-        {
-            sb.WriteShapeProperty("dyWrapDistBottom", distB.Value);
-        }
-        if (distL != null)
-        {
-            sb.WriteShapeProperty("dxWrapDistLeft", distL.Value);
-        }
-        if (distR != null)
-        {
-            sb.WriteShapeProperty("dxWrapDistRight", distR.Value);
-        }
+        sb.WriteShapeProperty("fAllowOverlap", "1");
+        sb.WriteShapeProperty("fLayoutInCell", "1");
+        sb.WriteShapeProperty("lockPosition", "1");
+        sb.WriteShapeProperty("lockRotation", "1");
+        sb.WriteShapeProperty("posrelh", "3");
+        sb.WriteShapeProperty("posrelv", "3");
+
+        // Not supported for inlines ? (however set to 0 in tested DOCX files)
+        //if (distT != null)
+        //{
+        //    sb.WriteShapeProperty("dyWrapDistTop", distT.Value);
+        //}
+        //if (distB != null)
+        //{
+        //    sb.WriteShapeProperty("dyWrapDistBottom", distB.Value);
+        //}
+        //if (distL != null)
+        //{
+        //    sb.WriteShapeProperty("dxWrapDistLeft", distL.Value);
+        //}
+        //if (distR != null)
+        //{
+        //    sb.WriteShapeProperty("dxWrapDistRight", distR.Value);
+        //}
     }
 
     internal void ProcessDrawingAnchor(Wp.Anchor anchor, RtfStringWriter sb)