Transform 1.1

From Aviberry API

Language:

English  • Русский

Contents
Still have a question?

During file conversion you can edit your video to enhance its quality or apply advanced parameters. For example, you can cut the video, change its contrast settings, add watermark etc. All the possible transformations with parameters are listed below. Transformation is set in startConversion method.

Cut

Cuts the specified part. Name of operation to use for this setting - cut. Parameters should be set as:

start_interval units, end_interval units

At least one parameter should be specified when setting. Intervals can be composite. Examples:

transform[cut] = '1000,10s' // Cuts out 9 seconds of video, starting from the 1st second of file.
transform[cut] = '1m,'      // Cuts out the fragment from 1 minute till the end of file.
transform[cut] = ',10m17s'  // Cuts out 10 minutes 17 seconds of video from the beginning of file.

Still have a question?

Split

Splits video in equal parts of same duration or same size. Name of operation to use for this setting - split. Parameters should be set as:

amount units

Both parameters are mandatory. If the splitting is set by duration, the minimum part is 1 minute ('1m' = '60s'). If by size, the minimum part is 10 Mb ('10mb' = '1024kb').

Interval or size can be composite. Examples:

transform[split] = '1m30s' // Splits video into fragments of 1m30s duration.
transform[split] = '1h'    // Splits video into fragments of 1h duration.
transform[split] = '50mb'  // Splits video into fragments of 50 Mb size.

Still have a question?

Crop

Crops the frame to indicated range. Name of operation to use for this setting - сrop. Parameters should be set as:

top, right, bottom, left

or

padding

If using the first format, at least one of the above parameters should be specified. Omitted parameters are set to default values. When using the second format, the only option is mandatory. Examples:

transform[crop] = '0.2,0.1,0.2,0.1' // Crops the frame on top and bottom by 20% and right and left by 10% of original size.
transform[crop] = ',0.1,,0.1'       // Crops the frame on the right and left by 10% of original size.
transform[crop] = '0.2,0.1,,'       // Crops the frame on top by 20% and on the right by 10% of original size.
transform[crop] = '0.1'             // Crops the frame by 10% from all sides.

Still have a question?

Rotate

Rotates the video. Name of operation to use for setting - rotate. Parameters should be set as:

mode

Example:

transform[rotate] = 'cw' // Rotates video by 90 degrees clockwise.

Still have a question?

Watermark

Applies "watermark" to video. Watermark can be image, text or both. Name of operation to use for this setting - watermark. To set the watermark, configure additionally image, text and general watermark settings.

Image settings. Name of operation property to use for this setting - image.

http|https://[user[:password]@]hostname[:port]/[path/][filename]
ftp|ftps://[user[:password]@]hostname[:port]/[path/][filename]
http://[user:password@]bucket.s3.amazonaws.com/[path/][filename]

scale, aspect

vertical, horizontal

align

Text settings. Name of operation to use for setting - text.

face, style, size, color

General parameter setting. Each general parameter is a separate operation property. General parameters are listed below.

Optional parameters may be omitted. In this case they are set to default values. Example:

transform[watermark][image][image] = 'http://example.org/watermark.png' // Sets the specified image as watermark.
transform[watermark][image][size] = '1.5,4:3' // Enlarges the picture by 50% and sets the ratio to 4:3 (1.333).
transform[watermark][image][position] = '-0.2,0.3' // Moves the image by 20% down and by 30% left.
transform[watermark][text][text] = 'My Watermark' // Sets the specified text as watermark.
transform[watermark][text][size] = '2' // Enlarges text 2 times, keeping the ratio of the text block unchanged.
transform[watermark][text][position] = 0.9,0.9 // Moves the text to the bottom right corner of the frame.
transform[watermark][text][font] = ',italic,,ff0000' // Makes font italic and sets font color to red.
transform[watermark][transparency] = '0.5' // Makes the watermark semitransparent.

Still have a question?

Video adjustment

Performs general image adjustment. Name of operation to use for this setting - adjust. Operation consists of set of suboperations, defined as separate operation properties and presented below.

Example:

transform[adjust][deinterlacing] = true // Removes interlacing.
transform[adjust][contrast] = 300    // Defines contrast.

Still have a question?

Converting to 3D

Converts any 2D video to 3D. Name of operation to use for this setting, - 3d.

Possible values are in range 0 to 100. The default value is 50.

Example:

transform[3d][Mode] = 'Anaglyph'
transform[3d][Depth] = -20
transform[3d][Shift] = 10
transform[3d][Perspective] = 40

Contents
Still have a question?

Language:

English  • Русский