Changes between Version 8 and Version 9 of FRAME_SIZE_R1

Timestamp:

06/01/09 11:50:24 (16 years ago)

Author:

deni

Comment:

--

FRAME_SIZE_R1

@@ -30 +30 @@
 
 = Design =
-^(Describe your design here.)^
+
+As described in the analysis, the resize area will be a thin rectangular area around the border outline. [[BR]]
+It will be divided into 8 subareas in the following way:
+ * The border outline has 8 interesting points described in the Position enum - TOP_LEFT, MIDDLE_LEFT, etc.
+ * 8 rectangles with centers these points that are twice smaller than the border outline will be created.
+ * Each subarea will be constructed as the intersection of the resize area with one of these rectangles.
+
+[picture...]
+
+Each subarea changes the size and position of the frame in a different way, so that the opposite one stays in place.[[BR]]
+Each subarea will have the position used for its construction (from the Position enum) and 2 coefficients - changeX and changeY.[[BR]]
+changeX could be:
+ * 0 if the resize area does not change the width of the frame
+ * +1 if dragging this area down (increasing x) will make the frame bigger
+ * -1 if dragging this area down will make the frame smaller
+The same applies for changeY
+
+So if we drag some of the resize areas, the code that will resize the frame will look like:
+
+{{{
+Frame f; // the frame we're resizing
+ImmRect r; // the border outline
+RezizeAreSceneElement resizeArea; // the resize subarea
+ImmPoint startPos; // the initial position of the point we started to drag
+ImmPoint mousePos; // the current position of the mouse, i.e. we dragged the resize area from startPos to mousePos
+
+float width = r.getWidth() + 
+        resizeArea.changeX().get() * (startPos.getX() - mousePos.getX());
+float height = r.getHeight() + 
+        resizeArea.changeY().get() * (startPos.getY() - mousePos.getY());
+
+Position positionToKeep = resizeArea.position().get().getOpposite();
+ImmPoint pointToKeep = r.getPoint(opposite);
+
+f.setSize(BoundMode.MID_BORDER, new ImmSize(width, height));
+f.setLocation(BoundMode.MID_BORDER, positionToKeep, pointToKeep);
+}}}
+
+A new class ResizeAreaSceneElement extending DefaultSceneElement with the following fields will be created:
+ * public Prop<ImmRect> borderOutline(); 
+ * public Prop<Position> position();
+ * public Prop<Integer> changeX();
+ * public Prop<Integer> changeY();
+In addition, it will override clip() to construct the clipping rectangle - with center borderOutline().get().getPoint(position().get()) and width and height twice as small as the border outline's width and height. [[BR]]
+
+
+
+A new ElementHelper for resize area scene elements is needed - ResizeAreaElementHelper [[BR]]
+In getResponsibleArea() it will construct a rectagular area around the border outline.
+
+
+
+In FrameView 8 resize scene elements will be added. They will also be added as subelements of FrameView.sceneElement after the border element (the order is important because the resize area should be above the border).
+
+
+A new controller used by FrameView to resize the frame will be created.
+It will consist of 3 operations:
+ * RESIZE_START
+It has a filter with eventId = InputEventR3.MOUSE_CLICKED, source class - FrameView.class and tip class - ResizeAreaSceneElement.class [[BR]]
+In the handle method it should save the current position of the border outline, so that it could be used for resizing later. It is necessary to do so because if we consider only the current state, the error accumulated will be too big.
+ * RESIZE 
+It has a filter with eventId = InputEventR3.MOUSE_DRAGGED, source class - FrameView.class and tip class - ResizeAreaSceneElement.class [[BR]]
+In the handle method it will actually resize the frame
+ * RESIZE_END
+It has a filter with eventId = InputEventR3.MOUSE_DRAGGED, source class - FrameView.class and tip class - ResizeAreaSceneElement.class [[BR]]
+In the handle method it will log a change for the UndoManager, so that the resize action could be undone.
+
 
 = Implementation =