• HPWindow.java is pure Java version
• HPWindow.m is Matlab version.
• XX is Mathematica version. (coming soon!)
• fechner.png and psychophysik.png are necessary image files for all versions.

Make sure that you have installed psychWithJava package and configured your environment.
• Pure Java version
Download the necessary files in your local drive. Open a terminal/command window and change to the directory where you saved the files. To compile type

javac HPWindow.java

and press enter. If there were no errors, type

java HPWindow

and press enter to run the program. For more information on command line development and development with Eclipse see the instructions on Building projects using psychWithJava to compile and run Java programs.
• Matlab version
Download the above listed necessary files in your current working directory and type (on Matlab command window)

HPWindow

and press enter. See Building projects using psychWithJava for more information
• Matematica version
Coming soon!

Pure Java version
Matlab version
Mathematica version

Precompiled program is in HPWindow.jar, which is a self running jar file. You can either run it directly from your browser or download the file on your local disk and run it with a double click.

NormalWindow manual pages,
FullScreen version of HelloPsychophysicist.

Pure Java version is in HPWindow.java file.

Most of the code is similar to the FullScreen version of HelloPsychophysicist. The differences are highlighted below.

First seven common steps
1. Import the necessary classes
In this version NormalWindow class is imported

import psychWithJava.NormalWindow;

Alternatively you can import all classes from a package

import psychWithJava.*;

More information on import.
2. Declare a public class and create a main method
The difference from FullScreen version of HelloPsychophysicist is that HPWindow inherits from NormalWindow

public class HPWindow extends NormalWindow implements Runnable {

    public static void main(String[] args) {

This syntax means that HPWindow is a class which inherits from another class called NormalWindow. NormalWindow provides the normal window version of FullScreen class. FullScreen works in Full Screen Exclusive Mode, NormalWindow works in a normal window environment. More information on class decleration.
3. Create an instance of the HPWindow class
In the main method, create an HPWindow object

HPWindow nw = new HPWindow();

Recall that HPWindow is NormalWindow, therefore constructing a HPWindow is nearly equivalent to constructing a NormalWindow object. For more information on the constructor of NormalWindow see Chapter 11: Applets, normal window applications, packaging and sharing your work. More information on object creation
4. Create a JFrame
This is the most significantly different part from the FullScreen version of HelloPsychophysicist. We need a lower level container to place our NormalWindow object. The suitable container for this purpose is a JFrame. Create a JFrame, set its dimensions and other properties and place the HPWindow object (nw) inside of it.

mainFrame = new JFrame();
mainFrame.setBounds(XO,YO,W,H);
mainFrame.add(nw);
mainFrame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
// Next two lines are optional 
mainFrame.setResizable(false);
mainFrame.setTitle("Hello Psychophysicist");
// you must set it visible
mainFrame.setVisible(true);

5. Create a new Thread and start it
This step is the same as in FullScreen version of HelloPsychophysicist

Thread experiment = new Thread(nw);
experiment.start();

More information on creating a thread
6. Provide the run() method
This step is the same as in FullScreen version of HelloPsychophysicist

public void run()

the method should be declared exactly as above.
7. Place the experiment/animation inside run(), use try-catch-finally
This step is nearly identical to FullScreen version of HelloPsychophysicist

public void run(){
  
  try{
    \\your methods for animation 
  } catch(){
    \\catch the exceptions, that is, if something goes wrong
  } finally {
    \\in the end clean up and return the resources used
    mainFrame.dispose();
  }

The crucial difference is that you should invoke mainFrame.dispose() method inside finally{}, instead of closeScreen() method of FullScreen class.

Above 7 steps are going to be nearly identical in all NormalWindow implementations, except the names of files and corresponding public classes. If you use an IDE, such as Eclipse, it will assist you with most of the steps. For instance you won't need to remember which classes to import. IDEs usually determine your import needs and place them in the beginning of your file. They will also warn you that you should have a public method called run() since your class inherits from Runnable interface. They will assist for catching the Exceptions, as well. Note: Unlike in FullScreen applications, you don't have to set number of video buffers manually (See HelloPsychophysicist for more on setting number of video buffers in FullScreen). NormalWindow always uses double buffering (one back, one front buffer).

The experiment/animation, inside the run() method
This is the part that will vary depending on your experiment. In this demo it is identical to FullScreen version of HelloPsychophysicist except closeScreen() is replaced by mainFrame.dispose() as explained above. This is possible because the thread is created by using a NormalWindow object and the method signitures are identical between FullScreen and NormalWindow. For instance displayImage(BufferedImage) method of FullScreen class displays an image at the center of the screen, whereas displayImage(BufferedImage) method of NormalWindow class displays an image at the center of the normal window. This makes converting FullScreen experiments into NormalWindow applications very simple. The only crucial difference is as explained above, creating a low level frame to place the NormalWindow object in the normal window mode. More information on run() method.

See Chapter 11: Applets, normal window applications, packaging and sharing your work.

See the entire code of HPWindow.java.

The Matlab code is to a great extend the same as the FullScreen version of HelloPsychophysicist. The differences are highlighted below.

1. Import psychWithJava.NormalWindow and javax.swing.JFrame
Instead of FullScreen, NormalWindow is imported.

import javax.swing.JFrame;
import psychWithJava.NormalWindow;

More information on import in Matlab
2. Create a Java object from within Matlab
Instead of a FullScreen object, a NormalWindow object is created

nw = NormalWindow();

More information on creating Java objsects in Matlab
3. Create a JFrame to place your NormalWindow object
This is the only substantial difference from the FullScreen version of HelloPsychophysicist. We need a lower level container to place our NormalWindow object. The suitable container for this purpose is a JFrame. Create a JFrame, set its dimensions and other properties and place the HPWindow object (nw) inside of it

mainFrame = JFrame();
mainFrame.setBounds(XO,YO,W,H);
mainFrame.add(nw);
mainFrame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
% next two lines are optional
mainFrame.setResizable(false);
mainFrame.setTitle('Hello Psychophysicist');
% you must set it visible
mainFrame.setVisible(true);

4. Place all your code in try-catch clause
This is similar to FullScreen version of HelloPsychophysicist

try
  nw = NormalWindow();
  mainFrame = JFrame()
  % place nw in mainFrame etc.
  % Your animation follows
  mainFrame.dispose;
catch
  mainFrame.dispose();
  rethrow(lasterror);
end

The difference is that mainFrame.dispose() replaces closeScreen() method. More information on putting your animation inside try-catch clause
5. Use the methods of NormalWindow
You can now invoke the NormalWindow methods, the syntax is as follows

nw.displayText(...
    'Hello Psychophysicist (from within Matlab)');
nw.updateScreen();
pause(2);

nw.blankScreen();
nw.hideCursor();

More information on invoking methods of Java objects in Matlab. Note that this is nearly identical to FullScreen version of HelloPsychophysicist except the name of the object changed from fs to nw. This is possible because the method signitures are identical between FullScreen and NormalWindow. For instance displayImage(BufferedImage) method of FullScreen class displays an image at the center of the screen, whereas displayImage(BufferedImage) method of NormalWindow class displays an image at the center of the normal window. This makes converting FullScreen experiments into NormalWindow applications very simple. The only crucial difference is as explained above, creating a low level frame to place the NormalWindow object in the normal window mode.

See Chapter 11: Applets, normal window applications, packaging and sharing your work.

See the entire code of HPWindow.m.