DynaPDF.WriteFTextExRotated
---------------------------

Writes text on current page with formatting commands.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [DynaPDF](component_DynaPDF.md) | [7.4](newinversion74.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "DynaPDF.WriteFTextExRotated"; PDF; PosX; PosY; Width; Height; Align; Text; Alpha { ; PlainText } ) 

**MBS**( **"DynaPDF.WriteFTextExRotated";** /\* Writes text on current page with formatting commands. \*/  
**$PDF**; /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/   
**$PosX**; /\* X-Coordinate of output rectanglee.g. $x \*/   
**$PosY**; /\* Y-Coordinate of output rectanglee.g. $y \*/   
**$Width**; /\* Width of output rectanglee.g. $w \*/   
**$Height**; /\* Height of output rectangle or -1.  
Use -1 for auto size.e.g. $h \*/   
**$Align**; /\* The text alignment. Can be left, center, right or justify.e.g. "left" \*/   
**$Text**; /\* The text to write.e.g. "Hello World" \*/   
**$Alpha**; /\* The rotation angle in degrees.  
From 0 to 360 degrees.e.g. 90 \*/   
**$PlainText**) /\* Optional; Pass 1 to ignore formatting commands and treat text as plain text.  
Default is 0 to interpret commands in text.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |  |
| PosX | X-Coordinate of output rectangle | $x |  |
| PosY | Y-Coordinate of output rectangle | $y |  |
| Width | Width of output rectangle | $w |  |
| Height | Height of output rectangle or -1.   Use -1 for auto size. | $h |  |
| Align | The text alignment. Can be left, center, right or justify. | "left" |  |
| Text | The text to write. | "Hello World" |  |
| Alpha | The rotation angle in degrees.   From 0 to 360 degrees. | 90 |  |
| PlainText | Pass 1 to ignore formatting commands and treat text as plain text.   Default is 0 to interpret commands in text. | 0 | Optional      Added in version **9.1**. |

### Result

Returns OK or error message.

### Description

Writes text on current page with formatting commands.  
Same as [DynaPDF.WriteFTextEx](DynaPDFWriteFTextEx.md), but with additional rotation in center of box.  
  
See [DynaPDF.WriteStyledTextExRotated](DynaPDFWriteStyledTextExRotated.md) to convert FileMaker styles to DynaPDF commands.  
Changes coordinate system to Bottom-Up since we can't rotate well in Top-Down.  
See also [WriteFTextExRotated](https://www.monkeybreadsoftware.com/DynaPDF-Manual/WriteFTextEx.shtml) function in DynaPDF manual.

### Examples

Try it:

 Set Variable \[ $r ; Value: MBS ("[DynaPDF.AppendPage](DynaPDFAppendPage.md)"; $pdf ) \]   
Set Variable \[ $r ; Value: MBS ("[DynaPDF.SetFillColor](DynaPDFSetFillColor.md)"; $pdf ; 0; 0; 0) \]   
Set Variable \[ $r ; Value: MBS ("[DynaPDF.SetFont](DynaPDFSetFont.md)"; $pdf ; "Arial"; 0; 48) \]   
Set Variable \[ $r ; Value: MBS ("DynaPDF.WriteFTextExRotated"; $pdf ; 0; 400; 500; -1; "center"; "DO NOT PRINT";90) \]   
Set Variable \[ $r ; Value: MBS ("[DynaPDF.EndPage](DynaPDFEndPage.md)"; $pdf ) \]  
### See also

- [DynaPDF.AppendPage](DynaPDFAppendPage.md)
- [DynaPDF.EndPage](DynaPDFEndPage.md)
- [DynaPDF.New](DynaPDFNew.md)
- [DynaPDF.SetFillColor](DynaPDFSetFillColor.md)
- [DynaPDF.SetFont](DynaPDFSetFont.md)
- [DynaPDF.WriteFText](DynaPDFWriteFText.md)
- [DynaPDF.WriteFTextEx](DynaPDFWriteFTextEx.md)
- [DynaPDF.WriteStyledText](DynaPDFWriteStyledText.md)
- [DynaPDF.WriteStyledTextEx](DynaPDFWriteStyledTextEx.md)
- [DynaPDF.WriteStyledTextExRotated](DynaPDFWriteStyledTextExRotated.md)

### Release notes

- **Version 9.1**
    - Added PlainText flag to [DynaPDF.WriteFText](http://www.mbsplugins.eu/DynaPDFWriteFText.shtml), [DynaPDF.WriteFTextEx](http://www.mbsplugins.eu/DynaPDFWriteFTextEx.shtml) and [DynaPDF.WriteFTextExRotated](http://www.mbsplugins.eu/DynaPDFWriteFTextExRotated.shtml) functions.
- **Version 7.4**
    - Added [DynaPDF.WriteFTextExRotated](http://www.mbsplugins.eu/DynaPDFWriteFTextExRotated.shtml) and [DynaPDF.WriteStyledTextExRotated](http://www.mbsplugins.eu/DynaPDFWriteStyledTextExRotated.shtml).

### Blog Entries

- [MBS FileMaker Plugin, version 9.1pr2](https://www.mbsplugins.de/archive/2019-02-11/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.4pr2](https://www.mbsplugins.de/archive/2017-08-14/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 10th August 2017 , last changed 6th August 2023

  
[DynaPDF.WriteFTextEx](DynaPDFWriteFTextEx.md) - [DynaPDF.WriteStyledText](DynaPDFWriteStyledText.md)

[HTML Version](DynaPDFWriteFTextExRotated.shtml)