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."
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.
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.
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