Java Doc for Screen3D.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » java 3d » javax.media.j3d 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   javax.media.j3d.Screen3D

Screen3D
public class Screen3D extends Object (Code)
The Screen3D Object contains all information about a particular screen. All Canvas3D objects on the same physical screen (display device) refer to the same Screen3D object. Note that Screen3D has no public constructors--it is obtained from the Canvas3D via the getScreen3D method.

Default values for Screen3D parameters are as follows:

    physical screen width : 0.0254/90.0 * screen width (in pixels)
    physical screen height : 0.0254/90.0 * screen height (in pixels)
    tracker base to image plate transform : identity
    head tracker to left image plate transform : identity
    head tracker to right image plate transform : identity
    off-screen size : (0,0)

Offscreen Rendering

New for Java 3D 1.2, an off-screen rendering mode allows rendering to a memory image, which is possibly larger than the screen. The setSize and getSize methods are defined specifically for this mode. Note that the off-screen size, physical width, and physical height must be set prior to rendering to the associated off-screen canvas. Failure to do so will result in an exception.

Calibration Parameters

The Screen3D object must be calibrated with the coexistence volume. The Screen3D class provides several methods for defining the calibration parameters.

    Measured Parameters

    The screen's (image plate's) physical width and height (in meters) is set once, typically by a browser, calibration program, system administrator, or system calibrator, not by an applet. These values must be determined by measuring the display's active image width and height. In the case of a head-mounted display, this should be the display's apparent width and height at the focal plane. These values are defined by the setPhysicalScreenWidth and setPhysicalScreenHeight methods.

    Head-tracker Coordinate System

    If head tracking is enabled, one of two parameters need to be specified:

    • If the view policy is SCREEN_VIEW, the tracker-base-to-image-plate coordinate system must be specified (setTrackerBaseToImagePlate method). This coordinate system must be recalibrated whenever the image plate moves relative to the tracker.
    • If the view policy is HMD_VIEW, the head-tracker-to-left-image-plate and head-tracker-to-right-image-plate coordinate systems must be specified (setHeadTrackerToLeftImagePlate and setHeadTrackerToRightImagePlate methods).

Additional Information

For more information, see the Introduction to the Java 3D API and View Model documents.
See Also:   Canvas3D
See Also:   Canvas3D.getScreen3D



Field Summary
final static  intHEAD_TRACKER_TO_IMAGE_PLATE_DIRTY
    
final static  intPHYSICAL_SCREEN_SIZE_DIRTY
    
final static  intSCREEN_SIZE_DIRTY_DIRTY
    
final static  intTRACKER_BASE_TO_IMAGE_PLATE_DIRTY
    
 UnorderListactiveViews
    
 intcanvasCount
    
static  HashtabledeviceRendererMap
    
 longdisplay
    
 GraphicsDevicegraphicsDevice
    
 Transform3DheadTrackerToLeftImagePlate
    
 Transform3DheadTrackerToRightImagePlate
    
 booleanoffScreen
    
 doublephysicalScreenHeight
    
 doublephysicalScreenWidth
    
 Rendererrenderer
    
 intscrDirtyMask
    
 intscreen
    
 DimensionscreenSize
    
 ScreenViewCachescreenViewCache
    
 Transform3DtrackerBaseToImagePlate
    
 ArrayListusers
    

Constructor Summary
 Screen3D(GraphicsConfiguration graphicsConfiguration, boolean offScreen)
     Construct a new Screen3D object with the specified size in pixels.

Method Summary
 booleanactiveViewEmpty()
    
 voidaddActiveView(View v)
    
synchronized  voidaddUser(Canvas3D c)
    
synchronized  voiddecCanvasCount()
    
public  voidgetHeadTrackerToLeftImagePlate(Transform3D t)
     Retrieves the head-tracker coordinate system to left image-plate coordinate system transform and copies it into the specified Transform3D object.
public  voidgetHeadTrackerToRightImagePlate(Transform3D t)
     Retrieves the head-tracker coordinate system to right image-plate coordinate system transform and copies it into the specified Transform3D object.
public  doublegetPhysicalScreenHeight()
     Retrieves the the screen's physical height in meters.
public  doublegetPhysicalScreenWidth()
     Retrieves the screen's physical width in meters.
public  DimensiongetSize()
     Retrieves the width and height (in pixels) of this Screen3D.
public  DimensiongetSize(Dimension rv)
     Retrieves the width and height (in pixels) of this Screen3D and copies it into the specified Dimension object.
Parameters:
  rv - Dimension object into which the size ofthis Screen3D is copied.If rv is null, a new Dimension object is allocated.
public  voidgetTrackerBaseToImagePlate(Transform3D t)
     Retrieves the tracker-base coordinate system to image-plate coordinate system transform and copies it into the specified Transform3D object.
synchronized  voidincCanvasCount()
    
synchronized  voidnotifyUsers()
    
 voidremoveActiveView(View v)
    
synchronized  voidremoveUser(Canvas3D c)
    
public  voidsetHeadTrackerToLeftImagePlate(Transform3D t)
     Sets the head-tracker coordinate system to left image-plate coordinate system transform.
public  voidsetHeadTrackerToRightImagePlate(Transform3D t)
     Sets the head-tracker coordinate system to right image-plate coordinate system transform.
public  voidsetPhysicalScreenHeight(double height)
     Sets the screen physical height in meters.
public  voidsetPhysicalScreenWidth(double width)
     Sets the screen physical width in meters.
public  voidsetSize(int width, int height)
     Sets the width and height (in pixels) of this off-screen Screen3D.
public  voidsetSize(Dimension d)
     Sets the width and height (in pixels) of this off-screen Screen3D.
public  voidsetTrackerBaseToImagePlate(Transform3D t)
     Sets the tracker-base coordinate system to image-plate coordinate system transform.
public  StringtoString()
    
 voidupdateViewCache()
     Update the view cache associated with this screen.

Field Detail
HEAD_TRACKER_TO_IMAGE_PLATE_DIRTY
final static int HEAD_TRACKER_TO_IMAGE_PLATE_DIRTY(Code)



PHYSICAL_SCREEN_SIZE_DIRTY
final static int PHYSICAL_SCREEN_SIZE_DIRTY(Code)



SCREEN_SIZE_DIRTY_DIRTY
final static int SCREEN_SIZE_DIRTY_DIRTY(Code)



TRACKER_BASE_TO_IMAGE_PLATE_DIRTY
final static int TRACKER_BASE_TO_IMAGE_PLATE_DIRTY(Code)



activeViews
UnorderList activeViews(Code)



canvasCount
int canvasCount(Code)



deviceRendererMap
static Hashtable deviceRendererMap(Code)



display
long display(Code)



graphicsDevice
GraphicsDevice graphicsDevice(Code)



headTrackerToLeftImagePlate
Transform3D headTrackerToLeftImagePlate(Code)



headTrackerToRightImagePlate
Transform3D headTrackerToRightImagePlate(Code)



offScreen
boolean offScreen(Code)



physicalScreenHeight
double physicalScreenHeight(Code)



physicalScreenWidth
double physicalScreenWidth(Code)



renderer
Renderer renderer(Code)



scrDirtyMask
int scrDirtyMask(Code)



screen
int screen(Code)



screenSize
Dimension screenSize(Code)



screenViewCache
ScreenViewCache screenViewCache(Code)



trackerBaseToImagePlate
Transform3D trackerBaseToImagePlate(Code)



users
ArrayList users(Code)




Constructor Detail
Screen3D
Screen3D(GraphicsConfiguration graphicsConfiguration, boolean offScreen)(Code)
Construct a new Screen3D object with the specified size in pixels. Note that currently, there is no AWT equivalent of screen so Java 3D users need to get this through the Canvas3D object (via getScreen()) if they need it.
Parameters:
  graphicsConfiguration - the AWT graphics configuration associatedwith this Screen3D
Parameters:
  offScreen - a flag that indicates whether this Screen3D isassociated with an off-screen Canvas3D




Method Detail
activeViewEmpty
boolean activeViewEmpty()(Code)



addActiveView
void addActiveView(View v)(Code)



addUser
synchronized void addUser(Canvas3D c)(Code)



decCanvasCount
synchronized void decCanvasCount()(Code)
Decrement canvas count, kill renderer if needed



getHeadTrackerToLeftImagePlate
public void getHeadTrackerToLeftImagePlate(Transform3D t)(Code)
Retrieves the head-tracker coordinate system to left image-plate coordinate system transform and copies it into the specified Transform3D object.
Parameters:
  t - the object that will receive the transform



getHeadTrackerToRightImagePlate
public void getHeadTrackerToRightImagePlate(Transform3D t)(Code)
Retrieves the head-tracker coordinate system to right image-plate coordinate system transform and copies it into the specified Transform3D object.
Parameters:
  t - the object that will receive the transform



getPhysicalScreenHeight
public double getPhysicalScreenHeight()(Code)
Retrieves the the screen's physical height in meters. the screen's physical height in meters



getPhysicalScreenWidth
public double getPhysicalScreenWidth()(Code)
Retrieves the screen's physical width in meters. the screen's physical width in meters



getSize
public Dimension getSize()(Code)
Retrieves the width and height (in pixels) of this Screen3D. a new Dimension object containing the width and heightof this Screen3D.



getSize
public Dimension getSize(Dimension rv)(Code)
Retrieves the width and height (in pixels) of this Screen3D and copies it into the specified Dimension object.
Parameters:
  rv - Dimension object into which the size ofthis Screen3D is copied.If rv is null, a new Dimension object is allocated. rv
since:
   Java 3D 1.2



getTrackerBaseToImagePlate
public void getTrackerBaseToImagePlate(Transform3D t)(Code)
Retrieves the tracker-base coordinate system to image-plate coordinate system transform and copies it into the specified Transform3D object.
Parameters:
  t - the object that will receive the transform



incCanvasCount
synchronized void incCanvasCount()(Code)
Increment canvas count, initialize renderer if needed



notifyUsers
synchronized void notifyUsers()(Code)



removeActiveView
void removeActiveView(View v)(Code)



removeUser
synchronized void removeUser(Canvas3D c)(Code)



setHeadTrackerToLeftImagePlate
public void setHeadTrackerToLeftImagePlate(Transform3D t)(Code)
Sets the head-tracker coordinate system to left image-plate coordinate system transform. This transform is typically a calibration constant. This is used only in HMD_VIEW mode.
Parameters:
  t - the new transform
exception:
  BadTransformException - if the transform is not rigid



setHeadTrackerToRightImagePlate
public void setHeadTrackerToRightImagePlate(Transform3D t)(Code)
Sets the head-tracker coordinate system to right image-plate coordinate system transform. This transform is typically a calibration constant. This is used only in HMD_VIEW mode.
Parameters:
  t - the new transform
exception:
  BadTransformException - if the transform is not rigid



setPhysicalScreenHeight
public void setPhysicalScreenHeight(double height)(Code)
Sets the screen physical height in meters. In the case of a head-mounted display, this should be the apparent height at the focal plane.
Parameters:
  height - the screen's physical height in meters



setPhysicalScreenWidth
public void setPhysicalScreenWidth(double width)(Code)
Sets the screen physical width in meters. In the case of a head-mounted display, this should be the apparent width at the focal plane.
Parameters:
  width - the screen's physical width in meters



setSize
public void setSize(int width, int height)(Code)
Sets the width and height (in pixels) of this off-screen Screen3D. The default size for off-screen Screen3D objects is (0,0).
NOTE: the size must be set prior to rendering to the associated off-screen canvas. Failure to do so will result in an exception.
Parameters:
  width - the new width of this Screen3D object
Parameters:
  height - the new height of this Screen3D object
exception:
  IllegalStateException - if this Screen3D is not inoff-screen mode.
since:
   Java 3D 1.2



setSize
public void setSize(Dimension d)(Code)
Sets the width and height (in pixels) of this off-screen Screen3D. The default size for off-screen Screen3D objects is (0,0).
NOTE: the size must be set prior to rendering to the associated off-screen canvas. Failure to do so will result in an exception.
Parameters:
  d - the new dimension of this Screen3D object
exception:
  IllegalStateException - if this Screen3D is not inoff-screen mode.
since:
   Java 3D 1.2



setTrackerBaseToImagePlate
public void setTrackerBaseToImagePlate(Transform3D t)(Code)
Sets the tracker-base coordinate system to image-plate coordinate system transform. This transform is typically a calibration constant. This is used only in SCREEN_VIEW mode.
Parameters:
  t - the new transform
exception:
  BadTransformException - if the transform is not rigid



toString
public String toString()(Code)



updateViewCache
void updateViewCache()(Code)
Update the view cache associated with this screen.



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.