Text Generator

Features ›› Tools ›› Text ››
Parent Previous Next

Text Generator by Jens Kafitz









Mari Extension Pack adds a Text Generation Tool to Mari:




Video




Text Generation Options


Text Generation Mode



Before you start to generate Text, you need to decide if you want the text created directly in the Paint Buffer or as a Paint Through Image.

Your prefered way of generating text is saved for future uses.


Paint Through Image


in the Viewport


and set as Paint Through Image


of the Set Project Paths Tool, also included in Extension Pack.


Paint Buffer


Buffer in the VIewport



Resolution



The Resolution field determines the Image Resolution of the generated Text.



       Image Resolution vs Paint Buffer Resolution



Don't forget to change it back when you are done, to the resolution you want to continue working in !



Screen Space Text Size


The Screen Space Text Size dynamically scales your font size up and down, to maintain the same size of the generated text

on screen between resolutions.

This allows you to work for example in 512x512 for fast Text Generation Mode, and then scale up to 2048x2048 in the end

while the result (font size, spacing etc.) stays the same on screen.


Screen Space Text Size is remembered between sessions






Work low, generate High


Generating a High resolution Image can take a second.

For fast iteration, work at low resolution, keep 'Screen Space Text Size' ticked on

and generate the final resolution when you are done





Position


The Position specifies the position of your generated text in the image or paint buffer




Generation Mode Tool Options


Depending on your chosen method of Text Generation, additional options are available


Paint Through Image



When in PaintThrough Image Text Generation Mode, the Unique Filename allows you to specify the Filename used to load

the generated Image into the Paint Buffer.


By default, the Text Generator will keep overwriting the previous generated Image.

If you wish to keep a generated Text for future use in the Image Manager, change the Filename and the Tool will not overwrite

the old Image.


The Filename is remembered between sessions.



Paint Buffer



For convenience several Paint Buffer Actions are directly available in the UI






Text Tool Reset Paint Buffer vs Default Mari Reset Paint Buffer


Other than the default Mari Reset Paint Buffer available in the 'Transform Paint' Toolbar

the Text Tool's Reset Buffer resets Transformations to the State they were in when the

Text Tool dialog was launched









Text Style Options


General Information



The Text Style options give you the usual controls over your text with some Tool specific modifications


when generating text in the viewport



value


the number behind the cursor (in 1, 10, 100 Steps)



Text Style




Font


Modify the font. All your installed fonts are shown



Font Style


Modify the font style such as Bold, Italic etc.


Font Size


Modify the font size.



increment the number behind the cursor (in 1, 10, 100 Steps)


Font Size Multiplicator


Multiplies the Font Size for all your document when generating the text. This allows you to work with large font sizes while still

seeing a reasonably sized preview in the text field.



increment the number behind the cursor (in 1, 10, 100 Steps)


Color


Modify the Text Color





Bold / Italic


Sets font to Bold or Italic. This also affects the font style dropdown


Underlined, Overlined, Strike


Adds a line under, over or through your text


All Caps


Capilalizes your Font


Small Caps


Capilalizes your Font, but applies it in a non-capitalized size


Superscript / Subscript


Adds Text above or below the font baseline





Kerning on/off


Toggles Kerning for the current font family





Alignment


Sets your Document Alignment to left, right or center







Letter Spacing


Modify the distance between individual Letters.



increment the number behind the cursor (in 1, 10, 100 Steps)



Font Stretching


Scale the font in X Axis



increment the number behind the cursor (in 1, 10, 100 Steps)





Font Stretching unavailable in Mari 3.x


Font Stretching is only available in Mari 4







Font Stretching only works with Font Sizes maxium 47


Font Stretching currently does not work with font sizes over 47.

This includes the font size multipliers and Screen Space Text Size.

E.g a Font Size of 47 with a multiplier of 2 will not work either






Word Spacing


Adjust the distance between words for your document



increment the number behind the cursor (in 1, 10, 100 Steps)



Writing System


Determines which fonts will be available in the Font Dropdown



Useful Shortcuts







Known Limitations



the original font color selection in the Text Tool.

This means that when you are using a viewport LUT other than sRGB (sRGB Aces etc.) the resulting color in the viewport

will be different from your color selection in the Text Tool.



This includes multipliers, so a Font Size of 47 with a multiplier of 2 will not work either


In these cases the Tool will be added to the Extension Pack Toolbar.





Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle