Vessel types: Drawing

The drawing data, represented by a set of vertices and either edges or panels, are used to draw each vessel of this type in both wire frame and, by default, shaded views (more elaborate vessel shaded drawings may also be used).

The wire frame origin is defined relative to the vessel axes $\Vxyz$, and the vertices are in turn defined by giving their coordinates relative to the wire frame origin. Wire frame symmetry can be one of none, xz plane, yz plane or xz and yz planes. If wire frame symmetry is specified then the vertices, edges and panels are reflected in the specified symmetry plane or planes to generate additional vertices, edges and panels that are implied by the symmetry.

The wire frame type determines whether the wire frame is specified by edges or panels. When specified by edges, the edges are defined by pairs of vertices, referred to by index. When specified by panels, each panel is defined by four vertex indices. When the vertex indices are distinct, a quadrilateral panels is defined. Triangular panels can be defined by duplicating one of the vertex indices.

Wire frame data can be imported from panel mesh files.

Each individual vessel has in addition its own set of drawing data, which may be used to represent any vessel-specific features.

The drawing data do not affect the mathematical model in any way – they are purely for drawing 3D views. The vertices, edges and panels follow the motions of the vessel, and thus may be used to improve understanding of the motion. They can also be used to represent, say, a spar or other equipment attached to the vessel, so that you can then look for clashing with other parts of the system.

Wire frame

In the wire frame view, the pen data are used to draw the given set of edges or panels. When specified by edges, the edge diameter values are ignored in this case.

Shaded drawing

In shaded graphics view, only the pen colour is used. The pen thickness and style are not used.

If the wire frame is specified by panels, then these panels are drawn. Any quadrilateral panels are split into two triangular panels.

When the wire frame is specified by edges, the appearance depends on the edge diameter. If the edge diameter is ~ then that edge will be used to build a convex shape. If the edge diameter is given a numerical value, then that edge is drawn as a cylinder with the given diameter. Note that you can use a mixture of edge diameters (some defined, some set to '~') to combine both filled-in and framework shapes.

Figure: Wire frames with different edge diameter. A value of ~ is used for the wire frame on the left and a value of 1 for the wire frame on the right.
Note: The convex shape generated from the edge data for the shaded graphics view is sometimes a poor representation of the vessel. Because of this it may be preferable to specify the wire frame data by panels.