1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
|
// envelope.h
/******************************************************************************
*
* MiXViews - an X window system based sound & data editor/processor
*
* Copyright (c) 1993, 1994 Regents of the University of California
*
* Author: Douglas Scott
* Date: December 13, 1994
*
* Permission to use, copy and modify this software and its documentation
* for research and/or educational purposes and without fee is hereby granted,
* provided that the above copyright notice appear in all copies and that
* both that copyright notice and this permission notice appear in
* supporting documentation. The author reserves the right to distribute this
* software and its documentation. The University of California and the author
* make no representations about the suitability of this software for any
* purpose, and in no event shall University of California be liable for any
* damage, loss of data, or profits resulting from its use.
* It is provided "as is" without express or implied warranty.
*
******************************************************************************/
// Envelope functions as a generic data class for editing and storage of
// contiguous binary floating point data. Envelope values are used as
// multipliers in many operations in which a time-variable value is desired.
// The added functionality beyond FrameData is: automatic interpolated lookup
// and customizable alternate range displays and labels.
// Envelope is a restricted version of Data: always type float, always one
// channel, for use as an envelope for such things as pitch, amplitude, and
// other one-dimensional arrays used by functions.
#ifndef ENVELOPE_H
#ifdef __GNUG__
#pragma interface
#endif
#define ENVELOPE_H
#include "framedata.h"
#include "range.h"
class Controller;
class Header;
class Envelope : public FrameData {
typedef FrameData Super;
enum Size { DefaultEnvelopeSize = 1024 };
public:
Envelope();
Envelope(int len);
virtual ~Envelope();
redefined Data *newData();
redefined Data *newData(int len);
redefined Data *clone(const Range &r);
redefined Data *clone(const Range &r, const Range &c);
virtual double next();
virtual void reset();
void setMappingLength(int mlength);
redefined int channels() const { return 1; }
redefined void information(Controller *);
// information methods for display objects
redefined const char* windowClassName() const;
redefined const char* channelDisplayAttribute() const;
redefined const char* horizontalScaleModeAttribute() const;
redefined const char* defaultDirAttribute() const;
void setFrameRangeLabel(const char*);
void setRangeFactor(double fac, double offset = 0);
void setChannelName(const char*);
redefined Range frameRange(RangeUnit units) const;
redefined const char* frameRangeLabel(RangeUnit units) const;
redefined const char* channelName(int chan) const;
redefined FileType fileType() const { return EVP_Data; }
redefined const char *fileSuffix() const { return ".evp"; }
redefined Header* createHeader(DataFile *, boolean reading);
protected:
redefined void readFromHeader(Header *);
redefined void checkValues();
Envelope(const Envelope *e) : FrameData(e) { init(); }
Envelope(const Envelope *e, int newlen) : FrameData(e, newlen) { init(); }
Envelope(const Envelope *e, const Range &r) : FrameData(e, r) { init(); }
Envelope(const Envelope *e, const Range &r, const Range &c)
: FrameData(e, r, c) { init(); }
private:
int mappinglength; // number of values to interp to
double currentIndex; // current location in array
int oldindex;
double increment, // these are all used for interpolated lookup
fraction,
currentVal,
nextVal;
char* frameLabel; // custom labels for visual display
char* channelLabel;
double rangeFactor, // modifiers for custom horiz range
rangeOffset;
void init();
};
inline void
Envelope::setMappingLength(int mlength) {
mappinglength = mlength;
increment = double(length()) / mappinglength;
}
inline const char*
Envelope::windowClassName() const { return "EnvelopeWindow"; }
inline const char*
Envelope::channelDisplayAttribute() const {
return "EnvelopeWindowDisplayChannels";
}
inline const char*
Envelope::horizontalScaleModeAttribute() const {
return "EnvelopeWindowHorizontalScale";
}
inline const char*
Envelope::defaultDirAttribute() const {
return "DefaultEnvelopeFileDir";
}
inline void
Envelope::setRangeFactor(double fac, double offset) {
rangeFactor = fac; rangeOffset = offset;
}
#endif
|