File: envelope.h

package info (click to toggle)
mixviews 1.20-4
  • links: PTS
  • area: main
  • in suites: slink
  • size: 2,920 kB
  • ctags: 5,958
  • sloc: cpp: 32,873; ansic: 2,110; makefile: 411; sh: 17
file content (130 lines) | stat: -rw-r--r-- 4,524 bytes parent folder | download | duplicates (4)
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