AutoMovie API
    Preparing search index...

    Function sampleAutoMovieInspectionTrails

    • Sample where every object a path pattern selects is, at each of a window's seconds, so a still can show the path it travels.

      The objects are the scene's objects of any kind, drawn or not, at the shallowest paths the pattern matches: a matched path whose parent path also matches is part of its parent's object. When several objects share a path, the first in scene order stands for it. For each second in times, seek places the subject and is awaited, so a subject that becomes ready only after an await, such as one loading a texture or a pose, is read once it is placed; then the world position of each object's origin is read, so any moving object is sampled, whatever its kind: a body's root or bone, a prop, a vehicle, a camera.

      Seconds are taken in ascending order, one seek at a time. The scene is left as the last seek placed it, so the caller seeks the second it draws again and awaits that seek before drawing. A trail whose every sample lies within a micrometre of its first is stationary.

      It rejects when times is empty or holds a second that is not finite, when the pattern matches no object, and with the seek's own rejection when a second cannot be placed.

      const trails = await sampleAutoMovieInspectionTrails({ scene, pattern: "hero/*Hand", times, seek: subject.seek });
      await subject.seek(seconds);
      inspection.update([...production.marks?.(seconds) ?? [], ...markAutoMovieInspectionTrails(trails, seconds)]);

      Parameters

      • props: {
            pattern: string;
            scene: Scene;
            seek: (seconds: number) => Promise<void>;
            times: readonly number[];
        }
        • pattern: string

          Path pattern of the objects whose trails are sampled.

        • scene: Scene

          The scene the subject is built into.

        • seek: (seconds: number) => Promise<void>

          Place the subject at a film second; resolves once the subject is ready to be read there.

        • times: readonly number[]

          The film seconds to sample.

      Returns Promise<IAutoMovieInspectionTrail[]>