IN THIS ARTICLE
Polygon Prism Shape Component
The Polygon Prism Shape component creates a transparent cuboid volume. The prism shape is defined by points that lie on the local XY plane. The point positions create identical parallel planes that are separated by a height value, and are connected by edges at right angles. The Polygon Prism Shape can be defined using the component’s Height property and Edit functionality. Polygon Prism Shapes can have three or more sides that do not self-intersect. The Polygon Prism Shape component is not a mesh, but rather a helper geometry that can be used to define volumes for area lights, AI, shape gradients, audio, vegetation, PhysX, and any application that can utilize the Shape EBus. For more information on using Shape components, see Shape components.
|Visible||Enable to always display the shape in the viewport, even when the entity is not selected. Disable to hide the shape when the entity is not selected.||Boolean|
|Game View||Enable to display the shape while in game mode.||Boolean|
|Filled||Enable to display the shape as filled. Disable to display the shape as a wireframe.||Boolean|
|Shape Color||The color of the shape.||Eight bits per channel color: 0-255|
|Height||The height of the shape in meters.||0.0 to Infinity|
|Edit||Choose the Edit button to enter Edit mode. In Edit mode, you can modify the dimensions of the shape in the viewport using the methods outlined in Edit mode actions below. While in Edit mode, the Edit menu in the menu bar displays available actions and hotkeys. To exit Edit mode, choose Done in the component interface.|
- Select a vertex - Left-click any vertex.
- Add to selection - Hold Ctrl and Left-click an unselected vertex.
- Remove from selection - Hold Ctrl and Left-click a selected vertex.
- Select multiple - Hold Shift and Left-click and drag over multiple vertices.
- Move vertices - Left-click and drag the red and green transform manipulator of a selected vertex. The top and bottom prism planes must be parallel, so vertex movement is limited to the XY plane.
- Add a vertex - Hold Ctrl and Left-click on an edge between existing vertices.
- Delete a vertex - Hold Alt and Left-click on a vertex.
- Delete multiple vertices - Press Delete to delete all selected vertices.
- Modify Height - Left-click and drag the blue transform manipulator at the top-center of the Polygon Prism Shape.
- Snap vertices to position - Hold Ctrl + Shift and Left-click in the viewport to snap the selected vertices to the position.
- Snap vertices to grid - If the Snap to grid tool is enabled in Edit mode, vertices will snap to positions on the construction plane.
Use the following request functions with the
PolygonPrismShapeComponentRequestBus EBus interface to communicate with Polygon Prism Shape components in your game. The Polygon Prism Shape component also uses
VertexContainer functions. See
Vertex Container for more information.
|Adds a vertex to the polygon prism shape.||Vertex: Vector2||None||Yes|
|Removes all vertices from the polygon prism shape.||None||None||Yes|
|Returns a constant pointer to the underlying polygon prism shape object that contains the properties ||None||Yes|
|Inserts a vertex at the index position specified.||Index: Integer, Vertex: Vector2||None||Yes|
|Removes the vertex at the index position specified.||Index: Integer||None||Yes|
|Sets the Height of the polygon prism shape.||Height: Float||None||Yes|
|Modifies the vertex at the index position specified.||Index: Integer, Vertex: Vector2||None||Yes|
Refer to Shape component Ebus interface for a description of functions that are available to all Shape components.