org.eclipse.jface.text/src/org/eclipse/jface/text/source/LineNumberChangeRulerColumn.java - platform/eclipse.platform.text - Git at Google

 /*******************************************************************************
  * Copyright (c) 2000, 2004 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Common Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/cpl-v10.html
  *
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *******************************************************************************/
 package org.eclipse.jface.text.source;

 import org.eclipse.swt.graphics.Color;
 import org.eclipse.swt.graphics.GC;
 import org.eclipse.swt.graphics.RGB;
 import org.eclipse.swt.widgets.Display;

 import org.eclipse.jface.text.Assert;

 /**
  * A vertical ruler column displaying line numbers and serving as a UI for quick diff.
  * Clients usually instantiate and configure object of this class.
  *
  * @since 3.0
  */
 public final class LineNumberChangeRulerColumn extends LineNumberRulerColumn implements IVerticalRulerInfo, IVerticalRulerInfoExtension, IChangeRulerColumn {

 	/** Width of the triangle displayed for deleted lines. */
 	private final static int fTriangleWidth= 7;
 	/** The height of the triangle displayed for deleted lines. */
 	private final static int fTriangleHeight= 3;

 	/**
 	 * Internal listener class that will update the ruler when the underlying model changes.
 	 */
 	class AnnotationListener implements IAnnotationModelListener {
 		/*
 		 * @see org.eclipse.jface.text.source.IAnnotationModelListener#modelChanged(org.eclipse.jface.text.source.IAnnotationModel)
 		 */
 		public void modelChanged(IAnnotationModel model) {
 			postRedraw();
 		}
 	}

 	/**
 	 * Returns a specification of a color that lies between the given
 	 * foreground and background color using the given scale factor.
 	 *
 	 * @param fg the foreground color
 	 * @param bg the background color
 	 * @param scale the scale factor
 	 * @return the interpolated color
 	 */
 	private static RGB interpolate(RGB fg, RGB bg, double scale) {
 		return new RGB(
 			(int) ((1.0-scale) * fg.red + scale * bg.red),
 			(int) ((1.0-scale) * fg.green + scale * bg.green),
 			(int) ((1.0-scale) * fg.blue + scale * bg.blue)
 		);
 	}

 	/**
 	 * Returns the grey value in which the given color would be drawn in grey-scale.
 	 *
 	 * @param rgb the color
 	 * @return the grey-scale value
 	 */
 	private static double greyLevel(RGB rgb) {
 		if (rgb.red == rgb.green && rgb.green == rgb.blue)
 			return rgb.red;
 		return  (0.299 * rgb.red + 0.587 * rgb.green + 0.114 * rgb.blue + 0.5);
 	}

 	/**
 	 * Returns whether the given color is dark or light depending on the colors grey-scale level.
 	 *
 	 * @param rgb the color
 	 * @return <code>true</code> if the color is dark, <code>false</code> if it is light
 	 */
 	private static boolean isDark(RGB rgb) {
 		return greyLevel(rgb) > 128;
 	}

 	/** Color for changed lines. */
 	private Color fAddedColor;
 	/** Color for added lines. */
 	private Color fChangedColor;
 	/** Color for the deleted line indicator. */
 	private Color fDeletedColor;
 	/** The ruler's annotation model. */
 	IAnnotationModel fAnnotationModel;
 	/** The ruler's hover. */
 	private IAnnotationHover fHover;
 	/** The internal listener. */
 	private AnnotationListener fAnnotationListener= new AnnotationListener();
 	/** <code>true</code> if changes should be displayed using character indications instead of background colors. */
 	private boolean fCharacterDisplay;
 	/** The shared text colors. */
 	private ISharedTextColors fSharedColors;

 	/**
 	 * Creates a new instance.
 	 *
 	 * @param sharedColors the shared colors provider to use
 	 */
 	public LineNumberChangeRulerColumn(ISharedTextColors sharedColors) {
 		Assert.isNotNull(sharedColors);
 		fSharedColors= sharedColors;
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.LineNumberRulerColumn#handleDispose()
 	 */
 	protected void handleDispose() {
 		if (fAnnotationModel != null) {
 			fAnnotationModel.removeAnnotationModelListener(fAnnotationListener);
 			fAnnotationModel= null;
 		}
 		super.handleDispose();
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.LineNumberRulerColumn#paintLine(int, int, int, org.eclipse.swt.graphics.GC, org.eclipse.swt.widgets.Display)
 	 */
 	protected void paintLine(int line, int y, int lineheight, GC gc, Display display) {
 		ILineDiffInfo info= getDiffInfo(line);

 		if (info != null) {
 			// width of the column
 			int width= getWidth();

 			// draw background color if special
 			if (hasSpecialColor(info)) {
 				gc.setBackground(getColor(info, display));
 				gc.fillRectangle(0, y, width, lineheight);
 			}

 			/* Deletion Indicator
 			 * It consists of a line across the column and a triangle as shown for a deleted
 			 * line below the line 50:
 			 * ('x' means its colored)
 			 *
 			 * 1, 2, 3 show the points of the triangle painted.
 			 *
 			 *      0				  width
 			 *		|					|
 			 * 		---------------------        - y
 			 * 		|	 ---   --   	|
 			 * 		|	|	  |  |		1_
 			 * 		|	 --   |  |	   x|   ^
 			 * 		|	   |  |  |	 xxx|   |  fTriangleHeight / 2
 			 * 		|	---    --  xxxxx|   |
 			 * 		xxxxxxxxxxxx0xxxxxxx2_  v    _   y + lineheight
 			 * 					|		|
 			 * 					<------>
 			 * 					 fTriangleWidth
 			 */
 			int delBefore= info.getRemovedLinesAbove();
 			int delBelow= info.getRemovedLinesBelow();
 			if (delBefore > 0 || delBelow > 0) {
 				Color deletionColor= getDeletionColor(display);
 				gc.setBackground(deletionColor);
 				gc.setForeground(deletionColor);

 				int[] triangle= new int[6];
 				triangle[0]= width - fTriangleWidth;
 				triangle[1]= y;
 				triangle[2]= width;
 				triangle[3]= y - fTriangleHeight;
 				triangle[4]= width;
 				triangle[5]= y + fTriangleHeight;

 				if (delBefore > 0) {
 					gc.drawLine(0, y, width, y);
 					gc.fillPolygon(triangle);
 				}

 				if (delBelow > 0) {
 					triangle[1] += lineheight;
 					triangle[3] += lineheight;
 					triangle[5] += lineheight;

 					gc.drawLine(0, y + lineheight, width, y + lineheight);
 					gc.fillPolygon(triangle);
 				}
 				gc.setForeground(getForeground());
 			}
 		}
 	}

 	/**
 	 * Returns whether the line background differs from the default.
 	 *
 	 * @param info the info being queried
 	 * @return <code>true</code> if <code>info</code> describes either a changed or an added line.
 	 */
 	private boolean hasSpecialColor(ILineDiffInfo info) {
 		return info.getChangeType() == ILineDiffInfo.ADDED || info.getChangeType() == ILineDiffInfo.CHANGED;
 	}

 	/**
 	 * Retrieves the <code>ILineDiffInfo</code> for <code>line</code> from the model.
 	 * There are optimizations for direct access and sequential access patterns.
 	 *
 	 * @param line the line we want the info for.
 	 * @return the <code>ILineDiffInfo</code> for <code>line</code>, or <code>null</code>.
 	 */
 	private ILineDiffInfo getDiffInfo(int line) {
 		if (fAnnotationModel == null)
 			return null;

 		// assume direct access
 		if (fAnnotationModel instanceof ILineDiffer) {
 			ILineDiffer differ= (ILineDiffer)fAnnotationModel;
 			return differ.getLineInfo(line);
 		}

 		return null;
 	}

 	/**
 	 * Returns the color for deleted lines.
 	 *
 	 * @param display the display that the drawing occurs on
 	 * @return the color to be used for the deletion indicator
 	 */
 	private Color getDeletionColor(Display display) {
 		return fDeletedColor == null ? getBackground(display) : fDeletedColor;
 	}

 	/**
 	 * Returns the color for the given line diff info.
 	 *
 	 * @param info the <code>ILineDiffInfo</code> being queried
 	 * @param display the display that the drawing occurs on
 	 * @return the correct background color for the line type being described by <code>info</code>
 	 */
 	private Color getColor(ILineDiffInfo info, Display display) {
 		Assert.isTrue(info != null && info.getChangeType() != ILineDiffInfo.UNCHANGED);
 		Color ret= null;
 		switch (info.getChangeType()) {
 			case ILineDiffInfo.CHANGED :
 				ret= getShadedColor(fChangedColor, display);
 				break;
 			case ILineDiffInfo.ADDED :
 				ret= getShadedColor(fAddedColor, display);
 				break;
 		}
 		return ret == null ? getBackground(display) : ret;
 	}

 	/**
 	 * Returns the character to display in character display mode for the given <code>ILineDiffInfo</code>
 	 *
 	 * @param info the <code>ILineDiffInfo</code> being queried
 	 * @return the character indication for <code>info</code>
 	 */
 	private String getDisplayCharacter(ILineDiffInfo info) {
 		if (info == null)
 			return ""; //$NON-NLS-1$
 		switch (info.getChangeType()) {
 			case ILineDiffInfo.CHANGED :
 				return "~"; //$NON-NLS-1$
 			case ILineDiffInfo.ADDED :
 				return "+"; //$NON-NLS-1$
 		}
 		return " "; //$NON-NLS-1$
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfo#getLineOfLastMouseButtonActivity()
 	 */
 	public int getLineOfLastMouseButtonActivity() {
 		return getParentRuler().getLineOfLastMouseButtonActivity();
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfo#toDocumentLineNumber(int)
 	 */
 	public int toDocumentLineNumber(int y_coordinate) {
 		return getParentRuler().toDocumentLineNumber(y_coordinate);
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#getHover()
 	 */
 	public IAnnotationHover getHover() {
 		return fHover;
 	}

 	/**
 	 * Sets the hover of this ruler column.
 	 * @param hover the hover that will produce hover information text for this ruler column
 	 */
 	public void setHover(IAnnotationHover hover) {
 		fHover= hover;
 	}

 	/*
 	 * @see IVerticalRulerColumn#setModel(IAnnotationModel)
 	 */
 	public void setModel(IAnnotationModel model) {
 		IAnnotationModel newModel;
 		if (model instanceof IAnnotationModelExtension) {
 			newModel= ((IAnnotationModelExtension)model).getAnnotationModel(QUICK_DIFF_MODEL_ID);
 		} else {
 			newModel= model;
 		}
 		if (fAnnotationModel != newModel) {
 			if (fAnnotationModel != null) {
 				fAnnotationModel.removeAnnotationModelListener(fAnnotationListener);
 			}
 			fAnnotationModel= newModel;
 			if (fAnnotationModel != null) {
 				fAnnotationModel.addAnnotationModelListener(fAnnotationListener);
 			}
 			updateNumberOfDigits();
 			computeIndentations();
 			layout(true);
 			postRedraw();
 		}
 	}

 	/**
 	 * Sets the background color for added lines. The color has to be disposed of by the caller when
 	 * the receiver is no longer used.
 	 *
 	 * @param addedColor the new color to be used for the added lines background
 	 */
 	public void setAddedColor(Color addedColor) {
 		fAddedColor= addedColor;
 	}

 	/**
 	 * Sets the background color for changed lines. The color has to be disposed of by the caller when
 	 * the receiver is no longer used.
 	 *
 	 * @param changedColor the new color to be used for the changed lines background
 	 */
 	public void setChangedColor(Color changedColor) {
 		fChangedColor= changedColor;
 	}

 	/**
 	 * Sets the background color for changed lines. The color has to be disposed of by the caller when
 	 * the receiver is no longer used.
 	 *
 	 * @param color the new color to be used for the changed lines background
 	 * @param display the display
 	 * @return the shaded color
 	 */
 	private Color getShadedColor(Color color, Display display) {
 		if (color == null)
 			return null;

 		RGB baseRGB= color.getRGB();
 		RGB background= getBackground(display).getRGB();

 		boolean darkBase= isDark(baseRGB);
 		boolean darkBackground= isDark(background);
 		if (darkBase && darkBackground)
 			background= new RGB(255, 255, 255);
 		else if (!darkBase && !darkBackground)
 			background= new RGB(0, 0, 0);

 		return fSharedColors.getColor(interpolate(baseRGB, background, 0.6));
 	}

 	/**
 	 * Sets the color for the deleted lines indicator. The color has to be disposed of by the caller when
 	 * the receiver is no longer used.
 	 *
 	 * @param deletedColor the new color to be used for the deleted lines indicator.
 	 */
 	public void setDeletedColor(Color deletedColor) {
 		fDeletedColor= deletedColor;
 	}

 	/**
 	 * Sets the the display mode of the ruler. If character mode is set to <code>true</code>, diff
 	 * information will be displayed textually on the line number ruler.
 	 *
 	 * @param characterMode <code>true</code> if diff information is to be displayed textually.
 	 */
 	public void setDisplayMode(boolean characterMode) {
 		if (characterMode != fCharacterDisplay) {
 			fCharacterDisplay= characterMode;
 			updateNumberOfDigits();
 			computeIndentations();
 			layout(true);
 		}
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#getModel()
 	 */
 	public IAnnotationModel getModel() {
 		return fAnnotationModel;
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.LineNumberRulerColumn#createDisplayString(int)
 	 */
 	protected String createDisplayString(int line) {
 		if (fCharacterDisplay && getModel() != null)
 			return super.createDisplayString(line) + getDisplayCharacter(getDiffInfo(line));
 		else
 			return super.createDisplayString(line);
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.LineNumberRulerColumn#computeNumberOfDigits()
 	 */
 	protected int computeNumberOfDigits() {
 		if (fCharacterDisplay && getModel() != null)
 			return super.computeNumberOfDigits() + 1;
 		else
 			return super.computeNumberOfDigits();
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#addVerticalRulerListener(org.eclipse.jface.text.source.IVerticalRulerListener)
 	 */
 	public void addVerticalRulerListener(IVerticalRulerListener listener) {
 		throw new UnsupportedOperationException();
 	}

 	/*
 	 * @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#removeVerticalRulerListener(org.eclipse.jface.text.source.IVerticalRulerListener)
 	 */
 	public void removeVerticalRulerListener(IVerticalRulerListener listener) {
 		throw new UnsupportedOperationException();
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2000, 2004 IBM Corporation and others.
	* All rights reserved. This program and the accompanying materials
	* are made available under the terms of the Common Public License v1.0
	* which accompanies this distribution, and is available at
	* http://www.eclipse.org/legal/cpl-v10.html
	*
	* Contributors:
	* IBM Corporation - initial API and implementation
	*******************************************************************************/
	package org.eclipse.jface.text.source;

	import org.eclipse.swt.graphics.Color;
	import org.eclipse.swt.graphics.GC;
	import org.eclipse.swt.graphics.RGB;
	import org.eclipse.swt.widgets.Display;

	import org.eclipse.jface.text.Assert;

	/**
	* A vertical ruler column displaying line numbers and serving as a UI for quick diff.
	* Clients usually instantiate and configure object of this class.
	*
	* @since 3.0
	*/
	public final class LineNumberChangeRulerColumn extends LineNumberRulerColumn implements IVerticalRulerInfo, IVerticalRulerInfoExtension, IChangeRulerColumn {

	/** Width of the triangle displayed for deleted lines. */
	private final static int fTriangleWidth= 7;
	/** The height of the triangle displayed for deleted lines. */
	private final static int fTriangleHeight= 3;

	/**
	* Internal listener class that will update the ruler when the underlying model changes.
	*/
	class AnnotationListener implements IAnnotationModelListener {
	/*
	* @see org.eclipse.jface.text.source.IAnnotationModelListener#modelChanged(org.eclipse.jface.text.source.IAnnotationModel)
	*/
	public void modelChanged(IAnnotationModel model) {
	postRedraw();
	}
	}

	/**
	* Returns a specification of a color that lies between the given
	* foreground and background color using the given scale factor.
	*
	* @param fg the foreground color
	* @param bg the background color
	* @param scale the scale factor
	* @return the interpolated color
	*/
	private static RGB interpolate(RGB fg, RGB bg, double scale) {
	return new RGB(
	(int) ((1.0-scale) * fg.red + scale * bg.red),
	(int) ((1.0-scale) * fg.green + scale * bg.green),
	(int) ((1.0-scale) * fg.blue + scale * bg.blue)
	);
	}

	/**
	* Returns the grey value in which the given color would be drawn in grey-scale.
	*
	* @param rgb the color
	* @return the grey-scale value
	*/
	private static double greyLevel(RGB rgb) {
	if (rgb.red == rgb.green && rgb.green == rgb.blue)
	return rgb.red;
	return (0.299 * rgb.red + 0.587 * rgb.green + 0.114 * rgb.blue + 0.5);
	}

	/**
	* Returns whether the given color is dark or light depending on the colors grey-scale level.
	*
	* @param rgb the color
	* @return <code>true</code> if the color is dark, <code>false</code> if it is light
	*/
	private static boolean isDark(RGB rgb) {
	return greyLevel(rgb) > 128;
	}

	/** Color for changed lines. */
	private Color fAddedColor;
	/** Color for added lines. */
	private Color fChangedColor;
	/** Color for the deleted line indicator. */
	private Color fDeletedColor;
	/** The ruler's annotation model. */
	IAnnotationModel fAnnotationModel;
	/** The ruler's hover. */
	private IAnnotationHover fHover;
	/** The internal listener. */
	private AnnotationListener fAnnotationListener= new AnnotationListener();
	/** <code>true</code> if changes should be displayed using character indications instead of background colors. */
	private boolean fCharacterDisplay;
	/** The shared text colors. */
	private ISharedTextColors fSharedColors;

	/**
	* Creates a new instance.
	*
	* @param sharedColors the shared colors provider to use
	*/
	public LineNumberChangeRulerColumn(ISharedTextColors sharedColors) {
	Assert.isNotNull(sharedColors);
	fSharedColors= sharedColors;
	}

	/*
	* @see org.eclipse.jface.text.source.LineNumberRulerColumn#handleDispose()
	*/
	protected void handleDispose() {
	if (fAnnotationModel != null) {
	fAnnotationModel.removeAnnotationModelListener(fAnnotationListener);
	fAnnotationModel= null;
	}
	super.handleDispose();
	}

	/*
	* @see org.eclipse.jface.text.source.LineNumberRulerColumn#paintLine(int, int, int, org.eclipse.swt.graphics.GC, org.eclipse.swt.widgets.Display)
	*/
	protected void paintLine(int line, int y, int lineheight, GC gc, Display display) {
	ILineDiffInfo info= getDiffInfo(line);

	if (info != null) {
	// width of the column
	int width= getWidth();

	// draw background color if special
	if (hasSpecialColor(info)) {
	gc.setBackground(getColor(info, display));
	gc.fillRectangle(0, y, width, lineheight);
	}

	/* Deletion Indicator
	* It consists of a line across the column and a triangle as shown for a deleted
	* line below the line 50:
	* ('x' means its colored)
	*
	* 1, 2, 3 show the points of the triangle painted.
	*
	* 0 width
	* \| \|
	* --------------------- - y
	* \| --- -- \|
	* \| \| \| \| 1_
	* \| -- \| \| x\| ^
	* \| \| \| \| xxx\| \| fTriangleHeight / 2
	* \| --- -- xxxxx\| \|
	* xxxxxxxxxxxx0xxxxxxx2_ v _ y + lineheight
	* \| \|
	* <------>
	* fTriangleWidth
	*/
	int delBefore= info.getRemovedLinesAbove();
	int delBelow= info.getRemovedLinesBelow();
	if (delBefore > 0 \|\| delBelow > 0) {
	Color deletionColor= getDeletionColor(display);
	gc.setBackground(deletionColor);
	gc.setForeground(deletionColor);

	int[] triangle= new int[6];
	triangle[0]= width - fTriangleWidth;
	triangle[1]= y;
	triangle[2]= width;
	triangle[3]= y - fTriangleHeight;
	triangle[4]= width;
	triangle[5]= y + fTriangleHeight;

	if (delBefore > 0) {
	gc.drawLine(0, y, width, y);
	gc.fillPolygon(triangle);
	}

	if (delBelow > 0) {
	triangle[1] += lineheight;
	triangle[3] += lineheight;
	triangle[5] += lineheight;

	gc.drawLine(0, y + lineheight, width, y + lineheight);
	gc.fillPolygon(triangle);
	}
	gc.setForeground(getForeground());
	}
	}
	}

	/**
	* Returns whether the line background differs from the default.
	*
	* @param info the info being queried
	* @return <code>true</code> if <code>info</code> describes either a changed or an added line.
	*/
	private boolean hasSpecialColor(ILineDiffInfo info) {
	return info.getChangeType() == ILineDiffInfo.ADDED \|\| info.getChangeType() == ILineDiffInfo.CHANGED;
	}

	/**
	* Retrieves the <code>ILineDiffInfo</code> for <code>line</code> from the model.
	* There are optimizations for direct access and sequential access patterns.
	*
	* @param line the line we want the info for.
	* @return the <code>ILineDiffInfo</code> for <code>line</code>, or <code>null</code>.
	*/
	private ILineDiffInfo getDiffInfo(int line) {
	if (fAnnotationModel == null)
	return null;

	// assume direct access
	if (fAnnotationModel instanceof ILineDiffer) {
	ILineDiffer differ= (ILineDiffer)fAnnotationModel;
	return differ.getLineInfo(line);
	}

	return null;
	}

	/**
	* Returns the color for deleted lines.
	*
	* @param display the display that the drawing occurs on
	* @return the color to be used for the deletion indicator
	*/
	private Color getDeletionColor(Display display) {
	return fDeletedColor == null ? getBackground(display) : fDeletedColor;
	}

	/**
	* Returns the color for the given line diff info.
	*
	* @param info the <code>ILineDiffInfo</code> being queried
	* @param display the display that the drawing occurs on
	* @return the correct background color for the line type being described by <code>info</code>
	*/
	private Color getColor(ILineDiffInfo info, Display display) {
	Assert.isTrue(info != null && info.getChangeType() != ILineDiffInfo.UNCHANGED);
	Color ret= null;
	switch (info.getChangeType()) {
	case ILineDiffInfo.CHANGED :
	ret= getShadedColor(fChangedColor, display);
	break;
	case ILineDiffInfo.ADDED :
	ret= getShadedColor(fAddedColor, display);
	break;
	}
	return ret == null ? getBackground(display) : ret;
	}

	/**
	* Returns the character to display in character display mode for the given <code>ILineDiffInfo</code>
	*
	* @param info the <code>ILineDiffInfo</code> being queried
	* @return the character indication for <code>info</code>
	*/
	private String getDisplayCharacter(ILineDiffInfo info) {
	if (info == null)
	return ""; //$NON-NLS-1$
	switch (info.getChangeType()) {
	case ILineDiffInfo.CHANGED :
	return "~"; //$NON-NLS-1$
	case ILineDiffInfo.ADDED :
	return "+"; //$NON-NLS-1$
	}
	return " "; //$NON-NLS-1$
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfo#getLineOfLastMouseButtonActivity()
	*/
	public int getLineOfLastMouseButtonActivity() {
	return getParentRuler().getLineOfLastMouseButtonActivity();
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfo#toDocumentLineNumber(int)
	*/
	public int toDocumentLineNumber(int y_coordinate) {
	return getParentRuler().toDocumentLineNumber(y_coordinate);
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#getHover()
	*/
	public IAnnotationHover getHover() {
	return fHover;
	}

	/**
	* Sets the hover of this ruler column.
	* @param hover the hover that will produce hover information text for this ruler column
	*/
	public void setHover(IAnnotationHover hover) {
	fHover= hover;
	}

	/*
	* @see IVerticalRulerColumn#setModel(IAnnotationModel)
	*/
	public void setModel(IAnnotationModel model) {
	IAnnotationModel newModel;
	if (model instanceof IAnnotationModelExtension) {
	newModel= ((IAnnotationModelExtension)model).getAnnotationModel(QUICK_DIFF_MODEL_ID);
	} else {
	newModel= model;
	}
	if (fAnnotationModel != newModel) {
	if (fAnnotationModel != null) {
	fAnnotationModel.removeAnnotationModelListener(fAnnotationListener);
	}
	fAnnotationModel= newModel;
	if (fAnnotationModel != null) {
	fAnnotationModel.addAnnotationModelListener(fAnnotationListener);
	}
	updateNumberOfDigits();
	computeIndentations();
	layout(true);
	postRedraw();
	}
	}

	/**
	* Sets the background color for added lines. The color has to be disposed of by the caller when
	* the receiver is no longer used.
	*
	* @param addedColor the new color to be used for the added lines background
	*/
	public void setAddedColor(Color addedColor) {
	fAddedColor= addedColor;
	}

	/**
	* Sets the background color for changed lines. The color has to be disposed of by the caller when
	* the receiver is no longer used.
	*
	* @param changedColor the new color to be used for the changed lines background
	*/
	public void setChangedColor(Color changedColor) {
	fChangedColor= changedColor;
	}

	/**
	* Sets the background color for changed lines. The color has to be disposed of by the caller when
	* the receiver is no longer used.
	*
	* @param color the new color to be used for the changed lines background
	* @param display the display
	* @return the shaded color
	*/
	private Color getShadedColor(Color color, Display display) {
	if (color == null)
	return null;

	RGB baseRGB= color.getRGB();
	RGB background= getBackground(display).getRGB();

	boolean darkBase= isDark(baseRGB);
	boolean darkBackground= isDark(background);
	if (darkBase && darkBackground)
	background= new RGB(255, 255, 255);
	else if (!darkBase && !darkBackground)
	background= new RGB(0, 0, 0);

	return fSharedColors.getColor(interpolate(baseRGB, background, 0.6));
	}

	/**
	* Sets the color for the deleted lines indicator. The color has to be disposed of by the caller when
	* the receiver is no longer used.
	*
	* @param deletedColor the new color to be used for the deleted lines indicator.
	*/
	public void setDeletedColor(Color deletedColor) {
	fDeletedColor= deletedColor;
	}

	/**
	* Sets the the display mode of the ruler. If character mode is set to <code>true</code>, diff
	* information will be displayed textually on the line number ruler.
	*
	* @param characterMode <code>true</code> if diff information is to be displayed textually.
	*/
	public void setDisplayMode(boolean characterMode) {
	if (characterMode != fCharacterDisplay) {
	fCharacterDisplay= characterMode;
	updateNumberOfDigits();
	computeIndentations();
	layout(true);
	}
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#getModel()
	*/
	public IAnnotationModel getModel() {
	return fAnnotationModel;
	}

	/*
	* @see org.eclipse.jface.text.source.LineNumberRulerColumn#createDisplayString(int)
	*/
	protected String createDisplayString(int line) {
	if (fCharacterDisplay && getModel() != null)
	return super.createDisplayString(line) + getDisplayCharacter(getDiffInfo(line));
	else
	return super.createDisplayString(line);
	}

	/*
	* @see org.eclipse.jface.text.source.LineNumberRulerColumn#computeNumberOfDigits()
	*/
	protected int computeNumberOfDigits() {
	if (fCharacterDisplay && getModel() != null)
	return super.computeNumberOfDigits() + 1;
	else
	return super.computeNumberOfDigits();
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#addVerticalRulerListener(org.eclipse.jface.text.source.IVerticalRulerListener)
	*/
	public void addVerticalRulerListener(IVerticalRulerListener listener) {
	throw new UnsupportedOperationException();
	}

	/*
	* @see org.eclipse.jface.text.source.IVerticalRulerInfoExtension#removeVerticalRulerListener(org.eclipse.jface.text.source.IVerticalRulerListener)
	*/
	public void removeVerticalRulerListener(IVerticalRulerListener listener) {
	throw new UnsupportedOperationException();
	}
	}