| |
 |  |  |  | Command |  | Argument |
 | Datatype |  | Default |  | Min |  | Max |  |
 |  | Format: |  | AutoMoveImage |
| Image selection, |
| SELECTION |  |
- |  | - |  | - |  |  | |  |
| | X = new top left X-coordinate of shown area in pixels
, |  | FLOAT |  | 0.0 |  | - |  | - |  |
 | |  | | | Y = new top left Y-coordinate of shown area in
pixels, |  | FLOAT |
 | 0.0 |
 | - |  | - |  |
 | |  | | | Width = new width of shown area in
pixels, |  | FLOAT |
 | original width |  | - |  | - |  |  | |
 | | | Height
= new weight of shown area in pixels, |  | FLOAT |  | original height
|  | - |  | - |  |  | |  |
| | Alpha = new alpha blending factor in percent, |  | FLOAT |  | 100.0 |  | 0.0 |  | 100.0 |
 |
 | |  | | | Steps = number of steps till new coordinates are reached,
|  | INT |  | 120 |  | - |  | - |  |
 | |  | | | Cycle = Cycle between original and new coordinates Off
| MoveBack | JumpBack, |  |
STRING |  | Off |
 | - |
 | - |  |  | |
 | | | Zoom3D
= Make 3D zooms with correct perspective (instead of linear interpolation) yes | no |
 | STRING |  | no |  | - |  | - |  |
 |  | Python: |  | AutoMoveImage(selection1,x=None,y=None,width=None,height=None,alpha=None,steps=None,cycle=None,zoom3d=None) |
 |  |  | Menu: |  | Effects > Image > Move automatically |  |
 |  | Related: |  | LoadBMP, LoadPNG
, ShowImage, AnimateImage
, SwapImage, HideImage
, DelImage, MakeImageObj
|  |  |
 | Required: |  |  |  |
 |
If the Cycle parameter is set to 'Yes', the automatic movement will cycle back and forth,
otherwise it will stop as soon as the new area is reached.
Image coordinates originate from the top left image corner (0/0), with the X-axis pointing right and the Y-axis pointing downwards.
Example 1:
AutoMoveImage 1,X=150,Y=100,Width=400,Height=300,Alpha=50,Steps=200
Zoom from the current view of image 1 to a rectangular 400x300 area at coordinates
150/100 in 200 steps. The image becomes half transparent (alpha=50).
Example 2:
AutoMoveImage 1,X=150,Y=100,Width=400,Height=300,Alpha=0,Steps=300,Zoom3D=Yes
Move from the current view of image 1 to a rectangular 400x300 area at coordinates
150/100 in 300 steps. During the movement, the image disappears (alpha=0).
|