tencent cloud

All product documents
User Generated Short Video SDK
DocumentationUser Generated Short Video SDKIntegration (No UI)Advanced Features and Special EffectsImage Transition Special EffectsiOS
iOS
Download PDF
Last updated: 2025-04-01 17:14:09
iOS
Last updated: 2025-04-01 17:14:09
Download PDF
The image editing feature is added starting from SDK 4.7. You can select a desired image to add effects such as transition animation, background music, and stickers.The API functions are as follows:
/*
 *pitureList: list of transition images, which must contain at least three images (note: we recommend you compress the images to 720p or lower (as shown in the demo); otherwise, the memory usage may be too high, causing editing exceptions).
 *fps: frame rate of the video generated from the transition images in fps. Value range: 15–30.
 * Returned values:
 *       0: set successfully
 *      -1: failed to set. Please check whether the image list exists, the number of images is greater than or equal to 3, and the frame rate (`fps`) is normal
 */
- (int)setPictureList:(NSArray<UIImage *> *)pitureList fps:(int)fps;

/*
 *transitionType: transition type. For more information, please see `TXTransitionType`
 * Returned values:
 *       duration: transition video duration (note: the duration for the same image list may vary by transition animation. You can get the transition image duration here)
 */
- (void)setPictureTransition:(TXTransitionType)transitionType duration:(void(^)(CGFloat))duration;


typedef NS_ENUM(NSInteger, TXTransitionType) {
    TXTransitionType_LefRightSlipping,
    TXTransitionType_UpDownSlipping,
    TXTransitionType_Enlarge,
    TXTransitionType_Narrow,
    TXTransitionType_RotationalScaling,
    TXTransitionType_FadeinFadeout,
};
The setPictureList API is used to set the image list, which must contain at least three images. If too many images are set, the image size should be appropriate to avoid editing exceptions due to high memory usage.
The setPictureTransition API is used to set the transition effect. Currently, six effects are available, and their durations may vary. You can get the transition duration through duration here.
Pay attention to the API call sequence: call setPictureList first and then call setPictureTransition.
Image editing currently does not support loop, reverse, fast/slow motions, and post-roll watermarking, but supports other video editing features. The call method is the same as that of video editing.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon