Merge "Enforce API preconditions in Java instead of deferring to Skia." into nyc-dev

     * Given a start and stop distance, return in dst the intervening

     * segment(s). If the segment is zero-length, return false, else return

     * true. startD and stopD are pinned to legal values (0..getLength()).

     * If startD <= stopD then return false (and leave dst untouched).

     * If startD >= stopD then return false (and leave dst untouched).

     * Begin the segment with a moveTo if startWithMoveTo is true.

     *

     * <p>On {@link android.os.Build.VERSION_CODES#KITKAT} and earlier

     * such as <code>dst.rLineTo(0, 0)</code>.</p>

     */

    public boolean getSegment(float startD, float stopD, Path dst, boolean startWithMoveTo) {

        // Skia used to enforce this as part of it's API, but has since relaxed that restriction

        // so to maintain consistency in our API we enforce the preconditions here.

        float length = getLength();

        if (startD < 0) {

            startD = 0;

        }

        if (stopD > length) {

            stopD = length;

        }

        if (startD >= stopD) {

            return false;

        }

        dst.isSimplePath = false;

        return native_getSegment(native_instance, startD, stopD, dst.ni(), startWithMoveTo);

    }