a12a8a71bb
The goal is to solve confusion of the "All rights reserved" for licensing
code under an open-source license.
The phrase "All rights reserved" comes from a historical convention that
required this phrase for the copyright protection to apply. This convention
is no longer relevant.
However, even though the phrase has no meaning in establishing the copyright
it has not lost meaning in terms of licensing.
This change makes it so code under the Blender Foundation copyright does
not use "all rights reserved". This is also how the GPL license itself
states how to apply it to the source code:
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software ...
This change does not change copyright notice in cases when the copyright
is dual (BF and an author), or just an author of the code. It also does
mot change copyright which is inherited from NaN Holding BV as it needs
some further investigation about what is the proper way to handle it.
114 lines
2.9 KiB
C
114 lines
2.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
* Copyright 2008 Blender Foundation */
|
|
|
|
/** \file
|
|
* \ingroup editors
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Scene;
|
|
struct TimeMarker;
|
|
struct bAnimContext;
|
|
struct bContext;
|
|
struct wmKeyConfig;
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Drawing API
|
|
* \{ */
|
|
|
|
/* flags for drawing markers */
|
|
enum {
|
|
DRAW_MARKERS_LINES = (1 << 0),
|
|
DRAW_MARKERS_LOCAL = (1 << 1),
|
|
DRAW_MARKERS_MARGIN = (1 << 2),
|
|
};
|
|
|
|
/* Draw Scene-Markers in time window */
|
|
void ED_markers_draw(const struct bContext *C, int flag);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Backend API
|
|
* \{ */
|
|
|
|
/**
|
|
* Public API for getting markers from context.
|
|
*/
|
|
ListBase *ED_context_get_markers(const struct bContext *C);
|
|
/**
|
|
* Public API for getting markers from "animation" context.
|
|
*/
|
|
ListBase *ED_animcontext_get_markers(const struct bAnimContext *ac);
|
|
|
|
/**
|
|
* Apply some transformation to markers after the fact
|
|
*
|
|
* \param markers: List of markers to affect - this may or may not be the scene markers list,
|
|
* so don't assume anything.
|
|
* \param scene: Current scene (for getting current frame)
|
|
* \param mode: (TfmMode) transform mode that this transform is for
|
|
* \param value: From the transform code, this is `t->vec[0]`
|
|
* (which is delta transform for grab/extend, and scale factor for scale)
|
|
* \param side: (B/L/R) for 'extend' functionality, which side of current frame to use
|
|
*/
|
|
int ED_markers_post_apply_transform(
|
|
ListBase *markers, struct Scene *scene, int mode, float value, char side);
|
|
|
|
/**
|
|
* Get the marker that is closest to this point.
|
|
* XXX: for select, the min_dist should be small.
|
|
*/
|
|
struct TimeMarker *ED_markers_find_nearest_marker(ListBase *markers, float x);
|
|
/**
|
|
* Return the time of the marker that occurs on a frame closest to the given time.
|
|
*/
|
|
int ED_markers_find_nearest_marker_time(ListBase *markers, float x);
|
|
|
|
void ED_markers_get_minmax(ListBase *markers, short sel, float *first, float *last);
|
|
|
|
/**
|
|
* This function makes a list of all the markers. The only_sel
|
|
* argument is used to specify whether only the selected markers
|
|
* are added.
|
|
*/
|
|
void ED_markers_make_cfra_list(ListBase *markers, ListBase *lb, short sel);
|
|
|
|
void ED_markers_deselect_all(ListBase *markers, int action);
|
|
|
|
/**
|
|
* Get the first selected marker.
|
|
*/
|
|
struct TimeMarker *ED_markers_get_first_selected(ListBase *markers);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Operators
|
|
* \{ */
|
|
|
|
/**
|
|
* Called in screen_ops.c:ED_operatortypes_screen().
|
|
*/
|
|
void ED_operatortypes_marker(void);
|
|
/**
|
|
* Called in screen_ops.c:ED_keymap_screen().
|
|
*/
|
|
void ED_keymap_marker(struct wmKeyConfig *keyconf);
|
|
|
|
/**
|
|
* Debugging only: print debugging prints of list of markers.
|
|
*/
|
|
void debug_markers_print_list(struct ListBase *markers);
|
|
|
|
/** \} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|