LIBRARY

PlaneShape

Plane shape primitive for 3D rendering.

Renders a flat rectangle in the plane spanned by length_direction and width_direction, centered at r + R * r_shape, with extents length x width. The height variable is unused.

This component extends from Shape

Usage

MultibodyComponents.PlaneShape(render=true, color=[0.5, 0.5, 0.5, 1.0], specular_coefficient=0.7)

Parameters:

Name	Description	Units	Default value
render	Whether this shape should be rendered	–	true
color	RGBA color of the shape	–	[0.5, 0.5, 0.5, 1.0]
specular_coefficient	Specular reflection coefficient (0 = fully diffuse)	–	0.7

Variables

Name	Description	Units
r	3D position of the shape origin in world frame	–
R	3D rotation matrix (orientation) of the shape in world frame	–
r_shape	Offset from r to shape origin, resolved in shape frame	–
length_direction	Primary axis direction (unit vector, resolved in shape frame)	–
width_direction	Secondary axis direction (unit vector, resolved in shape frame)	–
length	Dimension along length_direction	–
width	Dimension along width_direction	–
height	Dimension perpendicular to both length and width	–

Behavior

Dict{MIME{Symbol("text/plain")}, String} with 1 entry: MIME type text/plain => "Error displaying result"

Source

"""
Plane shape primitive for 3D rendering.

Renders a flat rectangle in the plane spanned by `length_direction` and
`width_direction`, centered at `r + R * r_shape`, with extents
`length` x `width`. The `height` variable is unused.
"""
component PlaneShape
  extends Shape
relations
metadata {"Dyad": {"icons": {"default": "dyad://MultibodyComponents/PlaneShape.svg"}}}
end

Flattened Source

"""
Plane shape primitive for 3D rendering.

Renders a flat rectangle in the plane spanned by `length_direction` and
`width_direction`, centered at `r + R * r_shape`, with extents
`length` x `width`. The `height` variable is unused.
"""
component PlaneShape
  "Whether this shape should be rendered"
  parameter render::Boolean = true
  "3D position of the shape origin in world frame"
  variable r::Real[3] = [0, 0, 0]
  "3D rotation matrix (orientation) of the shape in world frame"
  variable R::Real[3, 3] = RR(nullrotation())
  "Offset from r to shape origin, resolved in shape frame"
  variable r_shape::Real[3] = [0, 0, 0]
  "Primary axis direction (unit vector, resolved in shape frame)"
  variable length_direction::Real[3] = [1.0, 0, 0]
  "Secondary axis direction (unit vector, resolved in shape frame)"
  variable width_direction::Real[3] = [0, 1.0, 0]
  "Dimension along length_direction"
  variable length::Real = 0
  "Dimension along width_direction"
  variable width::Real = 0
  "Dimension perpendicular to both length and width"
  variable height::Real = 0
  "RGBA color of the shape"
  parameter color::Real[4] = [0.5, 0.5, 0.5, 1.0]
  "Specular reflection coefficient (0 = fully diffuse)"
  parameter specular_coefficient::Real = 0.7
relations
metadata {"Dyad": {"icons": {"default": "dyad://MultibodyComponents/PlaneShape.svg"}}}
end

Test Cases

No test cases defined.

Related

• Examples

• Experiments

• Analyses