model FixedShape "Visualizing an elementary shape with dynamically varying shape attributes (has one frame connector)"
import Modelica.Mechanics.MultiBody.Types;
extends Modelica.Mechanics.MultiBody.Interfaces.PartialVisualizer;
parameter Boolean animation = true "= true, if animation shall be enabled";
parameter Types.ShapeType shapeType = "box" "Type of shape"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input SI.Position r_shape[3] = {0, 0, 0} "Vector from frame_a to shape origin, resolved in frame_a"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input Types.Axis lengthDirection = {1, 0, 0} "Vector in length direction of shape, resolved in frame_a"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input Types.Axis widthDirection = {0, 1, 0} "Vector in width direction of shape, resolved in frame_a"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input SI.Distance length(start = 1) "Length of shape"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input SI.Distance width(start = 0.1) "Width of shape"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input SI.Distance height(start = 0.1) "Height of shape"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input Modelica.Mechanics.MultiBody.Types.Color color = {0, 128, 255} "Color of shape"
annotation (Dialog(
colorSelector = true,
group = "if animation = true",
enable = animation));
input Types.ShapeExtra extra = 0 "Additional data for cylinder, cone, pipe, gearwheel and spring"
annotation (Dialog(
group = "if animation = true",
enable = animation));
input Types.SpecularCoefficient specularCoefficient = world.defaultSpecularCoefficient "Reflection of ambient light (= 0: light is completely absorbed)"
annotation (Dialog(
group = "if animation = true",
enable = animation));
protected
Advanced.Shape vis(shapeType = shapeType, r_shape = r_shape, lengthDirection = lengthDirection, widthDirection = widthDirection, length = length, width = width, height = height, color = color, extra = extra, specularCoefficient = specularCoefficient, r = frame_a.r_0, R = frame_a.R) if world.enableAnimation and animation;
equation
frame_a.f = zeros(3);
frame_a.t = zeros(3);
annotation (
Documentation(info = "<html>\n<p>\nModel <strong>FixedShape</strong> defines a visual shape that is\nshown at the location of its frame_a.\nAll describing data such as size and color can vary dynamically by\nproviding appropriate expressions in the input fields of the\nparameter menu. The only exception is parameter shapeType\nthat cannot be changed during simulation.\nThe following shapes are currently supported via\nparameter <strong>shapeType</strong> (e.g., shapeType=\"box\"):<br> \n</p>\n\n<p>\n<img src=\"modelica://Modelica/Resources/Images/Mechanics/MultiBody/Shape.png\" alt=\"model Visualizers.FixedShape\">\n</p>\n\n<p>\nThe dark blue arrows in the figure above are directed along\nvariable <strong>lengthDirection</strong>. The light blue arrows are directed\nalong variable <strong>widthDirection</strong>. The <strong>coordinate systems</strong>\nin the figure represent frame_a of the FixedShape component.\n</p>\n\n<p>\nAdditionally, <strong>external shapes</strong> can be specified as (not all options might be supported by all tools):\n</p>\n\n<ul>\n<li> <strong>\"1\", \"2\", ...</strong><br>\n define external shapes specified in DXF format in files \"1.dxf\", \"2.dxf\", ...\n The DXF-files must be found either in the current directory or in the directory where\n the Shape instance is stored that references the DXF file.\n This (very limited) option should not be used for new models. Example:<br>\n shapeType=\"1\".<br></li>\n\n<li> \"<strong>modelica:</strong>//<Modelica-name>/<relative-path-file-name>\"<br>\n characterizes the file that is stored under the location of the\n <Modelica-name> library path with the given relative file name.\n Example:<br> shapeType = \"modelica://Modelica/Resources/Data/Shapes/Engine/piston.dxf\".<br></li>\n\n<li> \"<strong>file:</strong>//<absolute-file-name>\"<br>\n characterizes an absolute file name in the file system. Example:<br>\n shapeType=\"file://C:/users/myname/shapes/piston.dxf\".</li>\n</ul>\n\n<p>\nThe supported file formats are tool dependent. Most tools support at least DXF-files\nbut may support other format as well (such as stl, obj, 3ds).\nSince visualization files contain color and other data, the corresponding\ninformation in the model is usually ignored.\nFor information about DXF files, see <a href=\"https://en.wikipedia.org/wiki/AutoCAD_DXF\">Wikipedia</a>.\nAs a default it is assumed that the DXF coordinates are in the \"frame_a\"-system and in meters, and that the 3dfaces are two-sided.\nSome tools support only 3dface (for geometry) and layer (for advanced coloring).</p>\n\n<p>\nThe sizes of any of the above components are specified by the\n<strong>length</strong>, <strong>width</strong> and <strong>height</strong> variables.\nVia variable <strong>extra</strong> additional data can be defined:\n</p>\n<table border=1 cellspacing=0 cellpadding=2>\n<tr><th><strong>shapeType</strong></th><th>Meaning of parameter <strong>extra</strong></th></tr>\n<tr>\n <td>\"cylinder\"</td>\n <td>if extra > 0, a black line is included in the\n cylinder to show the rotation of it.</td>\n</tr>\n<tr>\n <td>\"cone\"</td>\n <td>extra = diameter-left-side / diameter-right-side, i.e.,<br>\n extra = 1: cylinder<br>\n extra = 0: \"real\" cone.</td>\n</tr>\n<tr>\n <td>\"pipe\"</td>\n <td>extra = outer-diameter / inner-diameter, i.e,<br>\n extra = 1: cylinder that is completely hollow<br>\n extra = 0: cylinder without a hole.</td>\n</tr>\n<tr>\n <td>\"gearwheel\"</td>\n <td>extra is the number of teeth of the (external) gear.\nIf extra < 0, an internal gear is visualized with |extra| teeth.\nThe axis of the gearwheel is along \"lengthDirection\", and usually:\nwidth = height = 2*radiusOfGearWheel.</td>\n</tr>\n<tr>\n <td>\"spring\"</td>\n <td>extra is the number of windings of the spring.\n Additionally, \"height\" is <strong>not</strong> the \"height\" but\n 2*coil-width.</td>\n</tr>\n<tr>\n <td>external shape</td>\n <td>extra = 0: Visualization from file is not scaled.<br>\n extra = 1: Visualization from file is scaled with \"length\", \"width\" and \"height\"\n of the shape</td>\n</tr>\n</table>\n<p>\nParameter <strong>color</strong> is a vector with 3 elements,\n{r, g, b}, and specifies the color of the shape.\n{r, g, b} are the \"red\", \"green\" and \"blue\" color parts.\nNote, r, g, b are given as Integer[3] in the ranges 0 .. 255,\nrespectively. The predefined type\n<a href=\"modelica://Modelica.Mechanics.MultiBody.Types.Color\">MultiBody.Types.Color</a> contains a menu\ndefinition of the colors used in the MultiBody library together with a color editor.\n</p>\n</html>"),
Icon(
coordinateSystem(
preserveAspectRatio = true,
extent = {
{-100, -100},
{100, 100}}),
graphics = {
Polygon(
points = {
{-100, 32},
{-64, 46},
{2, 30},
{72, 54},
{50, 32},
{-10, 12},
{-100, 32}},
lineColor = {215, 215, 215},
fillColor = {160, 160, 160},
fillPattern = FillPattern.Solid),
Polygon(
points = {
{72, 54},
{50, 32},
{50, -60},
{72, -32},
{72, 54}},
lineColor = {215, 215, 215},
fillColor = {160, 160, 164},
fillPattern = FillPattern.Solid),
Text(
extent = {
{-150, -65},
{150, -95}},
textString = "%shapeType"),
Text(
extent = {
{-150, 100},
{150, 60}},
textString = "%name",
lineColor = {0, 0, 255}),
Polygon(
points = {
{-100, 32},
{-100, -60},
{-10, -42},
{50, -60},
{50, 32},
{-10, 12},
{-100, 32}},
lineColor = {215, 215, 215},
fillColor = {0, 127, 255},
fillPattern = FillPattern.Solid)}));
end FixedShape;