# ImageYHandle image

# Parameters

image = variable holding the image's file handle

# Description

It is occasionally useful to determine the location of an image's image handle. This command returns the Y coordinate. Use ImageXHandle to get the X coordinate. Please see MidHandle for more information on the image's image handle.
Note about the term 'handle'. There are two types of 'handles' we discuss in these documents. One is the location within an image - as discussed in this command. The other is a 'file handle', a variable used to hold an image, sound, or font loaded with a command. See LoadImage for more information about file handles.

# Example

; MidHandle/ImageXHandle()/ImageYHandle()/AutoMidHandle
; Initiate Graphics Mode
Graphics 640,480,16
; Set up the image file handle as a global
Global gfxBall
; Load the image - you may need to change the location of the file
gfxBall=LoadImage ("C:Program FilesBlitz Basicsamplesall.bmp")
; Until the user presses ESC key ...
While Not KeyHit(1)
Text 0,0,"Default Image Handle for gfxBall... Press ESC ..."
Text 0,14,"X handle-" + ImageXHandle(gfxBall) ; Print the location of the image handle x location
Text 0,28,"Y handle-" + ImageYHandle(gfxBall) ; Print the location of the image handle y location
DrawImage gfxBall,200,200,0 ; draw the image at 200,200
Wend
; Clear the screen
Cls
; Set the ball's handle to the center of the image
MidHandle gfxBall
; Until the user presses ESC key ... show the new information
While Not KeyHit(1)
Text 0,0,"New Image Handle for gfxBall... Press ESC ..."
Text 0,14,"X handle-" + ImageXHandle(gfxBall)
Text 0,28,"Y handle-" + ImageYHandle(gfxBall)
DrawImage gfxBall,200,200,0
Wend
; Makes all images load up with their handles in the center of the image
AutoMidHandle True
Cls
; Load the image again
gfxBall=LoadImage ("C:Program FilesBlitz Basicsamplesall.bmp")
; Until the user presses ESC key ... show the new information
While Not KeyHit(1)
Text 0,0,"Automatic image handle of gfxBall... Press ESC ..."
Text 0,14,"X handle-" + ImageXHandle(gfxBall)
Text 0,28,"Y handle-" + ImageYHandle(gfxBall)
DrawImage gfxBall,200,200,0
Wend

Index
Click here to view the latest version of this page online