Счётчик кода Грея
Этот курс по библиотекам Logisim завершается довольно сложным счётчиком кода Грея, который позволяет пользователю менять его текущее значение, используя Инструмент Нажатие и размещать на компоненте метку, используя Инструмент Текст. Он также настраивает значок в проводнике, связанный с этим инструментом.
GrayCounter
package com.cburch.gray;
import java.net.URL;
import javax.swing.ImageIcon;
import com.cburch.logisim.data.Attribute;
import com.cburch.logisim.data.BitWidth;
import com.cburch.logisim.data.Bounds;
import com.cburch.logisim.data.Direction;
import com.cburch.logisim.instance.Instance;
import com.cburch.logisim.instance.InstanceFactory;
import com.cburch.logisim.instance.InstancePainter;
import com.cburch.logisim.instance.InstanceState;
import com.cburch.logisim.instance.Port;
import com.cburch.logisim.instance.StdAttr;
import com.cburch.logisim.util.GraphicsUtil;
import com.cburch.logisim.util.StringUtil;
/** Создаёт счётчик, который пробегает по очереди коды Грея. Он демонстрирует
* некоторые дополнительные возможности по сравнению с классом SimpleGrayCounter. */
class GrayCounter extends InstanceFactory {
public GrayCounter() {
super("Gray Counter");
setOffsetBounds(Bounds.create(-30, -15, 30, 30));
setPorts(new Port[] {
new Port(-30, 0, Port.INPUT, 1),
new Port( 0, 0, Port.OUTPUT, StdAttr.WIDTH),
});
// У нас будут атрибуты ширина, метка и шрифт метки. Последние два
// атрибута позволяют нам связать метку с компонентом (однако,
// нам также нужен configureNewInstance для настройки расположения
// метки).
setAttributes(
new Attribute[] { StdAttr.WIDTH, StdAttr.LABEL, StdAttr.LABEL_FONT },
new Object[] { BitWidth.create(4), "", StdAttr.DEFAULT_LABEL_FONT });
// Следующее обращение к методу устанавливает всё так, чтобы состоянием
// экземпляра можно было управлять с помощью Инструмента Нажатие.
setInstancePoker(CounterPoker.class);
// Следующие две строчки настраивают его так, чтобы окно проводника показывало
// определённый значок, представляющий тип компонента. Это должно быть
// изображение 16x16.
URL url = getClass().getClassLoader().getResource("com/cburch/gray/counter.gif");
if(url != null) setIcon(new ImageIcon(url));
}
/** Метод configureNewInstance вызывается каждый раз, когда создаётся
* новый экземпляр. В суперклассе метод ничего не делает, поскольку
* новый экземпляр уже довольно хорошо настроен по умолчанию. Но
* иногда вам нужно делать что-то специфическое с каждым экземпляром, так что вам
* придётся переопределить метод. В этом случае мы должны задать расположение
* для его метки. */
protected void configureNewInstance(Instance instance) {
Bounds bds = instance.getBounds();
instance.setTextField(StdAttr.LABEL, StdAttr.LABEL_FONT,
bds.getX() + bds.getWidth() / 2, bds.getY() - 3,
GraphicsUtil.H_CENTER, GraphicsUtil.V_BASELINE);
}
public void propagate(InstanceState state) {
// Это так же, как и с SimpleGrayCounter, кроме того, что мы используем
// атрибут StdAttr.WIDTH чтобы задать разрядность.
BitWidth width = state.getAttributeValue(StdAttr.WIDTH);
CounterData cur = CounterData.get(state, width);
boolean trigger = cur.updateClock(state.getPort(0));
if(trigger) cur.setValue(GrayIncrementer.nextGray(cur.getValue()));
state.setPort(1, cur.getValue(), 9);
}
public void paintInstance(InstancePainter painter) {
// Это по существу так же, как и с SimpleGrayCounter, за исключением
// вызова painter.drawLabel чтобы сделать метку отрисованной.
painter.drawBounds();
painter.drawClock(0, Direction.EAST);
painter.drawPort(1);
painter.drawLabel();
if(painter.getShowState()) {
BitWidth width = painter.getAttributeValue(StdAttr.WIDTH);
CounterData state = CounterData.get(painter, width);
Bounds bds = painter.getBounds();
GraphicsUtil.drawCenteredText(painter.getGraphics(),
StringUtil.toHexString(width.getWidth(), state.getValue().toIntValue()),
bds.getX() + bds.getWidth() / 2,
bds.getY() + bds.getHeight() / 2);
}
}
}
CounterPoker
package com.cburch.gray;
import java.awt.Color;
import java.awt.Graphics;
import java.awt.event.KeyEvent;
import java.awt.event.MouseEvent;
import com.cburch.logisim.data.BitWidth;
import com.cburch.logisim.data.Bounds;
import com.cburch.logisim.data.Value;
import com.cburch.logisim.instance.InstancePainter;
import com.cburch.logisim.instance.InstancePoker;
import com.cburch.logisim.instance.InstanceState;
import com.cburch.logisim.instance.StdAttr;
/** Когда пользователь щёлкает на счётчике, используя Инструмент Нажатие, объект CounterPoker
* создан, и этот объект будет обрабатывать все события пользователя. Обратите внимание, что
* CounterPoker - это класс, специфичный для GrayCounter, и что он должен быть
* подклассом InstancePoker из пакета com.cburch.logisim.instance. */
public class CounterPoker extends InstancePoker {
public CounterPoker() { }
/** Определяет, должно ли положение, в котором нажата мышь,
* инициировать нажатие.
*/
public boolean init(InstanceState state, MouseEvent e) {
return state.getInstance().getBounds().contains(e.getX(), e.getY());
// В любом месте главного прямоугольника инициирует нажатие. Пользователь может
// нажать на метке, но это будет за пределами границ.
}
/** Рисует индикатор того, что указатель был выбран. Здесь мы будем рисовать
* красный прямоугольник вокруг значения. */
public void paint(InstancePainter painter) {
Bounds bds = painter.getBounds();
BitWidth width = painter.getAttributeValue(StdAttr.WIDTH);
int len = (width.getWidth() + 3) / 4;
Graphics g = painter.getGraphics();
g.setColor(Color.RED);
int wid = 7 * len + 2; // width of caret rectangle
int ht = 16; // height of caret rectangle
g.drawRect(bds.getX() + (bds.getWidth() - wid) / 2,
bds.getY() + (bds.getHeight() - ht) / 2, wid, ht);
g.setColor(Color.BLACK);
}
/**Обрабатывает клавишу, просто добавив её в конец текущего значения. */
public void keyTyped(InstanceState state, KeyEvent e) {
// преобразовать её в шестнадцатеричное число; если она - не шестнадцатеричное число, то отменить.
int val = Character.digit(e.getKeyChar(), 16);
BitWidth width = state.getAttributeValue(StdAttr.WIDTH);
if(val < 0 || (val & width.getMask()) != val) return;
// вычислить следующее значение
CounterData cur = CounterData.get(state, width);
int newVal = (cur.getValue().toIntValue() * 16 + val) & width.getMask();
Value newValue = Value.createKnown(width, newVal);
cur.setValue(newValue);
state.fireInvalidated();
// Вы, возможно, подумываете о том, чтобы просчитать значение здесь сразу, используя
// state.setPort. Однако, схема может просчитываться в данный момент в
// другом потоке, и непосредственный вызов setPort может помешать
// этому. Использование fireInvalidated уведомляет поток просчёта о том,
// чтобы вызвать просчёт для счётчика при первой же возможности.
}
}
Далее: Указания.
