Richard Antalik
7afcfe111a
This patch makes it possible to manipulate strips without need to use update functions to recalculate effect and meta strips. Prior to this change function `SEQ_time_update_sequence` had to be used to update mainly effects and meta strips. This was implemented in a way that relied on sorted list of strips, which can't always be done and in rare cases this approach failed. In case of meta strips, `seqbase` had to be passed and compared with "active" one to determine whether meta strip should be updated or not. This is especially weak system that is prone to bugs when functions are used by python API functions. Finally, other strip types had startdisp` and `enddisp` fields updated by this function and a lot of code relied on these fields even if strip start, length and offsets are available. This is completely unnecessary. Implemented changes: All effects and meta strips are updated when strip handles are moved or strip is translated, without need to call any update function. Function `SEQ_time_update_sequence` has been split to `SEQ_time_update_meta_strip_range` and `seq_time_update_effects_strip_range`. These functions should be only used within sequencer module code. Meta update is used for versioning, which is only reason for it not being declared internally. Sequence fields `startdisp` and `enddisp` are now only used for effects to store strip start and end points. These fields should be used only internally within sequencer module code. Use function `SEQ_time_*_handle_frame_get` to get strip start and end points. To update effects and meta strips with reasonable performance, cache for "parent" meta strip and attached effects is added to `SequenceLookup` cache, so it shares invalidation mechanisms. All caches are populated during single iteration. There should be no functional changes. Differential Revision: https://developer.blender.org/D14990
63 lines
2.2 KiB
C++
63 lines
2.2 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
* Copyright 2004 Blender Foundation. All rights reserved. */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup sequencer
|
|
*/
|
|
|
|
#include "DNA_scene_types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct ListBase;
|
|
struct Mask;
|
|
struct Scene;
|
|
struct SeqRenderData;
|
|
struct Sequence;
|
|
struct StripElem;
|
|
|
|
void SEQ_sequence_base_unique_name_recursive(struct Scene *scene,
|
|
struct ListBase *seqbasep,
|
|
struct Sequence *seq);
|
|
const char *SEQ_sequence_give_name(struct Sequence *seq);
|
|
struct ListBase *SEQ_get_seqbase_from_sequence(struct Sequence *seq,
|
|
struct ListBase **channels,
|
|
int *r_offset);
|
|
const struct Sequence *SEQ_get_topmost_sequence(const struct Scene *scene, int frame);
|
|
/**
|
|
* In cases where we don't know the sequence's listbase.
|
|
*/
|
|
struct ListBase *SEQ_get_seqbase_by_seq(const struct Scene *scene, struct Sequence *seq);
|
|
/**
|
|
* Only use as last resort when the StripElem is available but no the Sequence.
|
|
* (needed for RNA)
|
|
*/
|
|
struct Sequence *SEQ_sequence_from_strip_elem(struct ListBase *seqbase, struct StripElem *se);
|
|
struct Sequence *SEQ_get_sequence_by_name(struct ListBase *seqbase,
|
|
const char *name,
|
|
bool recursive);
|
|
struct Mask *SEQ_active_mask_get(struct Scene *scene);
|
|
void SEQ_alpha_mode_from_file_extension(struct Sequence *seq);
|
|
bool SEQ_sequence_has_source(const struct Sequence *seq);
|
|
void SEQ_set_scale_to_fit(const struct Sequence *seq,
|
|
int image_width,
|
|
int image_height,
|
|
int preview_width,
|
|
int preview_height,
|
|
eSeqImageFitMethod fit_method);
|
|
/**
|
|
* Ensure, that provided Sequence has unique name. If animation data exists for this Sequence, it
|
|
* will be duplicated and mapped onto new name
|
|
*
|
|
* \param seq: Sequence which name will be ensured to be unique
|
|
* \param scene: Scene in which name must be unique
|
|
*/
|
|
void SEQ_ensure_unique_name(struct Sequence *seq, struct Scene *scene);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|