mirror of
https://github.com/EiffelSoftware/eiffel-org.git
synced 2025-12-06 14:52:03 +01:00
60ef0f55af
Date:2008-09-29T16:18:46.000000Z git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@62 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
145 lines
9.5 KiB
Plaintext
145 lines
9.5 KiB
Plaintext
[[Property:title|Figures]]
|
|
[[Property:weight|7]]
|
|
[[Property:uuid|c12fee6e-5e99-ae59-8ac5-f57abb4c1878]]
|
|
The EiffelVision figure cluster can be considered a high-level way of drawing on an [[ref:libraries/vision2/reference/ev_drawable_chart|EV_DRAWABLE]] descendant. Here are some advantages:
|
|
* The model is separated from the representation by using projectors that take a world of figures and project it to any device, not just a drawing area.
|
|
* Instead of drawing with static API's like draw_line, real figure objects are used that can move, change color or morph.
|
|
* For projection devices that allow this, events may be caught and fired through the appropriate figure object.
|
|
|
|
==Figure classes==
|
|
|
|
Every basic figure class inherits from [[ref:libraries/vision2/reference/ev_atomic_figure_chart|EV_ATOMIC_FIGURE]] . An atomic figure has the property of having a representation. [[ref:libraries/vision2/reference/ev_figure_group_chart|EV_FIGURE_GROUP]] on the other hand does not but is a collection of figures. On the top of those two stands [[ref:libraries/vision2/reference/ev_figure_chart|EV_FIGURE]] as common ancestor. As [[ref:libraries/vision2/reference/ev_figure_group_chart|EV_FIGURE_GROUP]] is a collection of EV_FIGUREs, it can contain subgroups.
|
|
|
|
As top-level group of a world of figures you must use [[ref:libraries/vision2/reference/ev_figure_world_chart|EV_FIGURE_WORLD]] . It inherits from [[ref:libraries/vision2/reference/ev_figure_group_chart|EV_FIGURE_GROUP]] but adds some features for grid and background color.
|
|
|
|
===Figures===
|
|
{| border="1"
|
|
|-
|
|
| class
|
|
| open/closed
|
|
| points
|
|
| description
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_arc_chart|EV_FIGURE_ARC]]
|
|
| open
|
|
| 2
|
|
| a segment of an open ellipse
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_dot_chart|EV_FIGURE_DOT]]
|
|
| open
|
|
| 1
|
|
| a single point
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_ellipse_chart|EV_FIGURE_ELLIPSE]]
|
|
| closed
|
|
| 2
|
|
| ellipse inside imaginary rectangle
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_equilateral_chart|EV_FIGURE_EQUILATERAL]]
|
|
| closed
|
|
| 2
|
|
| a figure with any number of sides of the same length
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_line_chart|EV_FIGURE_LINE]]
|
|
| open
|
|
| 2
|
|
| a straight line between two points
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_picture_chart|EV_FIGURE_PICTURE]]
|
|
| open
|
|
| 1
|
|
| an image positioned by its top-left point
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_pie_slice_chart|EV_FIGURE_PIE_SLICE]]
|
|
| closed
|
|
| 2
|
|
| a part of a closed ellipse
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_polygon_chart|EV_FIGURE_POLYGON]]
|
|
| closed
|
|
| *
|
|
| a figure defined by any number of points
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_polyline_chart|EV_FIGURE_POLYLINE]]
|
|
| open
|
|
| *
|
|
| a figure consisting of any number of connecting lines
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_rectangle_chart|EV_FIGURE_RECTANGLE]]
|
|
| closed
|
|
| 2
|
|
| figure with four sides
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_star_chart|EV_FIGURE_STAR]]
|
|
| open
|
|
| 2
|
|
| any number of lines emerging from a center point
|
|
|-
|
|
| [[ref:libraries/vision2/reference/ev_figure_text_chart|EV_FIGURE_TEXT]]
|
|
| open
|
|
| 1
|
|
| a string positioned by its top-left point displayed in the specified font
|
|
|}
|
|
|
|
A closed figure is a figure that has some area enclosed when drawn that can optionally be filled with a color. Closed figures inherit [[ref:libraries/vision2/reference/ev_closed_figure_chart|EV_CLOSED_FIGURE]] which gives them the property fill_color. Open figures inherit [[ref:libraries/vision2/reference/ev_atomic_figure_chart|EV_ATOMIC_FIGURE]] directly just as [[ref:libraries/vision2/reference/ev_closed_figure_chart|EV_CLOSED_FIGURE]] .
|
|
===Points===
|
|
|
|
Central in the design of the figures are points. Figures are built up as much from points as possible. For example, an ellipse is not a center point with two radii, but the biggest fitting ellipse inside an imaginary rectangle, so of two points.
|
|
|
|
As you can see in the table above, each figure has a certain number of points. These values can be 1, 2 or * (any number). For each value there is a class the figure inherits from. These classes are:
|
|
* 1 (a figure has one point): [[ref:libraries/vision2/reference/ev_single_pointed_figure_chart|EV_SINGLE_POINTED_FIGURE]] .
|
|
* 2 (a figure has two points): [[ref:libraries/vision2/reference/ev_double_pointed_figure_chart|EV_DOUBLE_POINTED_FIGURE]] .
|
|
* * (a figure has zero or more points): [[ref:libraries/vision2/reference/ev_multi_pointed_figure_chart|EV_MULTI_POINTED_FIGURE]] .
|
|
|
|
These classes offer features to handle the given number of points. [[ref:libraries/vision2/reference/ev_single_pointed_figure_chart|EV_SINGLE_POINTED_FIGURE]] offers the feature:
|
|
<code> point: EV_RELATIVE_POINT</code>
|
|
|
|
[[ref:libraries/vision2/reference/ev_double_pointed_figure_chart|EV_DOUBLE_POINTED_FIGURE]] inherits [[ref:libraries/vision2/reference/ev_single_pointed_figure_chart|EV_SINGLE_POINTED_FIGURE]] for its first point, which is renamed to <eiffel>point_a</eiffel>. It adds <eiffel>point_b</eiffel>, so it has the features:
|
|
<code>
|
|
point_a: EV_RELATIVE_POINT
|
|
point_b: EV_RELATIVE_POINT
|
|
</code>
|
|
|
|
[[ref:libraries/vision2/reference/ev_multi_pointed_figure_chart|EV_MULTI_POINTED_FIGURE]] internally holds an array of points. Its most important feature is:
|
|
<code>
|
|
i_th_point (i: INTEGER): EV_RELATIVE_POINT
|
|
</code>
|
|
|
|
===Relative point===
|
|
|
|
The points that the figures use are of type [[ref:libraries/vision2/reference/ev_relative_point_chart|EV_RELATIVE_POINT]] . Each point is relative to another point, which is also relative. Each point is a set of coordinates and a reference point. The absolute coordinates are calculated only when needed by adding the absolute coordinates of the reference point to the relative coordinates.
|
|
|
|
==Figure worlds==
|
|
|
|
In order to put the figures you want to display in a context, you have to insert them in a figure world object, an instance of [[ref:libraries/vision2/reference/ev_figure_world_chart|EV_FIGURE_WORLD]] . This is a descendant of [[ref:libraries/vision2/reference/ev_figure_group_chart|EV_FIGURE_GROUP]] and hence works in the same way. This figure world is later associated with one or more projectors.
|
|
[[ref:libraries/vision2/reference/ev_figure_world_chart|EV_FIGURE_WORLD]] adds a number of features to [[ref:libraries/vision2/reference/ev_figure_group_chart|EV_FIGURE_GROUP]] . These extra features are needed for the representation by a projector. One is the background color. This feature will be used to erase the canvas for a graphical projector in the specified color. The other features are to manage the grid.
|
|
==Projectors==
|
|
|
|
A projector is an object that knows what a figure world should look like. The figure world itself is not more than a hint towards its representation. For example, if a line is "20" long, this unit might mean pixels, miles, centimeters or whatever. It is up to the projector to interpret units. Also, color might be interpreted as gray scale. Typically, a projector will do the best possible job projecting the world to its device.
|
|
|
|
With EiffelVision come these projectors:
|
|
* [[ref:libraries/vision2/reference/ev_postscript_projector_chart|EV_POSTSCRIPT_PROJECTOR]]
|
|
* [[ref:libraries/vision2/reference/ev_drawing_area_projector_chart|EV_DRAWING_AREA_PROJECTOR]]
|
|
* [[ref:libraries/vision2/reference/ev_pixmap_projector_chart|EV_PIXMAP_PROJECTOR]]
|
|
The first one maps figure worlds to a postscript file. The other two are descendants of [[ref:libraries/vision2/reference/ev_widget_projector_chart|EV_WIDGET_PROJECTOR]] , and can project on widgets that inherit [[ref:libraries/vision2/reference/ev_drawable_chart|EV_DRAWABLE]] : [[ref:libraries/vision2/reference/ev_drawing_area_chart|EV_DRAWING_AREA]] and [[ref:libraries/vision2/reference/ev_pixmap_chart|EV_PIXMAP]] , eventually using double-buffering, which results in a more smooth animation but requires fast copying from memory to the video buffer (can be slow for a remote display).
|
|
==Events==
|
|
The other features of drawing area and widget is that they generate pointer events. These events can be translated by projectors to map the figure world. These projectors send the event to the appropriate figure. Every figure has all common pointer action sequences:
|
|
* <eiffel>pointer_motion_actions</eiffel>
|
|
* <eiffel>pointer_button_press_actions</eiffel>
|
|
* <eiffel>pointer_double_press_actions</eiffel>
|
|
* <eiffel>pointer_button_release_actions</eiffel>
|
|
* <eiffel>pointer_enter_actions</eiffel>
|
|
* <eiffel>pointer_leave_actions</eiffel>
|
|
* <eiffel>pick_actions</eiffel>
|
|
* <eiffel>conforming_pick_actions</eiffel>
|
|
* <eiffel>drop_actions</eiffel>
|
|
There are no events for keyboard focus and no key press events. In case you wish to use these events, use the ones of the pixmap or drawing area.
|
|
|
|
When using events, keep the z-order in mind. This is the order in which the figures are stacked in the world. The first item of a figure group is the figure that is the farthest away. This means that the figure is obscured by any figures which are in front of it, and events will also not be propagated to this figure in that case.
|
|
==Rotation and scaling==
|
|
|
|
The relative points also support rotation and scaling. These factors work just like coordinates, except scaling, which is multiplied instead of added in the chain of points. This means that when a relative point which is the root of a tree of several points is moved, the entire tree is moved, when it is scaled the entire tree is scaled and same for rotation.
|
|
|
|
The scaling factor is divided into a horizontal and vertical component. If the factor is 0.5, everything is displayed at half its size. The rotation factor is in radians.
|
|
|