Builder

Builder

Builder(view: View)

Construct a new builder for Magnifier objects.

build

fun build(): Magnifier

Builds a Magnifier instance based on the configuration of this Builder.

setClippingEnabled

fun setClippingEnabled(clip: Boolean): Magnifier.Builder

Defines the behavior of the magnifier when it is requested to position outside the surface of the main application window. The default value is true, which means that the position will be adjusted such that the magnifier will be fully within the bounds of the main application window, while also avoiding any overlap with system insets (such as the one corresponding to the status bar). If this flag is set to false, the area where the magnifier can be positioned will no longer be clipped, so the magnifier will be able to extend outside the main application window boundaries (and also overlap the system insets). This can be useful if you require a custom behavior, but it should be handled with care, when passing coordinates to show(float,float); note that:

• in a multiwindow context, if the magnifier crosses the boundary between the two windows, it will not be able to show over the window of the other application
• if the magnifier overlaps the status bar, there is no guarantee about which one will be displayed on top. This should be handled with care.

setCornerRadius

fun setCornerRadius(cornerRadius: Float): Magnifier.Builder

Sets the corner radius of the magnifier window, in pixels. Defaults to 2dp.

setDefaultSourceToMagnifierOffset

fun setDefaultSourceToMagnifierOffset(
    horizontalOffset: Int, 
    verticalOffset: Int
): Magnifier.Builder

Sets an offset that should be added to the content source center to obtain the position of the magnifier window, when the show(float,float) method is called. The offset is ignored when show(float,float,float,float) is used. The offset can be negative. It defaults to (0dp, 0dp).

setElevation

fun setElevation(elevation: Float): Magnifier.Builder

Sets the elevation of the magnifier window, in pixels. Defaults to 4dp.

setInitialZoom

fun setInitialZoom(zoom: Float): Magnifier.Builder

Sets the zoom to be applied to the chosen content before being copied to the magnifier. A content of size (content_width, content_height) will be magnified to (content_width * zoom, content_height * zoom), which will coincide with the size of the magnifier. A zoom of 1 will translate to no magnification (the content will be just copied to the magnifier with no scaling). The zoom defaults to 1.25. Note that the zoom can also be changed after the instance is built, using the Magnifier.setZoom(float) method.

setOverlay

fun setOverlay(overlay: Drawable?): Magnifier.Builder

Sets an overlay that will be drawn on the top of the magnifier. In general, the overlay should not be opaque, in order to let the magnified content be partially visible in the magnifier. The default overlay is null (no overlay). As an example, TextView applies a white ColorDrawable overlay with 5% alpha, aiming to make the magnifier distinguishable when shown in dark application regions. To disable the overlay, the parameter should be set to null. If not null, the overlay will be automatically redrawn when the drawable is invalidated. To achieve this, the magnifier will set a new android.graphics.drawable.Drawable.Callback for the overlay drawable, so keep in mind that any existing one set by the application will be lost.

setSize

fun setSize(
    width: Int, 
    height: Int
): Magnifier.Builder

Sets the size of the magnifier window, in pixels. Defaults to (100dp, 48dp). Note that the size of the content being magnified and copied to the magnifier will be computed as (window width / zoom, window height / zoom).

setSourceBounds

fun setSourceBounds(
    left: Int, 
    top: Int, 
    right: Int, 
    bottom: Int
): Magnifier.Builder

Defines the bounds of the rectangle where the magnifier will be able to copy its content from. The content will always be copied from the Surface of the main application window unless the magnified view is a SurfaceView, in which case its backing surface will be used. Each bound can have a different behavior, with the options being:

• SOURCE_BOUND_MAX_VISIBLE, which extends the bound as much as possible while remaining in the visible region of the magnified view, as given by android.view.View#getGlobalVisibleRect(Rect). For example, this will take into account the case when the view is contained in a scrollable container, and the magnifier will refuse to copy content outside of the visible view region
• SOURCE_BOUND_MAX_IN_SURFACE, which extends the bound as much as possible while remaining inside the surface the content is copied from.