Blender V5.3
DNA_tracking_types.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2011 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
10
11#pragma once
12
13#include "BLI_enum_flags.hh"
14
15#include "DNA_listBase.h"
16
17namespace blender {
18
19/* match-moving data */
20
21struct Image;
23struct MovieTracking;
27struct bGPdata;
28
35
40
49
51 TRACK_SELECT = (1 << 0),
52 TRACK_HAS_BUNDLE = (1 << 1),
56 TRACK_HIDDEN = (1 << 5),
57 TRACK_LOCKED = (1 << 6),
61 TRACK_DOPE_SEL = (1 << 10),
64};
66
75
82
87
93
101
103 /* TRACKING_USE_FALLBACK_RECONSTRUCTION = (1 << 0), */ /* DEPRECATED */
105};
107
117
126
132
137
140};
142
151
158
164
170
178
180 int framenr = 0;
181 float error = 0;
182 float mat[4][4] = {};
183};
184
187 void *intrinsics = nullptr;
188
190 char _pad[2] = {};
191
193 float sensor_width = 0;
195 float pixel_aspect = 0;
197 float focal = 0;
200 char _pad1[2] = {};
201
210 float principal_point[2] = {};
211
213 float principal_legacy[2] = {};
214
215 /* Polynomial distortion */
217 float k1 = 0, k2 = 0, k3 = 0;
218
219 /* Division distortion model coefficients */
220 float division_k1 = 0, division_k2 = 0;
221
222 /* Nuke distortion model coefficients */
223 float nuke_k1 = 0, nuke_k2 = 0;
224 float nuke_p1 = 0, nuke_p2 = 0;
225
226 /* Brown-Conrady distortion model coefficients */
228 float brown_k1 = 0, brown_k2 = 0, brown_k3 = 0, brown_k4 = 0;
230 float brown_p1 = 0, brown_p2 = 0;
231};
232
235 float pos[2] = {0.0f, 0.0f};
236
237 /* corners of pattern in the following order:
238 *
239 * Y
240 * ^
241 * | (3) --- (2)
242 * | | |
243 * | | |
244 * | | |
245 * | (0) --- (1)
246 * +-------------> X
247 *
248 * the coordinates are stored relative to pos.
249 */
250 float pattern_corners[4][2] = {};
251
252 /* positions of left-bottom and right-top corners of search area (in unified 0..1 units,
253 * relative to marker->pos)
254 */
255 float search_min[2] = {}, search_max[2] = {};
256
258 int framenr = 0;
261};
262
264 struct MovieTrackingTrack *next = nullptr, *prev = nullptr;
265
266 char name[/*MAX_NAME*/ 64] = "";
267
268 /* ** settings ** */
269
270 /* positions of left-bottom and right-top corners of pattern (in unified 0..1 units,
271 * relative to marker->pos)
272 * moved to marker's corners since planar tracking implementation
273 */
274 float pat_min_legacy[2] = {}, pat_max_legacy[2] = {};
275
276 /* positions of left-bottom and right-top corners of search area (in unified 0..1 units,
277 * relative to marker->pos)
278 * moved to marker since affine tracking implementation
279 */
280 float search_min_legacy[2] = {}, search_max_legacy[2] = {};
281
283 float offset[2] = {};
284
285 /* ** track ** */
287 int markersnr = 0;
289 int _pad = {};
292
293 /* ** reconstruction data ** */
295 float bundle_pos[3] = {};
297 float error = 0;
298
299 /* ** UI editing ** */
303 float color[3] = {};
304
305 /* ** control how tracking happens */
310 short frames_limit = 0;
312 short margin = 0;
315
316 /* tracking parameters */
324
326 struct bGPdata *gpd = nullptr;
327
328 /* Weight of this track.
329 *
330 * Weight defines how much the track affects on the final reconstruction,
331 * usually gets animated in a way so when track has just appeared its
332 * weight is zero and then it gets faded up.
333 *
334 * Used to prevent jumps of the camera when tracks are appearing or
335 * disappearing.
336 */
337 float weight = 0;
338
339 /* track weight especially for 2D stabilization */
340 float weight_stab = 0;
341};
342
344 /* Corners of the plane in the following order:
345 *
346 * Y
347 * ^
348 * | (3) --- (2)
349 * | | |
350 * | | |
351 * | | |
352 * | (0) --- (1)
353 * +-------------> X
354 *
355 * The coordinates are stored in frame normalized coordinates.
356 */
357 float corners[4][2] = {};
358
360 int framenr = 0;
363};
364
366 struct MovieTrackingPlaneTrack *next = nullptr, *prev = nullptr;
367
368 char name[/*MAX_NAME*/ 64] = "";
369
377 char _pad[4] = {};
378
382 int markersnr = 0;
383
386
388 struct Image *image = nullptr;
390 float image_opacity = 0;
391
392 /* Runtime data */
394 int last_marker = 0;
395};
396
398 /* ** default tracker settings */
401 short _pad = {};
415 short default_margin = 0;
418 short _pad1 = {};
422 float default_weight = 0;
423
426
427 /* ** common tracker settings ** */
430
431 /* ** reconstruction settings ** */
432 /* two keyframes for reconstruction initialization
433 * were moved to per-tracking object settings
434 */
437
439
440 /* Which camera intrinsics to refine. */
442
443 /* ** tool settings ** */
444
445 /* set scale */
447 float dist = 0;
448
449 /* cleanup */
451 float clean_error = 0;
452
453 /* set object scale */
456};
457
461 int tot_track = 0, act_track = 0;
464
465 /* 2d stabilization */
467 float maxscale = 0;
470
474 float target_pos[2] = {};
476 float target_rot = 0;
478 float scale = 0;
479
481 float locinf = 0, scaleinf = 0, rotinf = 0;
482
485
486 int _pad = {};
487};
488
502
504 struct MovieTrackingObject *next = nullptr, *prev = nullptr;
505
507 char name[/*MAX_NAME*/ 64] = "";
510 float scale = 0;
511
513 ListBaseT<MovieTrackingTrack> tracks = {nullptr, nullptr};
514 ListBaseT<MovieTrackingPlaneTrack> plane_tracks = {nullptr, nullptr};
515
519
522
523 /* reconstruction options */
525 int keyframe1 = 0, keyframe2 = 0;
526};
527
529 char message[256] = "";
530};
531
533 struct MovieTrackingDopesheetChannel *next = nullptr, *prev = nullptr;
534
537 char _pad[4] = {};
538
540 char name[64] = "";
541
543 int tot_segment = 0;
545 int *segments = nullptr;
550};
551
561
564 int ok = 0;
565
570
571 /* ** runtime stuff ** */
572
573 /* summary */
574 ListBaseT<MovieTrackingDopesheetCoverageSegment> coverage_segments = {nullptr, nullptr};
575
576 /* detailed */
577 ListBaseT<MovieTrackingDopesheetChannel> channels = {nullptr, nullptr};
578 int tot_channel = 0;
579
580 char _pad[4] = {};
581};
582
590 ListBaseT<MovieTrackingTrack> tracks_legacy = {nullptr, nullptr};
591 ListBaseT<MovieTrackingPlaneTrack> plane_tracks_legacy = {nullptr, nullptr};
592
596
599
604
605 ListBaseT<MovieTrackingObject> objects = {nullptr, nullptr};
607 int objectnr = 0, tot_object = 0;
608
611
614};
615
616} // namespace blender
#define ENUM_OPERATORS(_enum_type)
These structs are the foundation for all linked lists in the library system.
BMesh Iterators.
@ TRACK_ALGORITHM_FLAG_USE_NORMALIZATION
@ TRACK_ALGORITHM_FLAG_USE_MASK
@ TRACK_ALGORITHM_FLAG_USE_BRUTE
@ TRACK_MATCH_PREVIOUS_FRAME
@ TRACKING_DISTORTION_MODEL_DIVISION
@ TRACKING_DISTORTION_MODEL_POLYNOMIAL
@ TRACKING_DISTORTION_MODEL_NUKE
@ TRACKING_DISTORTION_MODEL_BROWN
TrackingSettingsReconstructionFlag
@ TRACKING_USE_KEYFRAME_SELECTION
@ TRACKING_COVERAGE_ACCEPTABLE
@ TRACKING_DOPE_SORT_AVERAGE_ERROR
@ TRACKING_STABILIZE_ROTATION
@ REFINE_TANGENTIAL_DISTORTION
@ TRACK_MOTION_MODEL_TRANSLATION_SCALE
@ TRACK_MOTION_MODEL_HOMOGRAPHY
@ TRACK_MOTION_MODEL_TRANSLATION_ROTATION_SCALE
@ TRACK_MOTION_MODEL_TRANSLATION
@ TRACK_MOTION_MODEL_AFFINE
@ TRACK_MOTION_MODEL_TRANSLATION_ROTATION
@ TRACKING_DOPE_SELECTED_ONLY
TrackingDistortionModel distortion_model
struct MovieTrackingDopesheetChannel * next
struct MovieTrackingDopesheetChannel * prev
struct MovieTrackingDopesheetCoverageSegment * prev
struct MovieTrackingDopesheetCoverageSegment * next
ListBaseT< MovieTrackingDopesheetCoverageSegment > coverage_segments
ListBaseT< MovieTrackingDopesheetChannel > channels
MovieTrackingPlaneTrack * active_plane_track
struct MovieTrackingObject * prev
MovieTrackingReconstruction reconstruction
struct MovieTrackingObject * next
ListBaseT< MovieTrackingTrack > tracks
ListBaseT< MovieTrackingPlaneTrack > plane_tracks
MovieTrackingTrack * active_track
MovieTrackingPlaneMarker * markers
struct MovieTrackingPlaneTrack * prev
struct MovieTrackingPlaneTrack * next
struct MovieReconstructedCamera * cameras
TrackingMotionModel default_motion_model
TrackingRefineCameraFlag refine_camera_intrinsics
TrackingSettingsReconstructionFlag reconstruction_flag
TrackingAlgorithmFlag default_algorithm_flag
TrackingStabilizationFilter filter
struct MovieTrackingTrack * next
struct MovieTrackingTrack * prev
MovieTrackingMarker * markers
TrackingAlgorithmFlag algorithm_flag
MovieTrackingStats * stats
MovieTrackingPlaneTrack * act_plane_track_legacy
ListBaseT< MovieTrackingPlaneTrack > plane_tracks_legacy
MovieTrackingCamera camera
MovieTrackingStabilization stabilization
ListBaseT< MovieTrackingTrack > tracks_legacy
MovieTrackingSettings settings
MovieTrackingReconstruction reconstruction_legacy
MovieTrackingTrack * act_track_legacy
ListBaseT< MovieTrackingObject > objects
MovieTrackingDopesheet dopesheet