Viz Artist

Version 3.11.0 | Published January 22, 2018 ©

Polygon

images/download/attachments/27788946/viz_icons_polygon.png
The Polygon Geometry plug-in enables the creation of user defined polygon shapes. The polygons are drawn and edited directly in the Scene Editor. Created Polygons can also be rotated to create a 3D object (see Revolve: Spline Rotation in 3D).

To create a Polygon, add the Polygon plug-in to a container and start drawing by clicking in the Scene Editor to create polygon nodes. A click, hold and drag converts the node into a spline handle for drawing curves. If an existing node is clicked on it removes the node, and if a line or spline is clicked on, between two nodes, it inserts a new node at this location. There are several Polygon plug-in Editor Shortcuts. If more than one polygon is created, in the same container, and if they overlap each other, they will act as masks.

Instead of drawing polygons manually, they can be imported as Adobe Illustrator files (*.ai) as well.

Note: Only Adobe Illustrator AI 88 format files are supported.

images/download/attachments/27788946/plugins_container_polygon_shape.png

Note: This plug-in is located in: Built Ins -> Geom plug-ins -> Default

This section contains the following topics:

See Also

Polygon Properties

To toggle between the Polygon and Container properties:

  • Click the Polygon or Transformation icon in the:

    • Scene Tree Container, or

    • The Properties panel

  • In the Scene Editor:

    • Outside the polygon bounding box: Right click and select Properties -> Geometry.

    • Inside the polygon bounding box: Right click and select Edit container.

      images/download/attachments/27788946/plugins_container_polygon_properties.png
  • Precision: Set the precision of the spline calculation

  • Import: Import Adobe illustrator files. Opens a window to select a file and import. Only Adobe Illustrator AI 88 format files are supported.

  • Revolve: See Revolve: Spline Rotation in 3D

  • Storage: Create a Spline with coordinates. Press <Enter> to apply

    images/download/attachments/27788946/plugins_geometries_polygon_storage.png

Polygon Scene Editor Context Menu

Right-click, and hold, in the polygon green bounding box, in the Scene Editor, to open the polygon context menu. To select a menu option see To Select an Option from the Context Menu.

Note: The right-click must be inside the created polygon shape box. If a click is outside the bounding box then the standard Scene Editor menu will be shown.

images/download/attachments/27788946/plugins_container_polygon_context_menu.png

  • New spline: Create a new polygon in the same container

  • Close/Open: Open or close a polygon

  • Cut: Cut the selected polygon or spline nodes

  • Copy: Copy the selected polygon or spline nodes

  • Paste: Paste the selected polygon or spline nodes

  • Mirror X/Mirror Y: Mirror the created shape in the X or Y axis

  • Flip x/Flip y: Flip the created shape in the X or Y axis

  • Edit container: Open the Container editor and exit polygon edit mode. To edit the polygon again click on the polygon icon in the properties editor or the Scene Tree

To Select an Option from the Context Menu

  1. Right-click and hold.

  2. Move the cursor to the required option.

  3. Release to select.

To Create a Simple Spline

  1. Create a Container.

  2. Add the Polygon plug-in.

  3. Click on the Polygon icon (in the Container or the Properties editor).

  4. The polygon splines are created by each click in the Scene Editor:

    • Click in the Scene Editor to create a spline point

    • Click and drag in the Scene Editor to create a spline node, complete with handles (continue the drag to increase the length of the handles)

      images/download/attachments/27788946/plugins_container_polygon_first_point_anno.png
  5. While the polygon plug-in is active each click in the Scene Editor will create more polygon points, and create the polygon shape.
    images/download/attachments/27788946/plugins_container_polygon_five_point.png

    Tip: At any time press and release <Delete> to remove the last created point. Press and hold <Delete> to remove more than one spline, or remove the whole polygon.

    Once the spline has been created it can be modified, as required, with various shortcuts (see Polygon plug-in Editor Shortcuts). List below are some common examples:

To Draw a New Spline

  1. Right-click in an existing spline.

  2. Click New Spline.

  3. Add intersections as detailed in To Create a Simple Spline.

To Move a Spline

  1. Select the spline to be moved:

    • Press <S> and click on a spline.

  2. Press <Alt> and drag.

    Tip: If there is only one spline in the Container, press <Alt> and drag.

To Move More Than One Spline

  1. Select the splines to be moved:

    • Press <S> and drag around the splines.

  2. Press <Alt+S> and drag.

To Add or Delete a Spline Point

  • Click anywhere on a spline to add another spline point.

  • Click on a spline point to delete it

To Move Spline Points

  1. Press and hold <Ctrl>.

  2. Click on a spline point and drag.
    When <Ctrl> is pressed move any spline points as required.

To Create or Delete a Spline Point Handle

  1. Press <Shift>:

    • Create: Click on a spline point and drag.

    • Delete: Click on a spline point with a handle.

To Resize a Spline Point Left or Right Handle

  1. Press <Shift>.

  2. Click on a spline point handle and drag. Only the selected handle will move.

To Resize a Spline Point Handle

  1. Press <Ctrl>.

  2. Click on a spline point handle and drag. The left and right handles will move as one handle.

    Note: The handle clicked on can be lengthened as required. The other handle will stay the same length

    Note: If either the left or right handle has been moved individually, this will set the two handles together again

To Mirror Spline Sections

  1. Right-click on a spline, or select particular nodes of it with <S>.

  2. Select either:

    • Mirror X: Mirrors whole spline along the X axis.

    • Mirror y: Mirrors whole spline along Y axis.

To Flip a Spline

  1. Right-click on a spline.

  2. Select either:

    • Flip x: Flips whole spline over X-axis.

    • Flip y: Flips whole spline over Y-axis.

Scene Editor Grid

The Scene Editor Grid Tool-bar can be used as a great tool to help draw polygons. Together with the grid snap option polygon points can positioned, simply and accurately, in the 3D space.

Make sure that the polygon is aligned with the grid for the grid snap to work.

To Create a Spline in the Scene Editor Grid Snap

  1. In the Scene Editor click images/download/attachments/27788946/workbench_grid_icon.png (Grid).

  2. Click images/download/attachments/27788946/plugins_geometries_grid_plain_type.png (Plane Type).

  3. Click images/download/attachments/27788946/workbench_free_grid_icon.png (Free Grid).

  4. Click images/download/attachments/27788946/workbench_gridsnap.png (Snap to Grid).

  5. Create a spline. Each spline point will snap to the nearest cross hairs on the grid.

    images/download/attachments/27788946/plugins_container_spline_grid.png

To Move a Spline in the Grid with Snap

  1. In the Scene Editor click images/download/attachments/27788946/workbench_grid_icon.png (Grid).

  2. Click images/download/attachments/27788946/plugins_geometries_grid_plain_type.png (Plane Type).

  3. Click images/download/attachments/27788946/workbench_free_grid_icon.png (Free Grid).

  4. Click on images/download/attachments/27788946/workbench_grid_motp.png (Move Object to Plane).

  5. Press <Alt>.

  6. Click on the Spline and drag.

    Note: If there is more than one Spline to be moved see To Move More Than One Spline.

    The Spline will snap to the next set of cross hairs, and so on, as it is dragged.

Revolve: Spline Rotation in 3D

The Spline rotation creates a 3D mesh by rotating the created spline.

images/download/attachments/27788946/plugins_container_polygon_shape_curve.png
Use the Polygon Revolve Properties panel to modify the Spline as required.

Polygon Revolve Properties

images/download/attachments/27788946/plugins_container_polygon_properties.png
The Polygon Revolve properties are available after the first spline point has been added to the Scene Editor. Click on Rotate to activate.

  • Precision: Set the precision of the spline calculation

  • Import: Import Adobe illustrator files. Opens a window to select a file and import. Only Adobe Illustrator AI 88 format files are supported.

  • Rotate: Click to create the revolve mesh and activate all its settings

    • Rotate in degrees box: Set the degree of rotation

  • Tessellation: Sets the degree of detail for the mesh

  • Shading Angle: Define how the shading normal are aligned on the revolve object surface

  • Culling: Set which side of the spline to view:

    • Back: View the back side of the spline

    • Front: View the front side of the spline

      Note: To view both sides at the same time, add the Expert plug-in to the Container and active Back Face.

  • Revolve Around: Set the axis to rotate the spline around

    • Local Axis: When the Rotation angle is changed the rotation is calculated around the Container axis

    • First to Last: When the Rotation angle is changed the rotation is around the first and last spline point (Revolve Axis is grayed out)

  • Revolve Axis: Set which axis to rotate around:

    • Y: The rotation is around the Y axis

    • X: The rotation is around the X axis

  • Direction: Set which direction to view the rotation:

    • Right-hand: View from the right hand side

    • Left-hand: View from the left hand side

  • Show Hull: Show the rotated shape (1 and 2)

  • Show Caps: Show the original polygon shape at the beginning and end of the rotation (1 and 3)

    images/download/attachments/27788946/plugins_container_spline_hull_caps_anno.png

To Rotate a Spline

  1. Create a spline.

  2. Click on Rotate.

  3. Modify the created 3D object with the Polygon Revolve Properties.