The "DrawAs" attribute value defines how an HepRepInstance will be represented on the screen. A "DrawAs" value may expect a number of points to be attached to the HepRepInstance as well as some attributes attached to the HepRepInstance or to its individual HepRepPoints.
The default "DrawAs" value is "Point" and represents any points attached to the HepRepInstance as points. Implementations may choose to draw a single pixel or a small square for better visibility.
The following table shows how "DrawAs" values are interpreted, how many HepRepPoints are to be attached to the HepRepInstance.
Any drawas value between parenthesis () is NOT implemented by WIRED 4 (yet).
DrawAs Value | # of Points | Behaviour |
Point (default) | 1* | Draws a marker at every point. |
Line | 2* | Draws a line segment between all the points given. |
(Helix) | 1* | Draws one or more of helices. |
Polygon | 3* | Draws a (closed) polyline connecting the last point to the first point. |
Circle | 1* | Draws one or more circles centered around the given points. |
Curve | 4+3n | Draws a cubic-bezier curve for the given points. Order of Points is as normally used for bezier curves. First section of the curve needs 4 points: P0, CP0b, CP1a, P1 where P is Point and CP is Control Point. Subsequent sections need sets of 3 points: CP1b, CP2a, P2 through CPn-1b, CPna, Pn. |
Ellipse | 1* | Draws one or more ellipses centered around the given points. |
Ellipsoid | 1* | Draws one or more ellipsoids centered around the given points. |
Prism | 2n | Draws a prism. First half of the Points define inner face, second half define outer face. Faces are connected from point 0 to point n/2, point 1 to point n/2+1, etc. |
Cylinder | 2* | Draws one or more cylinders or cones. Every end can have its own radius and angle. |
EllipsePrism | 2* | Draws one or more cylinders with elliptical ends. Every end can have its own ellipse parameters. |
Text | 0 | Draws text. |
The following table shows which HepRepAttributes are allowed (x) for a each DrawAs value and their defaults. Attributes are always optional since they have a default value, but sometimes the default value does not make much sense.
Any marker between parenthesis () is NOT implemented by WIRED 4 (yet).
DrawAs Value ------------ Attribute | Default Value | P o i n t | L i n e | H e l i x | P o l y g o n | C i r c l e | C u r v e | E l l i p s e | E l l i p s o i d | P r i s m | C y l i n d e r | E l l i p s e P r i s m | T e x t |
Visibility | true | x | x | (x) | x | x | x | x | x | x | x | x | x |
Label | "" | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) |
FontName | "SansSerif" | x | |||||||||||
FontStyle | "Plain" | x | |||||||||||
FontSize | 12 | x | |||||||||||
FontColor | White | x | |||||||||||
FontHasFrame | false | x | |||||||||||
FontFrameWidth | 1.0 | x | |||||||||||
FontFrameColor | White | x | |||||||||||
FontHasBanner | false | x | |||||||||||
FontBannerColor | Black | x | |||||||||||
Color | White | x | x | (x) | x | x | x | x | x | x | x | x | x |
Layer | "default" | x | x | (x) | x | x | x | x | x | x | x | x | x |
MarkName | "Circle" | x | |||||||||||
MarkSize | 5.0 | x | |||||||||||
MarkSizeMultiplier | 1.0 | x | |||||||||||
MarkType | "Symbol" | x | |||||||||||
HasFrame | true | x | x | (x) | x | x | x | x | x | x | x | x | |
FrameColor | Black | x | x | (x) | x | x | x | x | x | x | x | x | |
FrameWidth | 1.0 | x | x | (x) | x | x | x | x | x | x | x | x | |
LineStyle | "Solid" | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | |
LineWidth | 2.0 | x | x | (x) | x | x | x | x | x | x | x | x | |
LineWidthMultiplier | 1.0 | x | x | (x) | x | x | x | x | x | x | x | x | |
LineHasArrow | "None" | x | (x) | (x) | |||||||||
FillColor | White | x | x | x | x | x | x | x | x | ||||
FillType | "EvenOdd" | (x) | (x) | (x) | (x) | (x) | (x) | (x) | (x) | ||||
Fill | false | x | x | x | x | x | x | x | x | ||||
Radius | 5.0 | x | x | x | x | x | |||||||
Phi | 0.0 | x | x | x | x | x | |||||||
Theta | 0.0 | x | x | x | x | x | |||||||
Omega | 0.0 | x | x | x | |||||||||
Radius2 | 5.0 | x | x | x | |||||||||
Radius3 | 5.0 | x | |||||||||||
Curvature | 0.2 | (x) | |||||||||||
FlyLength | 10.0 | (x) | |||||||||||
Faces | 4 | x | |||||||||||
Text | "" | x | |||||||||||
HPos | 0.0 | x | |||||||||||
VPos | 0.5 | x | |||||||||||
HAlign | "Left" | x | |||||||||||
VAlign | "Baseline" | x | |||||||||||
IsPickable | true | x | x | (x) | x | x | x | x | x | x | x | x | x |
ShowParentAttributes | false | x | x | (x) | x | x | x | x | x | x | x | x | x |
PickParent | false | x | x | (x) | x | x | x | x | x | x | x | x | x |