Crop

From DVD-Slideshow
Jump to: navigation, search

Crop is an image effect in a dvd-slideshow that crops an image.


Preview

Before

Crop 100.jpg

Original image

After

Crop 50.jpg

50% cropped image


Usage

imagefile:duration:subtitle:crop:effect-parameters

The crop effect parameters can be passed using one of the following methods:


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.