Image (Plot)
Embed an image in a surface or volume plot.
Syntax
model.result(<pgtag>).feature(<ftag>).create(<atag>,"Image");
model.result(<pgtag>).feature(<ftag>).feature(<atag>).set(property,<value>);
model.result(<pgtag>).feature(<ftag>).selection()...
Description
model.result(<pgtag>).feature(<ftag>).create(<atag>,"Image") creates an image feature with the name <ftag>.
You can add an image a to a 3D or 2D plot group to plot an image on the geometry’s surface.
For example, model.result("pg1").feature("img1").selection().set(12); selects boundary 12 as the boundary for which to display the image called img1 in the plot group pg1.
The following properties are available:
Axis direction, when axistype is set cartesian.
cartesian | spherical | x | y | z
relative | pixels
none | parent | dataset name
on | off
The displacement for the cylinder, when heightmode is set to manual.
on | off
repeat | mirroredrepeat | clamp
How the image is extrapolated. With clamp, each coordinate is mapped to the closest valid value at an edge of the image.
auto | fit | manual
The height for the cylinder, when heightmode is set to manual.
If inheritplot is not none: Determines if the deformation scale is inherited.
none | plot name
auto | manual | planar | cylindrical | spherical | rectangular
Normal vector, when planetype is set to general.
xy | yz | zx | yx | zy | xz | auto | general
Axis direction, when mapping is set to cylindrical or spherical.
The angle range (in degrees), when mapping is set to cylindrical.
true | false
Preserve the aspect ratio when mapping is set to auto.
Projected size, when mapping is set to planar.
off | pprint | ppr
The element refinement to use, if resolution is set to manual. Bear in mind that this is the refinement used for the base dataset, so the number of elements in the model can increase radically if the plot uses, for example, a revolve dataset.
norefine | coarse | normal | fine | finer | extrafine | custom
The rotation of the image mapping in radians, when mapping is set to planar, cylindrical, or spherical.
none | material | internal | everywhere | expression
Smoothing settings. With material, smoothing is done inside domains with the same material. With internal, smoothing is done inside geometry domains. With expression, the smoothing is based on the expression in smoothexpr.
The expression to use for smoothing when smooth is set to expression.
manual | parent
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
The title to use when titletype is manual.
auto | custom | label | manual | none
auto, if the title should be computed automatically. custom, if the title should be computed automatically, but customized. label, if the title should be the plot group’s label. manual, if the manual title should be used (the title property). none, if no title should be displayed.
on | off
on | off
Expression for the u-coordinate when mapping is set to manual.
Expression for the v-coordinate when mapping is set to manual.
The width of the image, when mapping is set to rectangular or planar.
Attributes
Deform, MaterialAppearance, Translation, Transparency (3D only)
See Also
ImageOverlay, MaterialAppearance, Transparency