tmf: Update copyright headers in tmf.ui
[deliverable/tracecompass.git] / org.eclipse.linuxtools.tmf.ui / src / org / eclipse / linuxtools / tmf / ui / views / uml2sd / DrawableToolTip.java
index cf656fc1a5e76838aff082e15659d86378a71525..9201357831378d24faa382c99716ea4798dc3984 100755 (executable)
@@ -1,20 +1,19 @@
 /**********************************************************************
- * Copyright (c) 2005, 2008, 2011 IBM Corporation and others.
+ * Copyright (c) 2005, 2013 IBM Corporation, Ericsson
  * All rights reserved.   This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
- * $Id: DrawableToolTip.java,v 1.3 2008/01/24 02:29:01 apnan Exp $
- * 
- * Contributors: 
- * IBM - Initial API and implementation
- * Bernd Hufmann - Updated for TMF
+ *
+ * Contributors:
+ *     IBM - Initial API and implementation
+ *     Bernd Hufmann - Updated for TMF
  **********************************************************************/
+
 package org.eclipse.linuxtools.tmf.ui.views.uml2sd;
 
-import org.eclipse.linuxtools.tmf.core.event.ITmfTimestamp;
-import org.eclipse.linuxtools.tmf.core.event.TmfTimeRange;
-import org.eclipse.linuxtools.tmf.core.event.TmfTimestamp;
+import org.eclipse.linuxtools.tmf.core.timestamp.ITmfTimestamp;
+import org.eclipse.linuxtools.tmf.core.timestamp.TmfTimeRange;
 import org.eclipse.linuxtools.tmf.ui.views.uml2sd.util.SDMessages;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.events.PaintEvent;
@@ -27,188 +26,278 @@ import org.eclipse.swt.widgets.Display;
 import org.eclipse.swt.widgets.Shell;
 
 /**
+ * <p>
  * This class is used to reproduce the same tooltip behavior on Windows and Linux when the mouse move hover the time
  * compression bar used to display elapsed time using a tooltip. The tooltip is composed of 2 parts, the text value and
- * below, a scale to visually locate the value in a time range (usually the min an max elapsed time in the whole
+ * below, a scale to visually locate the value in a time range (usually the minimum an maximum elapsed time in the whole
  * diagram)
- * 
+ * </p>
+ *
+ * @version 1.0
  * @author sveyrier
  */
 public class DrawableToolTip implements PaintListener {
 
+    // ------------------------------------------------------------------------
+    // Attributes
+    // ------------------------------------------------------------------------
+
     /**
      * The parent control where the tooltip must be drawn
      */
-    protected Composite parent = null;
+    protected Composite fParent = null;
     /**
      * The tooltip shell
      */
-    protected Shell toolTipShell = null;
+    protected Shell fToolTipShell = null;
+    /**
+     * The Time range data.
+     */
+    protected TmfTimeRange fMinMaxRange;
+    /**
+     * The current time.
+     */
+    protected ITmfTimestamp fCurrentValue;
+    /**
+     * The horizontal margin used for drawing.
+     */
+    private static int fHorMargin = 10;
+    /**
+     * The vertical margin used for drawing.
+     */
+    private static int fVertMargin = 10;
+    /**
+     * The minimum text scale margin.
+     */
+    private static int fTextScaleMargin = 20;
+    /**
+     * The length of the text scale.
+     */
+    private static int fScaleLength = 100;
     /**
-     * Time range data
+     * The text to display
      */
-    protected TmfTimeRange minMaxRange;
-    protected ITmfTimestamp currentValue;
+    protected String fMessage;
+    /**
+     * The color array used to represent the 10 time range slices
+     */
+    protected Color[] fColors;
 
-    private static int H_MARGIN = 10;
-    private static int V_MARGIN = 10;
+    // ------------------------------------------------------------------------
+    // Constructors
+    // ------------------------------------------------------------------------
 
-    private static int TEXT_SCALE_MARGIN = 20;
-    private static int SCALE_LENGTH = 100;
+    /**
+     * Creates a drawable tool tip instance.
+     *
+     * @param parent The parent composite.
+     */
+    public DrawableToolTip(Composite parent) {
+        fParent = parent;
+        fToolTipShell = new Shell(fParent.getShell(), SWT.ON_TOP);
+        fToolTipShell.setLayout(new RowLayout());
+        fToolTipShell.setBackground(Display.getDefault().getSystemColor(SWT.COLOR_INFO_BACKGROUND));
+        fToolTipShell.addPaintListener(this);
+        fToolTipShell.setSize(200, 50);
 
-    protected String msg;
+        fColors = new Color[10];
+        fColors[0] = new Color(Display.getDefault(), 255, 229, 229);
+        fColors[1] = new Color(Display.getDefault(), 255, 204, 204);
+        fColors[2] = new Color(Display.getDefault(), 255, 178, 178);
+        fColors[3] = new Color(Display.getDefault(), 255, 153, 153);
+        fColors[4] = new Color(Display.getDefault(), 255, 127, 127);
+        fColors[5] = new Color(Display.getDefault(), 255, 102, 102);
+        fColors[6] = new Color(Display.getDefault(), 255, 76, 76);
+        fColors[7] = new Color(Display.getDefault(), 255, 51, 51);
+        fColors[8] = new Color(Display.getDefault(), 255, 25, 25);
+        fColors[9] = new Color(Display.getDefault(), 255, 0, 0);
+    }
 
+    // ------------------------------------------------------------------------
+    // Methods
+    // ------------------------------------------------------------------------
     /**
-     * The color array used to represent the 10 time range slices
+     * Returns the message to display.
+     *
+     * @return the message to display.
+     */
+    public String getText() {
+        return fMessage;
+    }
+
+    /**
+     * Returns teh current time to display.
+     *
+     * @return the current time to display
+     */
+    public String getAccessibleText() {
+        return fCurrentValue.toString();
+    }
+
+    /**
+     * Returns the horizontal margin.
+     *
+     * @return the horizontal margin.
+     */
+    protected static int getHorizontalMargin() {
+        return fHorMargin;
+    }
+
+    /**
+     * Sets the horizontal margin.
+     *
+     * @param margin The margin to set.
+     */
+    protected static void setHorizontalMargin(int margin) {
+        fHorMargin = margin;
+    }
+
+    /**
+     * Returns the vertical margin.
+     *
+     * @return the vertical margin.
+     */
+    protected static int getVerticalMargin() {
+        return fVertMargin;
+    }
+
+    /**
+     * Sets the vertical margin.
+     *
+     * @param margin The margin to set.
+     */
+    protected static void setVerticalMargin(int margin) {
+        fVertMargin = margin;
+    }
+
+    /**
+     * Returns the text scale margin.
+     *
+     * @return the text scale margin.
+     */
+    protected static int getTextScaleMargin() {
+        return fTextScaleMargin;
+    }
+
+    /**
+     * Sets the text scale margin.
+     * @param textScaleMargin The margin to set.
+     */
+    protected static void setTestScaleMargin(int textScaleMargin) {
+        fTextScaleMargin = textScaleMargin;
+    }
+
+    /**
+     * Returns the scale length.
+     *
+     * @return the scale length.
+     */
+    protected static int getScaleLength() {
+        return fScaleLength;
+    }
+
+    /**
+     * Sets the scale length.
+     *
+     * @param scaleLength The scale length to set.
      */
-    protected Color[] col;
-
-    public DrawableToolTip(Composite _parent) {
-        parent = _parent;
-        toolTipShell = new Shell(parent.getShell(), SWT.ON_TOP);
-        toolTipShell.setLayout(new RowLayout());
-        toolTipShell.setBackground(Display.getDefault().getSystemColor(SWT.COLOR_INFO_BACKGROUND));
-        toolTipShell.addPaintListener(this);
-        toolTipShell.setSize(200, 50);
-
-        col = new Color[10];
-        col[0] = new Color(Display.getDefault(), 255, 229, 229);
-        col[1] = new Color(Display.getDefault(), 255, 204, 204);
-        col[2] = new Color(Display.getDefault(), 255, 178, 178);
-        col[3] = new Color(Display.getDefault(), 255, 153, 153);
-        col[4] = new Color(Display.getDefault(), 255, 127, 127);
-        col[5] = new Color(Display.getDefault(), 255, 102, 102);
-        col[6] = new Color(Display.getDefault(), 255, 76, 76);
-        col[7] = new Color(Display.getDefault(), 255, 51, 51);
-        col[8] = new Color(Display.getDefault(), 255, 25, 25);
-        col[9] = new Color(Display.getDefault(), 255, 0, 0);
+    protected static void setScaleLength(int scaleLength) {
+        fScaleLength = scaleLength;
     }
 
     /**
      * Display the tooltip using the given time range(min,max) the current value and the time unit The tooltip will stay
      * on screen until it is told otherwise
-     * 
+     *
      * @param value the current in the scale
      * @param min the scale min
      * @param max the scale max
+     * @since 2.0
      */
     public void showToolTip(ITmfTimestamp value, ITmfTimestamp min, ITmfTimestamp max) {
-        minMaxRange = new TmfTimeRange(min.clone(), max.clone());
-        currentValue = value.clone();
+        fMinMaxRange = new TmfTimeRange(min, max);
+        fCurrentValue = value;
 
-        int w = toolTipShell.getBounds().width;
-        int h = toolTipShell.getBounds().height;
+        int w = fToolTipShell.getBounds().width;
+        int h = fToolTipShell.getBounds().height;
         Point hr = Display.getDefault().getCursorLocation();
-        toolTipShell.setBounds(hr.x, hr.y + 26, w, h);
-        toolTipShell.setVisible(true);
+        fToolTipShell.setBounds(hr.x, hr.y + 26, w, h);
+        fToolTipShell.setVisible(true);
     }
 
     /**
-     * Hide the tooltip
+     * Hide the tooltip.
      */
     public void hideToolTip() {
-        toolTipShell.setVisible(false);
+        fToolTipShell.setVisible(false);
     }
 
     /**
-     * Draw the tooltip text on the control widget when a paint event is received
+     * Disposes the system resource used by this kind of toolTips (a colors array essentially)
+     */
+    public void dispose() {
+        for (int i = 0; i < fColors.length; i++) {
+            fColors[i].dispose();
+        }
+    }
+
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.swt.events.PaintListener#paintControl(org.eclipse.swt.events.PaintEvent)
      */
     @Override
     public void paintControl(PaintEvent event) {
-        msg = SDMessages._138 + " " +  currentValue.toString(); //$NON-NLS-1$
-        Point size = event.gc.textExtent(msg);
-        if (size.x < SCALE_LENGTH)
-            size.x = SCALE_LENGTH;
-        event.gc.drawText(msg, H_MARGIN, V_MARGIN, true);
-        event.gc.drawLine(H_MARGIN, V_MARGIN + TEXT_SCALE_MARGIN + size.y, H_MARGIN + SCALE_LENGTH, V_MARGIN + TEXT_SCALE_MARGIN + size.y);
+        fMessage = SDMessages._138 + " " +  fCurrentValue.toString(); //$NON-NLS-1$
+        Point size = event.gc.textExtent(fMessage);
+        if (size.x < fScaleLength) {
+            size.x = fScaleLength;
+        }
+        event.gc.drawText(fMessage, fHorMargin, fVertMargin, true);
+        event.gc.drawLine(fHorMargin, fVertMargin + fTextScaleMargin + size.y, fHorMargin + fScaleLength, fVertMargin + fTextScaleMargin + size.y);
 
-        int step = SCALE_LENGTH / 10;
+        int step = fScaleLength / 10;
 
         // double gr = (max - min) / 10;
-        ITmfTimestamp minMaxdelta = (TmfTimestamp) minMaxRange.getEndTime().getDelta(minMaxRange.getStartTime());
+        ITmfTimestamp minMaxdelta = fMinMaxRange.getEndTime().getDelta(fMinMaxRange.getStartTime());
         double gr = (minMaxdelta.getValue()) / (double) 10;
 
         // double delta = currentValue-min;
-        ITmfTimestamp delta = (TmfTimestamp) currentValue.getDelta(minMaxRange.getStartTime());
+        ITmfTimestamp delta = fCurrentValue.getDelta(fMinMaxRange.getStartTime());
         long absDelta = Math.abs(delta.getValue());
-        
+
         int colIndex = 0;
         if (gr != 0) {
             // colIndex = Math.round((float)(Math.log(1+delta)/gr));
             colIndex = Math.round((float) (absDelta / gr));
-            if (colIndex > col.length)
-                colIndex = col.length;
-            else if (colIndex <= 1)
+            if (colIndex > fColors.length) {
+                colIndex = fColors.length;
+            } else if (colIndex <= 1) {
                 colIndex = 1;
-        } else
+            }
+        } else {
             colIndex = 1;
+        }
 
         for (int i = 0; i <= 10; i++) {
-            if (i < 10)
-                event.gc.setBackground(col[i]);
-            if ((i < colIndex) && (i < 10))
-                event.gc.fillRectangle(H_MARGIN + i * step, V_MARGIN + TEXT_SCALE_MARGIN + size.y - 5, step, 11);
-            if (i == 0)
-                event.gc.drawText(SDMessages._56, H_MARGIN, size.y + 2 * V_MARGIN + TEXT_SCALE_MARGIN, true);
+            if (i < 10) {
+                event.gc.setBackground(fColors[i]);
+            }
+            if ((i < colIndex) && (i < 10)) {
+                event.gc.fillRectangle(fHorMargin + i * step, fVertMargin + fTextScaleMargin + size.y - 5, step, 11);
+            }
+            if (i == 0) {
+                event.gc.drawText(SDMessages._56, fHorMargin, size.y + 2 * fVertMargin + fTextScaleMargin, true);
+            }
             if (i == 0) {
                 int len = event.gc.textExtent(SDMessages._55).x;
-                event.gc.drawText(SDMessages._55, H_MARGIN + SCALE_LENGTH - len + 1, size.y + 2 * V_MARGIN + TEXT_SCALE_MARGIN, true);
+                event.gc.drawText(SDMessages._55, fHorMargin + fScaleLength - len + 1, size.y + 2 * fVertMargin + fTextScaleMargin, true);
             }
             int lineWidth = 10;
-            if ((i == 0) || (i == 10))
+            if ((i == 0) || (i == 10)) {
                 lineWidth = 14;
-            event.gc.drawLine(H_MARGIN + i * step, V_MARGIN + TEXT_SCALE_MARGIN + size.y - lineWidth / 2, H_MARGIN + i * step, V_MARGIN + TEXT_SCALE_MARGIN + size.y + lineWidth / 2);
+            }
+            event.gc.drawLine(fHorMargin + i * step, fVertMargin + fTextScaleMargin + size.y - lineWidth / 2, fHorMargin + i * step, fVertMargin + fTextScaleMargin + size.y + lineWidth / 2);
         }
-        toolTipShell.setSize(size.x + 2 * H_MARGIN + 2, 2 * size.y + 3 * V_MARGIN + TEXT_SCALE_MARGIN);
-    }
-
-    public String getText() {
-        return msg;
-    }
-
-    public String getAccessibleText() {
-        return currentValue.toString();
-    }
-
-    /**
-     * Dispose the system resource used by this kind of toolTips (a colors array essentially)
-     * 
-     */
-    public void dispose() {
-        for (int i = 0; i < col.length; i++)
-            col[i].dispose();
-    }
-    
-    protected static int getHorizontalMargin() {
-        return H_MARGIN;
-    }
-
-    protected static void setHorizontalMargin(int margin) {
-        H_MARGIN = margin;
-    }
-
-    protected static int getVerticalMargin() {
-        return V_MARGIN;
+        fToolTipShell.setSize(size.x + 2 * fHorMargin + 2, 2 * size.y + 3 * fVertMargin + fTextScaleMargin);
     }
-
-    protected static void setVerticalMargin(int margin) {
-        V_MARGIN = margin;
-    }
-
-    protected static int getTestScaleMargin() {
-        return TEXT_SCALE_MARGIN;
-    }
-
-    protected static void setTestScaleMargin(int testScaleMargin) {
-        TEXT_SCALE_MARGIN = testScaleMargin;
-    }
-
-    protected static int getScaleLength() {
-        return SCALE_LENGTH;
-    }
-
-    protected static void setScaleLength(int scaleLength) {
-        SCALE_LENGTH = scaleLength;
-    }
-
 }
This page took 0.029212 seconds and 5 git commands to generate.