HDS ViewStation System Administrator's Guide

A Hypertext Document

PEX 3D Server Extensions for the ViewStation

PEX 3D Server Extension
This section describes the PEX-3D server extension. Note that this is an extension of the server code rather than a local client. This extension is loaded with entries in the clients.config file, described in ViewStation's Client's Configuration File.

PEX-3D Extension V1.0 Introduction
This extension is based on the X Consortium PEX 5.1 protocol standard. The PEX extension is a 3-D graphics extension to the HDSware X11 server.

Installation of the HDS PEX-3D Extension

The PEX extension is a downloaded extension controlled by the "hds.serverExtensions" resource in the /FXUtilities/hds-fx/config/clients.config file. There are two files, named X3D-PEX-Vnn and X3D-PEX-Vnn-D, which are located in /FXUtilities/hds-fx/extensions. These files are for use with ViewStation server versions Vnn.hds and Vnn-D.hds respectively. These two versions of the ViewStation's server code differ in their ability to download local clients (designated by the -D option). The appropriate PEX-3D extension files can be used with either version since these extensions are loaded as an integral part of the server code.

HDS PEX-3D utilizes the PEX_FONTPATH environment variable to set the PEX font path which is separate from the X11 font path. The default value is set to /FXUtilities/hds-fx/fonts/PEX which contains two compressed PEX fonts, Roman and Roman_m.

The PEX-3D extension requires the NFS file transfer protocol in order to read fonts. In addition the extension needs to read the Roman font in order to initialize. This means that the user would need to set the HDSware Host Access Protocol to NFS prior to starting the server.

ViewStation Requirements
The PEX-3D extensions are available with the HDSware 3.2.

HDS PEX-3D is supported on all Viewstation architectures. While it is possible to load the HDS PEX-3D extension with the Vnn.hds (non-downloadable) server version into a ViewStation containing only 4 MB of memory there is only about 500 KB of memory left. It is recommended that at least 8MB of memory be installed on the ViewStation when using the PEX-3D extension.

HDS PEX-3D Limitations

• Interior styles "Pattern" and "Hatch" are not supported. These styles will be rendered using the "Solid" interior style.
• PickOne methods "ClosestZ", "VisibleAny", and "VisibleClosest" are not supported. These methods will default to "Last".
• PickAll method "Visible" is not supported. This method will default to "All".
• Curve approximation methods "DC_ChordalSize", "DC_ChordalDev", "WCS_ Relative", "NPC_Relative", and "DC_Relative" are not supported. These methods are rendered as Implementation Dependent which defaults to ConstantBetweenKnots with a tolerance of 10.0.
• Surface interpolation methods "DotProduct" and "Normal" are not supported. These methods default to the "Color" (Gouraud).
• Surface approximation methods "DC_ChordalSize", "DC_ChordalDev", "WCS_Relative", "NPC_Relative", and "DC_Relative" are not supported. These methods are rendered as Implementation Dependent which defaults to ConstantBetweenKnots with a tolerance of 10.0 for u and v.
• Color types "CIEFloat", "HDSVFloat", "HLSFloat", "RGBInt8", and "RGBInt16" are not supported. Attempts to use these types will result in a ColorTypeError.
• Float formats "IEEE_754_64", and "DEC_D_Floating" are not supported.
• HLHSR modes "ZBufferId", "HiddenLineOnly", "Scanline", and "Painters" are not supported. These modes default to "Off".
• Prompt echo types "EchoStructure" and "EchoNetwork" are not supported. The types default to "EchoPrimitive".
• Color approximation types "CIE", "HSV", "HLS" and "YIQ" are not supported. Attempts to use these types will exit with a BadValue.
• "gdp", "gdp3", and "gse" types are not supported.
• Rendering color models "CIE", "HSV", and "HLS" are not supported. Requests to use these models will silently exit.
• Parametric surface characteristics "MC_LevelCurves", and "WC_Levelcurves" are not supported. These types will default to "None".
• Transparency is not supported.

HDS PEX-3D Functional Description
These are the HDS PEX-3D supported Enumerated Types

• Marker Type - there are 5 marker types supported.
  1. Dot
  2. Cross
  3. Asterisk
  4. Circle
  5. X
• Annotation text style - there are two types supported.
  1. Not Connected
  2. Connected
• Interior Style - there are three types supported.
  1. Hollow
  2. Solid
  3. Empty
• Line Type - there are four types supported.
  1. Solid
  2. Dashed
  3. Dotted
  4. DashDot
• Pick Device Type - there are two types supported.
  1. DC_HitBox
  2. NPC_HitVolume
• Pick One Methods - there are two types supported.
  1. 1
  2. Last
• Pick All Methods - there are two types supported.
  1. 1
  2. All
• Polyline Interpolation Methods - there are 2 types supported.
  1. None
  2. Color
• Curve Approximation Method - there are 6 types supported.
  1. Implementation Dependent - HDS PEX-3D utilizes the ConstantBetweenKnots method with a tolerance of 10.0
  2. ConstantBetweenKnots
  3. WCS_ChordalSize
  4. NPC_ChordalSize
  5. WCS_ChordalDev
  6. NPC_ChordalDev
• Reflection Methods - there are four types supported.
  1. NoShading
  2. Ambient
  3. Diffuse
  4. Specular
• Surface Interpolation Methods - there are two types supported.
  1. None
  2. Color
• Surface Approximation Methods - there are 6 types supported.
  1. Implementation Dependent - HDS PEX-3D utilizes the ConstantBetweenKnots method with u and v tolerances of 10.0
  2. ConstantBetweenKnots
  3. WCS_ChordalSize
  4. NPC_ChordalSize
  5. WCS_ChordalDev
  6. NPC_ChordalDev
• Trim Curve Approximation Methods - there are 2 methods supported.
  1. Implementation Dependent - HDS PEX-3D utilizes the ConstantBetweenKnots method with a tolerance of 10.0
  2. ConstantBetweenKnots
• Model Clip Operator - there are two types supported.
  1. Replace
  2. Intersection
• Light Types - there are 4 types supported.
  1. Ambient
  2. WCS_Vector
  3. WCS_Point
  4. WCS_Spot
• Color Type - there are two types supported.
  1. Indexed
  2. RGBFloat
• Float Format - there are two formats supported.
  1. IEEE_754_32
  2. DEC_F_Floating
• HLHSR modes - there are 2 modes supported.
  1. Off
  2. ZBuffer
• Prompt Echo Type - there is one type supported.
  1. EchoPrimitive.
• Display Update Modes - there are 5 modes supported.
  1. VisualizeEach
  2. VisualizeEasy
  3. VisualizeNone
  4. SimulateSome
  5. VisualizeWhenever
• Color Approximation Types - there are two types supported.
  1. ColorSpace
  2. ColorRange
• Color Approximation Models - there is one model supported.
  1. RGB
• Escapes - one escape is supported.
  1. "SetEchoColor"
• Rendering Color Models - there is one model supported.
  1. RGB
• Parametric Surface Characteristics - there are three types supported.
  1. None
  2. Implementation Dependent - HDS PEX-3D utilizes IsoparametricCurves with the number of u and v curves set to 20.
  3. IsoparametricCurves

HDS PEX-3D Implementation Dependent Constants

Name					Value
Dithering 				True
Maximum Edge Width			~((unsigned long)0)
Minimum Edge Width			1
Nominal Edge Width			1
Supported Edge Widths			~((unsigned long)0)
Maximum Line Width			~((unsigned long)0)
Minimum Line Width			1
Nominal Line Width			1
Supported Line Widths			~((unsigned long)0)
Maximum Marker Size			~((unsigned long)0)
Minimum Marker Size			1
Nominal Marker Size			1
Supported Marker Sizes			~((unsigned long)0)
Model Clip Planes			64
Name Set Names				256
Max Non Ambient Lights			64
Maximum Nurb Order			10
Maximum Trim Curve Order		6
Best Color Approximation Values 	ColorApproxAnyValues
Transparency support			False
Double Buffering support		True
Max Hits Event Support			True
ChromaticityRedU			0.628
ChromaticityRedV			0.346
LuminanceRed				1.0
ChromaticityGreenU			0.268
ChromaticityGreenV			0.588
LuminanceGreen				1.0
ChromaticityBlueU			0.150
ChromaticityBlueV			0.070
LuminanceBLue				1.0
ChromaticityWhiteU			0.313
ChromaticityWhiteV			0.329
LuminanceWhite				1.0

HDS PEX-3D Lookup Tables

Name		Maximum # of Entries		# Predefined
Line Bundle		20				1
Marker Bundle		20				1
TextBundle		20				1
Interior Bundle		20				1
Edge Bundle		20				1
Pattern			0				0
Color			256				8
TextFont		4 				1
View			6				1
Light			16				1
Depth Cue		6				1
ColorApprox		6				1

HDS PEX-3D Lookup Table default predefined values

Name					Index	Values
LineBundle				0
Line Type					1
polyline_interp					1
curve_approx					1
curve_tolerance					1.0
Line Width					1
line_color type					indexed
line_color index				1	

MarkerBundle				0
marker_type					asterisk
marker_scale					1.0
marker_color type				indexed
marker_color index				1

TextBundle				1
textFontIndex					1
textPrecision					StringPrecision
charExpansion					1.0
charSpacing					0.0
textColor type					indexed
textColor index					1

InteriorBundle				1
interiorStyle					InteriorStyleHollow
interiorStyleIndex				1
reflectionModel					ReflectionNoShading
surfaceInterp					SurfaceInterpNone
bfInteriorStyle					InteriorStyleHollow
bfInteriorStyleIndex				1
bfReflectionModel				ReflectionNoShading
surfaceApprox.approxMethod			1
surfaceApprox.uTolerance			1.0
surfaceApprox.vTolerance			1.0
surfaceColor type				indexed
surfaceColor index				1
bfSurfaceColor type				indexed
bfSurfaceColor index				1
reflectionAttr.ambient				1.0
reflectionAttr.diffuse				1.0
reflectionAttr.specular				1.0
reflectionAttr.specularConc 	 		0.0
reflectionAttr.transmission 	 		0.0
reflectionAttr.specularColor type 		indexed
reflectionAttr.specularColor index	 	1
bfreflectionAttr.ambient			1.0
bfreflectionAttr.diffuse			1.0
bfreflectionAttr.specular			1.0
bfreflectionAttr.specularConc 	 		0.0
bfreflectionAttr.transmission 	 		0.0
bfreflectionAttr.specularColor type		indexed
bfreflectionAttr.specularColor ind	 	1

Edge Bundle				1
edges 						off
edgeType					SurfaceEdgeSolid
edgeWidth					1.0
edgeColor type					indexed
edgeColor index					1

TextFont				1
numFonts					1
font						defaultFont (Roman)	
(16 character set id's allowed per Font group)

View					0
clipFlags					ClipXY|ClipBack|ClipFront
clipLimits					(0.0,0.0,0.0),(1.0,1.0,1.0)
orientation					identity matrix
mapping	 					identity matrix

Light					1
lightType					Ambient
direction					(0.0,0.0,0.0)
point						(0.0,0.0,0.0)
concentration					0.0
spreadAngle					0.0
attenuation1					0.0
attenuation2					0.0
lightColor type					RgbFloat
lightColor red					1.0
lightColor green				1.0
lightColor blue					1.0

DepthCue				0
mode						Off
frontPlane					1.0
backPlane					0.0
frontScaling					1.0
backScaling	 				0.5
depthCueColor type				indexed
depthCueColor index				1	

Color Approximation			0
approxType					ColorSpace
approxModel					ColorApproxRGB
max1						5
max2						5
max3	 					5
dither						Off
mult1	 					1
mult2						6
mult3						36
weight1						1.0
weight2						1.0
weight3						1.0
basePixel					16


Color					0
Index		Type		Red	Green	Blue
0		RgbFloat	0.0	0.0	0.0
1		RgbFloat	1.0	1.0	1.0
2		RgbFloat	1.0	0.0	0.0
3		RgbFloat	0.0	1.0	0.0
4		RgbFloat	0.0	0.0	1.0
5		RgbFloat	1.0	1.0	0.0
6		RgbFloat	0.0	1.0	1.0
7		RgbFloat	1.0	0.0	1.0

Return to Section Heading Page

Return to the Home Page

If you need more information than is available here, you can reach HDS via email at info@hds.com, or call us at 1.800.HDS.1551 in the USA, or at +610.277.8300 from outside the US. For questions or problems regarding the HDS WWW page, contact webmaster@hds.com.
© 1996 by HDS Network Systems Inc.