Materials

VisualMaterial(; color         = defaultColor(),
                 wireframe     = false,
                 transparency  = 0.0,
                 reflectslight = true,
                 shininess     = 0.7,
                 shadowMask    = CastsAndReceivesShadows)

Return a material object that defines attributes for the visualization of an Object3D that has visual or solid properties.

Arguments

• color defines the material color
  • color::Vector{Int}: The color is defined by a vector of RGB values where every value can be in the range 0..255. Example: color = [255, 0, 0].
  • color::String: The color is constructed by using color as key of named colors. Example: color = "lightsteelblue1" or color = "LightSteelBlue1". Note, color names are case insensitive.
  • Otherwise: Any other of the color specifications can be used.
• wireframe: = false, if solid, otherwise wireframe representation.
• transparency: = 0.0 (opaque) ... 1.0 (fully transparent).
• reflectslight: = true if it reflects light and false, if it does not reflect light.
• shininess: = 0.0 (matte surface) ... 1.0 (very shiny surface).
• shadowMask: defines whether or not an object casts or receives shadows. Possible values: NoShadows, CastsShadows, ReceivesShadows, CastsAndReceivesShadows.

Examples

using Modia3D

material = VisualMaterial(color         = "Green",
                          wireframe     = false,
                          transparency  = 0.5,
                          reflectslight = true,
                          shininess     = 0.5,
                          shadowMask    = NoShadows))

SolidMaterial(; density       = NaN,
                YoungsModulus = NaN,
                PoissonsRatio = NaN,
                meltingPoint  = NaN,
                specificHeatCapacity = NaN,
                thermalConductivity  = NaN,
                linearThermalExpansionCoefficient = NaN)

Generates a SolidMaterial object by providing the material properties of a Solid with keyword arguments.

Arguments

Arguments that are not provided have value NaN.

• density in [kg/m^3]: Density, see Wikipedia.
• YoungsModulus in [Pa]: Youngs' modulus, see Wikipedia.
• PoissonsRatio: Poissons' ratio, see Wikipedia.
• meltingPoint in [K]: Melting point, see Wikipedia. If the material is destroyed before its melting point (e.g. wood that is burning) then meltingPoint is the temperature when destruction of the solid starts.
• specificHeatCapacity in [J/(kg.K)]: Specific heat capacity, see Wikipedia.
• thermalConductivity in [W/(m.K)]: Thermal conductivity, see Wikipedia and List of thermal conductivities
• linearThermalExpansionCoefficient::Float64 in [1/K]: Linear thermal expansion coefficient, see Wikipedia.

Examples

using Modia3D

solidMaterial = SolidMaterial(density=3000.0, YoungsModulus=2e11)

ElasticContactPairMaterial(; coefficientOfRestitution=0.7,
                             slidingFrictionCoefficient=0.5,
                             rotationalResistanceCoefficient=0.001,
                             vsmall=0.01, wsmall=0.01)

Generates an ElasticContactPairMaterial object by providing the material properties of two objects that are in contact to each other. Those properties are needed for the Contact Force Law.

Arguments

• coefficientOfRestitution: Coefficient of restitution between two objects (=0: inelastic ... =1: fully elastic).
• slidingFrictionCoefficient: Kinetic/sliding friction force coefficent between two objects (>= 0.0).
• rotationalResistanceCoefficient: Rotational resistance torque coefficient between two objects (>= 0.0). Its effect is that the contact torque is computed to reduce the relative angular velocity between two objects. For a ball, rotationalResistanceCoefficient is the (standard) rolling resistance coefficient.
• vsmall in [m/s]: Used for regularization when computing the unit vector in direction of the relative tangential velocity to avoid a division by zero.
• wsmall in [rad/s]: Used for regularization when computing the unit vector in direction of the relative angular velocity to avoid a division by zero.