processing.app.syntax.im.InputMethodSupport Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of pde Show documentation
Processing is a programming language, development environment, and online community. This PDE package contains the Processing IDE.
There is a newer version: 3.3.7
Show newest version
package processing.app.syntax.im;

import java.awt.Color;
import java.awt.Font;
import java.awt.Graphics2D;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.RenderingHints;
import java.awt.event.InputMethodEvent;
import java.awt.event.InputMethodListener;
import java.awt.font.FontRenderContext;
import java.awt.font.TextAttribute;
import java.awt.font.TextHitInfo;
import java.awt.font.TextLayout;
import java.awt.im.InputMethodRequests;
import java.text.AttributedCharacterIterator;
import java.text.AttributedCharacterIterator.Attribute;

import javax.swing.text.BadLocationException;

import java.text.AttributedString;

import processing.app.Base;
import processing.app.Messages;
import processing.app.Preferences;
import processing.app.syntax.JEditTextArea;
import processing.app.syntax.TextAreaPainter;

/**
 * on-the-spot style input support for CJK.(Chinese, Japanese, Korean).
 * This class is implemented to fix Bug #854 from 2010-02-16.
 *
 * @see Bug 854 : implement input method support for Japanese (and other languages)
 * @see Bug 1531 : Can't input full-width space when Japanese IME is on.
 * @see http://docs.oracle.com/javase/8/docs/technotes/guides/imf/index.html
 * @see http://docs.oracle.com/javase/tutorial/2d/text/index.html
 *
 * @author Takashi Maekawa ([email protected])
 * @author Satoshi Okita
 */
public class InputMethodSupport implements InputMethodRequests,
    InputMethodListener {

  private static final Attribute[] CUSTOM_IM_ATTRIBUTES = {
    TextAttribute.INPUT_METHOD_HIGHLIGHT,
  };

  private int committed_count = 0;
  private JEditTextArea textArea;
  private AttributedString composedTextString;

  public InputMethodSupport(JEditTextArea textArea) {
    this.textArea = textArea;
    this.textArea.enableInputMethods(true);
    this.textArea.addInputMethodListener(this);
  }

  /////////////////////////////////////////////////////////////////////////////
  // InputMethodRequest
  /////////////////////////////////////////////////////////////////////////////
  @Override
  public Rectangle getTextLocation(TextHitInfo offset) {
    if (Base.DEBUG) {
      Messages.log("#Called getTextLocation:" + offset);
    }
    int line = textArea.getCaretLine();
    int offsetX = textArea.getCaretPosition() - textArea.getLineStartOffset(line);
    // '+1' mean textArea.lineToY(line) + textArea.getPainter().getFontMetrics().getHeight().
    // TextLayout#draw method need at least one height of font.
    Rectangle rectangle = new Rectangle(textArea.offsetToX(line, offsetX), textArea.lineToY(line + 1), 0, 0);

    Point location = textArea.getPainter().getLocationOnScreen();
    rectangle.translate(location.x, location.y);

    return rectangle;
  }


  @Override
  public TextHitInfo getLocationOffset(int x, int y) {
    return null;
  }

  @Override
  public int getInsertPositionOffset() {
    return textArea.getCaretPosition() * -1;
  }

  @Override
  public AttributedCharacterIterator getCommittedText(int beginIndex,
      int endIndex, AttributedCharacterIterator.Attribute[] attributes) {
    int length = endIndex - beginIndex;
    String textAreaString = textArea.getText(beginIndex, length);
    return new AttributedString(textAreaString).getIterator();
  }

  @Override
  public int getCommittedTextLength() {
    return committed_count;
  }

  @Override
  public AttributedCharacterIterator cancelLatestCommittedText(
      AttributedCharacterIterator.Attribute[] attributes) {
    return null;
  }

  @Override
  public AttributedCharacterIterator getSelectedText(
      AttributedCharacterIterator.Attribute[] attributes) {
    return null;
  }

  /////////////////////////////////////////////////////////////////////////////
  // InputMethodListener
  /////////////////////////////////////////////////////////////////////////////
  /**
   * Handles events from InputMethod.
   *
   * @param event event from Input Method.
   */
  @Override
  public void inputMethodTextChanged(InputMethodEvent event) {
    if (Base.DEBUG) {
      StringBuilder sb = new StringBuilder();
      sb.append("#Called inputMethodTextChanged");
      sb.append("\t ID: " + event.getID());
      sb.append("\t timestamp: " + new java.util.Date(event.getWhen()));
      sb.append("\t parmString: " + event.paramString());
      Messages.log(sb.toString());
    }

    AttributedCharacterIterator text = event.getText(); // text = composedText + commitedText
    committed_count = event.getCommittedCharacterCount();


    // The caret for Input Method.
    // if you type a character by a input method, original caret become off.
    // a JEditTextArea is not implemented by the AttributedStirng and TextLayout.
    // so JEditTextArea Caret On-off logic.
    //
    // japanese        : if the enter key pressed, event.getText is null.
    // japanese        : if first space key pressed, event.getText is null.
    // chinese(pinin)  : if a space key pressed, event.getText is null.
    // taiwan(bopomofo): ?
    // korean          : ?
    textArea.setCaretVisible(false);
    // Korean Input Method
    if (text != null && text.getEndIndex() - (text.getBeginIndex() + committed_count) <= 0) {
      textArea.setCaretVisible(true);
    }
    // Japanese Input Method
    if (text == null) {
      textArea.setCaretVisible(true);
    }

    char c;
    if (text != null) {
      int toCopy = committed_count;
      c = text.first();
      while (toCopy-- > 0) {
        if (Base.DEBUG) {
          Messages.log("INSERT:'" + c + "'");
        }
        this.insertCharacter(c);
        c = text.next();
      }

      CompositionTextPainter compositionPainter = textArea.getPainter().getCompositionTextpainter();
      if (Base.DEBUG) {
        Messages.log(" textArea.getCaretPosition() + committed_count: " + (textArea.getCaretPosition() + committed_count));
      }
      compositionPainter.setComposedTextLayout(getTextLayout(text, committed_count), textArea.getCaretPosition() + committed_count);
      compositionPainter.setCaret(event.getCaret());
    } else {
      // hide input method.
      CompositionTextPainter compositionPainter = textArea.getPainter().getCompositionTextpainter();
      compositionPainter.setComposedTextLayout(null, 0);
      compositionPainter.setCaret(null);
    }
    event.consume();
    textArea.repaint();
  }

  private TextLayout getTextLayout(AttributedCharacterIterator text, int committedCount) {
    boolean antialias = Preferences.getBoolean("editor.smooth");
    TextAreaPainter painter = textArea.getPainter();

    // create attributed string with font info.
    //if (text.getEndIndex() - (text.getBeginIndex() + committedCharacterCount) > 0) {
    if (text.getEndIndex() - (text.getBeginIndex() + committedCount) > 0) {
      composedTextString = new AttributedString(text, committedCount, text.getEndIndex(), CUSTOM_IM_ATTRIBUTES);
      Font font = painter.getFontMetrics().getFont();
      composedTextString.addAttribute(TextAttribute.FONT, font);
      composedTextString.addAttribute(TextAttribute.BACKGROUND, Color.WHITE);
    } else {
      composedTextString = new AttributedString("");
      return null;
    }

    // set hint of antialiasing to render target.
    Graphics2D g2d = (Graphics2D)painter.getGraphics();
    g2d.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING,
                        antialias ?
                        RenderingHints.VALUE_TEXT_ANTIALIAS_ON :
                        RenderingHints.VALUE_TEXT_ANTIALIAS_OFF);
    FontRenderContext frc = g2d.getFontRenderContext();
    if (Base.DEBUG) {
      Messages.log("debug: FontRenderContext is Antialiased = " + frc.getAntiAliasingHint());
    }

    return new TextLayout(composedTextString.getIterator(), frc);
  }

  @Override
  public void caretPositionChanged(InputMethodEvent event) {
    event.consume();
  }

  private void insertCharacter(char c) {
    if (Base.DEBUG) {
      Messages.log("debug: insertCharacter(char c) textArea.getCaretPosition()=" + textArea.getCaretPosition());
    }
    try {
      textArea.getDocument().insertString(textArea.getCaretPosition(), Character.toString(c), null);
      if (Base.DEBUG) {
        Messages.log("debug: \t after:insertCharacter(char c) textArea.getCaretPosition()=" + textArea.getCaretPosition());
      }
    } catch (BadLocationException e) {
      e.printStackTrace();
    }
  }
}