Patch implements better way to control playback speed than it is possible to do with speed effect. Speed factor property can be set in Time panel. There are 2 layers of control: Option to retime movie to match scene FPS rate. Custom speed factor to control playback rate. Since playback rate is strip property, it is now possible to manipulate strip as normal one even if it is retimed. To facilitate manipulation, some functions need to consider speed factor and apply necessary corrections to strip offset or strip start. These corrections may need to be float numbers, so start and offsets must be float as well. Sound strips now use speed factor instead of pitch. This means, that strips will change length to match usable length. In addition, it is possible to group movie and sound strip and change speed of meta strip.
143 lines
5.9 KiB
C++
143 lines
5.9 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
* Copyright 2004 Blender Foundation. All rights reserved. */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup sequencer
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Editing;
|
|
struct ListBase;
|
|
struct Scene;
|
|
struct SeqCollection;
|
|
struct Sequence;
|
|
|
|
bool SEQ_transform_sequence_can_be_translated(struct Sequence *seq);
|
|
/**
|
|
* Used so we can do a quick check for single image seq
|
|
* since they work a bit differently to normal image seq's (during transform).
|
|
*/
|
|
bool SEQ_transform_single_image_check(struct Sequence *seq);
|
|
void SEQ_transform_fix_single_image_seq_offsets(const struct Scene *scene, struct Sequence *seq);
|
|
bool SEQ_transform_test_overlap(const struct Scene *scene,
|
|
struct ListBase *seqbasep,
|
|
struct Sequence *test);
|
|
bool SEQ_transform_test_overlap_seq_seq(const struct Scene *scene,
|
|
struct Sequence *seq1,
|
|
struct Sequence *seq2);
|
|
void SEQ_transform_translate_sequence(struct Scene *scene, struct Sequence *seq, int delta);
|
|
/**
|
|
* \return 0 if there weren't enough space.
|
|
*/
|
|
bool SEQ_transform_seqbase_shuffle_ex(struct ListBase *seqbasep,
|
|
struct Sequence *test,
|
|
struct Scene *evil_scene,
|
|
int channel_delta);
|
|
bool SEQ_transform_seqbase_shuffle(struct ListBase *seqbasep,
|
|
struct Sequence *test,
|
|
struct Scene *evil_scene);
|
|
bool SEQ_transform_seqbase_shuffle_time(struct SeqCollection *strips_to_shuffle,
|
|
struct SeqCollection *time_dependent_strips,
|
|
struct ListBase *seqbasep,
|
|
struct Scene *evil_scene,
|
|
struct ListBase *markers,
|
|
bool use_sync_markers);
|
|
|
|
void SEQ_transform_handle_overlap(struct Scene *scene,
|
|
struct ListBase *seqbasep,
|
|
struct SeqCollection *transformed_strips,
|
|
struct SeqCollection *time_dependent_strips,
|
|
bool use_sync_markers);
|
|
/**
|
|
* Check if the selected seq's reference unselected seq's.
|
|
*/
|
|
bool SEQ_transform_seqbase_isolated_sel_check(struct ListBase *seqbase);
|
|
/**
|
|
* Move strips and markers (if not locked) that start after timeline_frame by delta frames
|
|
*
|
|
* \param scene: Scene in which strips are located
|
|
* \param seqbase: ListBase in which strips are located
|
|
* \param delta: offset in frames to be applied
|
|
* \param timeline_frame: frame on timeline from where strips are moved
|
|
*/
|
|
void SEQ_transform_offset_after_frame(struct Scene *scene,
|
|
struct ListBase *seqbase,
|
|
int delta,
|
|
int timeline_frame);
|
|
|
|
/**
|
|
* Check if `seq` can be moved.
|
|
* This function also checks `SeqTimelineChannel` flag.
|
|
*/
|
|
bool SEQ_transform_is_locked(struct ListBase *channels, struct Sequence *seq);
|
|
|
|
/* Image transformation. */
|
|
|
|
void SEQ_image_transform_mirror_factor_get(const struct Sequence *seq, float r_mirror[2]);
|
|
/**
|
|
* Get strip transform origin offset from image center
|
|
* NOTE: This function does not apply axis mirror.
|
|
*
|
|
* \param scene: Scene in which strips are located
|
|
* \param seq: Sequence to calculate image transform origin
|
|
* \param r_origin: return value
|
|
*/
|
|
void SEQ_image_transform_origin_offset_pixelspace_get(const struct Scene *scene,
|
|
const struct Sequence *seq,
|
|
float r_origin[2]);
|
|
/**
|
|
* Get 4 corner points of strip image, optionally without rotation component applied.
|
|
* Corner vectors are in viewport space.
|
|
*
|
|
* \param scene: Scene in which strips are located
|
|
* \param seq: Sequence to calculate transformed image quad
|
|
* \param apply_rotation: Apply sequence rotation transform to the quad
|
|
* \param r_quad: array of 4 2D vectors
|
|
*/
|
|
void SEQ_image_transform_quad_get(const struct Scene *scene,
|
|
const struct Sequence *seq,
|
|
bool apply_rotation,
|
|
float r_quad[4][2]);
|
|
/**
|
|
* Get 4 corner points of strip image. Corner vectors are in viewport space.
|
|
*
|
|
* \param scene: Scene in which strips are located
|
|
* \param seq: Sequence to calculate transformed image quad
|
|
* \param r_quad: array of 4 2D vectors
|
|
*/
|
|
void SEQ_image_transform_final_quad_get(const struct Scene *scene,
|
|
const struct Sequence *seq,
|
|
float r_quad[4][2]);
|
|
|
|
void SEQ_image_preview_unit_to_px(const struct Scene *scene,
|
|
const float co_src[2],
|
|
float co_dst[2]);
|
|
void SEQ_image_preview_unit_from_px(const struct Scene *scene,
|
|
const float co_src[2],
|
|
float co_dst[2]);
|
|
|
|
/**
|
|
* Get viewport axis aligned bounding box from a collection of sequences.
|
|
* The collection must have one or more strips
|
|
*
|
|
* \param scene: Scene in which strips are located
|
|
* \param strips: Collection of strips to get the bounding box from
|
|
* \param apply_rotation: Include sequence rotation transform in the bounding box calculation
|
|
* \param r_min: Minimum x and y values
|
|
* \param r_max: Maximum x and y values
|
|
*/
|
|
void SEQ_image_transform_bounding_box_from_collection(struct Scene *scene,
|
|
struct SeqCollection *strips,
|
|
bool apply_rotation,
|
|
float r_min[2],
|
|
float r_max[2]);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|