Spotlight

Scheinwerfer

Gradle

dependencies {
    implementation ' com.github.takusemba:spotlight:x.x.x '
}

Verwendung

 val spotlight = Spotlight . Builder ( this )
    .setTargets(firstTarget, secondTarget, thirdTarget .. .)
    .setBackgroundColor( R .color.spotlightBackground)
    .setDuration( 1000L )
    .setAnimation( DecelerateInterpolator ( 2f ))
    .setContainer(viewGroup)
    .setOnSpotlightListener( object : OnSpotlightListener {
      override fun onStarted () {
        Toast .makeText( this @MainActivity, " spotlight is started " , Toast . LENGTH_SHORT ).show()
      }
      override fun onEnded () {
        Toast .makeText( this @MainActivity, " spotlight is ended " , Toast . LENGTH_SHORT ).show()
      }
    })
    .build()         

Wenn Sie Spotlight sofort anzeigen möchten, müssen Sie warten, bis die Ansichten angezeigt werden.

 // with core-ktx method.
view.doOnPreDraw { Spotlight . Builder ( this ) .. .start() }

Ziel

Erstellen Sie ein Ziel, um Spotlight hinzuzufügen.

Ziel ist ein Spot, der von Spotlight gecastet werden soll. Sie können Spotlight mehrere Ziele hinzufügen.

 val target = Target . Builder ()
    .setAnchor( 100f , 100f )
    .setShape( Circle ( 100f ))
    .setEffect( RippleEffect ( 100f , 200f , argb( 30 , 124 , 255 , 90 )))
    .setOverlay(layout)
    .setOnTargetListener( object : OnTargetListener {
      override fun onStarted () {
        makeText( this @MainActivity, " first target is started " , LENGTH_SHORT ).show()
      }
      override fun onEnded () {
        makeText( this @MainActivity, " first target is ended " , LENGTH_SHORT ).show()
      }
    })
    .build()

Start-/Ziel-Spotlight

 val spotlight = Spotlight . Builder ( this ) .. .start()

spotlight.finish()

Nächster/Vorheriger/Ziel anzeigen

 val spotlight = Spotlight . Builder ( this ) .. .start()

spotlight.next()

spotlight.previous()

spotlight.show( 2 )

Benutzerdefinierte Form

Shape definiert, wie Ihr Ziel aussehen wird. Kreis- und RoundedRectangle-Formen sind bereits implementiert. Wenn Sie jedoch eine benutzerdefinierte Form wünschen, können Sie diese durch die Implementierung Shape Schnittstelle ermitteln.

 class CustomShape (
    override val duration : Long ,
    override val interpolator : TimeInterpolator
) : Shape {

  override fun draw ( canvas : Canvas , point : PointF , value : Float , paint : Paint ) {
    // draw your shape here.
  }
}

Benutzerdefinierter Effekt

Effect können Sie Ihr Ziel dekorieren. RippleEffect- und FlickerEffect-Formen sind bereits implementiert, aber wenn Sie Ihren benutzerdefinierten Effekt wünschen, können Sie ihn durch die Implementierung Effect Schnittstelle erreichen.

 class CustomEffect (
    override val duration : Long ,
    override val interpolator : TimeInterpolator ,
    override val repeatMode : Int
) : Effect {

  override fun draw ( canvas : Canvas , point : PointF , value : Float , paint : Paint ) {
    // draw your effect here.
  }
}

Probe

Klonen Sie dieses Repo und sehen Sie sich das App-Modul an.

Autor

• Taku Semba
  • Github – (https://github.com/takusemba)
  • Twitter - (https://twitter.com/takusemba)
  • Facebook – (https://www.facebook.com/takusemba)

Lizenz

 Copyright 2017 Taku Semba.

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.