kfxKUIImageReviewAndEdit Class Reference

Displays an image for review, and an optional crop rectangle/tetragon for a user to manually adjust the page boundaries. More...

#import <kfxKUIImageReviewAndEdit.h>

Inheritance diagram for kfxKUIImageReviewAndEdit:

Instance Methods
(int)	- setImage:
	Set image to review. More...
(void)	- clearImage
	Clears the image object out of review control. More...
(void)	- showCropRectangle:
	Show or hide crop rectangle (tetragon). More...
(void)	- showHighlights:
	Highlights the rectangles specified in the array. More...
(void)	- clearHighlights
	Clears all the areas highlighted by the method showHighlights. More...

Properties
< UIGestureRecognizerDelegate > kfxKEDBoundingTetragon *	cropTetragon
	The crop tetragon specified during edit operations. More...
UIColor *	cropLineColor
	Color of lines in cropping rectangle/tetragon. More...
UIColor *	cropCornerColor
	Color of corner handles (circles) in cropping rectangle/tetragon. More...
kfxUILineStyle	cropLineStyle
	Whether crop rectangle lines should be solid or dashed. More...
UIColor *	highlightColor
	Color of highlighted areas specified in showHighlights method. If nil is set or highlightColor is not set then default value of Yellow would be used. More...

Detailed Description

Displays an image for review, and an optional crop rectangle/tetragon for a user to manually adjust the page boundaries.

The Image Edit and Review Control object provides a means for the application to display an image (processed or unprocessed) for review and/or edit purposes. The actual image processing operation that “edits” the image according to the user’s preferences is performed separately by the application using the ImageProcessing object. The two main features supported in this image view control are zoom and set page boundaries. Zoom allows the user, via platform specific gestures, to magnify the image in order to see more detail. Set Page Boundaries provides a UI for setting the boundaries of a selection area (typically the page boundaries) for subsequent cropping and rectangularization by the application upon receiving the coordinates of the bounding rectangle or tetragon through an event. The application is responsible for creating and displaying any screen overlays which offer user feedback, such as “image blurry”.

Method Documentation

clearHighlights()

- (void) clearHighlights

Clears all the areas highlighted by the method showHighlights.

This method would clear all the rectangles previously highlighted by the method showHighlights

clearImage()

- (void) clearImage

Clears the image object out of review control.

setImage:()

- (int) setImage:

(kfxKEDImage *)

imageObjectToReview

Set image to review.

Use the setImage method to load the image to be reviewed. It also calculates a default crop rectangle (tetragon) based on the size and layout of the imageObjectToReview. If you want to override the default crop rectangle, change the cropTetragon property prior to calling showCropRectangle. This method will not succeed if a valid image processing license is not set.

Parameters

imageObjectToReview

This is the kfxKEDImage object to review The kfxKEDImage object must have an image represented as a bitmap, file or buffered. If none of these representations are found, then the library returns an error for nothing to display.

Returns

Status
This method returns KMC_SUCCESS if the image was accepted ok, or one of these errors:

• KMC_IP_LICENSE_INVALID (no license found)
  
• KMC_IP_NO_REPRESENTATION (No image found to display.
  
• KMC_ED_FILEPATH if the file path is nil
• KMC_ED_BITMAP_READ_FROM_FILE_FAILED if the image could not be read from the file for FILE_STORED case.
• KMC_ED_BUFFERED_READ_FAILED, if the file representaton was buffered, and the image could not be initialized from the buffer.
• KMC_ED_NOIMAGE, if the iamge representation was IMAGE_REGP_BITMAP or BOTH, and the image is nil, or the image representation is invalid.
  
  The method may also return one of these errors from the proxy call to imageReadFromFileBuffer:
  
• KMC_ED_INVALID_FOR_OBJECT_REP, if the object is already represented as both a bitmap and a buffered file.
  
• KMC_ED_NO_BUFFERED_IMAGE, if there is no buffered image to read from.
  
• KMC_ED_INVALID_ISO_DATE_TIME_FORMAT if you previously set an invalid date time string.
  
• KMC_IP_LICENSE_INVALID, if you have not set your SDK license.
  

  int setImageStatus = [ImageReview setImage:myImage];
  if (setImageStatus != KMC_SUCCESS) {
      // TODO Add your error handling logic for the error returned, no image will be displayed.
  }
  else {
      // TODO:  Add your own code to respond to dismissal of the image review control.
  }

showCropRectangle:()

- (void) showCropRectangle:

(BOOL)

shouldShow

Show or hide crop rectangle (tetragon).

Displays cropping rectangle with draggable corner indicators. Corners can be repositioned independently, creating a tetragon. Individual sides can be dragged to resize the rectangle and maintain the rectangular shape.

Parameters

shouldShow

set TRUE to show it, or FALSE to hide.

showHighlights:()

- (void) showHighlights:

(NSArray *)

rectArray

Highlights the rectangles specified in the array.

This method would highlight all the rectangles in the array with the value set for highlightColor. You need to call the setImage method before you call this method.

Parameters

rectArray

send an array of kfxKEDBoundingRectangle objects which need to be higlighted.

Property Documentation

cropCornerColor

- (UIColor*) cropCornerColor

readwritenonatomicstrong

Color of corner handles (circles) in cropping rectangle/tetragon.

cropLineColor

- (UIColor*) cropLineColor

readwritenonatomicstrong

Color of lines in cropping rectangle/tetragon.

cropLineStyle

- (kfxUILineStyle) cropLineStyle

readwritenonatomicassign

Whether crop rectangle lines should be solid or dashed.

cropTetragon

- (<UIGestureRecognizerDelegate> kfxKEDBoundingTetragon*) cropTetragon

readwritenonatomicstrong

Initial value:

{
    
    
}

+(void) initializeControl

The crop tetragon specified during edit operations.

Developer can set the tetragon coordinates to initialize the control before displaying bounding tetragon (crop rectangle), or allow the control to set it to a default. The library returns this crop tetragon while edit is in progress. After the user closes the view, this object contains the users final corner points after editing is complete.

highlightColor

- (UIColor*) highlightColor

readwritenonatomicstrong

Color of highlighted areas specified in showHighlights method. If nil is set or highlightColor is not set then default value of Yellow would be used.

---

The documentation for this class was generated from the following file:

• kfxKUIImageReviewAndEdit.h