/*******************************************************************************
 * Copyright (c) 2000, 2005 IBM Corporation and others.
 * 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
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 * Port to the D programming language:
 *     Frank Benoit <benoit@tionex.de>
 *******************************************************************************/
module dwtx.draw2d.RelativeLocator;

import dwt.dwthelper.utils;

import dwtx.draw2d.geometry.Dimension;
import dwtx.draw2d.geometry.PrecisionRectangle;
import dwtx.draw2d.geometry.Rectangle;
import dwtx.draw2d.Locator;
import dwtx.draw2d.IFigure;
import dwtx.draw2d.PositionConstants;

/**
 * Places a handle relative to a figure's bounds. The placement is determined by
 * indicating the figure to which the placement is relative, and two floating-point value
 * indicating the horizontal and vertical offset from that figure's top-left corner.  The
 * values (0.0, 0.0) would indicate the figure's top-left corner, while the values (1.0,
 * 1.0) would indicate the figure's bottom-right corner.
 * <P>
 * Constants such as {@link PositionConstants#NORTH NORTH} and {@link
 * PositionConstants#SOUTH SOUTH} can be used to set the placement.
 */
public class RelativeLocator
    : Locator
{

private double  relativeX;
private double  relativeY;
private IFigure reference;

/**
 * Null constructor. The reference figure must be set before use.  The relative locations
 * will default to (0.0, 0.0).
 * @since 2.0
 */
public this() {
    relativeX = 0.0;
    relativeY = 0.0;
}

/**
 * Constructs a RelativeLocator with the given reference figure and relative location. The
 * location is a constant from {@link PositionConstants} used as a convenient and readable
 * way to set both the relativeX and relativeY values.
 * @param reference the reference figure
 * @param location one of NORTH, NORTH_EAST, etc.
 * @since 2.0
 */
public this(IFigure reference, int location) {
    setReferenceFigure(reference);
    switch (location & PositionConstants.NORTH_SOUTH) {
        case PositionConstants.NORTH:
            relativeY = 0; break;
        case PositionConstants.SOUTH:
            relativeY = 1.0; break;
        default:
            relativeY = 0.5;
    }

    switch (location & PositionConstants.EAST_WEST) {
        case PositionConstants.WEST:
            relativeX = 0; break;
        case PositionConstants.EAST:
            relativeX = 1.0; break;
        default:
            relativeX = 0.5;
    }
}

/**
 * Constructs a RelativeLocator with the given reference Figure and offset ratios.
 * @param reference the reference figure
 * @param relativeX the relative X offset
 * @param relativeY the relative Y offset
 * @since 2.0
 */
public this(IFigure reference, double relativeX, double relativeY) {
    setReferenceFigure(reference);
    this.relativeX = relativeX;
    this.relativeY = relativeY;
}

/**
 * Returns the Reference Box in the Reference Figure's coordinate system.
 * The returned Rectangle may be by reference, and should <b>not</b> be modified.
 * @return the reference box
 * @since 2.0
 */
protected Rectangle getReferenceBox() {
    return getReferenceFigure().getBounds();
}

/**
 * Returns the Figure this locator is relative to.
 * @return the reference figure
 * @since 2.0
 */
protected IFigure getReferenceFigure() {
    return reference;
}

/**
 * Relocates the target using the relative offset locations.
 * @see dwtx.draw2d.Locator#relocate(dwtx.draw2d.IFigure)
 */
public void relocate(IFigure target) {
    IFigure reference = getReferenceFigure();
    Rectangle targetBounds = new PrecisionRectangle(getReferenceBox().getResized(-1, -1));
    reference.translateToAbsolute(targetBounds);
    target.translateToRelative(targetBounds);
    targetBounds.resize(1, 1);

    Dimension targetSize = target.getPreferredSize();

    targetBounds.x
        += cast(int) (targetBounds.width * relativeX - ((targetSize.width + 1) / 2));
    targetBounds.y
        += cast(int) (targetBounds.height * relativeY - ((targetSize.height + 1) / 2));
    targetBounds.setSize(targetSize);
    target.setBounds(targetBounds);
}

/**
 * Sets the reference figure this locator uses to place the target figure.
 * @param reference the reference figure
 * @since 2.0
 */
public void setReferenceFigure(IFigure reference) {
    this.reference = reference;
}

}