view/std/StdUtils.java

/*
 *   JSampler - a java front-end for LinuxSampler
 *
 *   Copyright (C) 2005-2007 Grigor Iliev <grigor@grigoriliev.com>
 *
 *   This file is part of JSampler.
 *
 *   JSampler is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License version 2
 *   as published by the Free Software Foundation.
 *
 *   JSampler is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with JSampler; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *   MA  02111-1307  USA
 */
package org.jsampler.view.std;

import java.awt.Desktop;
import java.awt.Rectangle;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;

import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;

import java.net.URI;

import java.text.NumberFormat;

import java.util.Vector;
import java.util.logging.Level;

import javax.swing.JComboBox;
import javax.swing.JSlider;
import javax.swing.JToolTip;
import javax.swing.Popup;
import javax.swing.PopupFactory;

import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
import org.jsampler.CC;
import org.jsampler.HF;
import org.jsampler.JSPrefs;

import static org.jsampler.view.std.StdI18n.i18n;
import static org.jsampler.view.std.StdPrefs.*;


/**
 *
 * @author Grigor Iliev
 */
public class StdUtils {
        
        /** Forbids the instantiation of this class */
        private
        StdUtils() { }
        
        private static JSPrefs
        preferences() { return CC.getViewConfig().preferences(); }
        
        public static JComboBox
        createPathComboBox() {
                final JComboBox cb = new JComboBox();
                cb.setEditable(true);
                cb.addActionListener(new ActionListener() {
                        public void
                        actionPerformed(ActionEvent e) {
                                if(cb.getSelectedItem() == null) {
                                        cb.setToolTipText(null);
                                        return;
                                }
                                String s = cb.getSelectedItem().toString();
                                if(s.length() < 15) cb.setToolTipText(null);
                                else cb.setToolTipText(s);
                        }
                });
                
                return cb;
        }
        
        /**
         * Updates the specified string list property by adding the specified
         * element on the top. Also restricts the maximum number of elements to 12.
         */
        public static void
        updateRecentElements(String property, String newElement) {
                String[] elements = preferences().getStringListProperty(property);
                Vector<String> v = new Vector<String>();
                v.add(newElement);
                for(String s : elements) {
                        if(!newElement.equals(s)) v.add(s);
                }
                if(v.size() > 12) v.setSize(12);
                
                elements = v.toArray(new String[v.size()]);
                preferences().setStringListProperty(property, elements);
        }
        
        public static boolean
        checkDesktopSupported() {
                if(Desktop.isDesktopSupported()) return true;
                
                String s = i18n.getError("StdUtils.DesktopApiNotSupported");
                HF.showErrorMessage(s, CC.getMainFrame());
                
                return false;
        }
        
        public static void
        browse(String uri) {
                if(!checkDesktopSupported()) return;
                
                try { Desktop.getDesktop().browse(new URI(uri)); }
                catch(Exception x) { x.printStackTrace(); }
        }
        
        public static void
        mail(String uri) {
                if(!StdUtils.checkDesktopSupported()) return;
                
                Desktop desktop = Desktop.getDesktop();
                
                try { Desktop.getDesktop().mail(new URI(uri)); }
                catch(Exception x) { x.printStackTrace(); }
        }
        
        /**
         * Gets the windows bounds from the preferences for the specified window.
         * @return The windows bounds saved in the preferences for the specified window
         * or <code>null</code>.
         */
        public static Rectangle
        getWindowBounds(String windowName) {
                String s = windowName + ".windowSizeAndLocation";
                s = CC.preferences().getStringProperty(s, null);
                if(s == null) return null;
                
                try {
                        int i = s.indexOf(',');
                        int x = Integer.parseInt(s.substring(0, i));
                        
                        s = s.substring(i + 1);
                        i = s.indexOf(',');
                        int y = Integer.parseInt(s.substring(0, i));
                        
                        s = s.substring(i + 1);
                        i = s.indexOf(',');
                        int width = Integer.parseInt(s.substring(0, i));
                        
                        s = s.substring(i + 1);
                        int height = Integer.parseInt(s);
                        
                        return new Rectangle(x, y, width, height);
                } catch(Exception x) {
                        String msg = windowName;
                        msg += ": Parsing of window size and location string failed";
                        CC.getLogger().log(Level.INFO, msg, x);
                        return null;
                }
        }
        
        /**
         * Saves the windows bounds in the preferences for the specified window.
         */
        public static void
        saveWindowBounds(String windowName, Rectangle r) {
                if(r.width < 50 || r.height < 50 || r.x < r.width * -1 || r.y < 0) {
                        CC.getLogger().warning("Invalid window size or location");
                        return;
                }

                StringBuffer sb = new StringBuffer();
                sb.append(r.x).append(',').append(r.y).append(',');
                sb.append(r.width).append(',').append(r.height);
                String s = windowName + ".windowSizeAndLocation";
                CC.preferences().setStringProperty(s, sb.toString());
        }
        
        public static JSlider
        createVolumeSlider() {
                return new VolumeSlider();
        }
        
        private static class VolumeSlider extends JSlider {
                private Popup popup = null;
                private final JToolTip tip = new JToolTip();
                private static NumberFormat numberFormat = NumberFormat.getInstance();
                
                VolumeSlider() {
                        super(0, 100, 100);
                        numberFormat.setMaximumFractionDigits(1);
                        // Setting the tooltip size (workaround for preserving that size)
                        boolean b = CC.getViewConfig().isMeasurementUnitDecibel();
                        if(b) tip.setTipText(i18n.getLabel("StdUtils.volumeDecibels", "-30.0"));
                        else tip.setTipText(i18n.getLabel("StdUtils.volume", "100"));
                        tip.setPreferredSize(tip.getPreferredSize());
                        tip.setMinimumSize(tip.getPreferredSize());
                        ///////
                        tip.setComponent(this);
                        tip.setTipText(i18n.getLabel("StdUtils.volume", 0));
                        
                        updateVolumeInfo();
                        
                        addMouseListener(new MouseAdapter() {
                                public void
                                mousePressed(MouseEvent e) {
                                        if(popup != null) {
                                                popup.hide();
                                                popup = null;
                                        }
                                        
                                        if(!VolumeSlider.this.isEnabled()) return;
                                        
                                        java.awt.Point p = VolumeSlider.this.getLocationOnScreen();
                                        PopupFactory pf = PopupFactory.getSharedInstance();
                                        popup = pf.getPopup(VolumeSlider.this, tip, p.x, p.y - 22);
                                        popup.show();
                                }
                                
                                public void
                                mouseReleased(MouseEvent e) {
                                        if(popup != null) {
                                                popup.hide();
                                                popup = null;
                                        }
                                }
                        });
                        
                        addChangeListener(new ChangeListener() {
                                public void
                                stateChanged(ChangeEvent e) { updateVolumeInfo(); }
                        });
                        
                        String s = VOL_MEASUREMENT_UNIT_DECIBEL;
                        preferences().addPropertyChangeListener(s, new PropertyChangeListener() {
                                public void
                                propertyChange(PropertyChangeEvent e) {
                                        // We use this to set the size of the lVolume
                                        // to prevent the frequent resizing of lVolume component
                                        boolean b = CC.getViewConfig().isMeasurementUnitDecibel();
                                        tip.setPreferredSize(null);
                                        String s;
                                        if(b) s = i18n.getLabel("StdUtils.volumeDecibels", "-30.0");
                                        else s = i18n.getLabel("StdUtils.volume", "100");
                                        tip.setTipText(s);
                                        tip.setPreferredSize(tip.getPreferredSize());
                                        tip.setMinimumSize(tip.getPreferredSize());
                                        ///////
                                        updateVolumeInfo();
                                }
                        });
                }
                
                private void
                updateVolumeInfo() {
                        String s;
                        if(CC.getViewConfig().isMeasurementUnitDecibel()) {
                                double d = HF.percentsToDecibels(getValue());
                                s = i18n.getLabel("StdUtils.volumeDecibels", numberFormat.format(d));
                        } else {
                                s = i18n.getLabel("StdUtils.volume", getValue());
                        }
                        
                        setToolTipText(s);
                        tip.setTipText(s);
                        tip.repaint();
                }
        }
}
1	iliev	1308	/*
2			* JSampler - a java front-end for LinuxSampler
3			*
4			* Copyright (C) 2005-2007 Grigor Iliev <grigor@grigoriliev.com>
5			*
6			* This file is part of JSampler.
7			*
8			* JSampler is free software; you can redistribute it and/or modify
9			* it under the terms of the GNU General Public License version 2
10			* as published by the Free Software Foundation.
11			*
12			* JSampler is distributed in the hope that it will be useful,
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15			* GNU General Public License for more details.
16			*
17			* You should have received a copy of the GNU General Public License
18			* along with JSampler; if not, write to the Free Software
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
20			* MA 02111-1307 USA
21			*/
22			package org.jsampler.view.std;
23
24	iliev	1496	import java.awt.Desktop;
25	iliev	1786	import java.awt.Rectangle;
26	iliev	1496
27	iliev	1540	import java.awt.event.ActionEvent;
28			import java.awt.event.ActionListener;
29			import java.awt.event.MouseAdapter;
30			import java.awt.event.MouseEvent;
31
32			import java.beans.PropertyChangeEvent;
33			import java.beans.PropertyChangeListener;
34
35	iliev	1496	import java.net.URI;
36
37	iliev	1540	import java.text.NumberFormat;
38
39	iliev	1308	import java.util.Vector;
40	iliev	1786	import java.util.logging.Level;
41	iliev	1308
42	iliev	1540	import javax.swing.JComboBox;
43			import javax.swing.JSlider;
44			import javax.swing.JToolTip;
45			import javax.swing.Popup;
46			import javax.swing.PopupFactory;
47
48			import javax.swing.event.ChangeEvent;
49			import javax.swing.event.ChangeListener;
50	iliev	1308	import org.jsampler.CC;
51	iliev	1496	import org.jsampler.HF;
52	iliev	1308	import org.jsampler.JSPrefs;
53
54	iliev	1496	import static org.jsampler.view.std.StdI18n.i18n;
55	iliev	1540	import static org.jsampler.view.std.StdPrefs.*;
56	iliev	1308
57	iliev	1496
58	iliev	1308	/**
59			*
60			* @author Grigor Iliev
61			*/
62			public class StdUtils {
63
64			/** Forbids the instantiation of this class */
65			private
66			StdUtils() { }
67
68			private static JSPrefs
69			preferences() { return CC.getViewConfig().preferences(); }
70
71	iliev	1540	public static JComboBox
72			createPathComboBox() {
73			final JComboBox cb = new JComboBox();
74			cb.setEditable(true);
75			cb.addActionListener(new ActionListener() {
76			public void
77			actionPerformed(ActionEvent e) {
78			if(cb.getSelectedItem() == null) {
79			cb.setToolTipText(null);
80			return;
81			}
82			String s = cb.getSelectedItem().toString();
83			if(s.length() < 15) cb.setToolTipText(null);
84			else cb.setToolTipText(s);
85			}
86			});
87
88			return cb;
89			}
90
91	iliev	1308	/**
92			* Updates the specified string list property by adding the specified
93			* element on the top. Also restricts the maximum number of elements to 12.
94			*/
95			public static void
96			updateRecentElements(String property, String newElement) {
97			String[] elements = preferences().getStringListProperty(property);
98			Vector<String> v = new Vector<String>();
99			v.add(newElement);
100			for(String s : elements) {
101			if(!newElement.equals(s)) v.add(s);
102			}
103			if(v.size() > 12) v.setSize(12);
104
105			elements = v.toArray(new String[v.size()]);
106			preferences().setStringListProperty(property, elements);
107			}
108	iliev	1496
109			public static boolean
110			checkDesktopSupported() {
111			if(Desktop.isDesktopSupported()) return true;
112
113			String s = i18n.getError("StdUtils.DesktopApiNotSupported");
114			HF.showErrorMessage(s, CC.getMainFrame());
115
116			return false;
117			}
118
119			public static void
120			browse(String uri) {
121			if(!checkDesktopSupported()) return;
122
123			try { Desktop.getDesktop().browse(new URI(uri)); }
124			catch(Exception x) { x.printStackTrace(); }
125			}
126
127			public static void
128			mail(String uri) {
129			if(!StdUtils.checkDesktopSupported()) return;
130
131			Desktop desktop = Desktop.getDesktop();
132
133			try { Desktop.getDesktop().mail(new URI(uri)); }
134			catch(Exception x) { x.printStackTrace(); }
135			}
136	iliev	1540
137	iliev	1786	/**
138			* Gets the windows bounds from the preferences for the specified window.
139			* @return The windows bounds saved in the preferences for the specified window
140			* or <code>null</code>.
141			*/
142			public static Rectangle
143			getWindowBounds(String windowName) {
144			String s = windowName + ".windowSizeAndLocation";
145			s = CC.preferences().getStringProperty(s, null);
146			if(s == null) return null;
147
148			try {
149			int i = s.indexOf(',');
150			int x = Integer.parseInt(s.substring(0, i));
151
152			s = s.substring(i + 1);
153			i = s.indexOf(',');
154			int y = Integer.parseInt(s.substring(0, i));
155
156			s = s.substring(i + 1);
157			i = s.indexOf(',');
158			int width = Integer.parseInt(s.substring(0, i));
159
160			s = s.substring(i + 1);
161			int height = Integer.parseInt(s);
162
163			return new Rectangle(x, y, width, height);
164			} catch(Exception x) {
165			String msg = windowName;
166			msg += ": Parsing of window size and location string failed";
167			CC.getLogger().log(Level.INFO, msg, x);
168			return null;
169			}
170			}
171
172			/**
173			* Saves the windows bounds in the preferences for the specified window.
174			*/
175			public static void
176			saveWindowBounds(String windowName, Rectangle r) {
177	iliev	1865	if(r.width < 50 \|\| r.height < 50 \|\| r.x < r.width * -1 \|\| r.y < 0) {
178			CC.getLogger().warning("Invalid window size or location");
179			return;
180			}
181
182	iliev	1786	StringBuffer sb = new StringBuffer();
183			sb.append(r.x).append(',').append(r.y).append(',');
184			sb.append(r.width).append(',').append(r.height);
185			String s = windowName + ".windowSizeAndLocation";
186			CC.preferences().setStringProperty(s, sb.toString());
187			}
188
189	iliev	1540	public static JSlider
190			createVolumeSlider() {
191			return new VolumeSlider();
192			}
193
194			private static class VolumeSlider extends JSlider {
195			private Popup popup = null;
196			private final JToolTip tip = new JToolTip();
197			private static NumberFormat numberFormat = NumberFormat.getInstance();
198
199			VolumeSlider() {
200			super(0, 100, 100);
201			numberFormat.setMaximumFractionDigits(1);
202	iliev	1567	// Setting the tooltip size (workaround for preserving that size)
203			boolean b = CC.getViewConfig().isMeasurementUnitDecibel();
204			if(b) tip.setTipText(i18n.getLabel("StdUtils.volumeDecibels", "-30.0"));
205			else tip.setTipText(i18n.getLabel("StdUtils.volume", "100"));
206			tip.setPreferredSize(tip.getPreferredSize());
207	iliev	1540	tip.setMinimumSize(tip.getPreferredSize());
208	iliev	1567	///////
209	iliev	1540	tip.setComponent(this);
210			tip.setTipText(i18n.getLabel("StdUtils.volume", 0));
211
212			updateVolumeInfo();
213
214			addMouseListener(new MouseAdapter() {
215			public void
216			mousePressed(MouseEvent e) {
217			if(popup != null) {
218			popup.hide();
219			popup = null;
220			}
221
222			if(!VolumeSlider.this.isEnabled()) return;
223
224			java.awt.Point p = VolumeSlider.this.getLocationOnScreen();
225			PopupFactory pf = PopupFactory.getSharedInstance();
226			popup = pf.getPopup(VolumeSlider.this, tip, p.x, p.y - 22);
227			popup.show();
228			}
229
230			public void
231			mouseReleased(MouseEvent e) {
232			if(popup != null) {
233			popup.hide();
234			popup = null;
235			}
236			}
237			});
238
239			addChangeListener(new ChangeListener() {
240			public void
241			stateChanged(ChangeEvent e) { updateVolumeInfo(); }
242			});
243
244			String s = VOL_MEASUREMENT_UNIT_DECIBEL;
245			preferences().addPropertyChangeListener(s, new PropertyChangeListener() {
246			public void
247			propertyChange(PropertyChangeEvent e) {
248	iliev	1567	// We use this to set the size of the lVolume
249			// to prevent the frequent resizing of lVolume component
250			boolean b = CC.getViewConfig().isMeasurementUnitDecibel();
251			tip.setPreferredSize(null);
252			String s;
253			if(b) s = i18n.getLabel("StdUtils.volumeDecibels", "-30.0");
254			else s = i18n.getLabel("StdUtils.volume", "100");
255			tip.setTipText(s);
256			tip.setPreferredSize(tip.getPreferredSize());
257			tip.setMinimumSize(tip.getPreferredSize());
258			///////
259	iliev	1540	updateVolumeInfo();
260			}
261			});
262			}
263
264			private void
265			updateVolumeInfo() {
266			String s;
267			if(CC.getViewConfig().isMeasurementUnitDecibel()) {
268			double d = HF.percentsToDecibels(getValue());
269			s = i18n.getLabel("StdUtils.volumeDecibels", numberFormat.format(d));
270			} else {
271			s = i18n.getLabel("StdUtils.volume", getValue());
272			}
273
274			setToolTipText(s);
275			tip.setTipText(s);
276			tip.repaint();
277			}
278			}
279	iliev	1308	}