WWW.DANCAD3D.COM (sm): THE OFFICIAL DANCAD3D (tm) "BETA TEST" WEB SITE.

TERMS OF USE, HOME, INDEX, SHORTCUT, WHAT'S NEW, DOWNLOADS, GET MAIN ZIP, DOCUMENTATION, VIDEO, HOOKUP#1, #2, #3, KEYWORDS

FEATURE FILM 4K+ DIGITAL CINEMA UNCOMPRESSED EDITING AND SOUND MIXING
PLUS DIY MOVIE 35mm FILM SCANNING AND DIY 35mm FILM RECORDER SOFTWARE.

DANCAD3D (tm) DRAWING EDITOR, click on image for more info. and larger images. 3D ROBOTIC ANIMATION, click on image for more info. and larger images. 3D CONTOUR SURFACE, click on image for more info. and larger images. 3D CAM TOOL PATH, click on image for more info. and larger images. STEPPER MOTORS FOR CAM, click on image for more info. and larger images. DANCAM.EXE (tm) OPERATING 3D MILL, click on image for more info. and video. IM HELP STATUS, click on image for more info. and IM address.
Kodak (tm) LAD film negative scan image made with Canon XTi (tm) DSLR. Kinema Edit list Grading Levels #1 color correction tool . Kinema Edit list Grading Curves #1 color correction tool. Kinema Edit list Grading chroma Masking tool Vector display. Kinema Edit list Grading chroma Masking tool Waveform display. Kinema Edit list Grading Sharp/Soft filter tool. Kodak (tm) LAD image color corrected positive.
Click on these thumbnails for related information about my current software, features, and IM support. Hold [Shift] and click [Reload] to refresh IM thumbnail.

If are helping "Beta Test" you should report bugs and feel free to ask questions about the program's commands, it is best to email me at tempnulbox (at) yahoo (dot) com and put "DANCAD3D (tm) 24x7 SUPPORT SUBMISSION" in the email subject line so your mail is not deleted as junk. See Section: 8 for more information about support related issues. I want you to ask questions so long as they are on the subject and relate to the current program's commands. If you do not get some kind of reply assume I did not get your message and resend it and also try voice mail, postal form, etc. All submissions and correspondence become the sole property of Daniel H. Hudgins to do with as he sees fit, so stay on subject.

SECTION: 3.3.7.8
Revised INFOV27H.TXT text for upgrading to v2.7H.
This Section, About DANCAD3D.ZIP (tm), and Text from INFOV27H.TXT.

Copyright (C) 1986-2008 by Daniel H. Hudgins, All Rights Reserved.

No part of "This Web Site" (HTML document), including associated files, may be: distributed, sublicensed, transmitted, copied, archived, mirrored, modified, bundled, embedded, sold, given away, rented, loaned, or shared in any form without express written permission in a formal Vendor agreement contract dated and signed in ink obtained directly from Daniel H. Hudgins by registered postal mail. All agreements for permission to distribute expire after a period no greater than one year from the date of the signing of the agreement by Daniel H. Hudgins. See the current "EULA" for information regarding limited copying and storage for the purpose of "Beta Testing" "This Web Site."

To view or use the current version of this Web page you may need to reload or refresh the display of this page by your browser. Just clicking on the browser's [Reload] or [Refresh] icon may not be enough to insure that all of the page's most current contents have been cached and displayed. Some browsers may have additional commands to help display the page's most current contents such as: holding down the [Shift] key and clicking on the [Reload] icon, holding down the [Control] key and clicking on the [Refresh] icon, holding down the [Control] and [Shift] keys and clicking on the [Refresh] icon, pressing the [Control] and [F5] keys, pressing [Control] and the [R] key, or some other combination of keys or clicks. Check to see which commands your HTML browser uses to load the most current page contents into its cache and then to display them onto the screen.

This Web site is dedicated to the thousands of "users" of my programs, those who have helped test my programs over the last 22 or so years, and especially those who shared their experiences with me.

You must read this notice: This is a licensed Web site (HTML document and associated files). You must read and agree to be legally bound in contract by the Terms of Use and conditions given in the End User License Agreement ("EULA"), Legal Notices, Instructions, Warnings, Disclaimers, and all other text in "SECTION: 0" of "This Web Site" (HTML document and associated files) before reading or using any of the information, software programs, and or files, contained in, linked to, and or associated with, "This Web Site" (HTML document and associated files). Any use or "Beta Testing" of "This Web Site" constitutes your acknowledgment of your full agreement with the current End User License Agreement ("EULA") and your decision to have this current license supersede all prior and contemporaneous agreements and understandings. Information and files in "This Web Site" (HTML document and associated files) have been placed here so that long time users of "The Author's" programs DANCAD3D.COM (tm) , DANCAM.EXE (tm) , or DANPLOT.EXE (tm) could help proofread the text of the documentation files or screens displayed, and also help test data files, example files, and or any software programs that might be made available from time to time, to aid "The Author" in finding mistakes, bugs, and other errors, omissions, defects, mistakes, and faults. Everything in "This Web Site" (HTML document and associated files) is "Beta Test", "Beta Code", Experimental, Preliminary, requires proofreading, or is being evaluated for possible revision, and is NOT warranted to be free of defect. To help "The Author" report any bugs, foul-ups, defects, or mistakes that you find, see "SECTION: 8" for instructions. "This Web Site" (HTML document and associated files) and all other files and programs by Daniel H. Hudgins are made available "AS IS" without warranty of any kind express, expressed, or implied. All offers and specifications are subject to change or discontinuation without notice of any kind. Please read "SECTION: 8" of "This Web Site" (HTML document and associated files) before trying to contact "The Author."


Click here to go back to SECTION 3.0.0.0 Index for documentation pages.
Click here to go back to SECTION 3.3.0.0 Index for update documentation pages.
Click here to go back to SECTION 3.3.7.0 Index for update v2.7 documentation pages.
Click here for top of DANCAD3D.COM (tm) Web site home page or here for home page INDEX.
Click here to check the current internet document if you are viewing this from a disk copy.
Note: If you want to go back to the previous link use the [Back] button in your browser.

This Section.

This section has text mostly about revisions to the "Beta Test" version v2.7H of my CAD and v2.74 CAM programs, and might be looked to for updated information relating to changes from v2.7G, regarding some of the revised or added program features. There may be changes made in versions subsequent to the revisions of the version of v2.7H that alter what is described in this section as it applies to that subsequent version. See also any other documentation files, and pages in this Web site (HTML document) for additional and or any more recent information.

The HTML documentation in this SECTION: 3.3.7.8 was derived from the text in the file INFOV27H.TXT that is, or was at one time, included in my *.ZIP file archive DANCAD3D.ZIP (tm). You may find the current revision of DANCAD3D.ZIP (tm) to download by going to SECTION: 9.70.51.0. My file DANCAD3D.ZIP (tm) may also archive some other types of files like the ones described in this section, so check the current *.ZIP file in its current revision to see what exactly might be in it.

You may not distribute, sell, rent, share, or give away these HTML documentation files or printed copies of them. You may not extract text from these HTML documentation files for distribution, sale, rent, sharing, or giving away. You can use the [Print] option in your browser to make one copy for yourself to mark up in order to help me proofread the text for mistakes.

Documents may be available to download from time to time, you can check SECTION: 9 to see what the current situation with regard to downloadable files is. The names of these documentation files may change, and they may be edited, combined, or eliminated in the future, without notice.

You may need to adjust your browser for best viewing of the pre- formatted text by changing the "font" size using the commands in your browser (see the help in your browser, or use the pull-down menus in your HTML browser.) If some letters in words on the screen appear to be missing or scrambled try changing the font size in your browser as this sometimes happens even though the words are spelled correctly in the HTML code.

Use the "Edit, Find in page Ctrl+F" or "Edit, Find (in this page)... Ctrl+F" command in your browser to search for keywords within the documentation text in this HTML page. You will need to search over again in the other pages in this HTML document for the same keyword since your browser may not search for a keyword beyond the current page that is loaded.

Click here to go back to the top of this page.

About DANCAD3D.ZIP (tm).

My current file DANCAD3D.ZIP (tm) is a *.ZIP file that holds the current "Beta Test" versions of my programs and associated files for "Beta Testing." This section refers to the preliminary revision of the v2.7H version of the programs, look for other sections or documentation relating to any subsequent revisions.

The use and copying of these programs and files are governed by my current Terms of Use and End User License Agreement ("EULA") which are located in SECTION: 0 of this "Beta Test" Web site. You must read and fully agree to be legally bound by the current End User License Agreement ("EULA") before you use or "Beta Test" any of the files in my file DANCAD3D.ZIP (tm). If you are unable to read and agree to the current End User License Agreement ("EULA") do not use or "Beta Test" any of the files in my program distribution, the DANCAD3D.ZIP (tm) archive file.

Be sure that you scan the programs and files in my DANCAD3D.ZIP (tm) for virus or other contamination since you are responsible for checking them before you use them. These programs and this information are made available "AS-IS" and are without warranty of any kind express, expressed, or implied. Since these programs are "Beta Test" you must agree to become a "Beta Tester" before you make any use of them, see the End User License Agreement ("EULA") in this "Beta Test" Web site for more information. Be sure to read the current instructions in this "Beta Test" Web site regarding procedures for reporting program bugs and other such problems.

On some systems the *.ASC data files, or *.MAC macro files, may be able to be renamed *.TXT to avoid certain kinds of file type misinterpretation by text editor type programs and such. Thank you for helping test these "Beta Test" CAD and CAM programs.

A *.TXT file version, similar to some of the text in this S0303078.HTM Section, may be included in the v2.7H revision of my DANCAD3D.ZIP (tm) file (see the "downloads" SECTION: 9 of this "Beta Test" Web site). See the text in any files like README.*, FILES.TXT, and INFOV27H.TXT stored in my current DANCAD3D.ZIP (tm). You should check for the current types of document files because they may be more up-to-date than this *.HTM file, or it is possible that this HTML file could be more up to date, depending on which one got worked on last.

Click here to go back to the top of this page.

Text from INFOV27H.TXT.

Below is text from file INFOV27H.TXT that was written to be included in a preliminary revision of version v2.7H of my DANCAD3D.ZIP (tm) distribution for preliminary information about changes in version v2.7H of the CAD and v2.74 of the CAM programs. You should read this information before you try to use or "Beta Test" the revised programs. This information is in addition to the previous documentation, i.e. a supplement to, and does not go into detail about many of the previously documented features, so you should therefore review the other sections and documentation as well. See also INFO16.TXT in file DANCAD16.ZIP (tm) for revisions relating to v3.7 of the programs.

The text of INFOV27H.TXT was derived from some notes I made to myself as I worked on the code for v2.7H, so you should check this document, and the other documentation, against the programs before you do any "serious" testing of the programs since there may be some differences between the descriptions here and the current state of development of commands and features in the programs. Please report any discrepancies between the documentation and the programs or files that you find. Some of the text from this section may have been incorporated into the other sections of this Web site, in doing that some of the text may have been further revised, and so may contain additional information, therefore after reading through all of this section you should also read through all of the other portions of this Web site, even those portions that might seem to be duplicates.

I have kept this preliminary information in one long file so that you can use the "find in page" feature of your HTML browser to search for a keyword relating to some new command or feature you are looking for more information about, otherwise you might have to search through more files.

See also the This Section and About DANCAD3D.ZIP (tm) sub-sections above, as well as SECTION: 9.70.0.0 and SECTION: 9.70.51.0 for more information about v2.7.


                             DOCUMENT: INFOV27H.TXT

         Copyright (C) 2003 by Daniel H. Hudgins, All Rights Reserved.

Terms of use:  This "Beta Test" document may only be used in accord and  within
the limitations imposed by the current End User License Agreement "EULA" posted
at the author's Web site www.DANCAD3D.com (sm) in file S0000000.HTM,  any other
use or copying is  prohibited.  This  document  is  provided  "AS  IS"  without
warranty of any kind express,  expressed,  or implied.  Mistakes,  errors,  and
omissions should be reported according to the instructions in SECTION: 8 of the
current "On-Line" version of my Web site www.DANCAD3D.com (sm).

Any trade marks mentioned in this document belong to their  respective  owners,
and  are  mentioned  not  as  an  endorsement  or recommendation but rather for
informational and educational purposes to enrich the discussion of the  matters
dealt with.

This preliminary document has some brief descriptions of changes made to my CAD
and  CAM programs DANCAD3D.COM (tm),  DANCAD87.COM (tm),  DANCAM.EXE (tm),  and
DANPLOT.EXE (tm) between the release of v2.7G and the "Beta  Test"  release  of
v2.7H.  This  file  is  meant  to  be included in the initial "Beta Test" v2.7H
distribution to help long time users acquaint themselves with some of the  many
changes  that  have been made to the programs.  If you are not a long time user
you will most probably need to read all of the text located at my  "Beta  Test"
Web  site  www.DANCAD3D.com (sm) before you read this document in order to make
practical use of it.  This document is not a complete list of changes  made  to
the  programs,  and may not reflect the operation of the version of the program
accompanying it in all respects.  The programs may be still undergoing  change,
so  the  results  obtained  from  any  of  the  commands  may be different than
expected,  and the operation of older commands may have changed as well.  Since
so many changes have been made to the programs you should not expect any of the
commands  to  operate  as  you  have  used  them  in  the past,  and you should
frequently back-up and save what you are working on so that  you  do  not  lose
everything  when  the program crashes.  All specifications,  descriptions,  and
instructions are subject to change without notice.

Be sure to see also the file INFO16.TXT that is in archive DANCAD16.ZIP (tm).

I would like to thank the thousands of users of my  programs  who  have  helped
"Beta Test" the many revisions of my programs since about 1986, I hope you will
enjoy checking out some of the newer program features that I have spent so many
years working on.  Best wishes for success in your projects.

---
MISCELLANEOUS NOTES ABOUT CHANGES IN CAD V2.7H NOVEMBER 27, 2003

Note: Some of the text in this description of the November 27, 2003 version may
have  been  revised  to reflect changes in later revisions,  and so may only be
relevant to those later revisions.

The main change from v2.7G to v2.7H is the addition of support for Stereoscopic
display formats in the the SVGA VESA 15, 16, 24, and 32 bpp (bit per pixel) and
BMP file output video modes.  The 32 bpp video modes only display 24  bpp,  the
extra  8  bpp  are  ancillary.  Five  new  file  utility commands were added to
manipulate and combine BMP files in various ways including but not  limited  to
making  color  images  from  multiple  scans  made  with DANPLOT.EXE (tm),  the
preparation of Stereoscopic images,  and masking or combining two BMP files  so
that a superimposed image is combined with the primary image.

Some  other  changes were made to the dithering used with VESA modes in some of
the commands.

---
CHANGES TO THE MAIN MENU PREVIEW COMMAND

The   main  menu  Preview  command  can  now  display  3D  stereoscopic  images
automatically in VESA 15, 16,  24,  or 32 bpp SVGA VESA video modes,  or output
the image to a BMP file when the BMP video mode is used.

Some  new  menus come up if you enter a stereo format code other than code zero
at the stereo format menu that comes up after the standard  perspective  values
menu.  When inside the Preview command the stereo format menu will only come up
if you are currently in a VESA 15, 16, 24, or 32 bpp SVGA video mode.  When you
are  in  BMP  video  mode the command dumps you back at the main menu after the
first image is made,  so the stereo format menu only comes up before  selecting
the  video  mode on video board configurations that do not support the required
VESA video modes, i.e. so you can select video mode BMP and make stereo images.

See the  information  about  the  various  stereoscopic  format  codes  in  the
information relating to the macro STEREO command.

After  a  stereoscopic  image  has been displayed on the screen three BMP image
files are left on the disk that you can copy if you want  to  keep  a  copy  of
them.  DANR0000.BMP has a form of the right eye image,  DANL0000.BMP has a form
of the left eye image,  and DANS0000.BMP  has  a  stereoscopic  image  combined
according to the selected stereo format code.  If you are using the VESA 15 bpp
or  16 bpp video display modes the combined image in the BMP file may be better
to use for saving the image since it is saved at 24 bpp  color  depth,  if  you
save  the  screen  as a BMP file the color depth gets converted from the screen
mode,  in this case 15 bpp or 16 bpp to 24 bpp.  If the BMP graphics video mode
is being used to bypass the video screen,  or to make an image larger than will
fit on the video screen, the combined image is sent to the filename entered for
the BMP output file and not to DANS0000.BMP,  so DANS0000.BMP may contain  some
older image and not the last one made.  The image quality of the right and left
eye image files may vary depending on which stereo format code was selected.

When  you  want  to include a stereoscopic background image you need to do some
special things with the background image  file.  If  the  last  letter  of  the
background image file name entered is a letter S, and a stereoscopic FormatCode
other  than  0  is also entered,  the program then replaces the S with R in the
background filename when making the Right eye view image,  and replaces  the  S
with  a  L  when making the Left eye view image.  If you want the same BMP file
loaded as the background image in both the Right and Left eye images  then  the
last  letter should not be a letter S,  and should be a letter M,  although any
other letter than S may work in present revisions,  in  the  future  M  may  be
required.  The  letter  S just before the period in the BMP background filename
keys stereoscopic background mode,  the letter M just before the period in  the
filename  keys  monoscopic background mode.  The filename entered with the last
letter being S does not exist,  and will not appear in the file directory,  you
would  need  to  look  for  the filename ending with R or L since those are the
names you would save the stereoscopic background images under.

Thusly:

Enter C:\MYDIR\MYBACK1S.BMP
then  C:\MYDIR\MYBACK1R.BMP is loaded for the Right eye view background,
and   C:\MYDIR\MYBACK1L.BMP is loaded for the Left eye view background.

Enter C:\MYDIR\MYBACK1M.BMP
then  C:\MYDIR\MYBACK1M.BMP is loaded for the Right eye view background,
and   C:\MYDIR\MYBACK1M.BMP is loaded for the Left eye view background.

This way of keying the background image name lets  the  program  use  just  the
usual  one  filename prompt and string variable with both stereo and non-stereo
display modes,  and lets you pick the  use  of  a  stereoscopic  or  monoscopic
background image.

To  make  the two stereoscopic background images with DANCAD3D.COM (tm) you can
use the main menu preview command to display the background elements  with  the
same  settings  and  FormatCode that the rest of the elements will be displayed
with.  After the combined stereoscopic image is made you just  make  copies  of
the two temporary eye view image files the program leaves on the disk,  so that
they can be used as the background image files later.

Use the Files Copy command off of the main menu thusly:
Source filename: DANR0000.BMP, result filename: C:\MYDIR\MYBACK1R.BMP
Source filename: DANL0000.BMP, result filename: C:\MYDIR\MYBACK1L.BMP

When making stereo backgrounds be careful about the  direction  and  amount  of
stereoscopic  disparity  since  the  background  must  appear  to be behind the
foreground  elements  to  have  the  foreground  elements  display   over   the
background,  and  the  direction  and  amount of stereoscopic disparity must be
small enough to allow the viewer to fuse the images easily.  And,  be sure that
the  various  display  values  used for the foreground are the same as when the
background was made to help make the combined rendering appear  such  that  the
foreground and background will look like they go together.

---
NEW FILE UTILITY BMP COMBINE MENU COMMANDS

The  new  File  Utility BMP Combine command from the main menu has five options
that can be used to manipulate BMP files.


COMBINE BMP_TO_BMP MODE 1:

This option takes one,  two,  or three monochrome 8 bpp BMP files and  combines
them  into  a  single  color  24 bpp BMP file.  If less than three 8 bpp source
files are used the filename for the unused colors  needs  to  be  BLACK.BMP  or
WHITE.BMP  to  fill  in the blank color while the 24 bpp is being made.  If you
use DANPLOT.EXE (tm) to scan something you can make a 8 bpp monochrome BMP file
from the NOR data file of the scan.  By making three scans you can make three 8
bpp BMP files that can then be converted into a color image with  Combine  Mode
1.  The three scans do not need to be just light filtered with red,  green, and
blue filters,  you  can  make  false  color  renderings  of  gamma-ray,  X-Ray,
ultraviolet, infrared, microwave, electromagnetic, magnetic, sonic, probe, or a
scan made with any other kind of sensor.  If you only have two scans to combine
you could use just two of the three colors,  making the other name BLACK.BMP or
WHITE.BMP,  or you could use the same source file for two of the colors and the
other  source  file for the third color.  The filenames BLACK.BMP and WHITE.BMP
are reserved words and cannot be used for source filenames.


COMBINE BMP_TO_BMP MODE 2:

This option works like the reverse of Mode 1,  it takes one color  24  bpp  BMP
file  and makes three monochrome color separation 8 bpp BMP files from it,  one
each for the red, green,  and blue portions of the color 24 bpp BMP file.  This
would  be  used  for editing or enhancing a 24 bpp BMP file,  or for extracting
some part of it.  In the case of editing or enhancing  Mode  1  would  be  used
later to put the color separation files back into one color file.


COMBINE BMP_TO_BMP MODE 3:

This  option  makes  one  8 bpp monochrome BMP file from one color 24 bpp file.
This can be used for making monochrome images using different portions  of  the
red,  green,  and  blue in the color 24 bpp file.  There are three primary uses
for this option,  1) to make a monochrome conversion of the color image,  2) to
mask two of the colors against the third while making a separation, the command
being  used  three  times  to make three masked separations,  and 3) to prepare
single images with the gray values biased for the preparation of color Anaglyph
stereograms.  This  option  uses  three  factors  to  control  the  portion  of
brightness  from each color that comes from the color image and is put into the
monochrome image file.  To make a monochrome conversion use red=0.30 green=0.59
blue=0.11.  To color mask for color  saturation  adjustment  you  use  negative
factors  for the two opposite colors,  e.g.  red=1.2 green=-0.1 blue=-0.1,  the
primary color needs to be greater than one  since  it  would  darken  from  the
subtraction  if no compensation was made.  When making Anaglyph stereograms you
sometimes want to weight the red filter eye monochrome image to have  more  red
in  it,  and  weight the cyan filter eye duochrome image to have more green and
blue in it.  To adjust the color weight you just vary the portions of the  red,
green,  and blue components always keeping the total for the portions to add up
to 1.0,  e.g.  red = 1.0 green=0 blue=0 or red=0.5 green=0.25 blue=0.25 and  so
on.


COMBINE BMP_TO_BMP MODE 4:

This option can be used to add or subtract two images, and to adjust the gamma,
contrast,  and brightness of the two images.  Just one image can be manipulated
by setting the contrast for the second image to 0.  This option might  also  be
used  in  many  other  ways.  You  might  use  this  option to adjust the gamma
correction of a color image by using it three times on the three primary  color
separations  made  using option 2 then put the gamma corrected separations back
together with option 1.  You might make high contrast images from  normal  ones
by  setting  the contrast to a large value and use the brightness value to pick
the black and white threshold point.  You might make negative images by setting
the contrast to a negative value.  To mask an image you set one image  contrast
to  a  positive  value  and  the  other  to  a  negative value,  contrast_1=1.1
contrast_2=-0.1,  the contrast_1 is greater than 1.0 because the subtraction of
the  mask  image  would make the number one image darker if no compensation was
done.  You might add two images  for  a  superimposition,  e.g.  contrast_1=0.5
contrast_2=0.5 or contrast_1=0.9 contrast_2=0.1, and so on, normally having the
sum of the contrasts for the two images being equal to 1.0 or -1.0.


COMBINE BMP_TO_BMP MODE 5:

This  option  makes a 3D stereoscopic image 24 bpp BMP file from two 24 bpp BMP
files.  The source BMP files can be ones made by DANCAD3D.COM (tm),  ones  made
with some other compatible program, compatible ones scanned from photographs or
drawings, or ones made in a digital camera.  The source BMP files are images of
the same subject viewed from the left and right eye points of view.  If you are
going  to  convert the stereogram BMP result file into a Pixel file for display
with the LOAD PIXEL or ANIMATE commands in DANCAD3D.COM (tm) the X and Y  pixel
dimensions  of the BMP result file need to be exactly the correct dimensions of
the VESA video mode that will be used when the Pixel file is loaded, e.g.  some
of  the  standard  pixel dimensions are 320x200,  640x480,  800x600,  1024x768,
1280x1024,  and 1600x1200.  Some of the stereoscopic formats available put  two
images  side-by-side or above-below so the result file will be twice as wide or
twice as high,  therefore the source files might need to be quarter size,  i.e.
half  as  wide or high,  to get the desired size in the combined image.  If you
want to convert  the  result  BMP  file  into  a  Pixel  file  for  display  in
DANCAD3D.COM  (tm)  there are options to pad the X and Y pixels out using black
on the sides or top  and  bottom.  When  the  padded  modes  are  used  in  the
stereoscopic  display  with  the macro DISPLAY command or the main menu Preview
command the images are generated half size so that the combined  image  is  the
same  size  as  the  video  mode selected,  but when you combine left and right
images that have already been saved to disk with this  command  the  result  is
twice  as big in some formats since no overall reduction of resolution is done,
and the images are kept their original size.  In some cases  the  result  image
when  padded  will be more that twice as big because the standard video size is
not simply twice as big,  for instance two 640x480 images could be adjusted  to
be  put  on one 1280x1024 padded image,  even though 480x2 is 960 and not 1024.
There are many stereoscopic formats this command can make result BMP files  in,
some  for  "free  viewing",  some  for  use with LCS shutter glasses,  some for
colored Anaglyph glasses, and a few special use types.  For more explanation of
the various stereoscopic format codes see the explanation of the  macro  STEREO
command  elsewhere in this document.  Some of the parameters available with the
STEREO command are not supported by this command since this  command  does  not
generate  the  images,  it  just  combines  image  files already generated,  in
particular the AspectComp parameter for FormatCodes 20, 40, 120, and 121 is not
present, nor are Zshift, SXshift,  EyeRot and EyeOff since they are values used
only in image generation.  The other parameters are similar in function between
this  command  and the STEREO command.  If you want to generate 3D stereoscopic
images from 3D CAD elements you can use the main  menu's  Preview  command,  or
combine the macro STEREO and DISPLAY commands.  This BMP Combine mode 5 command
can  be  used with odd size BMP files,  i.e.  not just the standard VESA screen
size images,  and so may work with stereoscopic images captured on a compatible
scanner  or  with a compatible digital camera.  Odd size images might be viewed
in some other third party  compatible  Windows  (tm)  or  Linux  (tm)  graphics
program.

---
NEW UTILITY BMP_TO_BMP MACRO COMMANDS

There  are  five  new  file UTILITY commands,  they are coded as options of the
UTILITY BMP_TO_BMP command.  They correspond to the Files Utility  BMP  Combine
command  options  one  through  five,  and are what is coded into the automatic
output macro when the output macro is used.

Option 1 combines three color separation files into one  color  file.  If  less
than  three colors are wanted the unused source files can be named BLACK.BMP or
WHITE.BMP, i.e.  those are code words to tell the program that no file is to be
loaded and to pad the non-image color with black or white.  See the explanation
of the equivalent menu command for more details.

UTILITY BMP_TO_BMP 1 f1 f2 f3 f4

Where:

f1 = Filename of source Red image mono 8 bpp BMP file.
f2 = Filename of source Green image mono 8 bpp BMP file.
f3 = Filename of source Blue image mono 8 bpp BMP file.
f4 = Filename of result color 24 bpp BMP file.

Option  2 splits up a 24 bpp color BMP file and makes three monochromatic color
separation 8 bpp BMP files, i.e. the opposite of Option 1.  See the explanation
of the equivalent menu command for more details.

UTILITY BMP_TO_BMP 2 f1 f2 f3 f4

Where:

f1 = Filename of source color 24 bpp BMP file.
f2 = Filename of result Red image mono 8 bpp BMP file.
f3 = Filename of result Green image mono 8 bpp BMP file.
f4 = Filename of result Blue image mono 8 bpp BMP file.

Option 3 makes one 8 bpp monochromatic BMP file from one color 24 bpp BMP file.
This is used to adjust the amount of each of the three  colors  in  the  source
image that goes into the result file.  This option can be used between option 2
and  option 1 for image editing,  and image processing.  See the explanation of
the equivalent menu command for more details.

UTILITY BMP_TO_BMP 3 f1 f2 r1 r2 r3

Where:

f1 = Filename of source color 24 bpp BMP file.
f2 = Filename of result mono 8 bpp BMP file.
r1 = Red factor decimal, pos or neg.
r2 = Green factor decimal, pos or neg.
r3 = Blue factor decimal, pos or neg.

Option 4 makes one 8 bpp monochromatic BMP file from two  8  bpp  monochromatic
BMP files.  This is used in image editing or processing and allows masking,  as
well as gamma, contrast, and brightness adjustments. See the explanation of the
equivalent menu command for more details.

UTILITY BMP_TO_BMP 4 f1 f2 f3 r1 r2 r3 r4 r5 r6

Where:

f1 = Filename of source file 1 mono 8 bpp BMP file.
f2 = Filename of source file 2 mono 8 bpp BMP file.
f3 = Filename of result file mono 8 bpp BMP file.
r1 = File 1 gamma factor decimal, pos. About 0.1 to 10, 1.0 makes no change.
r2 = File 1 contrast factor decimal, pos or neg. 1.0 makes no change.
r3 = File 1 brightness factor decimal, pos or neg. 0 makes no change.
r4 = File 2 gamma factor decimal, pos. About 0.1 to 10, 1.0 makes no change.
r5 = File 2 contrast factor decimal, pos or neg. 1.0 makes no change.
r6 = File 2 brightness factor decimal, pos or neg. 0 makes no change.

If you only want to process one file use the same name for file  one  and  two,
and  set  the  contrast for file two to 0.  The sum of the two contrasts should
come out to be 1.0 or -1.0 generally,  so if you  are  mixing  two  images  the
contrast  for  both  files  might  be  0.5,  i.e.  0.5+0.5=1.0  and  such.  The
brightness tone scale center is at full black,  and not  middle  tone,  so  the
default  brightness  level is zero,  that allows the contrast to be negative or
positive.

Option 5 is specifically for generating 3D  stereoscopic  images,  whereas  the
other  options can be used for a variety of image processing tasks.  Two 24 bpp
BMP files are the source and one 24 bpp BMP file is the result.  The two source
24 bpp BMP files are images of the same subject for viewing as a  stereo  pair,
i.e.  one  image  is from the right eye point of view and the other is from the
left eye point of view.  The source stereo pair  images  can  be  from  various
sources, and are not limited to computer generated images.  The size and aspect
ratio are taken from the source files, so when you want to make a BMP file that
will  be converted into a Pixel file for display in DANCAD3D.COM (tm) the X and
Y pixel dimensions of the source files must correspond to padded  or  un-padded
standard  screen sizes.  See the explanation of the equivalent menu command for
more details.

UTILITY BMP_TO_BMP 5 f1 f2 f3 i1 i2 i3 i4 i5 r1 r2 r3

Where:

f1 = Filename of right eye source 24 bpp BMP file.
f2 = Filename of left eye source 24 bpp BMP file.
f3 = Filename of combined stereoscopic result color 24 bpp BMP file.
i1 = FormatCode, see list of codes for macro STEREO command info.
i2 = BorderColor, 0 to 15, or 16 for none.
i3 = Reverse, 0=none 1=reverse left and right eye views.
i4 = SyncAdjust, applies only to sync double, e.g. formatcode 121.
i5 = SyncTweak, applies only to sync double, e.g. formatcode 121.
r1 = Right eye ghost mask, 0=none, or about 0.1 to 0.2 for ghosting formats.
r2 = Left eye ghost mask, 0=none, or about 0.1 to 0.2 for ghosting formats.
r3 = Stereo image gamma correction, 1.0=same, n>1=lighten n<1=darken shadows.

The STEREO macro command has some extra parameters,  e.g.  AspectComp,  Zshift,
SXshift, EyeRot, and EyeOff, these are needed since STEREO is used with DISPLAY
to generate the stereoscopic pair of images.  This file utility combines stereo
pairs  that  have  already  been  saved  to  disk,  and so the image generating
parameters are not present.  When the stereoscopic display option is used  with
the  main  menu  Preview  command  or  the  macro  STEREO and DISPLAY commands,
temporary BMP files are left on the disk,  that you might use  with  this  file
utility.  A form of the right eye view is saved in file DANR0000.BMP, a form of
the  left  eye  view  is saved in file DANL0000.BMP,  and when the stereoscopic
display  result  goes  to  the  screen  the  result  at  24  bpp  is  saved  in
DANS0000.BMP,  even  when 15 or 16 bpp VESA modes are used.  When the BMP video
mode is used the result goes to the file name designated for  the  BMP  result,
and  not  into  DANS0000.BMP,  which might then contain some older stereoscopic
image.  This BMP Combine mode 5 might be used with odd size BMP  source  files,
i.e.  not just the standard VESA screen size image sizes,  and so may work with
stereoscopic images captured on a  compatible  scanner  or  with  a  compatible
digital  camera.  Odd  size  images  might  be viewed in some other third party
compatible Windows (tm) or Linux (tm) graphics program.

---
NEW STEREO MACRO COMMAND

A new macro command keyword STEREO has been introduced in  order  to  pass  the
various values required for the Stereoscopic image formatting information on to
the  DISPLAY  command.  The  STEREO  macro command must come before the DISPLAY
command for the DISPLAY command to make an  image  formatted  in  the  assigned
stereoscopic  image  format.  The  STEREO  macro  command  must come before the
DISPLAY macro command each time you want to display a stereoscopic image.

Macro command parameter usage order for STEREO:

STEREO StereoMode FormatCode BorderColor Reverse
       SyncAdjust SyncTweak AspectComp
       RightMask LeftMask StereoGamma
       Zshift SXshift EyeRot EyeOff

Where:

StereoMode   = stereomode is always 0 in initial revision of v2.7H
FormatCode   = see formatcode list below
BorderColor  = 0-15=colors 16=none, see color code list below
Reverse      = 0=none 1=reverse right and left eye views
SyncAdjust   = only for sync double shutter glasses, 0 or about 20 to 60
SyncTweak    = only for sync double shutter glasses, 0 or about -3 to +3
AspectComp   = for FormatCodes 20, 40, 120, and 121, see AspectComp info.
RightMask    = for various glasses, 0 otherwise, 0 to about 0.35
LeftMask     = for various glasses, 0 otherwise, 0 to about 0.35
StereoGamma  = image adjustment, 1.0 or about 0.5 to 2.0
Zshift       = 0 or + moves image to you, - moves it away, about -50 to +100
SXshift      = 0 or + moves image to you, - moves it away, about -0.8 to +2
EyeRot       = eye rotation, about 0.2 to 0.4
EyeOff       = eye offset, about 0.1 to 0.2

STEREO 0 i i i i i i r r r r r r r

Where:

i            = integer number
r            = real number

What follows is a more detailed explanation of the STEREO command parameters.

SrereoMode:

There is just "stereo mode" 0 in the initial revision of  v2.7H,  so  you  just
enter 0 after STEREO for now.

FormatCode:

The "FormatCode" value is for selecting how the making of the stereo  3D  image
or  file  will  be done.  Each format code might be used to make a stereoscopic
image that could be viewed somewhat differently or with different apparatus.

The location of the Right eye view and the Left eye view  in  the  stereoscopic
combination image might be switched or swapped if there is a need to do so, use
the  "Reverse"  option  value  to  swap  the Right and Left views.  LCS shutter
glasses may have a button on their control driver electronics  that  also  lets
you  swap  the  Left  and  Right  views  when  you  need to,  without having to
regenerate the stereoscopic image.

For exporting the stereoscopic image pick BMP video mode  with  the  GRAPH_MODE
command,  rather  than  saving  the  image  displayed on the screen,  since the
shading will be better when the 15 or 16 bpp VESA modes  are  used.  Using  the
BMP  video mode also lets you save the stereoscopic image larger and with finer
detail for later printing.  When using a computer that has a video  board  that
does  not display fancy VESA video modes you might be able to use the BMP video
mode to save the stereoscopic image to disk without having to use  a  different
video board.

"Padding"  is  black  fill  around the stereo images so the combined stereo BMP
image file can be converted to a Pixel file,  i.e.  the image size is padded to
be  like a video screen shape.  In order for the padding to do its job the size
of the source images must be selected to convert to the desired standard result
size.  "Padding" is needed for some FormatCodes that put  the  Left  and  Right
images  above  and  below  or side by side when the stereoscopic image is to be
displayed on screen.  When using the main menu Preview  command  or  the  macro
DISPLAY  command  to  display  on  screen  the  image  is  automatically padded
regardless of the FormatCode selected,  but when using the BMP video  mode  the
image  is  saved  un-padded  when the appropriate FormatCode is selected.  Also
when displaying side by side or above  and  below  images  on  the  screen  the
resolution  is divided by two and adjusted so that the program does not need to
switch into a resolution that is twice as high,  which might not be possible or
safe for your monitor,  i.e.  the on-screen image is displayed in the VESA mode
selected regardless of the FormatCode entered.  When the image is  saved  using
the  BMP video mode the image will be double resolution when needed for some of
the side-by-side or above and below, a.k.a.  over-under, images.  If you do not
want the BMP file at double resolution for some of the above and below or side-
by-side  images  enter  X and Y pixel dimensions half the composite image size.
When making BMP files for later conversion to Pixel files for  display  through
LOAD  PIXEL or ANIMATE be sure to select the "Padding" adjusted FormatCodes and
enter X and Y pixel values that will make the  BMP  file  the  right  size  for
conversion.  Some  video  modes  do  not  come  out  even  for the double image
FormatCodes, such as putting two 640x480 views on one standard 1280x1024 image.
To make up for the odd screen sizes the program in some cases makes adjustments
to the size of the "padding" in the FormatCodes that are selected to give extra
adjustment of the "padding".

If you want to make transparency slides for projection in two slide  projectors
you  can  select  FormatCode  =  1  and 2,  or rename the temporary image files
DANR0000.BMP and DANL0000.BMP, then shoot the right and left eye views from the
computer's full screen.  You can convert BMP eye image  files  to  Pixel  files
using  the Files Utilities BMP Pixel command and then use Load Pixel to display
the Pixel files for photography.  The CRT Negative command  might  be  used  to
alter  the  display  on  the  screen to get reversed tones for photography onto
Color Positive film stock,  such as Agfa CP-30  (tm)  using  yellow  or  orange
filters,  to  give  a  color  positive  slide or movie from the negative screen
image.  The same idea might be used to make  two  strip  3D  movie  prints  for
projection with two movie projectors interlocked with synchro motors, which may
give  better  results  than  making  a  side-by-side squeezed print.  It may be
better to use video mode BMP when saving separate eye view files by use of  the
temporary eye image files, since the VESA modes reduce the separate image sizes
to half size,  when you are using some FormatCodes, in order to get both images
on the screen in the selected mode,  but when the BMP graphics  video  mode  is
selected  the  images  are  output full size and so may have four times as many
pixels.


FormatCode = 0

Monoscopic mode.  Use a FormatCode of  0  when  you  do  not  want  to  make  a
Stereoscopic view, but do not what to remove the STEREO command from the macro.
That is FormatCode 0 disables the Stereoscopic image generation.


FormatCode = 1

Right  eye single eye view image.  FormatCode 1 outputs just the right eye view
from the stereo pair.  You might want  each  of  the  stereo  views  output  to
separate images so that you can do further processing of the images, or so that
you  can  make  a  separate  slide  or  cine  film of each of the two views for
projection from two projectors or a special double image projector. Unlike just
copying the file DANR0000.BMP, FormatCode 1 generates an image that can that be
ghost masked.  Both the RightMask and LeftMask values should  be  set  as  they
would  be  when  making  a combined stereoscopic image.  FormatCode 1 was added
after the November 27, 2003 release.


FormatCode = 2

Left eye single eye view image.  FormatCode 2 outputs just the  left  eye  view
from  the  stereo  pair.  You  might  want  each  of the stereo views output to
separate images so that you can do further processing of the images, or so that
you can make a separate slide or cine  film  of  each  of  the  two  views  for
projection from two projectors or a special double image projector. Unlike just
copying the file DANL0000.BMP, FormatCode 2 generates an image that can that be
ghost  masked.  Both  the  RightMask  and LeftMask values should be set as they
would be when making a combined stereoscopic  image.  FormatCode  2  was  added
after the November 27, 2003 release.


FormatCode = 10

"Parallel",  a.k.a.  "wall eyes", side-by-side format, the Left eye image is on
the Left side of the image and the Right eye image is on the Right side of  the
image  (unless you have used "reverse" to swap them).  This format is used with
some kinds of stereoscopic image viewers that have prisms or  mirrors  in  them
that  let  you  view the centers of the two images without diverging your eyes.
Some people can "free view" the "Parallel" format if viewed from a distance  or
the images are printed so that their centers are equal to or a little less than
the distance between your eye's pupils,  about 50mm to 80mm.  Some people might
find the "Crossed eyes" format easier to "free view" since  the  image  spacing
may  be  less critical.  If the "Parallel" images are printed on small cards so
that their centers are spaced a little less than the inter-pupil distance,  you
can view the images by using two,  preferably achromatic, magnifying glasses of
about positive 75mm to 150mm focal length,  one cemented lens in front of  each
eye like eye glasses.  Holding a black card between the images so that each eye
can  see  only one image may help when viewing.  The "Parallel" images might be
viewed off of the computer screen by using special  "periscope"  viewers  using
four  front  surface  mirrors or 90 degree prisms.  The "periscope" type viewer
might have an adjustment to allow the images to be converged, e.g.  one or more
of  the  mirrors  might  pivot or slide to try to correct for different viewing
distances and different distances between the right and left image centers.  It
might be possible to use just one periscope over just the right  or  left  eye,
but  it  may  be  generally better to keep the optical path length the same for
both eyes so that both eyes focus at the same distance.  Wedge  prism  type  3D
viewers  for  "Parallel"  side-by-side views may also allow viewing images that
have a center spacing greater than the  spacing  between  the  eyes.  Two  thin
wedge  prisms  might be arranged like lenses mounted in eye glasses so that you
look through the prisms and your line of sight is made to diverge without  your
eyes having to diverge.  Achromatic wedge prisms might be desirable since wedge
prisms  made  of  a  single  kind  of  glass  may show some degree of chromatic
aberration,  i.e.  rainbow fringes.  Using the STEREO  command's  "BorderColor"
option  may help in lining up the two side-by-side stereo images while viewing.
Using the monitor's horizontal and vertical size adjustments may help  somewhat
to  achieve  fusing  and convergence by letting you change the distance between
the right and left image  centers.  See  also  FromatCode  20  which  might  be
adjusted  with  the  AspectComp  to give a tall aperture full screen image with
some image center distance compensations.  When the VESA video modes display on
the screen the images is padded,  but when the BMP video mode is  selected  the
image is not padded unless you select a padded FormatCode.


FormatCode = 11

This  is  also a "Parallel" image but simple black padding has been added equal
to twice the image height.  This might be needed for  conversion  to  some  odd
video  modes  such as 1280x960 or 640x400 and such.  See also FormatCode 12 for
adjustment for some uneven pixel ratios.


FormatCode = 12

This is like FormatCode 11 but the padding has been  adjusted  for  some  video
modes  like  2x-640x480 going to 1280x1024 or 2x-320x200 going to 640x480.  You
might try to report what other odd VESA modes you think should be  adjusted  on
the "Wish List" form.  When the image is to be displayed on-screen the adjusted
padded FormatCode would usually be the preferred FormatCode.


FormatCode = 20

This  is  a  "Parallel"  image format with the two images in anamorphic squeeze
across their width for recording on 3D cine film when the AspectComp is set  to
0.  Special  lenses or mirrors are used on the movie projector to unsqueeze and
superimpose the  two  images  on  the  movie  screen.  Polarizing  filters  are
normally  used for each side of the projector lens so the viewers can see color
images by using Polarized 3D glasses.  Pure Red and Cyan filters plus  Didymium
type rare earth glass filters might also be used on the projector with a stereo
unsqueeze  lens,  in  place  of  the  usual polarizers,  to possibly get better
ghosting results when viewing with Red-Cyan cardboard  gel  glasses  than  when
making  an  Anaglyph  color  release print,  since the dyes and minerals in the
filters over the movie projector might have better pass and stop bands than the
dyes obtainable by printing onto color print stock,  e.g.  a  black  and  white
print  could  be used since filters are on the projector lens.  If your monitor
has enough range on its vertical size or height adjustment  to  reduce  the  on
screen  image height to 50% you might use FormatCode 20 in place of FormatCodes
10,  11,  and 12 to try to get higher vertical resolution.  If your monitor can
not shrink the on screen image enough, you may be able to reduce the distortion
by  using the AspectComp adjustment value.  Within FormatCode 20 the AspectComp
value can select sub-formats,  when it is 1 the image is un-squeezed such  that
it is a tall aperture of the usual screen image with the sides cut off, when it
is  2 the image contains a smaller version of the usual screen image plus extra
on the top and bottom within the taller aperture.  If you what  to  adjust  the
monitor raster size in an asymmetric way in order to adjust the center distance
of  the  two  images to try to correct for the limitations of some viewing aid,
the AspectComp values 100 to 120 work like 1 except the aspect compensation  is
adjustable  in  grades from mode 0 to 1 and past 1,  and values 200 to 220 work
like 2 except that the aspect compensation is adjustable in grades from 0 to  2
and  some  extra  beyond that.  To view the "tall screen" side-by-side parallel
images off of the computer screen you might try to use some kind  of  prism  or
periscope viewer.


FormatCode = 30

"Crossed  eyes"  side-by-side  format puts the Right eye image on the Left side
and the Left eye image on the Right side.  "Crossed eyes" stereo format is  the
format  preferred  by  some  people  for  "free viewing",  "free viewing" means
viewing without any special glasses or viewers.  To "free  view"  the  "Crossed
eyes"  image  sit back about two to three feet from your monitor then hold your
finger about half way between your monitor and your nose.  Look at your  finger
tip  and  move your finger closer or further from your nose until you see three
out of focus images side by side.  Ignore the  two  images  on  the  sides  and
concentrate  on the center image.  Do not try to focus the center image,  focus
on your finger.  Slowly lower your finger while keeping your eyes lined  up  on
the center image.  When your finger is out of the way,  just sit there and look
at the out of focus center image for a few minutes,  being careful not  to  let
your  eyes  shift  position and look at one of the side images.  After you gain
good control at holding the out of focus center image  in  place  you  can  try
little by little to bring it into focus while struggling to keep your eyes from
moving  off  of  the center image.  It is natural for your eyes to focus at the
point that the eyes converge,  but to "free view" you need to train yourself to
separate  your control of the muscles on your eyes that focus and converge your
eyes.  This is somewhat like learning to ride and balance a bicycle,  once  you
learn  how  to gain conscious control of these various eye muscles it becomes a
new skill that you might be able to keep and use for the rest of your life.  Do
not give up if your first few tries fail,  once you learn this skill you  might
be  able  to  "free  view"  off  of  your  monitor  or  from a print out of the
stereoscopic image anytime and anywhere even when you do not have your  special
glasses  or  viewers  with  you.  Using the image "BorderColor" option may be a
help in "free viewing" since it gives the three images you see  an  outline  by
which  you  can  try  to  register  them.  Another  aid you might try for "free
viewing" is to cut a hole the shape of one of the on screen  images,  a  little
smaller  than the image,  in a black piece of cardboard.  Place the black piece
of cardboard midway between the monitor's screen and your eyes,  such that when
you  look  at the screen through the hole you see the image on the left side of
the screen with only your right eye,  and you see only the image on  the  right
side  of  the  screen  with  your left eye.  You may need to make several black
cards with the rectangular hole until you make one that has the hole just large
enough to see only one image when your eyes  are  crossed.  You  could  make  a
hinged  bracket  to flip the black cardboard mask down in front of your monitor
and hold it out the right distance on a stick of some kind,  that way  both  of
your hands could be free, and you just need to move your head to the right spot
to  view  the  3D  stereoscopic image through the rectangular hole in the mask.
The filetype JPS is a variation of the popular JPG filetype that is used on the
internet  to  display  stereoscopic  images.  To  make  a  JPS  file  save  the
stereoscopic  image  as a "Crossed eyes" BMP image,  then use the software that
came with your scanner to convert the BMP image into a JPG type file, using the
minimum compression option in order to preserve the stereo  detail  and  reduce
"cardboarding" of the image planes.  Next,  rename the JPG file to have the JPS
file extension.  Renaming should work since if the JPS file lacks  the  special
image header encoding the image reader should assume the JPS file is a JPG file
that  has  the  image  formatted  for "Crossed eyes" stereoscopic image format.
Since the JPS file will not have the usual stereo header encoding some  viewers
may  not  display the renamed JPG file properly.  It may be possible to add the
correct header encoding to the JPS file with a third  party  program,  but  you
would need to find such software.  See also FromatCode 40 which can be adjusted
with  the  AspectComp  to give a "crossed eyes" tall aperture full screen image
with image center distance compensations.

Some related viewing aids for viewing "Crossed eyes" side-by-side stereo images
might be of interest to viewers that have difficulty  "free  viewing"  "Crossed
eyes"  stereo  images.  When  you  are  using  a  CRT  monitor you can cut some
polarizer sheets so that you have two sheets half the width of the  screen  and
the  full height of the screen,  one sheet has the polarization angle set to 45
degrees and the other sheet has the polarization angle set to 135 degrees.  You
then put 45 and 135 degree Polarized glasses on and cover your left  eye,  then
place the Polarizer sheet that looks gray over the left half of the screen, and
the  Polarizer  sheet that looks black over the right side of the screen.  When
you switch and cover the right eye you should see the right side of the  screen
through a gray filter,  and the left side of the screen through a black filter.
You then display a "Crossed eyes" image on the screen by  using  stereo  format
code  30  or  40.  If you move back some distance from the monitor and view the
side-by-side images through the two filters over the screen and are wearing the
Polarized 3D glasses you should be able to cross your eyes  and  see  just  one
stereoscopic  image,  rather  than the usual three images side-by-side that you
would see when "free viewing" without using the Polarized 3D glasses.

If you are making transparency slides for projection,  you might be able to use
glass  mounts  and  bind  strips  of Polarizer material,  aligned to 45 and 135
degrees, half the width of the image on the lens side of a "Crossed eyes" color
transparency.  When such a slide is  projected  and  the  viewers  are  viewing
through 45 and 135 degree Polarized glasses they should be able to fuse the two
side-by-side  images  a  little  easier  than  if  the "Crossed eyes" image was
projected without the Polarized filter since  they  will  just  see  one  image
rather than three, particularly if the room is very dark and the image is small
and  distant.  A  special  type of screen to project on might be needed to make
the side images dim,  but ghosting should not be  an  issue  since  this  is  a
"Crossed  eyes" stereo format and the images are never superimposed,  except in
the viewers mind.  Heat from the projector lamp might be a problem with melting
and destruction of the bound transparency and Polarizer filter strips,  so  you
might  want to use a dichroic heat mirror for the mounting glass closest to the
light source.

Since LCD monitors and screens used in laptop computers already have polarizers
in them you can not tape two large Polarizer strips over them,  since one  side
of  the  screen  would come out black.  Dr.  Keigo Lizuka has suggested that in
this situation you can leave one side of the LCD screen  uncovered  and  put  a
sheet  of  about 1 mil clear cellophane over the other half of the screen.  The
cellophane rotates the polarized light so that you now have light  coming  from
the  two  sides of the screen at angles that are similar to using two Polarizer
filters on a CRT monitor.  You need to use cellophane of  the  right  thickness
for  this  to work,  using a different thickness or a different kind of plastic
will probably not give the same results.  If your LCD screen has an angle of 45
or 135 degrees then you may be able to use Polarized glasses set to 45 and  135
degrees  to  view  using the cellophane technique,  otherwise you might need to
make Polarized 3D glasses that have the filters rotated to the same angles that
you are getting from the uncovered and cellophane covered  sides  of  your  LCD
screen.  This cellophane gimmick may not work with all LCD displays.

This "split screen filtering"  idea  could  be  used  with  circular  Polarizer
glasses and sheets on the monitor or slide, and such.

This  same  idea  might  be used with colored filters over the two sides of the
computer monitor,  or slide transparency,  and viewing with  Anaglyph  glasses.
For instance if you display a side-by-side "Crossed eyes" image on the computer
screen,  then  cover the right side of the monitor screen with a red theatrical
gel or dyed plastic sheet and cover the left side of the monitor screen with  a
cyan  gel  or  dyed plastic sheet,  and view by using Red-Cyan Anaglyph glasses
with the red filter on the left eye,  you might then see a  ghost  free  stereo
image  by  crossing  your  eyes.  The color filters in this technique might not
need to be perfect since filter leakage may just make dim  side  images  rather
than  ghosts  within the central stereo image.  Any of the other Anaglyph color
combinations might operate in the same way.  Moving back a  distance  from  the
monitor or screen and viewing in a darkened room might help with the ability to
fuse the stereo image.

I have not yet tested all of the various display viewing options,  methods, and
techniques described so you may need to do some experimenting to see  what  you
might find of utility.


FormatCode = 31

This  is  "Crossed eyes" format plus simple black padding for conversion of the
image for on-screen display.  For some odd video modes this FormatCode might be
needed, but for standard video modes it may be better to use FormatCode 32.


FormatCode = 32

This is "Crossed eyes" format with padding plus adjustment for some video modes
that do not have double the image height of the original images.  FormatCode 32
would be the preferred FormatCode  for  on-screen  display  of  "Crossed  eyes"
stereoscopic image format, generally.


FormatCode = 40

When  AspectComp  is  0 this is a non-standard "Crossed eyes" anamorphic format
that might be useful if your monitor have size controls with  enough  range  to
make  the  images  un-squeezed,  thereby  getting twice the vertical resolution
since black padding would not be needed in  the  combined  stereoscopic  image.
See  if  you  can reduce the "vertical size" or "height" on your monitor to 50%
and increase the "horizontal size" or "width" on your monitor to 100%.  If  you
cannot get enough range on your monitor to get the correct 4:3 image shape, you
might  use  the  AspectComp adjustment to distort the image in order to make up
for the extra height of the image frames.  FormatCode 40 could be used in place
of FormatCode 20 for 3D motion pictures if the polarizing filters where swapped
for the two projected images.  Within FormatCode 40 the  AspectComp  value  can
select  sub-formats,  when  it  is 1 the image is un-squeezed such that it is a
tall aperture of the usual screen image with the sides cut off,  when it  is  2
the  image contains a small version of the usual screen image plus extra on the
top and bottom within the taller aperture.  If you want to adjust  the  monitor
raster  size in an asymmetric way in order to adjust the center distance of the
two images to try to correct for the  limitations  of  some  viewing  aid,  the
AspectComp  values  100  to  120  work like 1 except the aspect compensation is
adjustable in grades from mode 0 to 1 and past 1,  and values 200 to  220  work
like  2 except that the aspect compensation is adjustable in grades from 0 to 2
and some extra beyond that.  To view the "tall screen"  "Crossed  eyes"  images
you  can  try  to  "free  view"  by  crossing your eyes,  so no viewer would be
required by people who are able to  easily  "free  view"  such  "Crossed  eyes"
images.


FormatCode = 80

The  side-by-side  "Mirror  Right" stereoscopic format has the Left eye view on
the left side,  and the Right eye view on the right side,  like the  "Parallel"
format, but has the Right eye view flipped or mirrored side to side so that the
Right  eye  view  will  appear  correct  when viewed in a mirror.  To view this
format you place a front surface mirror perpendicular  to  the  monitor  screen
with  the mirrored surface facing right and you look directly at the left image
with your left eye and you look at the reflection of the right eye image in the
mirror.  You can tip the mirror a little from side to side at the  end  closest
to  your face in order to bring the centers of the images into convergence.  If
you use this format frequently you might make a hinged bracket that fits to the
top of your monitor and hangs the mirror in the proper position,  so  that  the
mirror  can  be flipped out of the way when not needed.  You might also add two
positive meniscus diopter lenses,  i.e.  eyepieces to look through,  of a focal
length  slightly longer than their distance to the monitor so that you can view
the images on the monitor without  straining  your  eyes  to  focus  close  up.
Viewing  with  one  eye's view reflected in a mirror might be easier for people
who cannot master "free viewing" by the use of "Crossed eyes" format.  Having a
border on the images may make lining up the two images  easier,  see  also  the
BorderColor option value.  The program uses the related padded FormatCodes when
rendering  the  image  for on screen display when the VESA graphics video modes
are selected, so use the graphics mode BMP and output the stereoscopic image to
a disk file if you do not want it padded.


FormatCode = 81

This is "Mirror Right" format with black padding, this might be needed for some
odd screen image dimensions,  but the adjusted  padding  in  FormatCode  82  is
probably  of more frequent use.  The padded FormatCodes are for use with images
that will be converted to Pixel files for on-screen display,  if you are making
images for display on the internet you do not need the padding, generally.


FormatCode = 82

This  is  "Mirror  Right"  format  with  black padding plus adjustment for some
standard screen image dimensions that do not have the  height  twice  the  sub-
image size, this might be needed for some odd screen image dimensions.  In some
cases  the non-adjusted padding in FormatCode 81 may be required for odd screen
dimensions.  The padded FormatCodes are  for  use  with  images  that  will  be
converted  to  Pixel files for on-screen display,  if you are making images for
display on the internet you do not need the  padding,  generally.  The  program
uses  the  related  padded  FormatCodes  when rendering the image for on screen
display when the VESA graphics video modes are selected,  so use  the  graphics
mode BMP and output the stereoscopic image to a disk file if you do not want it
padded.


FormatCode = 90

The  side-by-side  "Mirror  Left" stereoscopic format has the Right eye view on
the Right side,  and the Left eye view on the Left side,  like  the  "Parallel"
format,  but has the Left eye view flipped or mirrored side to side so that the
Left eye view will appear correct when viewed in a mirror.  To view this format
you place a front surface mirror perpendicular to the monitor screen  with  the
mirrored surface facing left and you look at the right image directly with your
right  eye  and you look at the reflection of the left eye image in the mirror.
You can tip the mirror a little from side to side at the end  closest  to  your
face  in order to bring the centers of the images into convergence.  If you use
this format frequently you might make a hinged bracket that fits to the top  of
your  monitor  and hangs the mirror in the proper position,  so that the mirror
can be flipped out of the way when not needed.  You might also add two positive
meniscus diopter lenses,  i.e.  eyepieces to look through,  of a  focal  length
slightly  longer  than  their  distance to the monitor so that you can view the
images on the monitor without straining your eyes to focus  close  up.  Viewing
with one eye's view reflected in a mirror might be easier for people who cannot
master  "free viewing" by the use of "Crossed eyes" format.  Having a border on
the images may make lining up the two images easier,  see also the  BorderColor
parameter.  The  program uses the related padded FormatCodes when rendering the
image for on screen display when the VESA graphics video modes are selected, so
use the graphics mode BMP and output the stereoscopic image to a disk  file  if
you do not want it padded.


FormatCode = 91

This is "Mirror Left" format with black padding,  this might be needed for some
odd screen image dimensions,  but the adjusted  padding  in  FormatCode  92  is
probably  of more frequent use.  The padded FormatCodes are for use with images
that will be converted to Pixel files for on-screen display,  if you are making
images for display on the internet you do not need the padding, generally.


FormatCode = 92

This  is  "Mirror  Left"  format  with  black  padding plus adjustment for some
standard screen image dimensions that do not have the  height  twice  the  sub-
image size, this might be needed for some odd screen image dimensions.  In some
cases  the non-adjusted padding in FormatCode 91 may be required for odd screen
dimensions.  The padded FormatCodes are  for  use  with  images  that  will  be
converted  to  Pixel files for on-screen display,  if you are making images for
display on the internet you do not need the  padding,  generally.  The  program
uses  the  related  padded  FormatCodes  when rendering the image for on screen
display when the VESA graphics video modes are selected,  so use  the  graphics
mode BMP and output the stereoscopic image to a disk file if you do not want it
padded.



FormatCode = 100

The  "Over-Under"  or  "Above-Below" stereoscopic image format,  with the right
image on top,  is used with special prism or periscope mirror viewers that  let
you  look  at  the  center  of  the  monitor  screen  or  printout  and see one
stereoscopic image.  If the left image needs to be  on  top  you  can  use  the
"Reverse"  option  value to swap the stereo images.  Some kinds of prism viewer
might have two weak wedge prisms that divert your line of  sight  so  that  the
right  eye  sees  objects above the line of sight and the left eye sees objects
below the line of sight.  The power of the wedge prisms may effect how far away
from the monitor you need to be and that the centers distance of  images  be  a
certain  value.  With  a  large monitor you may not be able to converge or fuse
the stereo images if the viewer's wedge prisms are too strong or weak.  You may
be able to find some kind of  wedge  prism  viewer  for  "Over-Under"  viewing,
perhaps  one  constructed  in a manner similar to the "KMQ (tm)" type lorgnette
style viewer described in Europe,  but how well such a viewer might work  could
depend  in  part on the image centers distance between the two stereo images on
your monitor.  One issue with wedge prism viewers might be that when the prisms
are made just from one kind of glass or plastic  there  may  be  some  residual
chromatic aberration, i.e. rainbow fringes.  To account for some of the rainbow
fringes  each  of  the  two  wedge  prisms  might be made of two prisms made of
different kinds of glass so that some of  the  chromatic  aberration  might  be
reduced,  i.e.  achromatic wedge prisms.  In some cases it might be possible to
view the "Over-Under" format with "periscope" type front surface mirror viewers
using two front surface mirrors for one eye where the mirrors can tip  to  make
up  for the difference in the vertical image to image center distance.  To keep
the optical path length the same for the two eyes two periscopes might be used,
the right one going up, and the left one going down, both adjusted to align the
view of the images with the vertical center line of the  monitor's  screen.  If
two  periscopes  are  used  you  would use four front surface mirrors.  Four 90
degree prisms can be used in place of four front surface mirrors  to  make  two
periscopes.  Using the STEREO command's "BorderColor" option may help in lining
up   the  two  images.   Using  the  monitor's  horizontal  and  vertical  size
adjustments may help achieve convergence by letting  you  change  the  distance
between the right and left image centers, this may be particularly helpful when
using a wedge prism viewer that is not adjustable.



FormatCode = 120

When  AspectComp  is  set  to  0 this "Squeezed Over-Under" right on top format
might be useful for viewing with the same kind of viewers as would be used with
the FormatCode 100 format,  except that you would need to  reduce  the  monitor
width   control  to  get  an  un-squeezed  image  with  double  the  horizontal
resolution.  The horizontal resolution is double since no black  padding  would
be needed on the sides of the two images.  If your monitor's horizontal size or
width control does not have enough range to reduce the on-screen image width to
50%  you  might also use the AspectComp value to try to correct for some of the
on-screen distortions.  FormatCode 120 is not for  use  with  Sync  Double  LCS
glasses since those require black padding between the two images for the second
vertical   retrace  period,   see  FormatCode  121  for  displaying  images  in
stereoscopic shutter glasses Sync Double stereo  modes.  Within  FormatCode  40
the  AspectComp  value  can  select sub-formats,  when it is 1 the image is un-
squeezed such that it is a wide aperture of the usual screen image with the top
and bottom cut off,  when it is 2 the image contains a  small  version  of  the
usual  screen  image  plus extra on the sides within the wide aperture.  If you
want to adjust the monitor raster size in an asymmetric way in order to  adjust
the  center distance of the two images to try to correct for the limitations of
some viewing aid,  the AspectComp values 100 to 120  work  like  1  except  the
aspect  compensation  is adjustable in grades from mode 0 to 1 and past 1,  and
values 200 to 220 work like 2 except that the aspect compensation is adjustable
in grades from 0 to 2 and some extra beyond that.  To view  the  "wide  screen"
over-under  images  you  will  probably  need  some  kind of prism or periscope
viewer.  FormatCode 120 could be used like FormatCodes 20 or 40 in a  movie  or
slide  projector,  the double projection lenses though would need to be rotated
90 degrees and adjusted for the smaller image center distance.


FormatCode = 121

This "Squeezed Over-Under,  Vertical Sync Doubler" format with  adjustments  is
for use with Liquid Crystal Shutter Glasses, a.k.a.  LCD Shutter Glasses or LCS
glasses.  To double the vertical sync coming from your video board you attach a
circuit between your video board,  a.k.a.  video card, and your monitor's video
input cable.  This circuit picks up the vertical sync pulse,  waits  about  one
half the vertical retrace frequency,  then sends a second vertical retrace sync
pulse to the monitor,  thereby doubling the vertical retrace frequency.  So  if
your  video  board  is  outputting 60Hz for the vertical sweep in your monitor,
your monitor will sweep at 120Hz when  sync  doubled.  The  advantage  of  sync
doubling your monitor may be two fold, there may be less flicker when using the
Shutter  Glasses,  and  the  flip-flop  that feeds drive signals to the shutter
glasses might be used to display the two stereo  images  without  the  need  to
"page  flip"  the  video  memory in the video board during the use of the video
board's non-interlaced modes.  If you sync  double  the  monitor  when  viewing
ordinary menus,  and such,  you will see the top of the menu stretched out with
the bottom also stretched out and superimposed over it, i.e.  the normal screen
display  is  "scrambled"  and  not readily usable.  So in order to use the Sync
Double stereoscopic display mode you need to have the  screen  image  specially
formatted  with  the  image  for  one  eye  on  the  top of the screen squeezed
vertically,  and the image for the other eye vertically squeezed on the  bottom
of  the  screen.  Since  the  electron  beam  in the monitor is moving from the
bottom of the screen back up to the top of the screen  after  the  second  sync
pulse  generated  by the Shutter Glasses driver circuit,  the top of the second
image cannot be right next to the bottom of the first image,  there needs to be
a  black  strip  between  the two images.  For use with my programs it might be
desirable for the shutter  glasses  controller  circuit  to  have  full  manual
control, i.e. one button for the shutter glasses stereo mode, i.e. "Interlace",
"Page Flip",  "Line Blank",  and "Sync Double", and another button for the left
and right view reverse.  FormatCode 121 has some extra options that are  needed
for its use,  "SyncAdjust" and "SyncTweak" let you try to set the height of the
black band between the two squeezed eyes images to a value that might help line
up the two images on top of each other when the shutter glasses  controller  is
set  to  "Sync  Double"  stereo  mode.  The number of scan lines needed for the
black strip may be different for different video modes  and  monitors,  so  you
will  need  to  figure  out what values might work with your hardware,  and use
those values to generate images for display on your hardware.  SyncTweak  might
be tried in addition to SyncAdjust to move just the top image down, or just the
lower  image  up.  Set  SyncTweak  to 0 and use SyncAdjust to get the images as
close as you can,  then if needed try making SyncTweak a positive  or  negative
value to try to get the two images superimposed.  Having a border on the images
helps  with  alignment,  see the BorderColor option.  SyncTweak may not help in
some cases,  or if the controller senses the video signal in  addition  to  the
sync  signal,  and such.  Since the two images are each less than half the full
screen height in sync double mode AspectComp is  used  to  figure  out  how  to
resolve the non-square pixels and reduced image aperture, the options are:  0 =
crop the images so that a little is lost of the top and bottom,  1 = compensate
the Y axis aspect ratio so that the image is squeezed a little more to fit into
the  aperture  that  is  less than half the screen high,  and 2 makes the image
smaller and wide screen by reducing both  the  image  height  and  width  while
adding  some  extra  image area on the sides.  Options 0 and 2 generally do not
require adjusting the monitor vertical size adjustments when going to and  from
regular to sync double stereo modes.  Option 1 shows the usual image area,  but
since the image is squeezed more than 2 times the vertical size  adjustment  on
the  monitor may need to be adjusted each time you go in and out of sync double
mode by pressing the button on the shutter glasses controller.  When your video
board is outputting interlaced video signals you may not be  able  to  use  the
"Sync  Double" stereo mode on your shutter glasses controller since the monitor
may superimpose the two fields and the image resolution may look less  than  if
the  interlace  was displayed normally.  Some video boards may sometimes output
non-interlaced video signals at the  lower  resolutions  and  interlaced  video
signals  at the higher resolutions.  When your video board is working at higher
resolutions and is interlacing you may need to use FormatCode 160  rather  than
FormatCode  121  for displaying images with shutter glasses.  The "Sync Double"
images can only be displayed "full screen" and only at the resolution they were
created for, also the sync adjustments are dependent on your particular monitor
and video refresh rate,  so FormatCode 121 is mostly  just  for  displaying  3D
stereoscopic images on your particular computer system, if you need to share 3D
images  for use with shutter glasses FormatCode 160 is probably a better choice
most of the time.  If you need to share an image or animation that needs to  be
displayed in FormatCode 121 you can share a macro file that generates the image
or  animation and the person running the macro can try to adjust the parameters
of the STEREO macro command to try to get the "Sync Double" images  to  display
on his or her computer system.


FormatCode = 160

This "Interleave/interlace/line blank" format with right eye on odd rows is for
use  with  Liquid  Crystal Shutter Glasses,  a.k.a.  LCD shutter glasses or LCS
glasses.  The image is made up of alternating lines from  the  two  views,  one
line from the right view then one from the left view,  and so on throughout the
height of the combined image.  FormatCode 160 might be  a  satisfactory  format
for display when the video board and monitor and shutter glasses controller are
working in "interlace" scanning mode.  When the video board is working in "non-
interlace"  video  mode  FormatCode  160  might  also  be viewed if the shutter
glasses controller circuit has a "line blank" stereoscopic mode.  In some cases
"line blank" stereo mode may look a little darker, or a little less sharp, than
some other stereo controller circuit mode since  every  other  scan  line  gets
turned  off  and  the  video  signal  goes  through  a  blanking  circuit.   In
"interlace" mode each  eye  sees  alternate  scan  lines.  Since  the  vertical
frequency  may  be  slower during "interlace" stereo mode there may be a little
less ghosting due to the phosphors having more time to  decay.  In  "interlace"
video  mode  the  video  signal  frequency  may  be  lower which might make the
horizontal details sharper in some cases.  In "sync double" stereo  mode  using
FormatCode  121,  with  the video board operating in non-interlaced video mode,
both vertical and video frequencies going to the monitor may he higher, and so,
possibly reduce sharpness and increase ghosting a little.  FormatCode 160 might
be good for use when the image is to be displayed as part of a document  or  on
the  internet  since  the  stereoscopic image does not have to take up the full
screen.  Because scrolling a displayed page  containing  an  image  made  using
FormatCode  160 can reverse the right and left eye scan lines,  you may need to
press the eye reverse button on the shutter glasses controller circuit to  have
the  right eye view get to the right eye,  and so on.  When "Interlaced" images
are converted from BMP to compressed filetypes you should select no or  minimum
compression  since  blurring  of  the  vertical  or  horizontal  details may be
destructive to some of the stereoscopic integrity,  so it might  be  better  to
keep  stereoscopic  images  un-compressed.  "Sync  Double"  images  need  to be
displayed "full screen" since the timing of the monitor  sync  depends  on  the
images  displayed,  also the black strip in "Sync Double" images probably needs
to be different for different monitors and video modes.  The "Interlace" format
does not need to be displayed full screen,  and  sync  adjustments  within  the
image  are not generally required for various monitors or video modes.  Because
the vertical resolution is half in "Interlace" stereo  mode  higher  resolution
video modes, such as 1280x1024 at 24bpp might be desirable when you do not need
to  animate  the images.  The program averages the scan lines for conversion to
"interlace" mode rather than just dropping the in between lines.  For use  with
my programs it might be desirable for the shutter glasses controller circuit to
have  "full  manual  control",  i.e.  one button for the shutter glasses stereo
mode,  i.e.  "Interlace",  "Page Flip",  "Line Blank",  and "Sync Double",  and
another button for the left and right view reverse.


FormatCode = 170

This "Lenticular/Parallax Barrier" format with the odd columns having the right
eye  view,  is  for  use  with special LCD screens that have a cylindrical lens
sheet or other parallax barrier attached so that each eye sees just the even or
odd pixel columns.  It is like FormatCode 160 but runs the interlaced lines  up
and  down  rather  than  side  to side.  Screens that have the parallax barrier
built in may be infrequent now,  but if you have one FormatCode 170 might  make
an  image  that  can  be  displayed  on  it for viewing in Stereoscopic 3D mode
without glasses of any kind.  You might be able to make a parallax barrier  for
your  regular  LCD  monitor  by printing out a drawing with thin lines spaced a
little closer than the width of the screen, one line for each pair of pixels on
the LCD's screen,  then print the drawing onto high contrast  "litho"  film  so
that you have wide black stripes with thin clear lines.  If you get the spacing
of  the  clear  lines correct,  can get the film close enough,  i.e.  the right
distance, to the LCD monitor, and you sit the right distance away in a darkened
room you might be able to see some of the 3D images without using glasses.  The
spacing of the clear lines in the barrier sheet should ideally be slightly non-
linear from center to the sides in  order  to  compensate  for  the  particular
distance  between  the  monitor  and  the viewer.  Do not try to use a parallax
barrier sheet on a CRT monitor,  it is probably too hard to get the  on  screen
image  and vertical barrier mask aligned,  especially at higher resolutions.  A
company called i-Art (tm) at www.iart3D.com,  seems to  be  offering,  or  have
offered,  an  add  on  kit that puts a transparent lenticular sheet in front of
your normal LCD monitor called "Auto3D  Kit  (tm)".  I  have  not  tested  this
product  and  do  not endorse it for use with my programs,  but you may want to
check for more information if you have a LCD monitor,  since it might  let  you
view  stereoscopic  images  without  using glasses of any kind.  If ghosting is
present when viewing with a parallax barrier  or  lenticular  sheet  you  might
experiment with using some ghost masks to see if there is any benefit.


FormatCode 205

This Red-Cyan Monochrome balanced Anaglyph  format  uses  glasses  with  a  Red
filter  on the left eye and a Cyan filter on the right eye,  is one of the more
common Anaglyph viewing formats,  and might be used for stereoscopic display on
various  monitors,  and possibly to some extent with color slides or print out.
If your Cyan-Red Anaglyph glasses have a red filter on the right  eye  use  the
"Reverse" parameter of the STEREO command to swap the right and left eye views.
FormatCode  205  might be a good choice for including 3D stereoscopic images on
Web pages,  so long as the file compression is kept  small,  or  not  used,  to
reduce,  or  prevent,  any compression induced artifacts.  When making Anaglyph
images the Zshift, XSshift,  EyeRot,  and EyeOff values should probably be less
than  the  values  that  look  good for making images to be viewed with shutter
glasses since the ghosting typical with impure  colored  glasses  may  make  it
difficult  to  fuse  the two images if the stereoscopic disparity is large.  To
try to reduce the ghosting you may be able to look through two, three, or more,
stacked Anaglyph colored glasses at the same time thereby filtering  the  light
better and perhaps reducing the ghosting somewhat.  Ghosting is seeing a little
of  the  left eye view in your right eye and a little of the right eye image in
your left eye.  To try to evaluate the quality of your Anaglyph glasses make an
test image using perspective display mode 10 and a large amount of stereoscopic
disparity for a bright  Anaglyph  wire-frame  outline  with  no  ghost  masking
against  a black background.  Look at the Anaglyph wire-frame image through the
colored glasses and cover your left eye,  this shows how much  red  is  leaking
through  the  cyan  filter,  then cover your right eye to see how much blue and
green are leaking through the red filter.  You may see  more  ghosting  through
one  of  the  filters  than  the  other  filter.  Some impure Red-Cyan Anaglyph
glasses might leak quite a lot through both filters possibly making viewing  of
images  with  a  large  amount of disparity problematic.  By stacking some Red-
Green 3D glasses over some Red-Cyan glasses you may be able to reduce  some  of
the  ghosting,  making  viewing  of  3D  stereoscopic Anaglyphs better.  Filter
stacking can be taken to extreme proportions,  but  since  the  monitor  is  of
limited  brightness you are limited as to how many filters you can stack before
the image is too dim,  even when viewed in a totally dark room.  Ghost  masking
might  be  combined  with  filter  stacking  to try to suppress whatever slight
residual ghosting would remain when filter stacks with  tolerable  transmission
would  be  used.  Gamma correction might also be helpful when very dark filters
are used to lighten the shadow areas of the image, which otherwise might be too
dark to see well.  The computer  monitor  may  not  have  100%  purity  of  the
electron  beams  reaching  phosphor  dots since there may be some spread of the
electrons passing through the internal shadow mask,  so the red image from  the
red  electron  gun may light up the blue and green phosphor dots a little,  and
the blue and green electron guns may  light  up  the  red  phosphor  a  little,
possibly  giving  rise  to  another source of ghosting no mater how perfect the
filters in the Anaglyph glasses are.  If you  move  the  computer  monitor  you
should  probably  degauss  it  since movement of the CRT monitor may effect the
color purity.  Some monitors may have better purity than others since there may
be small adjustments and magnets in the monitor the may effect the color purity
in some cases,  these settings are  generally  done  at  the  factory.  Another
source  for  a possible loss of purity and source of ghosting might be from the
phosphors themselves,  when the phosphor dots are applied using resists some of
the  other  color  phosphors  may  get  washed over the previously applied ones
giving an opportunity for contamination, that is, there may be a little blue or
green phosphor over the red  phosphor  dots,  and  such.  Anaglyph  images  are
simple to view by using just the properly colored glasses, and might be easy to
share  since anyone with the properly colored glasses might also be able to try
to view them.  If you are going to do quite a bit of stereoscopic viewing  just
by  yourself  the  Liquid Crystal shutter glasses may give you a somewhat nicer
viewing experience with perhaps less color  "twinkling"  and  perhaps  somewhat
easier  fusing  of  images  with  large  stereoscopic  disparity in some cases.
Images for LCS glasses may not be as share-able if they have had to be  tweaked
and  adjusted  for your monitors quarks,  e.g.  "sync double" stereo mode,  and
such.  When posting Anaglyph images on the internet you should probably use the
minimum image compression possible,  or no compression at all,  and use 24  bpp
color   since   any  reduction  in  the  image  resolution  may  contribute  to
"cardboarding" of the image details making them look  like  cardboard  cut-outs
rather  than  continuously  round  objects.  The  BMP  file  format the program
outputs in is un-compressed and gives un-compressed image  quality.  FormatCode
205 makes a stereoscopic Monochrome balanced image, but FormatCodes 225 and 235
allow  tri-color  to  be viewed with Red-Cyan glasses.  To possibly improve the
ghosting issues due to filter or phosphor  cross  talk  when  viewing  Red-Cyan
images  a special narrow band Yellow light absorbing filter,  such as Neodymium
and Praseodymium or didymium rare earth glass filter, might be placed over both
of the stacked Red and the stacked Cyan filters in the  Glasses,  or  over  the
monitor  screen as a whole.  How much benefit putting particular filters in the
filter stacks might be would depend on the various combined curves  of  all  of
the  system  components.  See  also  the associated text section about Anaglyph
viewing aids for additional Anaglyph  information  and  how  to  test  Anaglyph
filters using DANCAD3D.COM (tm).


FormatCode = 206

This  "Yellow-Blue" Monochrome balanced Anaglyph format uses a Yellow filter on
the Left eye and a Blue filter on the Right eye.  The  Reverse  option  can  be
used  to  swap  the  colors  for  the  eyes.  FormatCode 206 makes a Monochrome
balanced image,  but FormatCodes 226 and 236 allow  color  to  be  viewed  with
Yellow-Blue  glasses.  The Yellow-Blue glasses might be thought by some to give
better  color  results  than  Red-Cyan  glasses,  but  the  Yellow-Blue  filter
combination  might  in  some cases produce somewhat worse ghosting depending on
the purity of the filters used for viewing.  You can try to test the quality of
the filters used in the different kinds of glasses by viewing a bright Anaglyph
wire-frame image against a black background with no ghost masking,  and make up
your  own mind about which pair of colors give the least amount of ghosting and
look best with your monitor's phosphors.  Using stacked Deep Amber filters  and
stacked  Deep  Blue  filters  combined  with  narrow  band  blue-green blocking
filters,  e.g.  rare earth glass filter and or interference filters,  may  give
results  with  less  ghosting  than  just  a single light yellow and light blue
filter.  See also the associated text section about Anaglyph viewing  aids  for
additional  Anaglyph  information  and  how  to  test  Anaglyph  filters  using
DANCAD3D.COM (tm).  There may be some issues  relating  to  proprietary  rights
regarding  Yellow-Blue  anaglyphs  in  some  countries,  so  only  do  what  is
permissible in the jurisdictions applicable.


FormatCode = 207

This "Magenta-Green" Monochrome balanced Anaglyph format uses a Magenta  filter
over  the  Left  eye and a Green filter over the Right eye.  The Reverse option
can be used to swap the colors for the eyes,  i.e to get a Green-Magenta image.
FormatCode  207 makes a Monochrome balanced image,  but FormatCodes 227 and 237
allow color to be viewed with Magenta-Green or Green-Magenta glasses.  Magenta-
Green glasses are not common,  perhaps due to the difficulty of getting filters
that  are  pure  enough  to block the ghosting.  Magenta-Green or Green-Magenta
anaglyph might possibly find some use perhaps in display methods that  polarize
the  colors of light differently,  and so if that were the case the image might
be viewed with polarized glasses rather than colored glasses, bypassing some of
the issues of color filter purity,  or polarized and colored filters  could  be
stacked  to  reduce  ghosting.  See  also  the  associated  text  section about
Anaglyph viewing aids for additional  Anaglyph  information  and  how  to  test
Anaglyph filters using DANCAD3D.COM (tm).


FormatCode = 208

This  "Red-Blue" Monochrome balanced Anaglyph format uses a Red filter over the
Left eye and a Blue filter over the Right eye.  The Reverse option can be  used
to swap the colors for the eyes.  This color combination may produce the lowest
amount  of  ghosting  if  the  filters in the glasses are very good since green
tends to leak through both red and blue filters, i.e.  no green light may equal
less  leakage.  Many  red  filters  are  actually reddish magenta,  so they may
transmit some blue.  To reduce blue transmission through  the  red  filter  the
deep  red  filter  should be combined with some very strong yellow or yellowish
orange filters to block all of the blue light.  Blue filters sometimes transmit
a little red,  so the blue filter should be combined with bluish green  filters
in  order  to cut down on the amount of red light reaching the blue filter eye.
The strong purple effect of using Red-Blue Anaglyph glasses may make viewing  a
little  harsh  on  the eyes,  the alternative two-color FormatCode 209 the Red-
Green Anaglyph mode may  not  be  as  good  for  ghosting  reduction,  but  the
yellowish overall tint might,  for some people, be easier to look at for longer
periods of time.


FormatCode = 209

This "Red-Green" Monochrome balanced Anaglyph format uses a Red filter over the
Left eye and a Green filter over the Right eye.  The Reverse option can be used
to swap the colors for the eyes for Green-Red glasses.  This Red-Green Anaglyph
format may be one of the traditional Anaglyph color combinations  used  for  3D
stereoscopic  books  printed with Red and Green inks and for 3D Anaglyph motion
pictures.  The sensitivity of the red and green nerves in the eyes is close  in
wavelength and the sensitivity to red and green light overlaps somewhat.  It is
also  hard  to make red and green filters that do not both transmit some yellow
light.  So some  ghosting  when  using  Red-Green  Anaglyph  glasses  might  be
difficult  to  avoid  unless the filters used over the eyes are very strong and
the yellow light in the overlap region is filtered out.  Preferably the  narrow
band  of  yellow  light  between  colors  red  and green would be filtered out,
perhaps by adding a narrow band yellow absorbing filter to the  red  and  green
filters  on the Anaglyph glasses,  e.g.  the addition of didymium or rare earth
Amethyst Contrast Enhancer type  filters  might  have  some  effect.  How  much
benefit  rare  earth filters might have would depend on the transmission of the
other filters used,  and might not be worth the extra cost.  Red-Green  glasses
may  work  better  than Red-Blue or Red-Cyan glasses on printout in cases where
the red dyes or inks might  tend  to  allow  reflection  of  some  blue  light.
Printing  Red-Green  Anaglyph images on broad band bright yellow paper may help
filter out undesirable blue light.  Red-Green may  work  better  than  Red-Cyan
images  when  projecting  photographic  slide transparencies if the dyes in the
slide's image leak blue light.  You might try to use a broad band yellow filter
pass filter and a narrow band yellow blocking filter over the  slide  projector
to  help  the  Red-Green  Anaglyph glasses differentiate the peek red and green
parts of the spectrum.


FormatCode = 210

This "Green-Blue" Monochrome balanced Anaglyph format uses a Green filter  over
the  Left  eye and a Blue filter over the Right eye.  The Reverse option can be
used to swap the colors for the  eyes  for  Blue-Green  glasses.  Glasses  with
special filter stacks should probably be used to minimize ghosting when viewing
"Green-Blue"  anaglyph.  A  narrow band filter that absorbs light between green
and blue might be helpful in the filter stacks for this format.  Green and blue
may, for some people, show less color contrast than combinations involving red,
and so might perhaps tend to show less "twinkling", for some people.


FormatCode = 225

This half-color "Red-Cyan" format is for displaying  desaturated  color  images
for  viewing  with  "Red-Cyan" Anaglyph glasses like monochrome FormatCode 205.
The half-color display mode gives some impression of color with less of some of
the "twinkling" problems encountered in full color Anaglyph images when  highly
saturated  colors  are  displayed  such that there is a great difference in the
brightness between the same parts of the image in both eyes.  If  you  want  to
see what the full color anaglyph image would look like try FormatCode 235.


FormatCode = 226

This half-color "Yellow-Blue" format is for displaying desaturated color images
for viewing with "Yellow-Blue" Anaglyph glasses like monochrome FormatCode 206.
The half-color display mode gives some impression of color with less of some of
the  "twinkling" problems encountered in full color Anaglyph images when highly
saturated colors are displayed such that there is a  great  difference  in  the
brightness  between  the  same parts of the image in both eyes.  If you want to
see what the full color anaglyph image would  look  like  try  FormatCode  236.
There  may  be some issues relating to proprietary rights regarding Yellow-Blue
anaglyphs  in  some  countries,   so  only  do  what  is  permissible  in   the
jurisdictions applicable.


FormatCode = 227

This  half-color  "Magenta-Green"  format  is  for displaying desaturated color
images for  viewing  with  "Magenta-Green"  Anaglyph  glasses  like  monochrome
FormatCode  207.  The  half-color  display  mode gives some impression of color
with less of some  of  the  "twinkling"  problems  encountered  in  full  color
Anaglyph images when highly saturated colors are displayed such that there is a
great  difference in the brightness between the same parts of the image in both
eyes.  If you want to see what the full color anaglyph image  would  look  like
try FormatCode 237.


FormatCode = 235

This  full-color "Red-Cyan" format is for displaying saturated color images for
viewing with "Red-Cyan" Anaglyph glasses  like  FormatCode  205  and  225.  The
full-color  display  mode  gives  full  color  but with some of the "twinkling"
problems encountered when highly saturated colors are displayed such that there
may be a great difference in the brightness between the same parts of the image
in both eyes.  The monochrome FormatCode 205 may be easier on  the  eyes  since
the  brightness for corresponding parts of the image in both views may be about
the same.  The half-color FormatCode 225 gives some impression  of  the  colors
with  "twinkling"  problems  intermediate  between  Monochrome  and  full-color
Anaglyph display.


FormatCode = 236

This full-color "Yellow-Blue" format is for displaying saturated  color  images
for  viewing  with  "Yellow-Blue" Anaglyph glasses like FormatCode 206 and 226.
The full-color display mode gives full color but with some of  the  "twinkling"
problems encountered when highly saturated colors are displayed such that there
may be a great difference in the brightness between the same parts of the image
in  both  eyes.  The  monochrome FormatCode 206 may be easier on the eyes since
the brightness for corresponding parts of the image in both views may be  about
the  same.  The  half-color  FormatCode 226 gives some impression of the colors
with  "twinkling"  problems  intermediate  between  Monochrome  and  full-color
Anaglyph  display.  There  may  be  some  issues relating to proprietary rights
regarding  Yellow-Blue  anaglyphs  in  some  countries,  so  only  do  what  is
permissible in the jurisdictions applicable.


FormatCode = 237

This full-color "Magenta-Green" format is for displaying saturated color images
for  viewing with "Magenta-Green" Anaglyph glasses like FormatCode 207 and 227.
The full-color display mode gives full color but with some of  the  "twinkling"
problems encountered when highly saturated colors are displayed such that there
may be a great difference in the brightness between the same parts of the image
in  both  eyes.  The  monochrome FormatCode 207 may be easier on the eyes since
the brightness for corresponding parts of the image in both views may be  about
the  same.  The  half-color  FormatCode 227 gives some impression of the colors
with  "twinkling"  problems  intermediate  between  Monochrome  and  full-color
Anaglyph display.


BorderColor:

The BorderColor parameter lets you set the color of the thin border around each
of the stereoscopic images,  or to select no border.  Putting a  border  around
the  right  and  left  eye  images can make aligning the images easier and make
fusing of the stereoscopic image in your mind easier since you have some common
points to line up.  Seventeen options are  available,  sixteen  colors  and  no
border.  The border takes one or two pixels from around the image since fitting
the images into the screen requires that the pixel size remain constant with or
without  the border.  The colors available are:  0=black,  1=dark blue,  2=dark
green, 3=dark cyan, 4=dark red,  5=dark magenta,  6=dark yellow,  7=light gray,
8=dark  gray,  9=light  blue,  10=light  green,  11=light  cyan,  12=light red,
13=light magenta, 14=light yellow, 15=white,  16=no border.  Border color 6 may
be a good choice for many applications, such as "Crossed eye" free viewing.


Reverse:

The  Reverse  parameter of the STEREO macro command lets you swap the right and
left eye views when generating the stereoscopic image.  The values to use  are,
0=do not swap,  and 1=reverse right and left eye views.  When using LCS glasses
the electronic controller should have a button on it that lets you reverse  the
right and left eye views without having to regenerate the stereoscopic image.


SyncAdjust:

The  "SyncAdjust"  only  applies  to  sync double shutter glasses modes such as
FormatCode 121, when using other FormatCodes set this parameter to 0.  In order
for the shutter glasses to be used in sync double stereo mode the image on  the
screen  must  consist of two eye images squeezed vertically and arranged in the
above-below format.  Between the two images there must be  a  black  band  that
gives  the  electron beam in the monitor time to make it back to the top of the
screen before the top of the lower image is displayed  over  the  upper  image.
The  width  of  this black strip will need to be wider or narrower depending on
the video mode selected, the vertical refresh rate Hz,  and the type of Monitor
being  used.  This  SyncAdjust  value lets you make the black strip between the
upper and lower images on the screen wider or narrower depending on  the  value
that  you  enter.  A value of around 46 may work with 640x480 mode but you will
need to experiment to see what  values  work  with  your  computer  system  and
shutter  glasses.  To  test  the value make an image with a border and increase
this value by one each time the screen redraws until the borders line  up  with
the shutter glasses control in sync double stereo mode.  If the borders go from
one  line  too  low  to  one line too high you might try a non-zero "SyncTweak"
value.  You will need to test each video mode that you want to  use  and  write
down  the settings that work with that mode.  The "SyncAdjust" values that work
may range from about 20 to 60 depending on  the  video  mode  used.  The  "Sync
Double"  stereo  mode  may  not be usable for video modes that your video board
sends out as interlaced, in which case you would use FormatCode 160 and set the
shutter glasses controller to "interlace" stereo mode,  or perhaps "page  flip"
stereo  mode  if  that works the same as "interlace" in your glasses controller
driver circuit.  Be sure that you adjust the "SyncAdjust"  and  "SyncTweak"  to
get the right and left images superimposed as best you can or the ghost masking
might not have the mask and image aligned enough.


SyncTweak:

The  "SyncTweak"  parameter  value  should  be  set  to  0  while adjusting the
"SyncAdjust" value.  "SyncTweak" only applies to sync double stereo  mode  when
used  with  Liquid  Crystal shutter glasses,  e.g.  FormatCode 121.  When other
format codes are used SyncTweak should usually be set to 0.  "SyncTweak" can be
set  to small positive or negative integers to shift just the top image down or
just  the  bottom  image  up.  Usually  "SyncTweak"  would  be  set  to  0  and
"SyncAdjust"  would  be  used  alone  to  align the left and right view images.
"SyncTweak" may not help at all in some cases,  particularly in cases where the
control circuit senses the start of the video information, and such.


AspectComp:

The  AspectComp  value  is needed to resolve some issues relating to the aspect
ratio of images displayed  using  the  Sync  Double  stereo  mode  for  shutter
glasses, e.g.  FormatCode 121, and anamorphic FormatCodes 120, 20, and 40.  For
other  FormatCodes  AspectComp should generally be set to 0.  In FormatCode 121
the black stripe in the center of the above-below image used  for  Sync  Double
stereo  mode  takes  part  of the screen so that each of the two eye images are
less than half the screen height.  There are three ways to resolve  this  issue
by  setting  AspectComp to:  0=crop image height to fit the available aperture,
1=compensate by squeezing the image height  more  to  fit  into  the  available
aperture height, and 2=reduce both the image height and width to make the image
height  fit  the  aperture  and have a little extra image on the sides giving a
slightly wide screen image.  AspectComp options 0 and 2 help  avoid  having  to
adjust  the monitor's vertical size or height control each time you switch into
or out of sync double stereo mode.  AspectComp  option  1  lets  you  have  the
normal  4:3 screen image,  but may require adjusting the monitors vertical size
or height control each time you switch into or out of the  sync  double  stereo
mode  for your shutter glasses.  In FormatCode 120 when AspectComp is 0 the two
images are anamorphic squeezed vertically.  By using other values of AspectComp
with FormatCode 120 you can get "over-under" "wide-screen" images that are  not
vertically  squeezed.  The  valid  values  to use are:  AspectComp 0 = Y is 2:1
squeezed for anamorphic over-under format, AspectComp 1 = adjust Y image aspect
for of the image half height and full width no squeeze, AspectComp 2 = adjust X
image aspect for normal image height and twice width no squeeze, AspectComp 100
to 120 are grades between modes 0 and  1,  plus  extra,  and  may  require  the
monitor raster size to be adjusted to cancel distortion,  AspectComp 200 to 220
are grades between modes 0 and 2,  plus extra,  and may require monitor  raster
size  to  be adjusted to cancel distortion,  AspectComp 100 to 120,  and 200 to
220,  might be used to adjust the centers distance of  the  images  for  better
viewing with some fixed center viewers.  In FormatCode 40 when AscpectComp is 0
the  two images are anamorphic squeezed across their width.  When AspectComp is
a value other than 0 a tall image aperture side-by-side image is  made.  Values
for  AspectComp  when  FormatCode  is  20  or  40 are:  AspectComp 0 = X is 2:1
squeezed for anamorphic side-by-side format,  AspectComp 1  =  adjust  X  image
aspect for normal image height and half width no squeeze, AspectComp 2 = adjust
Y image aspect for normal width and twice height no squeeze,  AspectComp 100 to
120 are grades between modes 0 and 1, plus extra, and may,  require the monitor
raster  size  to  be  adjusted to cancel distortion,  AspectComp 200 to 220 are
grades between modes 0 and 2, plus extra, and may,  require monitor raster size
to  be  adjusted to cancel distortion,  AspectComp 100 to 120,  and 200 to 220,
might be used to adjust the centers,  distance of the images for better viewing
with some fixed center viewers.


RightMask:

Ghost  masking  is  used  to  try  to  obscure ghost images seen through filter
glasses when the filters are not perfect.  Best results will probably always be
obtained by using viewing aids that do not produce ghost images, but when ghost
images are present combining the stereo images with masking images may make the
ghost images somewhat less apparent.  The combination  image  of  the  original
image  and  the ghost mask does not look like the original image since the mask
image has been combined with it, and so whether or not the masked image is more
or less satisfactory is a  subjective  impression,  and  will  depend  on  many
factors  only  some  of  which may be controllable.  Since the black level gets
lifted during masking,  reducing the monitor brightness to push the black level
down may negate the masking and make the ghosts visible again,  particularly in
the shadows.

If the filters leak quite a lot of light the amount that the black level  needs
to  be  lifted  to match the ghosts from the brightest image points may be more
than what might be satisfactory,  so you may end up just  adjusting  things  so
that some ghosts from the highlights are left somewhat visible.  To offset this
issue you may select element colors that are less bright, e.g. do not use white
and  such,  and  adjust the lighting values and stereo gamma correction so that
the foreground is not too much brighter than the other parts of the rendering.

The values for RightMask and LeftMask should be set to 0 for  FormatCodes  that
do  not  superimpose  the right and left images in such a way that ghost images
can be seen because of filter leakage,  and such.  The RightMask  and  LeftMask
values  set  some  fraction  of  the  opposite  eye  view that is to be used to
generate the masking image,  typical values range from about 0.1 to  0.35  with
larger  values  used for more apparent ghosts and smaller values used for faint
ghosts.  If the ghost image represents only a small portion of the total  image
brightness, superimposing around the ghost a de-ghosting image mask image might
make the ghost somewhat less visible. In practice complete nulling of the ghost
is  probably  impossible,  because  of  non-linearity  of the monitor and other
factors,  but some reduction may  help  with  stereoscopic  fusion  under  some
circumstances  such as viewing wire-frame images.  For Ghost masking to work at
all with high contrast images on a black background, such as wire-frame display
modes, the black level needs to be lifted to dark tones or medium tones.  Since
the filters in the glasses are dark the appearance of the lifting of the  black
level  is  suppressed  somewhat  by  the  filters  in the viewing glasses,  and
therefore the lifting of the black  level  may  be  less  noticeable  with  the
viewing glasses on.

Ghost  masking  may  tend  to  be more incomplete for Anaglyph images since the
chrominance component might not be nulled for large bright areas in the  stereo
images.  There are some things you might try to do to improve the effectiveness
of the ghost masking when used with Anaglyph images, such as moving far back to
view  the  Anaglyph images at a distance of more than four feet,  adjusting the
monitor's controls to reduce the contrast and increase or decrease the  monitor
brightness  to  the  level that nulls the ghosts best,  balancing the right and
left masking values to correspond to the leakage differences of the  right  and
left  eye filters,  improving the filters in the glasses by stacking filters to
make the ghosts less bright so smaller  values  of  ghost  mask  are  required,
adjusting  the StereoGamma setting to flatten the image tones,  and keeping the
stereoscopic disparity small to help in reducing the size of the color fringes.

Eyes tend lose the ability to differentiate color in details if they  are  very
small  and  surrounded by another color.  So when the ghost of a red wire-frame
line is viewed through the green filter with a dim cyan mask image  around  the
ghost,  and  the  monitor contrast is reduced and brightness tweaked to balance
the apparent brightness of the ghost and the mask,  the ability to see the  dim
red  ghost  surrounded  by  the cyan mask tends to decrease the further you get
back from the monitor.

Greatly reducing the brightness of the image and viewing in a darkened room may
reduce the perceived color from Anaglyph images since our eyes cannot see  much
color in very dim light.  Viewing the images very dim may help reduce the color
contrast between the masks and the images.

The  Ghost masking may be more utilitarian when used with shutter glasses.  The
LCM electro-optical filter elements in shutter glasses  may  have  uneven  peak
density  across  their filter area,  so no particular value for the Ghost masks
may be somewhat effective for looking through all portions of the  LCM  shutter
filter  elements,  that is when you look through different parts of the shutter
filter the ghosts may change brightness.  If you move farther from the  monitor
you  may be better able to view the whole monitor screen through a small "sweet
spot" in the LCM shutter filters, if there is one.  Also the LCM shutter filter
for the right eye may have a different peak density than the LCM shutter filter
for the left eye,  giving rise to incomplete nulling for one of the two eyes if
the same value is used for both RightMask and LeftMask,  hence the need for the
ability to enter separate masking values for the two filters.

Ghost masks may in some cases seem to reduce the  subjective  assertiveness  of
some ghosts, but the strength of the mask used may need to be adjusted for best
effect  with a particular image,  stereo mode,  and vertical refresh rate used.
So masked images may not look the same when viewed on other computers  or  with
other shutter glasses.  Also the monitor brightness and contrast may need to be
adjusted for each image.

When  using  "Sync  Double"  stereo  mode  larger  values for the RightMask and
LeftMask seem to be needed,  perhaps because the higher vertical refresh  gives
less  time  for the monitor's phosphors to decay,  so values of 0.20 to 0.40 or
more may be needed.  When using "Interlace" stereo mode on the shutter  glasses
controller  with the video board in interlace mode at higher resolutions values
from 0.10 to 0.30 might seem satisfactory.  When using "Line  Blank"  with  the
video  board  in non interlace mode values around 0.15 to 0.35 might seem close
to a good fit.  Larger values may need to be used for higher  vertical  refresh
Hz rates.

Because  the  ghost mask and image to mask are on different scan lines in field
sequential images displayed for use with shutter glasses the ghost mask may not
register or fit exactly over the image being masked.  The misregistration might
be caused by jitter  in  the  monitor's  sync  circuits,  jitter  in  the  sync
triggering  of  the  shutter  glasses  controller,  timing  errors during "Sync
Double",  movement of the viewers eyes,  interlacing,  or similar issues.  When
the  mask and image are not on top of each other at the same time small fringes
around the ghost may be visible.  Moving farther back from the monitor may make
the ghost fringes and other misregistration artifacts less visible.

When using "Sync Double" stereo mode be sure that you adjust  the  "SyncAdjust"
and  "SyncTweak"  as  best  you  can  to  try  to get the right and left images
superimposed or the ghost and mask may not have their images aligned well.


LeftMask:

Since the filters in the stereoscopic viewing glasses may not be  balanced  and
may  give  ghost images of different brightness each eye has its own ghost mask
setting value,  RightMask for the right eye,  and LeftMask for  the  left  eye.
Imbalance  of  the  ghost  images  is  probably  more of an issue with Anaglyph
glasses than with Liquid Crystal  Shutter  glasses,  a.k.a.  LCS  glasses.  The
setting  of  the  monitor "drive",  "gain",  and "screen" controls for the red,
green, and blue electron guns may effect the "black level" and "white level" of
the three colors,  and make their brightness relationship on the screen "drift"
or  "cross  over"  when  the brightness or contrast controls on the monitor are
adjusted.  To get  the  mask  images  to  null  optimally  may  require  making
adjustments  to  the brightness and contrast controls on the monitor,  stacking
filters on the glasses,  and or in some  cases  perhaps  having  the  monitor's
internal controls adjusted by qualified service personal to rebalance the three
colors.  The  three  electron  guns  should  generally  be adjusted to keep the
relative brightness and contrast of the red, green,  and blue,  images constant
when  the  monitor  contrast  and  brightness  controls are adjusted over their
entire range,  and the brightness control should be able  to  bring  the  black
level  above  black.  If the monitor's colors do not track as needed,  that may
exacerbate the problem of finding a single setting of  the  monitor's  contrast
and  brightness controls that may help null the ghosts in both eyes at the same
time.


StereoGamma:

When the stereo  images  are  viewed  through  dark  filters,  or  the  monitor
brightness  is reduced it may be hard to see details in the darker areas of the
images, applying gamma correction to the stereo images might be used to lighten
the shadow areas to make viewing better.  Doing gamma correction to  alter  the
image  contrast  may  make  the  ghost  masking  more effective for some source
images,  or monitor types.  When StereoGamma is 1.0 no  change  is  made,  when
StereoGamma  is  greater  than  one  the  shadow areas are lightened,  and when
StereoGamma is less than one the shadow areas are darkened.  A value of  around
1.4 may be helpful.


Zshift:

The  Zshift  value  might  be  used  to make the displayed objects appear to be
closer to the viewer or further from  the  viewer.  When  Zshift  is  zero  the
workspace  center  is  about even with the plane of the screen.  When Zshift is
less than 0 the rotation point for EyeRot  is  effectively  moved  forward,  so
elements  centered  around the workspace center would appear to be farther back
or inside the monitor.  When Zshift is greater than 0 the  rotation  point  for
EyeRot is effectively moved backward, so elements centered around the workspace
center  would  appear  nearer  to the viewer or in front of the monitor screen.
Depending on your vision, being near or far sighted and such,  it may be easier
for  you to fuse the stereoscopic images if they appear nearer or farther away.
Zshift interacts with EyeRot and EyeOff so those values may need to be adjusted
when you make changes to Zshift.  Zshift is normalized relative to the  display
scale  in  order to have it have a relatively constant effect regardless of the
perspective display scale,  otherwise every time you changed the display  scale
to  make  the  image  a  little  larger or smaller you would need to change the
Zshift value as well,  you may still need to make small  adjustments  sometimes
though.  Exaggerating  the  perspective  by setting the Perspective Z vanishing
point distance, a.k.a. zvp, value to a small value relative to the depth of the
elements being displayed may cause distortions in the  stereoscopic  disparity,
particularly  at larger values for the stereoscopic values,  so you may need to
increase the zvp to reduce such distortions.  The EyeRot value should not be  0
when Zshift is not zero, generally.  Typical values for Zshift might range from
-50 to +100 or so.


SXshift:

This  Stereo  X  shift  works  somewhat  like  the Zshift value,  but through a
mechanism more like the X shift perspective display  value.  The  Zshift  value
moves  the  rotation  point used with EyeRot,  which converts into increased or
decreased stereoscopic disparity for the foreground or background.  This Stereo
X shift slides the two stereo images in  opposite  directions,  which  has  the
effect  of  moving the point your eyes converge on when viewing the images move
to or away from you.  A value of 0 makes no change.  Values larger than 0 slide
the images so that the right eye view moves left and the left  eye  view  moves
right,  making  you  more  cross  eyed  than you are just looking at the screen
plane, putting the image between the screen and your eyes.  Values smaller than
0 slide the images so that the right eye view moves right and the left eye view
moves left,  making you less cross eyed than you are just looking at the screen
plane,  putting  the image inside or behind the monitor's screen.  These values
are normalized for a display scale of 240,  and so scale to the  screen's  with
being  about  8  units.  You  do not want to move the right eye image more than
about 1 inch to the right on the screen, so negative values would be limited to
about -0.8 or so,  positive values would be limited to how far the  images  can
spread  before  they fall off the sides of the screen,  perhaps +1.0 to +2.0 or
so.


EyeRot:

The EyeRot value is the apparent Y axis rotation deviation  from  the  rotation
entered  with  the DISPLAY command for each eye,  the left eye view rotates the
elements so that more of the left side is  visible,  and  the  right  eye  view
rotates  the  elements  so  that more of the right side is visible.  The EyeOff
value simulates the parallax obtained by moving ones viewpoint to the left  and
right from the center of the image.  Typical values for EyeRot would range from
0.2 to 0.4 degrees for rotation to the right and to the left, i.e.  this is the
half angle of the rotated element not the triangle formed  by  both  eyes.  The
amount  of  stereo rotation used should be limited in order to keep the maximum
disparity of the near and far po