com.physpics.toys

Class ColorRange

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

com.physpics.tools.ui.blox.Blox

com.physpics.toys.ColorRange

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class ColorRange
extends com.physpics.tools.ui.blox.Blox

ColorRange.java - manage an array of eleven colors. Nominally the colors are suitable for representing values 0.0, 0.1, ... 1.0. The file format is eleven lines of three integers: hue, saturation, and brightness. If no file is specified, reads asset:com.physpics.tools/colorRange.txt The old version of the file is retained under the name colorRange-old.txt Lines beginning w/ '#' are ignored. A sample source file is in STARTER_RANGE, below Supposing the input is ddd/xxx.txt, then the app also generates ddd/xxx.png, a 11x1 image file, one pixel per color. ddd/xxx.htm, An array of the color for viewing them a web page

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ColorRange.Editor

Nested classes/interfaces inherited from class com.physpics.tools.ui.blox.Blox

com.physpics.tools.ui.blox.Blox.AccessibleBlox, com.physpics.tools.ui.blox.Blox.BaseAlignNote, com.physpics.tools.ui.blox.Blox.BkgdColorNote, com.physpics.tools.ui.blox.Blox.CrossSizeFull, com.physpics.tools.ui.blox.Blox.DebugNote, com.physpics.tools.ui.blox.Blox.Filler, com.physpics.tools.ui.blox.Blox.GlueNote, com.physpics.tools.ui.blox.Blox.NameNote, com.physpics.tools.ui.blox.Blox.Note, com.physpics.tools.ui.blox.Blox.Scroller, com.physpics.tools.ui.blox.Blox.StrutNote

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String[]	BUILT_IN_RANGES

Fields inherited from class com.physpics.tools.ui.blox.Blox

DEFAULT_HEIGHT, DEFAULT_WIDTH, DIM_ZERO, PIXELS_PER_POINT

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Method Summary

Modifier and Type	Method and Description
static ColorRange	create()
java.lang.String	getDestination()
java.io.File	getDir()
java.lang.String	getSource()
void	handleSaveButton() Store the color data in current 'dest'.
static void	main(java.lang.String[] args) Run app from command line.
javax.swing.JFrame	openWindow(javax.swing.JFrame f, int width, int height) Override openWindow to also read the data.
static javax.swing.JFrame[]	openWindows()
boolean	readColors(com.physpics.tools.IOUtils.InfoInputStream iis) Read the splotch HSB from a text file
boolean	readColors(java.io.Reader rdr) Read the splotch HSB from a Reader
boolean	readColors(java.lang.String s) Read a colors range file from a string.
boolean	saveColors(java.lang.String stem) Save the current colors to original file.
void	setDefaults() Set default directories and initial color range.
void	setDestination(java.lang.String destination)
void	setDir(java.lang.String dir)
void	setSource(java.lang.String source) Set the source location name.

Methods inherited from class com.physpics.tools.ui.blox.Blox

addImpl, addMany, baseAlign, color, componentOrientationFactory, createGlue, createHorizontalBlox, createHorizontalBlox, createHorizontalGlue, createHorizontalStrut, createRigidArea, createVerticalBlox, createVerticalBlox, createVerticalGlue, createVerticalStrut, crossSizeFull, debug, getAccessibleContext, getBaseline, getFrame, glue, name, openWindow, openWindow, paintComponent, pixelsToPoints, pointsToPixels, setLayout, setOpaque, setTransparent, strut, wrapFrame

Methods inherited from class javax.swing.JPanel

getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

BUILT_IN_RANGES

public static final java.lang.String[] BUILT_IN_RANGES

Method Detail

getDir

public java.io.File getDir()

Returns:

the working directory.

setDir

public void setDir(java.lang.String dir)

Parameters:

dir - working-directory value, expressed as a locator

getSource

public java.lang.String getSource()

Returns:

the source. value is not absolutized.

setSource

public void setSource(java.lang.String source)

Set the source location name.

Parameters:

source - the source to set. Strip leading '#'. If the remaining string begins with '(', end string at ')'

getDestination

public java.lang.String getDestination()

Returns:

the destination. If no slash in name, use directory ./images.

setDestination

public void setDestination(java.lang.String destination)

Parameters:

destination - the destination to set. The value should be a file name and not a locator. To use a locator, write

        setDestination(computeSaveLocation(locator)) 

create

public static ColorRange create()

Returns:

a ColorRange panel showing a newly created color-range Editor. directory and source file are not set.

setDefaults

public void setDefaults()

Set default directories and initial color range. Check ourDir and ourSource. Read colors from source.

handleSaveButton

public void handleSaveButton()

Store the color data in current 'dest'.

readColors

public boolean readColors(java.lang.String s)

Read a colors range file from a string.

Parameters:

s - The full contents of a colorrange file.

Returns:

the value from readColors(Reader); can fail if s is not a proper colorrange file.

readColors

public boolean readColors(com.physpics.tools.IOUtils.InfoInputStream iis)

Read the splotch HSB from a text file

Parameters:

iis - An IOUtils InfoInputStream indicating where to find the data.

Returns:

true if colors were read

readColors

public boolean readColors(java.io.Reader rdr)

Read the splotch HSB from a Reader

Parameters:

rdr - A Reader of a stream of data lines.

Returns:

true if colors were read

saveColors

public boolean saveColors(java.lang.String stem)

Save the current colors to original file. Also create a .png file with the eleven colors and a .htm file displaying them.

Parameters:

stem - Where to write the output, but without extension. Files will be saved to stem+".txt", stem+".png, and stem+".htm"

Returns:

True unless writing failed for any one of the files.

openWindow

public javax.swing.JFrame openWindow(javax.swing.JFrame f,
                                     int width,
                                     int height)

Override openWindow to also read the data.

Overrides:

openWindow in class com.physpics.tools.ui.blox.Blox

Returns:

the JFrame.

openWindows

public static javax.swing.JFrame[] openWindows()

main

public static void main(java.lang.String[] args)

Run app from command line.

Parameters:

args - the command line arguments. Synopsis:

      [-D working-dir] [color-range-file]