/*******************************************************************************
 * 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 org.eclipse.draw2d.BendpointLocator;

import java.lang.all;

import org.eclipse.draw2d.geometry.Point;
import org.eclipse.draw2d.ConnectionLocator;
import org.eclipse.draw2d.Connection;

/**
 * Places a figure relative to a specified bend in a {@link Connection}. A bendpoint is
 * one of the points returned in the connection's {@link Connection#getPoints()} method.
 * It is not related to the bendpoint class used as routing constraints.
 */
public class BendpointLocator
    : ConnectionLocator
{

private int index;

/**
 * Creates a BendpointLocator associated with passed Connection c and index i.
 *
 * @param c Connection associated with BendpointLocator
 * @param i Index of bendpoint, represents the position of the bendpoint on Connection c
 * @since 2.0
 */
public this(Connection c, int i) {
    super(c);
    index = i;
}

/**
 * Returns the index of this BendpointLocator. This index is the position of the reference
 * point in this BendpointLocator's {@link Connection}.
 *
 * @return The index
 * @since 2.0
 */
protected int getIndex() {
    return index;
}

/**
 * Returns reference point associated with the BendpointLocator.  This Point is taken from
 * the BendpointLocator's connection and is point number 'index'.
 *
 * @return The reference point
 * @since 2.0
 */
protected Point getReferencePoint() {
    Point p = getConnection().getPoints().getPoint(Point.SINGLETON, getIndex());
    getConnection().translateToAbsolute(p);
    return p;
}

}