ScaleImageView

Events:

• Click 'The user has tapped on the view. Use ClickImage or ClickView for the coordinates.
• LongClick 'The user has long pressed the view. Use ClickImage or ClickView for the coordinates.
• OnDraw (viewcanvas As Canvas) 'The view is being redrawn. Use viewcanvas to draw on it.

Functions:

• BringToFront
  
• DesignerCreateView (base As Panel, lw As Label, props As Map)
  
• Initialize (arg1 As String)
  
• Invalidate
  
• Invalidate2 (arg0 As android.graphics.Rect)
  
• Invalidate3 (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int)
  
• IsInitialized As Boolean
  
• Recycle
  Releases all resources the view is using and resets the state, nulling any fields that use significant memory.
  After you have called this method, the view can be re-used by setting a new image.
  Settings are remembered but state (scale and center) is forgotten.
• RemoveView
  
• RequestFocus As Boolean
  
• ResetScaleAndCenter
  Zooms the image out to minimum scale and centers it on the screen according to the view's settings.
• SendToBack
  
• SetBackgroundImage (arg0 As android.graphics.Bitmap) As BitmapDrawable
  
• SetColorAnimated (arg0 As Int, arg1 As Int, arg2 As Int)
  
• SetLayout (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int)
  
• SetLayoutAnimated (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int, arg4 As Int)
  
• SetScaleAndCenter (scale As Float, x As Float, y As Float, duration As Int)
  Set the zoom of the displayed image and center it on the point (x,y).
  x and y are width and height factor values of the full image size between 0 and 1.
  PanLimit should be set to PAN_LIMIT_CENTER if any point is to be centered.
  Duration sets the duration of the transition in milliseconds.
  Returns False if the image is not ready and the transition was not made otherwise True.
• SetScaleAndCenterPixels (scale As Float, x As Int, y As Int, duration As Int) As Boolean
  Set the zoom of the displayed image and center it on the point (x,y).
  x and y are full image size x and y pixel values.
  PanLimit should be set to PAN_LIMIT_CENTER if any point is to be centered.
  Duration sets the duration of the transition in milliseconds.
  Returns False if the image is not ready and the transition was not made otherwise True.
• SetVisibleAnimated (arg0 As Int, arg1 As Boolean)
  
• SourceXYtoViewXY (sourcex As Int, sourcey As Int) As Float()
  Returns a Float array containing the X and Y pixel position on the view of the specified point of the full size image.
  If the image coordinates are currently off screen, the view coordinates will also be outside the view
  Index 0 of the array contains the X coordinate and index 1 the Y coordinate.
• ViewXYtoSourceXY (viewx As Int, viewy As Int) As Float()
  Returns a Float array containing the X and Y pixel position on the full size image of the specified point of the view.
  Index 0 of the array contains the X coordinate and index 1 the Y coordinate.

Properties:

• Background As android.graphics.drawable.Drawable
  
• CenterX As Float [read only]
  Gets the X pixel value of the full image point which is at the centre of the view.
  Can only be set programatically by SetScaleAndCenter or SetScaleAndCenterPixels
• CenterY As Float [read only]
  Gets the Y pixel value of the full image point which is at the centre of the view.
  Can only be set programmatically by SetScaleAndCenter or SetScaleAndCenterPixels
• CircleColor As Int
  Gets or sets the colour of the inner ring of the circle.
  The default is 0xff20b2aa - LightSeaGreen.
• CircleDrawnRadius As Float [read only]
  Gets the radius of the circle in pixels as last drawn regardless of the state of EnableCircleScale.
  This can be used to position other drawn items relative to the circle.
• CircleMinimumRadius As Float
  Gets or sets the minimum radius of the circle as a factor between 0 and 1 of the width of the view.
  This prevents the circle being drawn vanishingly small when zoomed out if EnableCircleScale is True.
  The default is 0.02.
• CircleRadius As Float
  Gets or sets the radius of the circle as a factor between 0 and 1 of the width of the view or of the full image.
  If EnableCircleScale is True the factor is that of the full size image width.
  If EnableCircleScale is False the factor is that of the width of the view.
  The default is 0.002 which is appropriate if EnableCircleScale is True.
• CircleWidth As Float
  Gets or sets the width of stroke used to draw the circle (not the radius).
  The value is a factor between 0 and 1 of the radius of the circle as drawn. The default is 0.2.
• CircleX As Float
  Gets or sets the X position factor of the point on the full image at which to draw the circle.
  The default is 0.5, the centre of the image.
• CircleXPixels As Float
  Gets or sets the X position in pixels of the point on the full image at which to draw the circle.
  The default is the centre of the image.
• CircleY As Float
  Gets or sets the Y position factor of the point on the full image at which to draw the circle.
  The default is 0.5, the centre of the image.
• CircleYPixels As Float
  Gets or sets the Y position in pixels of the point on the full image at which to draw the circle.
  The default is the centre of the image.
• ClickImageX As Float [read only]
  When accessed in a Click or LongClick event gets the X pixel position on the full size image of the point clicked.
• ClickImageY As Float [read only]
  When accessed in a Click or LongClick event gets the Y pixel position on the full size image of the point clicked.
• ClickViewX As Float [read only]
  When accessed in a Click or LongClick event gets the X pixel position on the view of the point clicked.
• ClickViewY As Float [read only]
  When accessed in a Click or LongClick event gets the Y pixel position on the view of the point clicked.
• Color As Int [write only]
  
• DoubleTapZoomDuration As Int [write only]
  Sets the duration of a double tap zoom animation, in milliseconds. The default is 500ms.
• EnableCircle As Boolean
  Gets or sets whether a circle will be drawn at the image coordinates specified by CircleX and CircleY.
  The default is False.
• EnableCircleScale As Boolean
  Gets or sets whether the size of the circle will increase and decrease when the image is zoomed.
  If True the circle will resize to bound the same features on the image whatever the zoom.
  If False the circle will maintain a fixed size on the screen of the device.
  The default is True.
• Enabled As Boolean
  
• Height As Int
  
• Image As android.graphics.Bitmap [write only]
  Load an existing Bitmap into the view.
  This is unsuitable for large images because it bypasses subsampling and may cause OutOfMemoryErrors.
  This is an easy way to add pan and zoom functionality to an image already in memory.
• ImageFile As String [write only]
  Load an image from a file saved on the device file system into the view.
  This method can display JPG and PNG images of any size.
  In order to support huge images without running out of memory, a sub-sampled base layer is first loaded.
  Higher resolution tiles are loaded for the visible area as the user zooms in.
• IsReady As Boolean [read only]
  Gets whether the view is initialised, has dimensions and will display an image.
  Returns True if the view is ready to display an image and accept touch gestures.
• Left As Int
  
• MaxZoom As Float
  Gets or set the maximum permitted zoom level of the displayed image. The default is 2.0.
  The minimum zoom level is set automatically to fit the entire image to the view.
• Orientation As Int
  Gets or set the orientation of the image relative to the source file.
  Valid values for orientation are 0, 90, 180, 270 and -1 or one of the ORIENTATION values.
• ORIENTATION_0 As Int [read only]
  Display the image file in its native orientation. Value is 0.
• ORIENTATION_180 As Int [read only]
  Rotate the image 180 degrees. Value is 180.
• ORIENTATION_270 As Int [read only]
  Rotate the image 270 degrees clockwise. Value is 270.
• ORIENTATION_90 As Int [read only]
  Rotate the image 90 degrees clockwise. Value is 90.
• ORIENTATION_USE_EXIF As Int [read only]
  Attempt to use EXIF information on the image to rotate it. Value is -1.
• Padding As Int()
  
• PAN_LIMIT_CENTER As Int [read only]
  Allow the image to be panned until a corner reaches the center of the screen but no further.
  Useful when you need to pan any spot on the image to the exact center of the screen.
• PAN_LIMIT_INSIDE As Int [read only]
  Don't allow the image to be panned off screen.
  As much of the image as possible is always displayed, centered in the view when it is smaller.
• PAN_LIMIT_OUTSIDE As Int [read only]
  Allow the image to be panned until it is just off screen, but no further.
  The edge of the image will stop when it is flush with the screen edge.
• PanLimit As Int [write only]
  Sets the image pan limit to one of the PAN_LIMIT values.
  The default is 3 = PAN_LIMIT_CENTER.
• Parent As Object [read only]
  
• Scale As Float [read only]
  Get the current scale of the image as set by the user.
  Can only be set programmatically by SetScaleAndCenter or SetScaleAndCenterPixels.
• SrcHeight As Int [read only]
  Get the height of the current full size image in pixels.
  Note that this does not take the applied rotation into account.
• SrcWidth As Int [read only]
  Get the width of the current full size image in pixels.
  Note that this does not take the applied rotation into account.
• Tag As Object
  
• TileBackgroundColor As Int [write only]
  Default none. Renders a background color behind tiles. Useful when rendering a transparent PNG.
  Note: transparent PNGs require double the memory of PNGs with no alpha layer, and may cause out of memory errors.
  The default is none.
• Top As Int
  
• Visible As Boolean
  
• Width As Int