Documentation Center

Viz Artist

Version 3.11.0 | Published January 22, 2018 ©

Max Size

images/download/attachments/27789571/viz_icons_maxsize.png
The Max size plug-in is used to set max size parameters for text objects. This allows you to have control over the space the text should use such that it does not ‘overflow’ the designated text area.

Note: This plug-in is located in: Built Ins -> Container plug-ins -> Tools

This section contains information on the following topics:

Max Size Properties

images/download/attachments/27789571/plugins_container_maxsize_editor.png

  • Default x-scale: Sets the default x-scale

  • Default y-scale: Sets the default y-scale

  • Max size: Sets the direction of the size to be controlled:

    • x: Control the width

    • y: Control the height

  • Max width/height: Sets the maximum width or height, depending on whether x or y is selected for Max size

  • Scale y/x: Scales the y or x value accordingly when maximum width or height is reached, respectively

  • Initialize text scale: Initializes the plug-in parameters.

To Set Maximum size

images/download/attachments/27789571/plugins_container_maxsize_example.png

  1. Add a group container to the scene tree

  2. Add a group container as a Sub-Container of the first (scaled to 1,1,1) and name it text

  3. Add a font (e.g. Georgia Regular) to the text container

  4. Add the MaxSize plug-in to the text container

  5. Click the MaxSize plug-in and set Max width to 200.0

    images/download/attachments/27789571/plugins_container_maxsize_example_both.png

  6. Click the font and type Create

  7. Now type Create more

    • This will automatically scale the font’s X value as it limits itself to the Max width

      images/download/attachments/27789571/plugins_container_maxsize_example3.png

  8. Optional: Click the MaxSize plug-in and enable the Scale Y parameter to automatically scale the font’s Y value
    When working with scenes that includes vertically aligned text direction, such as East Asian languages where top to bottom columns of text can be desirable, please pay attention to the vertical orientation selected in the Text editor. When the text scale is adjusted with Max size, the selected vertical orientation can affect the text geometry’s position:

  • Top: The geometry’s center is always at the top of the boundary. Changes to the text scale will not change the geometry position

  • First Line: The geometry’s center is always at the base of the first line. Because of this, changes to the text scale will also move the geometry’s boundary

  • Center: Because the geometry’s center is not the same as the center of the boundary, the boundary will be moved slightly when the text scale is changed

  • Bottom: The geometry’s center is always at the base of the last line of text, but this is not the same as the bottom boundary. This results in the boundary being moved when the text scale is changed
    This allows for more flexible choices when designing a scene, and should be selected based on the desired result.

See Also