Skip to content

Ghidra is a software reverse engineering (SRE) framework

24.1 KB
Raw Blame
/* ###
 * IP: GHIDRA
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package generic.theme;

import java.awt.*;
import java.util.List;
import java.util.Set;

import javax.swing.*;
import javax.swing.plaf.ComponentUI;

import generic.theme.builtin.*;
import ghidra.framework.OperatingSystem;
import ghidra.framework.Platform;
import ghidra.util.Msg;
import ghidra.util.datastruct.WeakDataStructureFactory;
import ghidra.util.datastruct.WeakSet;
import resources.ResourceManager;
import utilities.util.reflection.ReflectionUtilities;
import utility.function.Callback;

/**
 * This class manages application themes and their values. The ThemeManager is an abstract
 * base class that has two concrete subclasses (and others for testing purposes) -
 * StubThemeManager and ApplicationThememManager. The StubThemeManager exists as a placeholder
 * until the ApplicationThemeManager is installed via {@link ApplicationThemeManager#initialize()}.
 * <P>
 * The basic idea is that all the colors, fonts, and icons used in an application should be
 * accessed indirectly via an "id" string. Then the actual color, font, or icon can be changed
 * without changing the source code. The default mapping of the id strings to a value is defined
 * in {@code <name>.theme.properties} files which are dynamically discovered by searching the module's
 * data directory. Also, these files can optionally define a dark default value for an id which
 * would replace the standard default value in the event that the current theme specifies that it
 * is a dark theme. Themes are used to specify the application's {@link LookAndFeel}, whether or
 * not it is dark, and any customized values for colors, fonts, or icons. There are several
 * "built-in" themes, one for each supported {@link LookAndFeel}, but additional themes can
 * be defined and stored in the users application home directory as a {@code <name>.theme} file.
 * <P>
 * Clients that just need to access the colors, fonts, and icons from the theme can use the
 * convenience methods in the {@link Gui} class.  Clients that need to directly manipulate the
 * themes and values will need to directly use the ThemeManager which and be retrieved using the
 * static {@link #getInstance()} method.
 */

public abstract class ThemeManager {

	public static final String THEME_DIR = "themes";

	static final Font DEFAULT_FONT = new Font("Dialog", Font.PLAIN, 12);
	static final Color DEFAULT_COLOR = Color.CYAN;

	private static final int MIN_FONT_SIZE = 3;

	protected static ThemeManager INSTANCE;

	protected GTheme activeTheme = getDefaultTheme();
	protected LafType activeLafType = activeTheme.getLookAndFeelType();
	protected boolean useDarkDefaults = activeTheme.useDarkDefaults();

	// this use our normalized ids (e.g., 'laf.')
	protected GThemeValueMap javaDefaults = new GThemeValueMap();
	protected GThemeValueMap currentValues = new GThemeValueMap();

	protected ApplicationThemeDefaults applicationDefaults;

	// these notifications are only when the user is manipulating theme values, so rare and at
	// user speed, so using copy on read
	private WeakSet<ThemeListener> themeListeners =
		WeakDataStructureFactory.createCopyOnReadWeakSet();

	private boolean isUpdating;

	public static ThemeManager getInstance() {
		return INSTANCE;
	}

	public ThemeManager() {
		if (INSTANCE == null) {
			// default behavior is only install to INSTANCE if first time
			INSTANCE = this;
		}

		applicationDefaults = loadApplicationDefaults();
	}

	protected ApplicationThemeDefaults loadApplicationDefaults() {
		return new PropertyFileThemeDefaults();
	}

	protected void installInGui() {
		Gui.setThemeManager(this);
	}

	/**
	 * This method is called to create the internal set of theme value used by the application. To
	 * do this, we use a layered approach to install values, with the last values added overwriting
	 * any pre-existing values with the same key.  The values are added in the following order:
	 * <pre>
	 * java defaults -> light values -> dark values -> look and feel values -> property file values -> theme values
	 * </pre>
	 * <p>
	 * At the point this method is called, this is the state of these various values:
	 * <ul>
	 *     <li>The 'javaValues' are normalized in the form of 'laf.font.TextArea'
	 *     </li>
	 *     <li>The 'applicationDefaults' contains values loaded from the {@code theme.properties}
	 *     files:
	 *     <pre>
	 *     font.listing.base
	 *     font.monospaced
	 *     [color]Viewport.background = color.bg
	 *     [laf.font]TextArea.font = font.monospaced
	 *     [laf.boolean]Button.rollover = true
	 *     </pre>
	 *     </li>
	 *     <li>The 'activeTheme' values are those loaded by the current theme, which has any changes
	 *     made to the default values
	 *     </li>
	 * </ul>
	 */
	protected void buildCurrentValues() {
		GThemeValueMap map = new GThemeValueMap();
		map.load(javaDefaults);
		map.load(applicationDefaults.getLightValues());
		if (useDarkDefaults) {
			map.load(applicationDefaults.getDarkValues());
		}
		map.load(applicationDefaults.getLookAndFeelValues(getLookAndFeelType()));
		map.load(activeTheme);
		currentValues = map;
	}

	/**
	 * Restores all the current application back to the values as specified by the active theme.
	 * In other words, reverts any changes to the active theme that haven't been saved.
	 */
	public void restoreThemeValues() {
		throw new UnsupportedOperationException();
	}

	/**
	 * Restores the current color value for the given color id to the value established by the
	 * current theme.
	 * @param id the color id to restore back to the original theme value
	 */
	public void restoreColor(String id) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Restores the current font value for the given font id to the value established by the
	 * current theme.
	 * @param id the font id to restore back to the original theme value
	 */
	public void restoreFont(String id) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Restores the current icon value for the given icon id to the value established by the
	 * current theme.
	 * @param id the icon id to restore back to the original theme value
	 */
	public void restoreIcon(String id) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns true if the color associated with the given id has been changed from the current
	 * theme value for that id.
	 * @param id the color id to check if it has been changed
	 * @return true if the color associated with the given id has been changed from the current
	 * theme value for that id.
	 */
	public boolean isChangedColor(String id) {
		return false;
	}

	/**
	 * Returns true if the font associated with the given id has been changed from the current
	 * theme value for that id.
	 * @param id the font id to check if it has been changed
	 * @return true if the font associated with the given id has been changed from the current
	 * theme value for that id.
	 */
	public boolean isChangedFont(String id) {
		return false;
	}

	/**
	 * Returns true if the Icon associated with the given id has been changed from the current
	 * theme value for that id.
	 * @param id the Icon id to check if it has been changed
	 * @return true if the Icon associated with the given id has been changed from the current
	 * theme value for that id.
	 */
	public boolean isChangedIcon(String id) {
		return false;
	}

	/**
	 * Sets the application's active theme to the given theme.
	 * @param theme the theme to make active
	 */
	public void setTheme(GTheme theme) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Sets the current {@link LookAndFeel}. This is used by theme editors to allow users to
	 * see the effects of changing LookAndFeels when configuring a theme. Setting this different
	 * from the activeTheme's LookAndFeel setting means that the current theme is in an unsaved
	 * state and causes the {@link #hasThemeChanges()} method to return true.
	 * @param lafType the {@link LafType} to set the LookAndFeel to
	 * @param useDarkDefaults true if the application should used dark defaults with this
	 * LookAndFeel
	 */
	public void setLookAndFeel(LafType lafType, boolean useDarkDefaults) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Adds the given theme to set of all themes.
	 * @param newTheme the theme to add
	 */
	public void addTheme(GTheme newTheme) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Removes the theme from the set of all themes. Also, if the theme has an associated
	 * file, the file will be deleted.
	 * @param theme the theme to delete
	 */
	public void deleteTheme(GTheme theme) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns a set of all known themes.
	 * @return a set of all known themes.
	 */
	public Set<GTheme> getAllThemes() {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns a set of all known themes that are supported on the current platform.
	 * @return a set of all known themes that are supported on the current platform.
	 */
	public List<GTheme> getSupportedThemes() {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns the active theme.
	 * @return the active theme.
	 */
	public GTheme getActiveTheme() {
		return activeTheme;
	}

	/**
	 * Returns the {@link LafType} for the currently active {@link LookAndFeel}
	 * @return the {@link LafType} for the currently active {@link LookAndFeel}
	 */
	public LafType getLookAndFeelType() {
		return activeLafType;
	}

	/**
	 * Returns the known theme that has the given name.
	 * @param themeName the name of the theme to retrieve
	 * @return the known theme that has the given name
	 */
	public GTheme getTheme(String themeName) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns a {@link GThemeValueMap} of all current theme values including unsaved changes to the
	 * theme.
	 * @return a {@link GThemeValueMap} of all current theme values
	 */
	public GThemeValueMap getCurrentValues() {
		return new GThemeValueMap(currentValues);
	}

	/**
	 * Returns the theme values as defined by the current theme, ignoring any unsaved changes that
	 * are currently applied to the application.
	 * @return the theme values as defined by the current theme, ignoring any unsaved changes that
	 * are currently applied to the application
	 */
	public GThemeValueMap getThemeValues() {
		GThemeValueMap map = new GThemeValueMap();
		map.load(javaDefaults);
		map.load(applicationDefaults.getLightValues());
		if (useDarkDefaults) {
			map.load(applicationDefaults.getDarkValues());
		}
		map.load(applicationDefaults.getLookAndFeelValues(getLookAndFeelType()));
		map.load(activeTheme);
		return map;
	}

	/**
	 * Returns a {@link GThemeValueMap} contains all values that differ from the default
	 * values (values defined by the {@link LookAndFeel} or in the theme.properties files.
	 * @return a {@link GThemeValueMap} contains all values that differ from the defaults.
	 */
	public GThemeValueMap getNonDefaultValues() {
		return currentValues.getChangedValues(getDefaults());
	}

	/**
	 * Returns the {@link Color} registered for the given id. Will output an error message if
	 * the id can't be resolved.
	 * @param id the id to get the direct color for
	 * @return the {@link Color} registered for the given id.
	 */
	public Color getColor(String id) {
		ColorValue color = currentValues.getColor(id);

		if (color == null) {
			error("No color value registered for: '" + id + "'");
			return DEFAULT_COLOR;
		}
		return color.get(currentValues);
	}

	/**
	 * Returns the current {@link Font} associated with the given id. A default font will be
	 * returned if the font can't be resolved and an error message will be printed to the console.
	 * @param id the id for the desired font
	 * @return the current {@link Font} associated with the given id.
	 */
	public Font getFont(String id) {
		FontValue font = currentValues.getFont(id);

		if (font == null) {
			error("No font value registered for: '" + id + "'");
			return DEFAULT_FONT;
		}
		return font.get(currentValues);
	}

	/**
	 * Returns the Icon registered for the given id. If no icon is registered for the id,
	 * the default icon will be returned and an error message will be dumped to the console
	 * @param id the id to get the registered icon for
	 * @return the actual icon registered for the given id
	 */
	public Icon getIcon(String id) {
		IconValue icon = currentValues.getIcon(id);
		if (icon == null) {
			error("No icon value registered for: '" + id + "'");
			return ResourceManager.getDefaultIcon();
		}
		return icon.get(currentValues);
	}

	/**
	 * Updates the current font for the given id.
	 * @param id the font id to update to the new color
	 * @param font the new font for the id
	 */
	public void setFont(String id, Font font) {
		setFont(new FontValue(id, font));
	}

	/**
	 * Updates the current value for the font id in the newValue
	 * @param newValue the new {@link FontValue} to install in the current values.
	 */
	public void setFont(FontValue newValue) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Updates the current color for the given id.
	 * @param id the color id to update to the new color
	 * @param color the new color for the id
	 */
	public void setColor(String id, Color color) {
		if (color == null) {
			throw new IllegalArgumentException("Can't set theme value to null!");
		}
		if (color instanceof GColor gColor) {
			if (id.equals(gColor.getId())) {
				Throwable t = new Throwable();
				Msg.error(this, "Attempted to set a color for id \"" + id + "\" using a GColor" +
					" defined using that same id! This would create a self reference!", t);
				return;  // this would create a circular reference to itself, don't do it
			}
		}
		setColor(new ColorValue(id, color));
	}

	/**
	 * Updates the current value for the color id in the newValue
	 * @param newValue the new {@link ColorValue} to install in the current values.
	 */
	public void setColor(ColorValue newValue) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Updates the current {@link Icon} for the given id.
	 * @param id the icon id to update to the new icon
	 * @param icon the new {@link Icon} for the id
	 */
	public void setIcon(String id, Icon icon) {
		setIcon(new IconValue(id, icon));
	}

	/**
	 * Updates the current value for the {@link Icon} id in the newValue
	 * @param newValue the new {@link IconValue} to install in the current values.
	 */
	public void setIcon(IconValue newValue) {
		throw new UnsupportedOperationException();
	}

	/**
	 * Returns the {@link GThemeValueMap} containing all the default theme values defined by the
	 * current {@link LookAndFeel}.
	 * @return  the {@link GThemeValueMap} containing all the default theme values defined by the
	 * current {@link LookAndFeel}
	 */
	public GThemeValueMap getJavaDefaults() {
		GThemeValueMap map = new GThemeValueMap();
		map.load(javaDefaults);
		return map;
	}

	/**
	 * Returns the {@link GThemeValueMap} containing all the dark default values defined
	 * in theme.properties files. Note that dark defaults includes light defaults that haven't
	 * been overridden by a dark default with the same id.
	 * @return the {@link GThemeValueMap} containing all the dark values defined in
	 * theme.properties files
	 */
	public GThemeValueMap getApplicationDarkDefaults() {
		GThemeValueMap map = new GThemeValueMap(applicationDefaults.getLightValues());
		map.load(applicationDefaults.getDarkValues());
		map.load(applicationDefaults.getLookAndFeelValues(getLookAndFeelType()));
		return map;
	}

	/**
	 * Returns the {@link GThemeValueMap} containing all the standard default values defined
	 * in theme.properties files.
	 * @return the {@link GThemeValueMap} containing all the standard values defined in
	 * theme.properties files
	 */
	public GThemeValueMap getApplicationLightDefaults() {
		GThemeValueMap map = new GThemeValueMap(applicationDefaults.getLightValues());
		map.load(applicationDefaults.getLookAndFeelValues(getLookAndFeelType()));
		return map;
	}

	/**
	 * Returns a {@link GThemeValueMap} containing all default values for the current theme. It
	 * is a combination of application defined defaults and java {@link LookAndFeel} defaults.
	 * @return the current set of defaults.
	 */
	public GThemeValueMap getDefaults() {
		GThemeValueMap currentDefaults = new GThemeValueMap(javaDefaults);
		currentDefaults.load(applicationDefaults.getLightValues());
		if (useDarkDefaults) {
			currentDefaults.load(applicationDefaults.getDarkValues());
		}
		currentDefaults.load(applicationDefaults.getLookAndFeelValues(getLookAndFeelType()));
		return currentDefaults;
	}

	/**
	 * Returns true if the given UI object is using the Aqua Look and Feel.
	 * @param UI the UI to examine.  (This parameter is ignored)
	 * @return true if the UI is using Aqua
	 * @deprecated use {@link #isUsingAquaUI()}
	 */
	@Deprecated(since = "11.3", forRemoval = true)
	public boolean isUsingAquaUI(ComponentUI UI) {
		return getLookAndFeelType() == LafType.MAC;
	}

	/**
	 * Returns true if the current UI is using the Aqua Look and Feel.
	 * @return true if the UI is using Aqua
	 */
	public boolean isUsingAquaUI() {
		return getLookAndFeelType() == LafType.MAC;
	}

	/**
	 * Returns true if the current UI is the FlatLaf Dark or FlatLaf Light Look and Feel.
	 * @return true if the current UI is the FlatLaf Dark or FlatLaf Light Look and Feel 
	 */
	public boolean isUsingFlatUI() {
		return getLookAndFeelType() == LafType.FLAT_DARK ||
			getLookAndFeelType() == LafType.FLAT_LIGHT;
	}

	/**
	 * Returns true if 'Nimbus' is the current Look and Feel
	 * @return true if 'Nimbus' is the current Look and Feel
	 */
	public boolean isUsingNimbusUI() {
		return getLookAndFeelType() == LafType.NIMBUS;
	}

	/**
	 * Adds a {@link ThemeListener} to be notified of theme changes.
	 * @param listener the listener to be notified
	 */
	public void addThemeListener(ThemeListener listener) {
		themeListeners.add(listener);
	}

	/**
	 * Removes the given {@link ThemeListener} from the list of listeners to be notified of
	 * theme changes.
	 * @param listener the listener to be removed
	 */
	public void removeThemeListener(ThemeListener listener) {
		themeListeners.remove(listener);
	}

	/**
	 * Returns true if there are any unsaved changes to the current theme.
	 * @return true if there are any unsaved changes to the current theme.
	 */
	public boolean hasThemeChanges() {
		return false;
	}

	/**
	 * Returns true if any theme values have changed.  This does not take into account the current
	 * Look and Feel.   Use {@link #hasThemeChanges()} to also account for changes to the Look and
	 * Feel.
	 * @return true if any theme values have changed
	 */
	public boolean hasThemeValueChanges() {
		return false;
	}

	/**
	 * Returns true if an color for the given Id has been defined
	 * @param id the id to check for an existing color.
	 * @return true if an color for the given Id has been defined
	 */
	public boolean hasColor(String id) {
		return currentValues.containsColor(id);
	}

	/**
	 * Returns true if an font for the given Id has been defined
	 * @param id the id to check for an existing font.
	 * @return true if an font for the given Id has been defined
	 */
	public boolean hasFont(String id) {
		return currentValues.containsFont(id);
	}

	/**
	 * Returns true if an icon for the given Id has been defined
	 * @param id the id to check for an existing icon.
	 * @return true if an icon for the given Id has been defined
	 */
	public boolean hasIcon(String id) {
		return currentValues.containsIcon(id);
	}

	/**
	 * Binds the component to the font identified by the given font id. Whenever the font for
	 * the font id changes, the component will updated with the new font.
	 * @param component the component to set/update the font
	 * @param fontId the id of the font to register with the given component
	 */
	public void registerFont(Component component, String fontId) {
		// do nothing
	}

	/**
	 * Binds the component to the font identified by the given font id. Whenever the font for
	 * the font id changes, the component will updated with the new font.
	 * <p>
	 * This method is fairly niche and should not be called by most clients.  Instead, call
	 * {@link #registerFont(Component, String)}.
	 *
	 * @param component the component to set/update the font
	 * @param fontId the id of the font to register with the given component
	 * @param fontStyle the font style
	 */
	public void registerFont(Component component, String fontId, int fontStyle) {
		// do nothing
	}

	/**
	 * Removes the component and font id binding made in a previous call to 
	 * {@link #registerFont(Component, String)}.
	 * @param component the component to remove
	 * @param fontId the id of the font previously registered
	 */
	public void unRegisterFont(JComponent component, String fontId) {
		// do nothing
	}

	/**
	 * Returns true if the current theme use dark default values.
	 * @return true if the current theme use dark default values.
	 */
	public boolean isDarkTheme() {
		return useDarkDefaults;
	}

	/**
	 * Returns the default theme for the current platform.
	 * @return the default theme for the current platform.
	 */
	public static GTheme getDefaultTheme() {
		OperatingSystem OS = Platform.CURRENT_PLATFORM.getOperatingSystem();
		return switch (OS) {
			case MAC_OS_X -> new MacTheme();
			case WINDOWS -> new WindowsTheme();
			default -> new FlatLightTheme();
		};
	}

	/**
	 * Returns true if the theme system is in the process of updating
	 * @return true if the theme system is in the process of updating
	 */
	public boolean isUpdatingTheme() {
		return isUpdating;
	}

	protected void update(Callback callback) {
		isUpdating = true;
		try {
			callback.call();
		}
		finally {
			isUpdating = false;
		}
	}

	protected void notifyThemeChanged(ThemeEvent event) {
		for (ThemeListener listener : themeListeners) {
			listener.themeChanged(event);
		}
	}

	protected void error(String message) {
		Throwable t = ReflectionUtilities.createThrowableWithStackOlderThan(ThemeManager.class);
		StackTraceElement[] trace = t.getStackTrace();
		StackTraceElement[] filtered = ReflectionUtilities.filterStackTrace(trace, "java.",
			"theme.Gui", "theme.ThemeManager", "theme.GColor");
		t.setStackTrace(filtered);
		Msg.error(this, message, t);
	}

	/**
	 * Adjust the size of all fonts by the given amount.
	 * @param amount the number to add to the current font size;
	 */
	public void adjustFonts(int amount) {
		List<FontValue> fonts = currentValues.getFonts();
		for (FontValue fontValue : fonts) {
			Font directFont = fontValue.getRawValue();
			if (directFont == null) {
				continue;  // indirect fonts will be handled when its referenced font is handled
			}
			int currentSize = directFont.getSize();
			int newSize = Math.max(MIN_FONT_SIZE, currentSize += amount);
			setFont(fontValue.getId(), directFont.deriveFont((float) newSize));
		}
	}

	/**
	 * Sets application's blinking cursor state. This will affect all JTextFields, JTextAreas, 
	 * JTextPanes via {@link UIDefaults}. Custom components can also respect this setting by
	 * either adding a {@link ThemeListener} or overriding {@link JComponent#updateUI()}
	 * <P> NOTE: This method is a bit odd here as it doesn't really apply to a theme. But it
	 * requires manipulation of the look and feel which is managed by the theme. If other 
	 * application level properties  come along and also require changing the UIDefaults, 
	 * perhaps a more general solution might be to add a way for clients to register a callback
	 * so that they get a chance to change the UIDefaults map as the look and feel is loaded.
	 * @param b true for blinking text cursors, false for non-blinking text cursors
	 */
	protected void setBlinkingCursors(boolean b) {
		// do nothing
	}

	/**
	 * Returns true if the application should allow blinking cursors, false otherwise. Custom
	 * components can use this method to determine if they should have a blinking cursor or not.
	 * @return true if the application should allow blinking cursors, false otherwise.
	 */
	protected boolean isBlinkingCursors() {
		return true;
	}
}