Crop
From DVD-Slideshow
Crop is an image effect in a dvd-slideshow that crops an image.
Preview
|
|
Usage
imagefile:duration:subtitle:crop:effect-parameters
The crop effect parameters can be passed using one of the following methods:
- The size & location method: ... [ todo: insert description here ]
- The rectangle method: specifies coordinates of the top-left and bottom-right corner of a rectangle.
Size & location method
[ todo: insert description here ]
Syntax
The format for the effect parameters of this method consists of two parts the size and the location of the target image frame, these two parts are separated by a semi-colon ( ; ).
size;location
The size indicates the fraction of the final image frame, and can be specified in any of the following ways:
- n%
Set the cropped image size equal to n% of the original image size.
- imageheight
Set the cropped image size equal to original image height.
- imagewidth
Set the cropped image size equal to original image width.
Whereas the location refers to the center of this image frame, and can be specified in any of the following ways:
- x%,y%
The location in percent of the image size from the left and top of the video window.
- keyword
Either one of the keywords that are listed in the table below.
| topleft | top | topright |
| left | middle | right |
| bottomleft | bottom | bottomright |
Examples
imagefile:duration:subtitle:crop:imageheight;left imagefile:duration:subtitle:crop:50%;80%,80% imagefile:duration:subtitle:crop:50%;topleft
Rectangle method
The rectangle selection method specifies coordinates of the top-left and bottom-right corner of a rectangle.
Syntax
The format for the effect parameters of this method consists of two parts the top-left corner coordinate and the bottom-right corner coordinate of the rectangle, these two parts are separated by a semi-colon ( ; ).
top-left;bottom-right
Each individual part consists of an x and y value specified in pixels, these values are separated by a comma ( , ).
x0,y0;x1,y1
Where x0,y0 represents the top-left corner coordinate and x1,y1 the bottom-right corner coordinate of the rectangle.
Examples
imagefile:duration:subtitle:crop:0,10;100,90
In this example the top-left corner of the rectangle has the coordinate x=0 y=10, the bottom-right corner of the rectangle has the coordinate x=100 y=90.
