Added new pointers

mreram · Jul 7, 2021 · 4867f21 · 4867f21
1 parent 766e115
commit 4867f21
Show file tree

Hide file tree

Showing 3 changed files with 47 additions and 11 deletions.
diff --git a/app/src/main/java/ir/smartdevelop/eram/showcaseview/MainActivity.java b/app/src/main/java/ir/smartdevelop/eram/showcaseview/MainActivity.java
@@ -3,11 +3,11 @@
 import android.os.Bundle;
 import android.support.v7.app.AppCompatActivity;
 import android.view.View;
-import android.widget.EditText;
 
 import smartdevelop.ir.eram.showcaseviewlib.GuideView;
 import smartdevelop.ir.eram.showcaseviewlib.config.DismissType;
 import smartdevelop.ir.eram.showcaseviewlib.config.Gravity;
+import smartdevelop.ir.eram.showcaseviewlib.config.PointerType;
 import smartdevelop.ir.eram.showcaseviewlib.listener.GuideListener;
 
 public class MainActivity extends AppCompatActivity {
@@ -38,6 +38,7 @@ protected void onCreate(Bundle savedInstanceState) {
                 .setContentText("Guide Description Text\n .....Guide Description Text\n .....Guide Description Text .....")
                 .setGravity(Gravity.center)
                 .setDismissType(DismissType.anywhere)
+                .setPointerType(PointerType.arrow)
                 .setTargetView(view1)
                 .setGuideListener(new GuideListener() {
                     @Override

diff --git a/showcaseviewlib/src/main/java/smartdevelop/ir/eram/showcaseviewlib/GuideView.java b/showcaseviewlib/src/main/java/smartdevelop/ir/eram/showcaseviewlib/GuideView.java
@@ -10,6 +10,7 @@
 import android.graphics.Canvas;
 import android.graphics.Color;
 import android.graphics.Paint;
+import android.graphics.Path;
 import android.graphics.Point;
 import android.graphics.PorterDuff;
 import android.graphics.PorterDuffXfermode;
@@ -28,6 +29,7 @@
 
 import smartdevelop.ir.eram.showcaseviewlib.config.DismissType;
 import smartdevelop.ir.eram.showcaseviewlib.config.Gravity;
+import smartdevelop.ir.eram.showcaseviewlib.config.PointerType;
 import smartdevelop.ir.eram.showcaseviewlib.listener.GuideListener;
 
 /**
@@ -84,6 +86,7 @@ public class GuideView extends FrameLayout {
     private GuideListener mGuideListener;
     private Gravity mGravity;
     private DismissType dismissType;
+    private PointerType pointerType;
     private final GuideMessageView mMessageView;
 
     private GuideView(Context context, View view) {
@@ -271,17 +274,33 @@ protected void onDraw(final Canvas canvas) {
             paintCircleInner.setAntiAlias(true);
 
             final float x = (targetRect.left / 2 + targetRect.right / 2);
-            canvas.drawLine(
-                x,
-                startYLineAndCircle,
-                x,
-                stopY,
-                paintLine
-            );
-
-            canvas.drawCircle(x, startYLineAndCircle, circleIndicatorSize, paintCircle);
-            canvas.drawCircle(x, startYLineAndCircle, circleInnerIndicatorSize, paintCircleInner);
 
+            switch (pointerType) {
+                case circle:
+                    canvas.drawLine(x,startYLineAndCircle,x,stopY,paintLine);
+                    canvas.drawCircle(x, startYLineAndCircle, circleIndicatorSize, paintCircle);
+                    canvas.drawCircle(x, startYLineAndCircle, circleInnerIndicatorSize, paintCircleInner);
+                    break;
+                case arrow:
+                    canvas.drawLine(x,startYLineAndCircle,x,stopY,paintLine);
+                    Path path = new Path();
+                    if (isTop) {
+                        path.moveTo(x, startYLineAndCircle - (circleIndicatorSize * 2));
+                        path.lineTo(x + circleIndicatorSize, startYLineAndCircle);
+                        path.lineTo(x - circleIndicatorSize, startYLineAndCircle);
+                        path.close();
+                    } else {
+                        path.moveTo(x, startYLineAndCircle + (circleIndicatorSize * 2));
+                        path.lineTo(x + circleIndicatorSize, startYLineAndCircle);
+                        path.lineTo(x - circleIndicatorSize, startYLineAndCircle);
+                        path.close();
+                    }
+                    canvas.drawPath(path, paintCircle);
+                    break;
+                case none:
+                    //draw no line and no pointer
+                    break;
+            }
             targetPaint.setXfermode(X_FER_MODE_CLEAR);
             targetPaint.setAntiAlias(true);
 
@@ -455,6 +474,7 @@ public static class Builder {
         private String title, contentText;
         private Gravity gravity;
         private DismissType dismissType;
+        private PointerType pointerType;
         private final Context context;
         private Spannable contentSpan;
         private Typeface titleTypeFace, contentTypeFace;
@@ -628,10 +648,20 @@ public Builder setCircleStrokeIndicatorSize(float size) {
             return this;
         }
 
+        /**
+         * this method defining the type of pointer
+         *
+         * @param pointerType should be one type of PointerType enum. for example: arrow -> To show arrow pointing to target view
+         */
+        public Builder setPointerType(PointerType pointerType) {
+            this.pointerType = pointerType;
+            return this;
+        }
         public GuideView build() {
             GuideView guideView = new GuideView(context, targetView);
             guideView.mGravity = gravity != null ? gravity : Gravity.auto;
             guideView.dismissType = dismissType != null ? dismissType : DismissType.targetView;
+            guideView.pointerType = pointerType != null ? pointerType : PointerType.circle;
             float density = context.getResources().getDisplayMetrics().density;
 
             guideView.setTitle(title);

diff --git a/showcaseviewlib/src/main/java/smartdevelop/ir/eram/showcaseviewlib/config/PointerType.java b/showcaseviewlib/src/main/java/smartdevelop/ir/eram/showcaseviewlib/config/PointerType.java
@@ -0,0 +1,5 @@
+package smartdevelop.ir.eram.showcaseviewlib.config;
+
+public enum PointerType {
+    circle, arrow, none
+}