source: trunk/org/expeditee/items/Constraint.java@ 4

package org.expeditee.items;

/**
 * This class represents a constraint between two Dots on the screen. A vertical
 * constraint means the Dot's Y values will be equal, likewise a horizontal
 * constraint means the Dot's X values will be equal.
 * 
 * @author jdm18
 * 
 */
public class Constraint {
        public static final int VERTICAL = 2;

        public static final int HORIZONTAL = 3;

        // the list of points that are constrained
        private Item _start = null;

        private Item _end = null;

        // id and type info
        private int _id;

        private int _type;

        /**
         * Constructs a constraint with the two given end points, id, and type. Type
         * should be one of the constants defined in this class.
         * 
         * @param a
         *            One of the points in this constraint.
         * @param b
         *            The other point in this constraint.
         * @param id
         *            The ID of this constraint item.
         * @param type
         *            The type of this constraint (horizontal, vertical).
         */
        public Constraint(Item a, Item b, int id, int type) {
                _start = a;
                _end = b;

                a.addConstraint(this);
                b.addConstraint(this);

                _id = id;
                _type = type;
        }

        /**
         * @return The Item ID of this Constraint.
         */
        public int getID() {
                return _id;
        }

        /**
         * 
         * @return The type of this Constraint. The Type corresponds to the
         *         constants defined in this class.
         */
        public int getConstraintType() {
                return _type;
        }

        public Item getStart() {
                return _start;
        }

        public Item getEnd() {
                return _end;
        }

        public boolean contains(Item d) {
                if (_start == d || _end == d)
                        return true;

                return false;
        }

        /**
         * If there are only two points in this constraint, this method returns the
         * Point not passed to it. If there are more than two points then the first
         * encountered is returned.
         * 
         * @return A Point in the constraint that is not the one given (or null if
         *         none is found).
         */
        public Item getOppositeEnd(Item from) {
                if (from == _start)
                        return _end;

                if (from == _end)
                        return _start;

                return null;
        }

        public void replacePoint(Dot toReplace, Dot with) {
                if (_start == toReplace)
                        _start = with;

                if (_end == toReplace)
                        _end = with;
        }

        public String getLineEnds() {
                String ends = "";

                if (_start != null)
                        ends += _start.getID();

                if (_end != null)
                        ends += " " + _end.getID();

                return ends;
        }

}