-
Notifications
You must be signed in to change notification settings - Fork 3k
/
DrawingDelegate.java
99 lines (86 loc) · 3.42 KB
/
DrawingDelegate.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
/*
* Copyright (C) 2020 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.material.progressindicator;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.graphics.Rect;
import androidx.annotation.ColorInt;
import androidx.annotation.FloatRange;
import androidx.annotation.NonNull;
/** A delegate abstract class for drawing the graphics in different drawable classes. */
abstract class DrawingDelegate<S extends BaseProgressIndicatorSpec> {
S spec;
public DrawingDelegate(S spec) {
this.spec = spec;
}
protected DrawableWithAnimatedVisibilityChange drawable;
/**
* Returns the preferred width, in pixels, of the drawable based on the drawing type. Returns a
* negative value if it depends on the {@link android.view.View}.
*/
abstract int getPreferredWidth();
/**
* Returns the preferred height, in pixels, of the drawable based on the drawing type. Returns a
* negative value if it depends on the {@link android.view.View}.
*/
abstract int getPreferredHeight();
/**
* Prepares the bound of the canvas for the actual drawing. Should be called before any drawing
* (per frame).
*
* @param canvas Canvas to draw
* @param bounds Bounds that the drawable is supposed to be drawn within
* @param trackThicknessFraction A fraction representing how much portion of the track thickness
* should be used in the drawing
*/
abstract void adjustCanvas(
@NonNull Canvas canvas,
@NonNull Rect bounds,
@FloatRange(from = 0.0, to = 1.0) float trackThicknessFraction);
/**
* Fills a part of the track with the designated indicator color. The filling part is defined with
* two fractions normalized to [0, 1] representing the start and the end of the track.
*
* @param canvas Canvas to draw.
* @param paint Paint used to draw.
* @param startFraction A fraction representing where to start the drawing along the track.
* @param endFraction A fraction representing where to end the drawing along the track.
* @param color The color used to draw the indicator.
*/
abstract void fillIndicator(
@NonNull Canvas canvas,
@NonNull Paint paint,
@FloatRange(from = 0.0, to = 1.0) float startFraction,
@FloatRange(from = 0.0, to = 1.0) float endFraction,
@ColorInt int color);
/**
* Fills the whole track with track color.
*
* @param canvas Canvas to draw.
* @param paint Paint used to draw.
*/
abstract void fillTrack(@NonNull Canvas canvas, @NonNull Paint paint);
protected void registerDrawable(@NonNull DrawableWithAnimatedVisibilityChange drawable) {
this.drawable = drawable;
}
void validateSpecAndAdjustCanvas(
@NonNull Canvas canvas,
@NonNull Rect bounds,
@FloatRange(from = 0.0, to = 1.0) float trackThicknessFraction) {
spec.validateSpec();
adjustCanvas(canvas, bounds, trackThicknessFraction);
}
}