Package org.zkoss.zkmax.zul

Class Cropper

    • Constructor Detail

      • Cropper

        public Cropper()

    • Method Detail

      • getAspectRatio

        public double getAspectRatio()
        Returns the aspect ratio of the cropped area.

        Default: 0 Means the ratio has no restrict

        Returns:
        double the ratio of the cropped area

      • setAspectRatio

        public void setAspectRatio​(double aspectRatio)
        Sets the aspect ratio of the selected area.

        Default: 0. Means the ratio has no restrict

        Parameters:
        aspectRatio - the ratio of the selected area

      • getMinWidth

        public int getMinWidth()
        Returns the minimum width of the selected crop area.
        Returns:
        int as the minimum width

      • setMinWidth

        public void setMinWidth​(int minWidth)
        Sets the minimum width of the selected crop area.
        Parameters:
        minWidth - the minimum width of the selected crop area

      • getMinHeight

        public int getMinHeight()
        Returns the minimum height of the selected crop area.
        Returns:
        int as the minimum height of the selected crop area

      • setMinHeight

        public void setMinHeight​(int minHeight)
        Sets the minimum height of the selected crop area.
        Parameters:
        minHeight - the minimum height of the selected crop area

      • getMaxWidth

        public int getMaxWidth()
        Returns the maximum width of the selected crop area.
        Returns:
        int as the maximum width of the selected crop area

      • setMaxWidth

        public void setMaxWidth​(int maxWidth)
        Sets the maximum width of the selected crop area.
        Parameters:
        maxWidth - the maximum width of the selected crop area

      • getMaxHeight

        public int getMaxHeight()
        Returns the maximum height of the selected crop area.
        Returns:
        int as the maximum height of the selected crop area

      • setMaxHeight

        public void setMaxHeight​(int maxHeight)
        Sets the maximum height of the selected crop area.
        Parameters:
        maxHeight - the maximum height of the selected crop area

      • getX

        public int getX()
        Returns the left position of the crop area relates to the left edge of the child image in pixel.
        Returns:
        int as the left position.

      • setX

        public void setX​(int x)
        Sets the left position of the crop area relates to the left edge of the child image in pixel.
        Parameters:
        x - as the left related pixel

      • getY

        public int getY()
        Returns the top position of the crop area relates to the top edge of the child image in pixel.
        Returns:
        int as the top position.

      • setY

        public void setY​(int y)
        Sets the top position of the crop area relates to the top edge of the child image in pixel.
        Parameters:
        y - as the top related pixel

      • getW

        public int getW()
        Returns the width of the crop area in pixel.
        Returns:
        int as the width of the crop area.

      • setW

        public void setW​(int w)
        Sets the width of the crop area in pixel.
        Parameters:
        w - as the width of the crop area

      • getH

        public int getH()
        Returns the height of the crop area in pixel.
        Returns:
        int as the height of the crop area

      • setH

        public void setH​(int h)
        Sets the height of the crop area in pixel.
        Parameters:
        h - as the height of the crop area

      • getCroppedImage

        public AImage getCroppedImage()
        Returns the cropped image as an AImage.
        Returns:
        the AImage cropped image

      • isToolbarVisible

        public boolean isToolbarVisible()
        Returns whether the toolbar is visible.
        Returns:
        true if the toolbar is visible

      • setToolbarVisible

        public void setToolbarVisible​(boolean toolbarVisible)
        Sets the visibility of the cropper toolbar.
        Parameters:
        toolbarVisible - true or false to set the visibility of toolbar

      • getCroppedFormat

        public java.lang.String getCroppedFormat()
        Get the cropped image format, e.g., image/png, image/jpeg. If the requested type is invalid or unspecified, it will use image/png.

        Default: "image/png".

        Returns:
        cropped image format

      • setCroppedFormat

        public void setCroppedFormat​(java.lang.String croppedFormat)
        Set the cropped image format, e.g., image/png, image/jpeg. If the requested type is invalid or unspecified, it will use image/png.
        Parameters:
        croppedFormat - cropped image format

      • getSrc

        public java.lang.String getSrc()
        Returns the source URI of the image.

        Default: null.

      • getCrossOrigin

        public java.lang.String getCrossOrigin()
        Returns the crossOrigin of the img of this cropper, could be "anonymous", "use-credentials" or null.

        Default: null.

        Returns:
        the crossOrigin of the img of this cropper.

      • setCrossOrigin

        public void setCrossOrigin​(java.lang.String crossOrigin)

        Could be "anonymous" or "use-credentials", an invalid string and an empty string will be handled as the "anonymous". Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.

        Parameters:
        crossOrigin - the crossOrigin of the img of this cropper.

      • isInstant

        public boolean isInstant()
        Returns whether to send back onChange event immediately while the user is resizing the selected area.
        Returns:
        boolean

      • setInstant

        public void setInstant​(boolean instant)
        Sets whether to send back onChange event as soon as possible while the user is resizing the selected area. Default: false.
        Parameters:
        instant -

      • resize

        public void resize​(int deltaW,
                   int deltaH)
        Resize the crop area according to the delta width and height in pixel. Positive means larger, negative means smaller.
        Parameters:
        deltaW - the delta width to resize
        deltaH - the delta height to resize

      • resizeTo

        public void resizeTo​(int width,
                     int height)
        Resize the crop area to the specified width and height in pixel.
        Parameters:
        width - the width of the crop area
        height - the height of the crop area

      • move

        public void move​(int deltaX,
                 int deltaY)
        Moves the crop area according to the delta x and y. Positive for x means move right, negative means move left. Positive for y means move down, negative means move top.
        Parameters:
        deltaX - the x difference to move
        deltaY - the y difference to move

      • moveTo

        public void moveTo​(int x,
                   int y)
        Moves the crop area to the specified left and top related position.
        Parameters:
        x - the x position to move to
        y - the y position to move to

      • crop

        public void crop()
        Request cropper JavaScript widget to crop the selected area and send it back to the server. You can't call getCroppedImage() immediately in the same event listener. You need to complete the listener calling, let the response back to the browser to crop the image. It will fire an onCrop event to invoke onCrop event listener, then you can get cropped image in the onCrop listener.

      • cancel

        public void cancel()
        To cancel the selected area.