2 * 11/19/04 1.0 moved to LGPL.
\r
3 * 12/12/99 Initial implementation. mdm@techie.com.
\r
4 *-----------------------------------------------------------------------
\r
5 * This program is free software; you can redistribute it and/or modify
\r
6 * it under the terms of the GNU Library General Public License as published
\r
7 * by the Free Software Foundation; either version 2 of the License, or
\r
8 * (at your option) any later version.
\r
10 * This program is distributed in the hope that it will be useful,
\r
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
13 * GNU Library General Public License for more details.
\r
15 * You should have received a copy of the GNU Library General Public
\r
16 * License along with this program; if not, write to the Free Software
\r
17 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
\r
18 *----------------------------------------------------------------------
\r
22 * A Type-safe representation of the the supported output channel constants.
\r
24 * This class is immutable and, hence, is thread safe.
\r
26 * @author Mat McGowan 12/12/99
\r
30 @METHODDEFAULT("OUT<THIS,THIS<IN,THISLOC=THIS,RETURNLOC=OUT")
\r
31 public class OutputChannels {
\r
33 * Flag to indicate output should include both channels.
\r
35 public static final int BOTH_CHANNELS = 0;
\r
38 * Flag to indicate output should include the left channel only.
\r
40 public static final int LEFT_CHANNEL = 1;
\r
43 * Flag to indicate output should include the right channel only.
\r
45 public static final int RIGHT_CHANNEL = 2;
\r
48 * Flag to indicate output is mono.
\r
50 public static final int DOWNMIX_CHANNELS = 3;
\r
52 public static final OutputChannels LEFT = new OutputChannels(LEFT_CHANNEL);
\r
53 public static final OutputChannels RIGHT = new OutputChannels(RIGHT_CHANNEL);
\r
54 public static final OutputChannels BOTH = new OutputChannels(BOTH_CHANNELS);
\r
55 public static final OutputChannels DOWNMIX = new OutputChannels(DOWNMIX_CHANNELS);
\r
58 private/* final */int outputChannels;
\r
61 * Creates an <code>OutputChannels</code> instance corresponding to the given
\r
65 * one of the OutputChannels channel code constants.
\r
67 * @throws IllegalArgumentException
\r
68 * if code is not a valid channel code.
\r
70 static public OutputChannels fromInt(int code) {
\r
78 case DOWNMIX_CHANNELS:
\r
81 throw new IllegalArgumentException("Invalid channel code: " + code);
\r
85 public OutputChannels(@LOC("IN") int channels) {
\r
86 outputChannels = channels;
\r
88 if (channels < 0 || channels > 3)
\r
89 throw new IllegalArgumentException("channels");
\r
93 * Retrieves the code representing the desired output channels. Will be one of
\r
94 * LEFT_CHANNEL, RIGHT_CHANNEL, BOTH_CHANNELS or DOWNMIX_CHANNELS.
\r
96 * @return the channel code represented by this instance.
\r
98 public int getChannelsOutputCode() {
\r
99 return outputChannels;
\r
103 * Retrieves the number of output channels represented by this channel output
\r
106 * @return The number of output channels for this channel output type. This
\r
107 * will be 2 for BOTH_CHANNELS only, and 1 for all other types.
\r
109 public int getChannelCount() {
\r
110 int count = (outputChannels == BOTH_CHANNELS) ? 2 : 1;
\r
114 public boolean equals(Object o) {
\r
115 boolean equals = false;
\r
117 if (o instanceof OutputChannels) {
\r
118 OutputChannels oc = (OutputChannels) o;
\r
119 equals = (oc.outputChannels == outputChannels);
\r
125 public int hashCode() {
\r
126 return outputChannels;
\r