org.eclipse.tracecompass.tmf.ui/src/org/eclipse/tracecompass/tmf/ui/views/histogram/HistogramView.java

   1 /*******************************************************************************
   2  * Copyright (c) 2009, 2015 Ericsson
   3  *
   4  * All rights reserved. This program and the accompanying materials are
   5  * made available under the terms of the Eclipse Public License v1.0 which
   6  * accompanies this distribution, and is available at
   7  * http://www.eclipse.org/legal/epl-v10.html
   8  *
   9  * Contributors:
  10  *   William Bourque - Initial API and implementation
  11  *   Yuriy Vashchuk - GUI reorganisation, simplification and some related code improvements.
  12  *   Yuriy Vashchuk - Histograms optimisation.
  13  *   Yuriy Vashchuk - Histogram Canvas Heritage correction
  14  *   Francois Chouinard - Cleanup and refactoring
  15  *   Francois Chouinard - Moved from LTTng to TMF
  16  *   Patrick Tasse - Update for mouse wheel zoom
  17  *   Xavier Raynaud - Support multi-trace coloring
  18  *******************************************************************************/
  19
  20 package org.eclipse.tracecompass.tmf.ui.views.histogram;
  21
  22 import java.util.Collection;
  23
  24 import org.eclipse.jdt.annotation.NonNull;
  25 import org.eclipse.jface.action.Action;
  26 import org.eclipse.jface.action.IAction;
  27 import org.eclipse.jface.action.Separator;
  28 import org.eclipse.swt.SWT;
  29 import org.eclipse.swt.custom.CLabel;
  30 import org.eclipse.swt.custom.SashForm;
  31 import org.eclipse.swt.custom.ScrolledComposite;
  32 import org.eclipse.swt.events.MouseAdapter;
  33 import org.eclipse.swt.events.MouseEvent;
  34 import org.eclipse.swt.events.MouseWheelListener;
  35 import org.eclipse.swt.events.PaintEvent;
  36 import org.eclipse.swt.events.PaintListener;
  37 import org.eclipse.swt.graphics.GC;
  38 import org.eclipse.swt.graphics.Image;
  39 import org.eclipse.swt.graphics.Point;
  40 import org.eclipse.swt.graphics.Rectangle;
  41 import org.eclipse.swt.layout.GridData;
  42 import org.eclipse.swt.layout.GridLayout;
  43 import org.eclipse.swt.layout.RowLayout;
  44 import org.eclipse.swt.widgets.Composite;
  45 import org.eclipse.swt.widgets.Control;
  46 import org.eclipse.swt.widgets.Display;
  47 import org.eclipse.swt.widgets.Event;
  48 import org.eclipse.swt.widgets.Label;
  49 import org.eclipse.swt.widgets.Listener;
  50 import org.eclipse.swt.widgets.Sash;
  51 import org.eclipse.tracecompass.internal.tmf.ui.Activator;
  52 import org.eclipse.tracecompass.internal.tmf.ui.ITmfImageConstants;
  53 import org.eclipse.tracecompass.tmf.core.request.ITmfEventRequest;
  54 import org.eclipse.tracecompass.tmf.core.request.ITmfEventRequest.ExecutionType;
  55 import org.eclipse.tracecompass.tmf.core.signal.TmfSelectionRangeUpdatedSignal;
  56 import org.eclipse.tracecompass.tmf.core.signal.TmfSignalHandler;
  57 import org.eclipse.tracecompass.tmf.core.signal.TmfSignalManager;
  58 import org.eclipse.tracecompass.tmf.core.signal.TmfSignalThrottler;
  59 import org.eclipse.tracecompass.tmf.core.signal.TmfTraceClosedSignal;
  60 import org.eclipse.tracecompass.tmf.core.signal.TmfTraceOpenedSignal;
  61 import org.eclipse.tracecompass.tmf.core.signal.TmfTraceRangeUpdatedSignal;
  62 import org.eclipse.tracecompass.tmf.core.signal.TmfTraceSelectedSignal;
  63 import org.eclipse.tracecompass.tmf.core.signal.TmfTraceUpdatedSignal;
  64 import org.eclipse.tracecompass.tmf.core.signal.TmfWindowRangeUpdatedSignal;
  65 import org.eclipse.tracecompass.tmf.core.timestamp.ITmfTimestamp;
  66 import org.eclipse.tracecompass.tmf.core.timestamp.TmfTimeRange;
  67 import org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestamp;
  68 import org.eclipse.tracecompass.tmf.core.trace.ITmfTrace;
  69 import org.eclipse.tracecompass.tmf.core.trace.TmfTraceContext;
  70 import org.eclipse.tracecompass.tmf.core.trace.TmfTraceManager;
  71 import org.eclipse.tracecompass.tmf.ui.signal.TmfTimeViewAlignmentInfo;
  72 import org.eclipse.tracecompass.tmf.ui.signal.TmfTimeViewAlignmentSignal;
  73 import org.eclipse.tracecompass.tmf.ui.views.ITmfTimeAligned;
  74 import org.eclipse.tracecompass.tmf.ui.views.TmfView;
  75 import org.eclipse.ui.IActionBars;
  76
  77 /**
  78  * The purpose of this view is to provide graphical time distribution statistics about the trace events.
  79  * <p>
  80  * The view is composed of two histograms and two controls:
  81  * <ul>
  82  * <li>an event distribution histogram for the whole trace;
  83  * <li>an event distribution histogram for current time window (window span);
  84  * <li>the timestamp of the currently selected event;
  85  * <li>the window span (size of the time window of the smaller histogram).
  86  * </ul>
  87  * The histograms x-axis show their respective time range.
  88  *
  89  * @version 2.0
  90  * @author Francois Chouinard
  91  */
  92 public class HistogramView extends TmfView implements ITmfTimeAligned {
  93
  94     // ------------------------------------------------------------------------
  95     // Constants
  96     // ------------------------------------------------------------------------
  97
  98     /**
  99      *  The view ID as defined in plugin.xml
 100      */
 101     public static final @NonNull String ID = "org.eclipse.linuxtools.tmf.ui.views.histogram"; //$NON-NLS-1$
 102
 103     private static final Image LINK_IMG = Activator.getDefault().getImageFromPath(ITmfImageConstants.IMG_UI_LINK);
 104
 105     private static final int[] DEFAULT_WEIGHTS = {1, 3};
 106
 107     // ------------------------------------------------------------------------
 108     // Attributes
 109     // ------------------------------------------------------------------------
 110
 111     // The current trace
 112     private ITmfTrace fTrace;
 113
 114     // Current timestamp/time window - everything in the TIME_SCALE
 115     private long fTraceStartTime;
 116     private long fTraceEndTime;
 117     private long fWindowStartTime;
 118     private long fWindowEndTime;
 119     private long fWindowSpan;
 120     private long fSelectionBeginTime;
 121     private long fSelectionEndTime;
 122
 123     // SashForm
 124     private SashForm fSashForm;
 125     private ScrolledComposite fScrollComposite;
 126     private Composite fTimeControlsComposite;
 127     private Composite fTimeRangeComposite;
 128     private Listener fSashDragListener;
 129
 130     // Time controls
 131     private HistogramTextControl fSelectionStartControl;
 132     private HistogramTextControl fSelectionEndControl;
 133     private HistogramTextControl fTimeSpanControl;
 134
 135     // Link
 136     private Label fLinkButton;
 137     private boolean fLinkState;
 138
 139     // Histogram/request for the full trace range
 140     private static FullTraceHistogram fFullTraceHistogram;
 141     private HistogramRequest fFullTraceRequest;
 142
 143     // Histogram/request for the selected time range
 144     private static TimeRangeHistogram fTimeRangeHistogram;
 145     private HistogramRequest fTimeRangeRequest;
 146
 147     // Legend area
 148     private Composite fLegendArea;
 149     private Image[] fLegendImages;
 150
 151     // Throttlers for the time sync and time-range sync signals
 152     private final TmfSignalThrottler fTimeSyncThrottle;
 153     private final TmfSignalThrottler fTimeRangeSyncThrottle;
 154
 155     // Action for toggle showing the lost events
 156     private Action hideLostEventsAction;
 157     // Action for toggle showing the traces
 158     private Action showTraceAction;
 159
 160     // ------------------------------------------------------------------------
 161     // Constructor
 162     // ------------------------------------------------------------------------
 163
 164     /**
 165      * Default constructor
 166      */
 167     public HistogramView() {
 168         super(ID);
 169         fTimeSyncThrottle = new TmfSignalThrottler(this, 200);
 170         fTimeRangeSyncThrottle = new TmfSignalThrottler(this, 200);
 171     }
 172
 173     @Override
 174     public void dispose() {
 175         if ((fTimeRangeRequest != null) && !fTimeRangeRequest.isCompleted()) {
 176             fTimeRangeRequest.cancel();
 177         }
 178         if ((fFullTraceRequest != null) && !fFullTraceRequest.isCompleted()) {
 179             fFullTraceRequest.cancel();
 180         }
 181         fFullTraceHistogram.dispose();
 182         fTimeRangeHistogram.dispose();
 183         fSelectionStartControl.dispose();
 184         fSelectionEndControl.dispose();
 185         fTimeSpanControl.dispose();
 186         disposeLegendImages();
 187
 188         super.dispose();
 189     }
 190
 191     private void disposeLegendImages() {
 192         if (fLegendImages != null) {
 193             for (Image i: fLegendImages) {
 194                 i.dispose();
 195             }
 196         }
 197         fLegendImages = null;
 198     }
 199
 200     // ------------------------------------------------------------------------
 201     // TmfView
 202     // ------------------------------------------------------------------------
 203
 204     @Override
 205     public void createPartControl(Composite parent) {
 206         super.createPartControl(parent);
 207
 208         // Control labels
 209         final String selectionStartLabel = Messages.HistogramView_selectionStartLabel;
 210         final String selectionEndLabel = Messages.HistogramView_selectionEndLabel;
 211         final String windowSpanLabel = Messages.HistogramView_windowSpanLabel;
 212
 213         // --------------------------------------------------------------------
 214         // Set the HistogramView layout
 215         // --------------------------------------------------------------------
 216         Composite viewComposite = new Composite(getParentComposite(), SWT.FILL);
 217         GridLayout gridLayout = new GridLayout(1, false);
 218         gridLayout.verticalSpacing = 0;
 219         gridLayout.marginHeight = 0;
 220         gridLayout.marginWidth = 0;
 221         viewComposite.setLayout(gridLayout);
 222
 223         // --------------------------------------------------------------------
 224         // Add a sash for time controls and time range histogram
 225         // --------------------------------------------------------------------
 226
 227         /*
 228          * The ScrolledComposite preferred size can be larger than its visible
 229          * width. This affects the preferred width of the SashForm. Set the
 230          * preferred width to 1 to prevent it from affecting the preferred width
 231          * of the view composite.
 232          */
 233         fSashForm = new SashForm(viewComposite, SWT.NONE) {
 234             @Override
 235             public Point computeSize(int wHint, int hHint) {
 236                 Point computedSize = super.computeSize(wHint, hHint);
 237                 if (wHint == SWT.DEFAULT) {
 238                     return new Point(1, computedSize.y);
 239                 }
 240                 return computedSize;
 241             }
 242             @Override
 243             public Point computeSize(int wHint, int hHint, boolean changed) {
 244                 Point computedSize = super.computeSize(wHint, hHint, changed);
 245                 if (wHint == SWT.DEFAULT) {
 246                     return new Point(1, computedSize.y);
 247                 }
 248                 return computedSize;
 249             }
 250         };
 251         GridData gridData = new GridData(GridData.FILL, GridData.FILL, false, true);
 252         fSashForm.setLayoutData(gridData);
 253
 254         // --------------------------------------------------------------------
 255         // Time controls
 256         // --------------------------------------------------------------------
 257         fScrollComposite = new PackedScrolledComposite(fSashForm, SWT.H_SCROLL | SWT.V_SCROLL);
 258         fTimeControlsComposite = new Composite(fScrollComposite, SWT.NONE);
 259         fScrollComposite.setContent(fTimeControlsComposite);
 260         gridLayout = new GridLayout(1, false);
 261         gridLayout.marginHeight = 0;
 262         gridLayout.marginWidth = 0;
 263         fScrollComposite.setLayout(gridLayout);
 264         fScrollComposite.setExpandHorizontal(true);
 265         fScrollComposite.setExpandVertical(true);
 266
 267         gridLayout = new GridLayout(1, false);
 268         gridLayout.marginHeight = 0;
 269         gridLayout.marginWidth = 0;
 270         fTimeControlsComposite.setLayout(gridLayout);
 271         gridData = new GridData(GridData.FILL, GridData.CENTER, false, true);
 272         fTimeControlsComposite.setLayoutData(gridData);
 273
 274         Composite innerComp = new Composite(fTimeControlsComposite, SWT.NONE);
 275
 276         gridLayout = new GridLayout(2, false);
 277         innerComp.setLayout(gridLayout);
 278         gridLayout.marginHeight = 0;
 279         gridLayout.marginWidth = 0;
 280         gridLayout.horizontalSpacing = 5;
 281         gridLayout.verticalSpacing = 1;
 282         gridData = new GridData(GridData.FILL, GridData.CENTER, false, true);
 283         innerComp.setLayoutData(gridData);
 284
 285         Composite selectionGroup = new Composite(innerComp, SWT.BORDER);
 286         gridLayout = new GridLayout(1, false);
 287         gridLayout.marginHeight = 0;
 288         gridLayout.marginWidth = 0;
 289         selectionGroup.setLayout(gridLayout);
 290         gridData = new GridData(GridData.BEGINNING, GridData.CENTER, false, false);
 291         selectionGroup.setLayoutData(gridData);
 292
 293         // Selection start control
 294         gridData = new GridData(GridData.FILL, GridData.CENTER, false, false);
 295         fSelectionStartControl = new HistogramSelectionStartControl(this, selectionGroup, selectionStartLabel, 0L);
 296         fSelectionStartControl.setLayoutData(gridData);
 297         fSelectionStartControl.setValue(Long.MIN_VALUE);
 298
 299         // Selection end control
 300         gridData = new GridData(GridData.FILL, GridData.CENTER, false, false);
 301         fSelectionEndControl = new HistogramSelectionEndControl(this, selectionGroup, selectionEndLabel, 0L);
 302         fSelectionEndControl.setLayoutData(gridData);
 303         fSelectionEndControl.setValue(Long.MIN_VALUE);
 304
 305         // Link button
 306         gridData = new GridData(GridData.BEGINNING, GridData.CENTER, false, false);
 307         fLinkButton = new Label(innerComp, SWT.NONE);
 308         fLinkButton.setImage(LINK_IMG);
 309         fLinkButton.setLayoutData(gridData);
 310         addLinkButtonListeners();
 311
 312         // Window span time control
 313         gridData = new GridData(GridData.FILL, GridData.CENTER, false, false);
 314         fTimeSpanControl = new HistogramTimeRangeControl(this, innerComp, windowSpanLabel, 0L);
 315         fTimeSpanControl.setLayoutData(gridData);
 316         fTimeSpanControl.setValue(Long.MIN_VALUE);
 317
 318         // --------------------------------------------------------------------
 319         // Time range histogram
 320         // --------------------------------------------------------------------
 321         fTimeRangeComposite = new Composite(fSashForm, SWT.NONE);
 322         gridLayout = new GridLayout(1, true);
 323         gridLayout.marginTop = 0;
 324         gridLayout.marginWidth = 0;
 325         fTimeRangeComposite.setLayout(gridLayout);
 326
 327         // Use remaining horizontal space
 328         gridData = new GridData(GridData.FILL, GridData.FILL, true, true);
 329         fTimeRangeComposite.setLayoutData(gridData);
 330
 331         // Histogram
 332         fTimeRangeHistogram = new TimeRangeHistogram(this, fTimeRangeComposite, true);
 333
 334         // --------------------------------------------------------------------
 335         // Full range histogram
 336         // --------------------------------------------------------------------
 337         final Composite fullRangeComposite = new Composite(viewComposite, SWT.FILL);
 338         gridLayout = new GridLayout(1, true);
 339         fullRangeComposite.setLayout(gridLayout);
 340
 341         // Use remaining horizontal space
 342         gridData = new GridData(GridData.FILL, GridData.FILL, true, true, 2, 1);
 343         fullRangeComposite.setLayoutData(gridData);
 344
 345         // Histogram
 346         fFullTraceHistogram = new FullTraceHistogram(this, fullRangeComposite);
 347
 348         fLegendArea = new Composite(viewComposite, SWT.FILL);
 349         fLegendArea.setLayoutData(new GridData(SWT.BEGINNING, SWT.BEGINNING, true, false, 2, 1));
 350         fLegendArea.setLayout(new RowLayout());
 351
 352         // Add mouse wheel listener to time span control
 353         MouseWheelListener listener = fFullTraceHistogram.getZoom();
 354         fTimeSpanControl.addMouseWheelListener(listener);
 355
 356         // View Action Handling
 357         contributeToActionBars();
 358
 359         ITmfTrace trace = TmfTraceManager.getInstance().getActiveTrace();
 360         if (trace != null) {
 361             traceSelected(new TmfTraceSelectedSignal(this, trace));
 362         }
 363
 364         fSashForm.setVisible(true);
 365         fSashForm.setWeights(DEFAULT_WEIGHTS);
 366
 367         fTimeControlsComposite.addPaintListener(new PaintListener() {
 368             @Override
 369             public void paintControl(PaintEvent e) {
 370                 // Sashes in a SashForm are being created on layout so add the
 371                 // drag listener here
 372                 if (fSashDragListener == null) {
 373                     for (Control control : fSashForm.getChildren()) {
 374                         if (control instanceof Sash) {
 375                             fSashDragListener = new Listener() {
 376                                 @Override
 377                                 public void handleEvent(Event event) {
 378                                     TmfSignalManager.dispatchSignal(new TmfTimeViewAlignmentSignal(fSashForm, getTimeViewAlignmentInfo()));
 379                                 }
 380                             };
 381                             control.removePaintListener(this);
 382                             control.addListener(SWT.Selection, fSashDragListener);
 383                             // There should be only one sash
 384                             break;
 385                         }
 386                     }
 387                 }
 388             }
 389         });
 390     }
 391
 392     @Override
 393     public void setFocus() {
 394         fFullTraceHistogram.fCanvas.setFocus();
 395     }
 396
 397     void refresh() {
 398         getParentComposite().layout(true);
 399     }
 400
 401     /**
 402      * @since 1.0
 403      */
 404     @Override
 405     public TmfTimeViewAlignmentInfo getTimeViewAlignmentInfo() {
 406         if (fSashForm == null) {
 407             return null;
 408         }
 409         return new TmfTimeViewAlignmentInfo(fSashForm.getShell(), fSashForm.toDisplay(0, 0), getTimeAxisOffset());
 410     }
 411
 412     private int getTimeAxisOffset() {
 413         int[] weights = fSashForm.getWeights();
 414         int width = (int) (((float) weights[0] / (weights[0] + weights[1])) * fSashForm.getBounds().width);
 415         int curTimeAxisOffset = width + fSashForm.getSashWidth() + fTimeRangeHistogram.getPointAreaOffset();
 416         return curTimeAxisOffset;
 417     }
 418
 419     /**
 420      * @since 1.0
 421      */
 422     @Override
 423     public int getAvailableWidth(int requestedOffset) {
 424         int pointAreaWidth = fTimeRangeHistogram.getPointAreaWidth();
 425         int curTimeAxisOffset = getTimeAxisOffset();
 426         if (pointAreaWidth <= 0) {
 427             pointAreaWidth = fSashForm.getBounds().width - curTimeAxisOffset;
 428         }
 429         // TODO this is just an approximation that assumes that the end will be at the same position but that can change for a different data range/scaling
 430         int endOffset = curTimeAxisOffset + pointAreaWidth;
 431         GridLayout layout = (GridLayout) fTimeRangeComposite.getLayout();
 432         int endOffsetWithoutMargin = endOffset + layout.marginRight;
 433         int availableWidth = endOffsetWithoutMargin - requestedOffset;
 434         availableWidth = Math.min(fSashForm.getBounds().width, Math.max(0, availableWidth));
 435
 436         return availableWidth;
 437     }
 438
 439     /**
 440      * @since 1.0
 441      */
 442     @Override
 443     public void performAlign(int offset, int width) {
 444         int total = fSashForm.getBounds().width;
 445         int plotAreaOffset = fTimeRangeHistogram.getPointAreaOffset();
 446         int width1 = Math.max(0, offset - plotAreaOffset - fSashForm.getSashWidth());
 447         int width2 = Math.max(0, total - width1 - fSashForm.getSashWidth());
 448         fSashForm.setWeights(new int[] { width1, width2 });
 449         fSashForm.layout();
 450
 451         // calculate right margin
 452         GridLayout layout = (GridLayout) fTimeRangeComposite.getLayout();
 453         int timeBasedControlsWidth = fTimeRangeComposite.getSize().x;
 454         int marginSize = timeBasedControlsWidth - width - plotAreaOffset;
 455         layout.marginRight = Math.max(0, marginSize);
 456         fTimeRangeComposite.layout();
 457     }
 458
 459     // ------------------------------------------------------------------------
 460     // Accessors
 461     // ------------------------------------------------------------------------
 462
 463     /**
 464      * Returns the current trace handled by the view
 465      *
 466      * @return the current trace
 467      */
 468     public ITmfTrace getTrace() {
 469         return fTrace;
 470     }
 471
 472     /**
 473      * Returns the time range of the current selected window (base on default time scale).
 474      *
 475      * @return the time range of current selected window.
 476      */
 477     public TmfTimeRange getTimeRange() {
 478         return new TmfTimeRange(
 479                 new TmfTimestamp(fWindowStartTime, ITmfTimestamp.NANOSECOND_SCALE),
 480                 new TmfTimestamp(fWindowEndTime, ITmfTimestamp.NANOSECOND_SCALE));
 481     }
 482
 483     /**
 484      * get the show lost events action
 485      *
 486      * @return The action object
 487      */
 488     public Action getShowLostEventsAction() {
 489         if (hideLostEventsAction == null) {
 490             /* show lost events */
 491             hideLostEventsAction = new Action(Messages.HistogramView_hideLostEvents, IAction.AS_CHECK_BOX) {
 492                 @Override
 493                 public void run() {
 494                     HistogramScaledData.hideLostEvents = hideLostEventsAction.isChecked();
 495                     long maxNbEvents = HistogramScaledData.hideLostEvents ? fFullTraceHistogram.fScaledData.fMaxValue : fFullTraceHistogram.fScaledData.fMaxCombinedValue;
 496                     fFullTraceHistogram.setMaxNbEvents(maxNbEvents);
 497                     maxNbEvents = HistogramScaledData.hideLostEvents ? fTimeRangeHistogram.fScaledData.fMaxValue : fTimeRangeHistogram.fScaledData.fMaxCombinedValue;
 498                     fTimeRangeHistogram.setMaxNbEvents(maxNbEvents);
 499                 }
 500             };
 501             hideLostEventsAction.setText(Messages.HistogramView_hideLostEvents);
 502             hideLostEventsAction.setToolTipText(Messages.HistogramView_hideLostEvents);
 503             hideLostEventsAction.setImageDescriptor(Activator.getDefault().getImageDescripterFromPath(ITmfImageConstants.IMG_UI_SHOW_LOST_EVENTS));
 504         }
 505         return hideLostEventsAction;
 506     }
 507
 508     /**
 509      * get the show trace action
 510      *
 511      * @return The action object
 512      */
 513     public Action getShowTraceAction() {
 514         if (showTraceAction == null) {
 515             /* show lost events */
 516             showTraceAction = new Action(Messages.HistogramView_showTraces, IAction.AS_CHECK_BOX) {
 517                 @Override
 518                 public void run() {
 519                     Histogram.showTraces = showTraceAction.isChecked();
 520                     fFullTraceHistogram.fCanvas.redraw();
 521                     fTimeRangeHistogram.fCanvas.redraw();
 522                     updateLegendArea();
 523                 }
 524             };
 525             showTraceAction.setChecked(true);
 526             showTraceAction.setText(Messages.HistogramView_showTraces);
 527             showTraceAction.setToolTipText(Messages.HistogramView_showTraces);
 528             showTraceAction.setImageDescriptor(Activator.getDefault().getImageDescripterFromPath(ITmfImageConstants.IMG_UI_SHOW_HIST_TRACES));
 529         }
 530         return showTraceAction;
 531     }
 532
 533     // ------------------------------------------------------------------------
 534     // Operations
 535     // ------------------------------------------------------------------------
 536
 537     /**
 538      * Broadcast TmfSignal about new current selection time range.
 539      * @param beginTime the begin time of current selection.
 540      * @param endTime the end time of current selection.
 541      */
 542     void updateSelectionTime(long beginTime, long endTime) {
 543         updateDisplayedSelectionTime(beginTime, endTime);
 544         TmfTimestamp beginTs = new TmfTimestamp(beginTime, ITmfTimestamp.NANOSECOND_SCALE);
 545         TmfTimestamp endTs = new TmfTimestamp(endTime, ITmfTimestamp.NANOSECOND_SCALE);
 546         TmfSelectionRangeUpdatedSignal signal = new TmfSelectionRangeUpdatedSignal(this, beginTs, endTs);
 547         fTimeSyncThrottle.queue(signal);
 548     }
 549
 550     /**
 551      * Get selection begin time
 552      * @return the begin time of current selection
 553      */
 554     long getSelectionBegin() {
 555         return fSelectionBeginTime;
 556     }
 557
 558     /**
 559      * Get selection end time
 560      * @return the end time of current selection
 561      */
 562     long getSelectionEnd() {
 563         return fSelectionEndTime;
 564     }
 565
 566     /**
 567      * Get the link state
 568      * @return true if begin and end selection time should be linked
 569      */
 570     boolean getLinkState() {
 571         return fLinkState;
 572     }
 573
 574     /**
 575      * Broadcast TmfSignal about new selection time range.
 576      * @param startTime the new start time
 577      * @param endTime the new end time
 578      */
 579     void updateTimeRange(long startTime, long endTime) {
 580         if (fTrace != null) {
 581             // Build the new time range; keep the current time
 582             TmfTimeRange timeRange = new TmfTimeRange(
 583                     new TmfTimestamp(startTime, ITmfTimestamp.NANOSECOND_SCALE),
 584                     new TmfTimestamp(endTime, ITmfTimestamp.NANOSECOND_SCALE));
 585             fTimeSpanControl.setValue(endTime - startTime);
 586
 587             updateDisplayedTimeRange(startTime, endTime);
 588
 589             // Send the FW signal
 590             TmfWindowRangeUpdatedSignal signal = new TmfWindowRangeUpdatedSignal(this, timeRange);
 591             fTimeRangeSyncThrottle.queue(signal);
 592         }
 593     }
 594
 595     /**
 596      * Broadcast TmfSignal about new selected time range.
 597      * @param newDuration new duration (relative to current start time)
 598      */
 599     public synchronized void updateTimeRange(long newDuration) {
 600         if (fTrace != null) {
 601             long delta = newDuration - fWindowSpan;
 602             long newStartTime = fWindowStartTime - (delta / 2);
 603             setNewRange(newStartTime, newDuration);
 604         }
 605     }
 606
 607     private void setNewRange(long startTime, long duration) {
 608         long realStart = startTime;
 609
 610         if (realStart < fTraceStartTime) {
 611             realStart = fTraceStartTime;
 612         }
 613
 614         long endTime = realStart + duration;
 615         if (endTime > fTraceEndTime) {
 616             endTime = fTraceEndTime;
 617             if ((endTime - duration) > fTraceStartTime) {
 618                 realStart = endTime - duration;
 619             } else {
 620                 realStart = fTraceStartTime;
 621             }
 622         }
 623         updateTimeRange(realStart, endTime);
 624     }
 625
 626     // ------------------------------------------------------------------------
 627     // Signal handlers
 628     // ------------------------------------------------------------------------
 629
 630     /**
 631      * Handles trace opened signal. Loads histogram if new trace time range is not
 632      * equal <code>TmfTimeRange.NULL_RANGE</code>
 633      * @param signal the trace opened signal
 634      */
 635     @TmfSignalHandler
 636     public void traceOpened(TmfTraceOpenedSignal signal) {
 637         assert (signal != null);
 638         fTrace = signal.getTrace();
 639         loadTrace();
 640     }
 641
 642     /**
 643      * Handles trace selected signal. Loads histogram if new trace time range is not
 644      * equal <code>TmfTimeRange.NULL_RANGE</code>
 645      * @param signal the trace selected signal
 646      */
 647     @TmfSignalHandler
 648     public void traceSelected(TmfTraceSelectedSignal signal) {
 649         assert (signal != null);
 650         if (fTrace != signal.getTrace()) {
 651             fTrace = signal.getTrace();
 652             loadTrace();
 653         }
 654     }
 655
 656     private void loadTrace() {
 657         initializeHistograms();
 658         getParentComposite().redraw();
 659     }
 660
 661     /**
 662      * Handles trace closed signal. Clears the view and data model and cancels requests.
 663      * @param signal the trace closed signal
 664      */
 665     @TmfSignalHandler
 666     public void traceClosed(TmfTraceClosedSignal signal) {
 667
 668         if (signal.getTrace() != fTrace) {
 669             return;
 670         }
 671
 672         // Kill any running request
 673         if ((fTimeRangeRequest != null) && !fTimeRangeRequest.isCompleted()) {
 674             fTimeRangeRequest.cancel();
 675         }
 676         if ((fFullTraceRequest != null) && !fFullTraceRequest.isCompleted()) {
 677             fFullTraceRequest.cancel();
 678         }
 679
 680         // Initialize the internal data
 681         fTrace = null;
 682         fTraceStartTime = 0L;
 683         fTraceEndTime = 0L;
 684         fWindowStartTime = 0L;
 685         fWindowEndTime = 0L;
 686         fWindowSpan = 0L;
 687         fSelectionBeginTime = 0L;
 688         fSelectionEndTime = 0L;
 689
 690         // Clear the UI widgets
 691         fFullTraceHistogram.clear();
 692         fTimeRangeHistogram.clear();
 693         fSelectionStartControl.setValue(Long.MIN_VALUE);
 694         fSelectionEndControl.setValue(Long.MIN_VALUE);
 695
 696         fTimeSpanControl.setValue(Long.MIN_VALUE);
 697
 698         for (Control c: fLegendArea.getChildren()) {
 699             c.dispose();
 700         }
 701         disposeLegendImages();
 702         fLegendArea.layout();
 703         fLegendArea.getParent().layout();
 704     }
 705
 706     /**
 707      * Handles trace range updated signal. Extends histogram according to the new time range. If a
 708      * HistogramRequest is already ongoing, it will be cancelled and a new request with the new range
 709      * will be issued.
 710      *
 711      * @param signal the trace range updated signal
 712      */
 713     @TmfSignalHandler
 714     public void traceRangeUpdated(TmfTraceRangeUpdatedSignal signal) {
 715
 716         if (signal.getTrace() != fTrace) {
 717             return;
 718         }
 719
 720         TmfTimeRange fullRange = signal.getRange();
 721
 722         fTraceStartTime = fullRange.getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 723         fTraceEndTime = fullRange.getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 724
 725         fFullTraceHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 726         fTimeRangeHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 727
 728         sendFullRangeRequest(fullRange);
 729     }
 730
 731     /**
 732      * Handles the trace updated signal. Used to update time limits (start and end time)
 733      * @param signal the trace updated signal
 734      */
 735     @TmfSignalHandler
 736     public void traceUpdated(TmfTraceUpdatedSignal signal) {
 737         if (signal.getTrace() != fTrace) {
 738             return;
 739         }
 740         TmfTimeRange fullRange = signal.getTrace().getTimeRange();
 741         fTraceStartTime = fullRange.getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 742         fTraceEndTime = fullRange.getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 743
 744         fFullTraceHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 745         fTimeRangeHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 746
 747         if ((fFullTraceRequest != null) && fFullTraceRequest.getRange().getEndTime().compareTo(signal.getRange().getEndTime()) < 0) {
 748             sendFullRangeRequest(fullRange);
 749         }
 750 }
 751
 752     /**
 753      * Handles the selection range updated signal. Sets the current time
 754      * selection in the time range histogram as well as the full histogram.
 755      *
 756      * @param signal
 757      *            the signal to process
 758      * @since 1.0
 759      */
 760     @TmfSignalHandler
 761     public void selectionRangeUpdated(final TmfSelectionRangeUpdatedSignal signal) {
 762         if (Display.getCurrent() == null) {
 763             // Make sure the signal is handled in the UI thread
 764             Display.getDefault().asyncExec(new Runnable() {
 765                 @Override
 766                 public void run() {
 767                     if (getParentComposite().isDisposed()) {
 768                         return;
 769                     }
 770                     selectionRangeUpdated(signal);
 771                 }
 772             });
 773             return;
 774         }
 775
 776         // Update the selected time range
 777         ITmfTimestamp beginTime = signal.getBeginTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE);
 778         ITmfTimestamp endTime = signal.getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE);
 779         updateDisplayedSelectionTime(beginTime.getValue(), endTime.getValue());
 780     }
 781
 782     /**
 783      * Updates the current window time range in the time range histogram and
 784      * full range histogram.
 785      *
 786      * @param signal
 787      *            the signal to process
 788      * @since 1.0
 789      */
 790     @TmfSignalHandler
 791     public void windowRangeUpdated(final TmfWindowRangeUpdatedSignal signal) {
 792         if (Display.getCurrent() == null) {
 793             // Make sure the signal is handled in the UI thread
 794             Display.getDefault().asyncExec(new Runnable() {
 795                 @Override
 796                 public void run() {
 797                     if (getParentComposite().isDisposed()) {
 798                         return;
 799                     }
 800                     windowRangeUpdated(signal);
 801                 }
 802             });
 803             return;
 804         }
 805
 806         if (fTrace != null) {
 807             // Validate the time range
 808             TmfTimeRange range = signal.getCurrentRange().getIntersection(fTrace.getTimeRange());
 809             if (range == null) {
 810                 return;
 811             }
 812
 813             updateDisplayedTimeRange(
 814                     range.getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue(),
 815                     range.getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue());
 816
 817             // Send the event request to populate the small histogram
 818             sendTimeRangeRequest(fWindowStartTime, fWindowEndTime);
 819
 820             fTimeSpanControl.setValue(fWindowSpan);
 821         }
 822     }
 823
 824     // ------------------------------------------------------------------------
 825     // Helper functions
 826     // ------------------------------------------------------------------------
 827
 828     private void initializeHistograms() {
 829         TmfTimeRange fullRange = updateTraceTimeRange();
 830
 831         TmfTraceContext ctx = TmfTraceManager.getInstance().getCurrentTraceContext();
 832         long selectionBeginTime = ctx.getSelectionRange().getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 833         long selectionEndTime = ctx.getSelectionRange().getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 834         long startTime = ctx.getWindowRange().getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 835         long duration = ctx.getWindowRange().getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue() - startTime;
 836
 837         if ((fTimeRangeRequest != null) && !fTimeRangeRequest.isCompleted()) {
 838             fTimeRangeRequest.cancel();
 839         }
 840         fTimeRangeHistogram.clear();
 841         fTimeRangeHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 842         fTimeRangeHistogram.setTimeRange(startTime, duration);
 843         fTimeRangeHistogram.setSelection(selectionBeginTime, selectionEndTime);
 844         fTimeRangeHistogram.fDataModel.setTrace(fTrace);
 845
 846         if ((fFullTraceRequest != null) && !fFullTraceRequest.isCompleted()) {
 847             fFullTraceRequest.cancel();
 848         }
 849         fFullTraceHistogram.clear();
 850         fFullTraceHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 851         fFullTraceHistogram.setTimeRange(startTime, duration);
 852         fFullTraceHistogram.setSelection(selectionBeginTime, selectionEndTime);
 853         fFullTraceHistogram.fDataModel.setTrace(fTrace);
 854
 855         fWindowStartTime = startTime;
 856         fWindowSpan = duration;
 857         fWindowEndTime = startTime + duration;
 858
 859         fSelectionBeginTime = selectionBeginTime;
 860         fSelectionEndTime = selectionEndTime;
 861         fSelectionStartControl.setValue(fSelectionBeginTime);
 862         fSelectionEndControl.setValue(fSelectionEndTime);
 863
 864         // make sure that the scrollbar is setup properly
 865         fScrollComposite.setMinSize(fTimeControlsComposite.computeSize(SWT.DEFAULT, SWT.DEFAULT));
 866         fTimeSpanControl.setValue(duration);
 867
 868         Collection<ITmfTrace> traces = TmfTraceManager.getTraceSet(fTrace);
 869         if (!traces.isEmpty()) {
 870             this.showTraceAction.setEnabled(traces.size() < fFullTraceHistogram.getMaxNbTraces());
 871         }
 872         updateLegendArea();
 873
 874         if (!fullRange.equals(TmfTimeRange.NULL_RANGE)) {
 875             sendTimeRangeRequest(startTime, startTime + duration);
 876             sendFullRangeRequest(fullRange);
 877         }
 878     }
 879
 880     private void updateLegendArea() {
 881         for (Control c: fLegendArea.getChildren()) {
 882             c.dispose();
 883         }
 884         disposeLegendImages();
 885         if (fFullTraceHistogram.showTraces()) {
 886             Collection<ITmfTrace> traces = TmfTraceManager.getTraceSet(fTrace);
 887             fLegendImages = new Image[traces.size()];
 888             int traceIndex = 0;
 889             for (ITmfTrace trace : traces) {
 890                 fLegendImages[traceIndex] = new Image(fLegendArea.getDisplay(), 16, 16);
 891                 GC gc = new GC(fLegendImages[traceIndex]);
 892                 gc.setBackground(fFullTraceHistogram.getTraceColor(traceIndex));
 893                 gc.fillRectangle(0, 0, 15, 15);
 894                 gc.setForeground(fLegendArea.getDisplay().getSystemColor(SWT.COLOR_BLACK));
 895                 gc.drawRectangle(0, 0, 15, 15);
 896                 gc.dispose();
 897
 898                 CLabel label = new CLabel(fLegendArea, SWT.NONE);
 899                 label.setText(trace.getName());
 900                 label.setImage(fLegendImages[traceIndex]);
 901                 traceIndex++;
 902             }
 903         }
 904         fLegendArea.layout();
 905         fLegendArea.getParent().layout();
 906     }
 907
 908     private void updateDisplayedSelectionTime(long beginTime, long endTime) {
 909         fSelectionBeginTime = beginTime;
 910         fSelectionEndTime = endTime;
 911
 912         fFullTraceHistogram.setSelection(fSelectionBeginTime, fSelectionEndTime);
 913         fTimeRangeHistogram.setSelection(fSelectionBeginTime, fSelectionEndTime);
 914         fSelectionStartControl.setValue(fSelectionBeginTime);
 915         fSelectionEndControl.setValue(fSelectionEndTime);
 916     }
 917
 918     private void updateDisplayedTimeRange(long start, long end) {
 919         fWindowStartTime = start;
 920         fWindowEndTime = end;
 921         fWindowSpan = fWindowEndTime - fWindowStartTime;
 922         fFullTraceHistogram.setTimeRange(fWindowStartTime, fWindowSpan);
 923     }
 924
 925     private TmfTimeRange updateTraceTimeRange() {
 926         fTraceStartTime = 0L;
 927         fTraceEndTime = 0L;
 928
 929         TmfTimeRange timeRange = fTrace.getTimeRange();
 930         if (!timeRange.equals(TmfTimeRange.NULL_RANGE)) {
 931             fTraceStartTime = timeRange.getStartTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 932             fTraceEndTime = timeRange.getEndTime().normalize(0, ITmfTimestamp.NANOSECOND_SCALE).getValue();
 933         }
 934         return timeRange;
 935     }
 936
 937     private void sendTimeRangeRequest(long startTime, long endTime) {
 938         if ((fTimeRangeRequest != null) && !fTimeRangeRequest.isCompleted()) {
 939             fTimeRangeRequest.cancel();
 940         }
 941         TmfTimestamp startTS = new TmfTimestamp(startTime, ITmfTimestamp.NANOSECOND_SCALE);
 942         TmfTimestamp endTS = new TmfTimestamp(endTime, ITmfTimestamp.NANOSECOND_SCALE);
 943         TmfTimeRange timeRange = new TmfTimeRange(startTS, endTS);
 944
 945         fTimeRangeHistogram.clear();
 946         fTimeRangeHistogram.setFullRange(fTraceStartTime, fTraceEndTime);
 947         fTimeRangeHistogram.setTimeRange(startTime, endTime - startTime);
 948
 949         int cacheSize = fTrace.getCacheSize();
 950         fTimeRangeRequest = new HistogramRequest(fTimeRangeHistogram.getDataModel(),
 951                 timeRange, 0, ITmfEventRequest.ALL_DATA, cacheSize, ExecutionType.FOREGROUND, false);
 952         fTrace.sendRequest(fTimeRangeRequest);
 953     }
 954
 955     private void sendFullRangeRequest(TmfTimeRange fullRange) {
 956         if ((fFullTraceRequest != null) && !fFullTraceRequest.isCompleted()) {
 957             fFullTraceRequest.cancel();
 958         }
 959         int cacheSize = fTrace.getCacheSize();
 960         fFullTraceRequest = new HistogramRequest(fFullTraceHistogram.getDataModel(),
 961                 fullRange,
 962                 (int) fFullTraceHistogram.fDataModel.getNbEvents(),
 963                 ITmfEventRequest.ALL_DATA,
 964                 cacheSize,
 965                 ExecutionType.BACKGROUND, true);
 966         fTrace.sendRequest(fFullTraceRequest);
 967     }
 968
 969     private void contributeToActionBars() {
 970         IActionBars bars = getViewSite().getActionBars();
 971         bars.getToolBarManager().add(getShowLostEventsAction());
 972         bars.getToolBarManager().add(getShowTraceAction());
 973         bars.getToolBarManager().add(new Separator());
 974     }
 975
 976     private void addLinkButtonListeners() {
 977         fLinkButton.addMouseListener(new MouseAdapter() {
 978             @Override
 979             public void mouseDown(MouseEvent e) {
 980                 fSelectionEndControl.setEnabled(fLinkState);
 981                 fLinkState = !fLinkState;
 982                 fLinkButton.redraw();
 983             }
 984         });
 985
 986         fLinkButton.addPaintListener(new PaintListener() {
 987             @Override
 988             public void paintControl(PaintEvent e) {
 989                 if (fLinkState) {
 990                     Rectangle r = fLinkButton.getBounds();
 991                     r.x = -1;
 992                     r.y = -1;
 993                     e.gc.setForeground(e.display.getSystemColor(SWT.COLOR_WIDGET_NORMAL_SHADOW));
 994                     e.gc.drawRectangle(r);
 995                     r.x = 0;
 996                     r.y = 0;
 997                     e.gc.setForeground(e.display.getSystemColor(SWT.COLOR_DARK_GRAY));
 998                     e.gc.drawRectangle(r);
 999                 }
1000             }
1001         });
1002     }
1003
1004     private static class PackedScrolledComposite extends ScrolledComposite {
1005         Point fScrollBarSize;  // Size of OS-specific scrollbar
1006
1007         public PackedScrolledComposite(Composite parent, int style) {
1008             super(parent, style);
1009             Composite composite = new Composite(parent, SWT.H_SCROLL | SWT.V_SCROLL);
1010             composite.setSize(1, 1);
1011             fScrollBarSize = composite.computeSize(0, 0);
1012             composite.dispose();
1013         }
1014
1015         @Override
1016         public Point computeSize(int wHint, int hHint, boolean changed) {
1017             Point point = super.computeSize(wHint, hHint, changed);
1018             // Remove scrollbar size if applicable
1019             point.x += ((getStyle() & SWT.V_SCROLL) != 0) ? -fScrollBarSize.x : 0;
1020             point.y += ((getStyle() & SWT.H_SCROLL) != 0) ? -fScrollBarSize.y : 0;
1021             return point;
1022         }
1023     }
1024 }