CL/CL_Align.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Mark Alexander
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        CL_Align.h ( Clip Library, C++)
 *
 * COMMENTS:
 *
 *      Aligns a collection.
 */

#ifndef __CL_Align__
#define __CL_Align__

#include "CL_API.h"
#include "CL_Clip.h"

enum CL_Alignment { NO_ALIGN =0,
                    STRETCH_TO_FILL,
                    ALIGN_TO_START,
                    ALIGN_TO_END,
                    SHIFT_TO_FIRST,
                    TRUNC_TO_FIRST,
                    STRETCH_TO_FIRST,
                    TRUNC_TO_MIN,
                    SQUASH_TO_MIN     };

class CL_API CL_Align
{
public:

                        CL_Align();
                        ~CL_Align();


    int                 getAlignment(CL_TrackListC &toAlign, 
                                     CL_Alignment align,
                                     float &start, float &end);

    // Sets the start, length and rate on the 'dest' clip, adds all the tracks
    // in toAlign and aligns them.
    int                 align(CL_TrackListC &toAlign,CL_Clip *dest,
                              CL_Alignment align, float rate,
                              float *fstart = 0, float *fend = 0);

    // This version sets the start, length and rate on the clip, but does not
    // add tracks.
    int                 alignOnly(CL_TrackListC &toAlign, CL_Clip *dest,
                                  CL_Alignment align, float rate);
    
    // after a call to getAlignment this method will return 1 if
    // aligning will produce new data, zero otherwise.

    int                 needsAlignment(float rate);

    // this version returns the aligned data of
    // track "source" in the array "data". Used for extracting data one
    // track at a time. Always call getAlignment() first.
    
    int                 align(const CL_Track *source,
                              CL_Alignment align,
                              float *dest, float rate);

    // this version of align does the same as above, but for a short
    // segment, rather than the full interval. segstart and segend are
    // in seconds, and are "post-alignment" times
    int                 align(const CL_Track *source,
                              CL_Alignment align,
                              float *dest, float rate,
                              float segstart, float segend);

    // align() or getAlignment must be called first. This returns the number
    // of samples that the alignment, sample rate and sources would produce.
    int                 getNumSamples() const { return myNumSamples; }
private:

    float               findEarliestStart() const;
    float               findLatestEnd() const;
    float               findLatestStart() const;
    float               findEarliestEnd() const;
    
    const CL_Clip       *findLongestClip(float *cliplen=0) const;
    const CL_Clip       *findShortestClip(float *cliplen=0) const;

    void                alignNone(CL_Clip *dest,float start,float end);
    
    void                alignStart(CL_Clip *dest,float length);
    void                alignEnd(CL_Clip *dest,float length);
    
    void                alignStretch(CL_Clip *dest);


    CL_TrackListC      *myTracks;
    int                 myNumSamples;
    float               myStart;
    float               myEnd;
};

#endif

---