CollectCircles 1 - המסך, המחלקות והציור

package com.example.collectcircles;

import android.graphics.Canvas;
import android.graphics.Paint;

public class Circle {
    private float centerX;
    private float centerY;
    private final float radius;
    private final int color;

    /**
     * יוצר עיגול במיקום, בגודל ובצבע הנתונים.
     *
     * @param centerX מיקום מרכז העיגול בציר האופקי
     * @param centerY מיקום מרכז העיגול בציר האנכי
     * @param radius רדיוס העיגול
     * @param color צבע העיגול
     */
    public Circle(float centerX, float centerY, float radius, int color) {
        this.centerX = centerX;
        this.centerY = centerY;
        this.radius = radius;
        this.color = color;
    }

    /**
     * @return מיקום מרכז העיגול בציר האופקי
     */
    public float getCenterX() {
        return centerX;
    }

    /**
     * @return מיקום מרכז העיגול בציר האנכי
     */
    public float getCenterY() {
        return centerY;
    }

    /**
     * @return רדיוס העיגול
     */
    public float getRadius() {
        return radius;
    }

    /**
     * מעביר את מרכז העיגול לנקודה חדשה.
     *
     * @param centerX מיקום המרכז החדש בציר האופקי
     * @param centerY מיקום המרכז החדש בציר האנכי
     */
    public void setCenter(float centerX, float centerY) {
        this.centerX = centerX;
        this.centerY = centerY;
    }

    /**
     * מחשב את המרחק בין מרכז העיגול למרכזו של עיגול אחר.
     *
     * @param other העיגול האחר
     * @return המרחק בין מרכזי העיגולים
     */
    public double distanceTo(Circle other) {
        return distanceTo(other.centerX, other.centerY);
    }

    /**
     * מחשב את המרחק בין מרכז העיגול לנקודה נתונה.
     *
     * @param pointX מיקום הנקודה בציר האופקי
     * @param pointY מיקום הנקודה בציר האנכי
     * @return המרחק ממרכז העיגול לנקודה
     */
    public double distanceTo(float pointX, float pointY) {
        float dx = centerX - pointX;
        float dy = centerY - pointY;
        return Math.sqrt(dx * dx + dy * dy);
    }

    /**
     * בודק אם נקודה נמצאת בתוך העיגול או על היקפו.
     *
     * @param pointX מיקום הנקודה בציר האופקי
     * @param pointY מיקום הנקודה בציר האנכי
     * @return {@code true} אם הנקודה בתוך העיגול או על היקפו
     */
    public boolean contains(float pointX, float pointY) {
        return distanceTo(pointX, pointY) <= radius;
    }

    /**
     * בודק אם לעיגול ולעיגול אחר יש שטח משותף.
     *
     * @param other העיגול האחר
     * @return {@code true} אם העיגולים חופפים
     */
    public boolean overlaps(Circle other) {
        return distanceTo(other) < radius + other.radius;
    }

    /**
     * מצייר את העיגול על משטח הציור הנתון.
     *
     * @param canvas משטח הציור
     * @param paint הגדרות הצבע והסגנון שישמשו לציור
     */
    public void draw(Canvas canvas, Paint paint) {
        paint.setStyle(Paint.Style.FILL);
        paint.setColor(color);
        canvas.drawCircle(centerX, centerY, radius, paint);
    }
}

package com.example.collectcircles;

import android.graphics.Canvas;
import android.graphics.Paint;

public class Target extends Circle {
    private final int crossColor;
    private final float crossStrokeWidth;

    /**
     * יוצר מטרה עגולה שבמרכזה מצויר צלב.
     *
     * @param centerX מיקום מרכז המטרה בציר האופקי
     * @param centerY מיקום מרכז המטרה בציר האנכי
     * @param radius רדיוס המטרה
     * @param color צבע המטרה
     * @param crossColor צבע הצלב
     * @param crossStrokeWidth עובי קווי הצלב
     */
    public Target(float centerX, float centerY, float radius, int color,
                  int crossColor, float crossStrokeWidth) {
        super(centerX, centerY, radius, color);
        this.crossColor = crossColor;
        this.crossStrokeWidth = crossStrokeWidth;
    }

    /**
     * בודק אם עיגול נמצא במלואו בתוך המטרה.
     *
     * @param circle העיגול שאותו בודקים
     * @return {@code true} אם כל העיגול נמצא בתוך המטרה
     */
    public boolean fullyContains(Circle circle) {
        return distanceTo(circle) + circle.getRadius() <= getRadius();
    }

    /**
     * מצייר את גוף המטרה ואת הצלב שבמרכזה.
     *
     * @param canvas משטח הציור
     * @param paint הגדרות הצבע והסגנון שישמשו לציור
     */
    @Override
    public void draw(Canvas canvas, Paint paint) {
        super.draw(canvas, paint);

        paint.setStyle(Paint.Style.STROKE);
        paint.setStrokeWidth(crossStrokeWidth);
        paint.setColor(crossColor);

        canvas.drawLine(
                getCenterX(), getCenterY() - getRadius(),
                getCenterX(), getCenterY() + getRadius(), paint
        );
        canvas.drawLine(
                getCenterX() - getRadius(), getCenterY(),
                getCenterX() + getRadius(), getCenterY(), paint
        );
    }
}

public class GameBoardView extends View {
    private static final float TARGET_RADIUS_DP = 64f;
    private final Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG);
    private Target target;
    private Circle[] previewCircles = new Circle[0];

    /**
     * יוצר לוח משחק מתוך קוד Java.
     *
     * @param context ההקשר שבו הלוח פועל
     */
    public GameBoardView(Context context) {
        this(context, null);
    }

    /**
     * יוצר לוח משחק מתוך XML.
     *
     * @param context ההקשר שבו הלוח פועל
     * @param attrs המאפיינים שנקראו מן ה-XML
     */
    public GameBoardView(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    /**
     * יוצר לוח משחק מתוך XML עם סגנון ברירת מחדל.
     *
     * @param context ההקשר שבו הלוח פועל
     * @param attrs המאפיינים שנקראו מן ה-XML
     * @param defStyleAttr מאפיין הסגנון שיוחל כברירת מחדל
     */
    public GameBoardView(Context context, AttributeSet attrs,
                         int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        setBackgroundColor(color(R.color.board_background));
    }

    /**
     * מתאים את המטרה ואת עיגולי הדוגמה למידות החדשות של הלוח.
     *
     * @param width רוחב הלוח החדש בפיקסלים
     * @param height גובה הלוח החדש בפיקסלים
     * @param oldWidth רוחב הלוח הקודם בפיקסלים
     * @param oldHeight גובה הלוח הקודם בפיקסלים
     */
    @Override
    protected void onSizeChanged(int width, int height,
                                 int oldWidth, int oldHeight) {
        float centerX = width / 2f;
        float centerY = height / 2f;
        float targetRadius = Math.min(
                dp(64f),
                Math.min(width, height) / 5f
        );
        float circleRadius = targetRadius / 2f;

        target = new Target(
                centerX, centerY, targetRadius,
                color(R.color.target_red),
                color(R.color.target_cross),
                dp(2f)
        );

        previewCircles = new Circle[] {
                new Circle(circleRadius * 1.5f, circleRadius * 1.5f,
                        circleRadius, color(R.color.circle_green)),
                new Circle(width - circleRadius * 1.5f, circleRadius * 2.2f,
                        circleRadius, color(R.color.circle_green)),
                new Circle(circleRadius * 1.8f, height - circleRadius * 1.7f,
                        circleRadius, color(R.color.circle_green))
        };
    }

    /**
     * מצייר את המטרה ואת עיגולי הדוגמה על הלוח.
     *
     * @param canvas משטח הציור שסיפקה מערכת Android
     */
    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        if (target == null) {
            return;
        }

        target.draw(canvas, paint);
        for (Circle circle : previewCircles) {
            circle.draw(canvas, paint);
        }
    }

    /**
     * ממיר יחידות dp לפיקסלים בהתאם לצפיפות המסך.
     *
     * @param value הגודל ביחידות dp
     * @return הגודל המתאים בפיקסלים
     */
    private float dp(float value) {
        return value * getResources().getDisplayMetrics().density;
    }

    /**
     * קורא ערך צבע ממשאבי היישום.
     *
     * @param colorResource מזהה משאב הצבע
     * @return ערך הצבע שבו אפשר להשתמש לציור
     */
    private int color(int colorResource) {
        return ContextCompat.getColor(getContext(), colorResource);
    }
}