Page locked

This page is currently locked for editing by another user. You have to wait until this user finishes editing or the lock expires.
Currently locked by: 2a03:2880:f800:13::
Lock expires at: 2026/06/19 17:01 (3 min)
This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== 3D Viewer ====

{{../Resources/Images/Master_Document_03282019_next/3D_Viewer_58x83.png}}

{{../Resources/Images/Master_Document_03282019_next/3D_Viewer_1_329x167.png}}

Draws 3D layout plots of the lens system. The algorithm draws a wireframe style representation of the lens. There are Graph view and Classic view available, which can be toggled at the lower left corner if Classic view is turned on. The Classic view can be turned on or off in the Setup tab > Project Preferences > Graphics > Enable Classic View.

{{../Resources/Images/Master_Document_03282019_next/3D_Viewer_2_473x680.png}}

**First Surface**%% %%The first surface to be drawn.

**Last Surface**%% %%The last surface to be drawn.

**Wavelength**%% %%Either any one or all wavelengths may be shown.

**Field%% %%**Either any one or all field positions may be shown.

**Number of Rays**%% %%The number of rays specifies the number of rays to be drawn for each selected field and wavelength. The rays will be evenly distributed along the fan of the pupil, or around the perimeter if Ring is the selected Ray Pattern, or unless%% apodization %%has been specified. This parameter may be set to zero. It is ignored if the Ray Pattern is set to List.

**Ray Pattern**%% %%Choose XY Fan, X Fan, Y Fan, Ring, List, Random, or Grid to indicate what the pattern of rays to be traced should be. The List option indicates that the rays to be traced are user defined and listed in a file, see the discussion below for information on the ray list format. If List is selected the Number of Rays setting is ignored.

**Scale Bar**%% %%(in Graph view) If Scale Bar is set to On, then a scale bar will be displayed at the bottom of the window. The scale bar will be automatically adjusted when the layout is zoomed in or out.

**Scale Factor**%% %%(in Classic view) If the scale factor is set to zero, then "Fill Frame" will be selected, which will scale the range of surfaces drawn to fill the graphic page. If a numeric value is entered, then the plot will be drawn in "real" scale, times the scale factor. For example, a scale factor of 1.0 will plot the lens actual size on the printer (not the display). A factor of 0.5 will plot the lens at half scale.

**Hide Lens Faces**%% %%If checked, this option will suppress drawing of the lens faces, and only the lens edges will be drawn. This is useful because some complicated systems look cluttered with the faces drawn.

**Hide Lens Edges**%% %%If checked, this option will suppress drawing of the outer aperture of the lens. This is useful for giving the 3D layout a 2D "cross section" appearance.

This option does not apply to the user-defined apertures and obscurations.

**Hide X Bars**%% %%If checked, this option will suppress drawing of the X portions of the lens faces. This option is useful when "Hide Lens Edges" is checked and "Hide Lens Faces" is not checked.

**Rotation About X**%% %%The angle in degrees by which the lens appears to be rotated about the X axis.

**Rotation About Y**%% %%The angle in degrees by which the lens appears to be rotated about the Y axis.

**Rotation About Z**%% %%The angle in degrees by which the lens appears to be rotated about the Z axis.

**Color Rays By**%% %%For sequential rays, "Field #" will use color to distinguish between each field position, "Wave #" to distinguish between each wavelength, "Config #" to distinguish between configurations, and "Wavelength" to approximate the color of wavelengths in the visible spectrum.

For non-sequential rays "Field #" will use color to distinguish between each source number, unless a source has a user defined color assigned to that source.

**Suppress Frame**%% %%Suppresses drawing of the frame on the bottom of the window, which leaves more room for the layout plot itself. No scale bar, address block, or other data will be displayed.

**Delete Vignetted**%% %%If checked, rays are not drawn if they will be vignetted by any surface.

**Configuration**%% %%This option is activated when more than one configuration is used. Select "All" to show all configurations, "Current" to show just the%% active configuration%%, or select any combination of other configurations.

**Offset X, Y, Z**%% %%This option is activated when more than one configuration is used. The X, Y, and Z direction offset between configurations in%% lens units%%. Only has an effect on the drawing if "All" configurations are being drawn.

**Fletch Rays**%% %%If checked, small arrows are drawn on each ray to indicate the direction of propagation.

**Split%% NSC %%Rays**%% %%If checked, rays from NSC sources will be statistically split at ray-surface intercepts. Rays entering from the entry port are not affected by this setting.

**Scatter NSC Rays**%% %%If checked, rays from NSC sources will be statistically scattered at ray-surface intercepts. Rays entering from the entry port are not affected by this setting.

**Discussion**

Pressing the left, right, up, down, Page Up, or Page Down keys will rotate the displayed image for a different perspective.

**The orientation indicator%% %%**To create the layout, OpticStudio projects the 3D coordinates of the rotated optical model onto the 2D plane of the plot. Conceptually, the optical model is first rendered in an unrotated 3D space, with +z oriented to the right, +y up, and +x away from the viewer into the page.

The coordinates and orientations of all surfaces and objects are defined by the Global Coordinate Reference Surface (set in the Surface Properties Dialogue).

This 3D model is then rotated by the Rotation About X, Y, and Z values specified in the settings (see%% ?Graphics (project preferences)%%? for information about the rotation order).

The resulting 3D model is then projected onto a 2D plane by plotting the z coordinate along the horizontal direction and the y coordinate along the vertical direction; the x coordinate is ignored.

To help visually define the orientation of the model, an orientation indicator is shown in the bottom left hand corner of the drawing. This indicator consists of 3 lines extending along the directions of the +x, +y, and +z axes of the global coordinate reference surface. These 3 lines rotate as the drawing is rotated. If the coordinates of the 3D orientation indicator lines lie in the plane of the drawing, or would extend out (toward the viewer), they are drawn in black. If the orientation indicator lines would extend in (away from the viewer) then the lines are drawn in grey.

**Ray errors%% %%**If rays miss a surface, then the rays will not be drawn to the surface where the error occurred. If the ray is total internal reflected, then the ray will be drawn up to but not past the surface where the error occurred. Ray failures can be evaluated in detail by using ?Ray Trace?. These comments only apply to rays from the sequential object surface, and not to rays from NSC sources.

**Configuration data%% %%**When drawing all configurations, an offset may be added to each configuration in the x, y, and z directions independently. The offsets may all be zero if desired. If the offsets are zero, then all the configurations are superimposed; otherwise, the configurations are all displaced from one another by the specified amount. Note that all offsets are defined from the global coordinate reference surface position. The global coordinate reference surface is defined in the Miscellaneous section of the System Explorer. If all offsets are zero, the multiple configurations are all overlapped at the global coordinate reference surface.

**Raylist file format%% %%**If List is chosen for the ray pattern, the rays to be traced are defined in a file. The file must be called RAYLIST.TXT and be placed in the <data>\Miscellaneous folder. The file format is ASCII, with two distinct methods for defining the rays supported, implicit and explicit. The implicit format file consists of two numbers on each line, one for the p<sub>x</sub>%% %%and one for the p<sub>y</sub>%% normalized pupil coordinates%%. The specified rays are traced at each defined field and wavelength selected.

Example: Four marginal rays are defined by:

0.0 -1.0

0.0 1.0

-1.0 0.0

1.0 0.0

The explicit format file consists of the word EXPLICIT followed by the values x, y, z, l, m, n, and wavenumber; where x, y, and z are the ray starting coordinates, l, m, and n are the direction cosines, and wavenumber is an integer indicating the wavelength to use. All coordinates are in object space. If the object thickness is infinity, then the spatial coordinates are relative to surface 1. If the object is not at infinity, then the coordinates are relative to surface 0. In both cases the ray itself is in the object space medium, prior to refraction into surface 1. If explicit format is used, then the field and wavelength settings are ignored, and only those rays listed in the file are traced.

Example: Three rays at wavelengths 1, 2, and 3 along the Y axis parallel to the Z axis are defined as follows:

EXPLICIT

0.0 -5.0 0.0 0.0 0.0 1.0 1

0.0 +0.0 0.0 0.0 0.0 1.0 2

0.0 +5.0 0.0 0.0 0.0 1.0 3

**Next:**

Shaded Model\\