quicktime.app.display
Class JQTCanvas

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--quicktime.app.display.JQTCanvas

All Implemented Interfaces:

DrawingListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

Deprecated. since QTJava 6.1

public class JQTCanvas

extends javax.swing.JComponent

implements DrawingListener

This is a Lightweight version of the JQTCanvas class designed for use with Swing Because it is strictly lightweight, and has no native peer, you can only have client classes that do not use a controller such as the Compositor class and MoviePlayer. QuickTime cannot render controllers in an offscreen buffer.

See Also:

Serialized Form

Field Summary

static boolean	flashScaling Deprecated.
QTImageProducer	ip Deprecated.
static int	kAspectResize Deprecated. since QTJava 6.1
static int	kFreeResize Deprecated. since QTJava 6.1
static int	kHorizontalResize Deprecated. since QTJava 6.1
static int	kInitialSize Deprecated. since QTJava 6.1
static int	kInitialSizeNoResize Deprecated. since QTJava 6.1
static int	kIntegralResize Deprecated. since QTJava 6.1
static int	kPerformanceResize Deprecated. since QTJava 6.1
static int	kVerticalResize Deprecated. since QTJava 6.1
static boolean	useMacOSXAcceleration Deprecated.

Fields inherited from class javax.swing.JComponent

accessibleContext, 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

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

Constructor Summary

JQTCanvas()
Deprecated. since QTJava 6.1

JQTCanvas(int resizeFlag, float xAlignment, float yAlignment)
Deprecated.

Method Summary

void	addQTClientListener(java.awt.event.ComponentListener e) Deprecated. since QTJava 6.1
java.awt.Image	createImage(java.awt.image.ImageProducer producer) Deprecated.
void	drawingComplete(QTDrawable drawable) Deprecated. since QTJava 6.1
int	getResizeFlag() Deprecated. since QTJava 6.1
boolean	isFlashScaling() Deprecated.
void	paint(java.awt.Graphics g) Deprecated. since QTJava 6.1
void	removeClient() Deprecated. since QTJava 6.1
void	removeQTClientListener(java.awt.event.ComponentListener e) Deprecated. since QTJava 6.1
void	reshape(int x, int y, int width, int height) Deprecated. As of JDK version 1.1, replaced by setBounds(int, int, int, int).
void	setAlignment(float x, float y) Deprecated.
void	setBounds(int x, int y, int width, int height) Deprecated. since QTJava 6.1
void	setBounds(java.awt.Rectangle r) Deprecated. since QTJava 6.1
void	setClient(QTDrawable drawable, boolean layoutFlag) Deprecated. since QTJava 6.1
void	setClient(QTDrawable cl, QDRect initialBounds) Deprecated. since QTJava 6.1
void	setFlashScaling(boolean scale) Deprecated.
void	setResizeFlag(int rFlag) Deprecated. since QTJava 6.1
void	setSize(java.awt.Dimension dim) Deprecated. since QTJava 6.1
void	setSize(int width, int height) Deprecated. since QTJava 6.1

Methods inherited from class javax.swing.JComponent

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

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, 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, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

kIntegralResize

public static final int kIntegralResize

Deprecated. since QTJava 6.1

Use this flag if the client should maintain the aspect size of its original dimensions but grow bigger by integral increments (2x, 3x, 4x, etc.)

See Also:

Constant Field Values

kInitialSize

public static final int kInitialSize

Deprecated. since QTJava 6.1

Use this flag if the client should revert to its initially specified size. The client can be made smaller (using an aspect setting) but can be no larger than its initial size. The JQTCanvas takes this initial size as the best viewing size for its client.

See Also:

Constant Field Values

kFreeResize

public static final int kFreeResize

Deprecated. since QTJava 6.1

Use this flag if the client can be resized to any size >= the minimum and <= the maximum.

See Also:

Constant Field Values

kAspectResize

public static final int kAspectResize

Deprecated. since QTJava 6.1

Use this flag if the client can be resized to any size which preserves the initial aspect ratio.

See Also:

Constant Field Values

kPerformanceResize

public static final int kPerformanceResize

Deprecated. since QTJava 6.1

Use this flag if the client can be resized to any size which is a factor of 2 of the initial size.

See Also:

Constant Field Values

kHorizontalResize

public static final int kHorizontalResize

Deprecated. since QTJava 6.1

Use this flag to allow the client's horizontal aspect to be any size, but the vertical axis will be the intial size of smaller. This is a good setting for QT VR content.

See Also:

Constant Field Values

kVerticalResize

public static final int kVerticalResize

Deprecated. since QTJava 6.1

Use this flag to allow the client's vertical aspect to be any size, but the horizontal axis will be the intial size of smaller.

See Also:

Constant Field Values

kInitialSizeNoResize

public static final int kInitialSizeNoResize

Deprecated. since QTJava 6.1

Use this flag specify that the client cannot be resized

See Also:

Constant Field Values

flashScaling

public static boolean flashScaling

Deprecated.

useMacOSXAcceleration

public static boolean useMacOSXAcceleration

Deprecated.

ip

public QTImageProducer ip

Deprecated.

Constructor Detail

JQTCanvas

public JQTCanvas()

Deprecated. since QTJava 6.1

Default Constructor for JQTCanvas

JQTCanvas

public JQTCanvas(int resizeFlag,
                 float xAlignment,
                 float yAlignment)

Deprecated.

Method Detail

paint

public void paint(java.awt.Graphics g)

Deprecated. since QTJava 6.1

This method is invoked by Swing to draw this component

Overrides:

paint in class javax.swing.JComponent

setFlashScaling

public void setFlashScaling(boolean scale)

Deprecated.

isFlashScaling

public boolean isFlashScaling()

Deprecated.

setClient

public void setClient(QTDrawable drawable,
                      boolean layoutFlag)
               throws QTException

Deprecated. since QTJava 6.1

Associates a new client, a Drawable object, with this JQTCanvas. The flag determines if awt will perform a layout and how the client will be integrated with the canvas. If the flag is false then the new client will take on the current size and position of the canvas. If the flag is true, then awt will layout the canvas again, using the initial size of the client and the resize flags to resize the canvas and its client.

The size of the client when this method is called is used to ascertain the best size for viewing this client's media.

This method can throw a number of exceptions:
QTUnknownOSException the application is trying to run on a platform that is not supported by QuickTime
NativeGraphicsException the native graphics environment is not initialised
QTException or subclass - there was a problem within QuickTime itself in dealing with this client

Parameters:

layoutFlag - if true java.awt will re-layout the canvas, if false the client will fit into the existing state (display size, etc) of the canvas, disregarding any resize that might have occured to honour the layout flag setting with respect to the different size of the new client. Keep in mind that only controllerless clients are valid

QTException

setClient

public void setClient(QTDrawable cl,
                      QDRect initialBounds)
               throws QTException

Deprecated. since QTJava 6.1

Associates a new client, a Drawable object, with this JQTCanvas. It will use existing alignment and resize restrictions.

This method can throw a number of exceptions:
QTUnknownOSException the application is trying to run on a platform that is not supported by QuickTime
NativeGraphicsException the native graphics environment is not initialised
QTException or subclass - there was a problem within QuickTime itself in dealing with this client

Parameters:

initialBounds - the best size of the client Keep in mind that only controllerless clients are valid

QTException

removeClient

public final void removeClient()

Deprecated. since QTJava 6.1

Removes the current client, a drawable object, from the canvas.

createImage

public java.awt.Image createImage(java.awt.image.ImageProducer producer)

Deprecated.

Overrides:

createImage in class java.awt.Component

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Deprecated. since QTJava 6.1

Moves and resizes this component. The new location of the top-left corner is specified by x and y, and the new size is specified by width and height.

Overrides:

setBounds in class java.awt.Component

Parameters:

x - the new x-coordinate of this component

y - the new y-coordinate of this component

width - the new width of this component

height - the new height of this component

See Also:

setBounds(Rectangle r)

setBounds

public void setBounds(java.awt.Rectangle r)

Deprecated. since QTJava 6.1

Moves and resizes this component to conform to the new bounding rectangle r. This component's new position is specified by r.x and r.y, and its new size is specified by r.width and r.height

Overrides:

setBounds in class java.awt.Component

setSize

public void setSize(java.awt.Dimension dim)

Deprecated. since QTJava 6.1

Resizes the JQTCanvas object to the specified parameters.

Overrides:

setSize in class java.awt.Component

Parameters:

dim - a Dimension object with the new width and height

setSize

public void setSize(int width,
                    int height)

Deprecated. since QTJava 6.1

Resizes the JQTCanvas object, as well as the associated Drawable object.

Overrides:

setSize in class java.awt.Component

Parameters:

width - the width, in pixels, to make this component

height - the height, in pixels, to make this component

reshape

public final void reshape(int x,
                          int y,
                          int width,
                          int height)

Deprecated. As of JDK version 1.1, replaced by setBounds(int, int, int, int).

Overrides:

reshape in class javax.swing.JComponent

setAlignment

public void setAlignment(float x,
                         float y)

Deprecated.

setResizeFlag

public void setResizeFlag(int rFlag)

Deprecated. since QTJava 6.1

Reset the resize flag and re-layout the component.

Parameters:

rFlag - the new value for the resizeFlag

getResizeFlag

public int getResizeFlag()

Deprecated. since QTJava 6.1

Returns the current setting of the resize flag being used.

Returns:

the resize flag value

drawingComplete

public void drawingComplete(QTDrawable drawable)

Deprecated. since QTJava 6.1

Called when a client is finished drawing and the canvas needs to be updated

Specified by:

drawingComplete in interface DrawingListener

Parameters:

drawable - the drawable which drawing has just been completed upon

Returns:

an error code or zero if no error

See Also:

quicktime.app.display

addQTClientListener

public void addQTClientListener(java.awt.event.ComponentListener e)

Deprecated. since QTJava 6.1

A ComponentListener and ComponentEvent are used to listen to these types of events that occur to the QTCanvas' client - ie. when the QTCanvas' client is resized, moved, shown or hidden. These events generally occur in conjunction with the Component events they mirror - with some exceptions:

• ComponentShown and ComponentHidden are generated when the QTCanvas is shown or hidden and when the QTDrawable client is set or removed.
• ComonentMoved and ComponentResized are generated when the QTCanvas is moved or resized but the event is actually generated when the QTCanvas is repainted as this is when the QTDrawable client is itself resized or moved.

  Parameters:

  e - the ComponentListener

removeQTClientListener

public void removeQTClientListener(java.awt.event.ComponentListener e)

Deprecated. since QTJava 6.1

Remove a previously registered ComponentListener that is listening to events that occur with the QTCanvas' QTDrawable client.

Parameters:

e - the ComponentListener

See Also:

addQTClientListener