Release Notes 3Dfx Interactive Glide 2.3 Driver Document Revision 2.3 April 1997 Copyright ã 1996, 1997 3Dfx Interactive, Inc. All Rights Reserved 3Dfx Interactive, Inc. 4435 Fortran Drive San Jose, CA 95134 408-935-4400 www.3dfx.com Friendly Reminder The software that you are using is covered by the 3Dfx Interactive LICENSE AND CONFIDENTIALITY AGREEMENT. For more specific information, please refer to the License and Confidentiality Agreement located in the back of this document. Thanks for your supp ort! The 3Dfx Interactive logo, Voodoo Graphics and Voodoo Rush are registered trademarks of 3Dfx Interactive, Inc. All other trademarks are the property of their respective owners. Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of 3Dfx Interactive, Inc. Copyright © 1996, 1997 3Dfx Interactive, Inc. The 3Dfx Interactive Software Developers Kit General Information Important Tips Using Glide 2.3 on Pentium ProÓ Systems Voodoo Rush Multiple Glide windowed Applications Using The Trident ProVidia 9685-1 + Voodoo Rush reference design Card Hardware Support Obsidian (Pro) Board Righteous 3D™ (Orchid Technologies) Monster 3D™ (Diamond Multimedia) Alliance Semiconductor ProMotion-AT3D Rev. A reference design and the Voodoo Rush reference design Daughterboard The Trident ProVidia 9685-1 + Voodoo Rush reference design Board Technical Support Operating Systems DOS Notes Windows 95 Notes Windows NT Notes Glide Changes to Drivers Changes in Glide Version 2.3 Using Dual Video Cards Simultaneously Changes in Glide Version 2.2 New Routines GrSstWinOpen grSstWinClose grSstControl grLfbLock grLfbUnlock grLfbWriteRegion grLfbReadRegion Routines Removed Bug Fixes Web Information Development Support Total Immersion Program Support Environment Resource Page Development & Deployment Bug Reporting Developer Bug Submission Form 3DFX INTERACTIVE, INC. LICENSE AND CONFIDENTIALITY AGREEMENT The 3Dfx Interactive Software Developers Kit This document is part of the 3Dfx Interactive Software Development Kit (SDK). The 3Dfx Interactive SDK documentation consists of: * DOCS\GLRELNO.DOC - Release Notes: Glide 2.3 * DOCS\ATBRELNO.DOC - Release Notes: ATB 0.5 * DOCS\D3DRELNO.DOC - Release Notes: 3Dfx Direct 3DÔ 2.08 * DOCS\GPGUIDE.DOC - Glide Porting Guide: Voodoo RushÔ 2.3 * DOCS\INSTALL.DOC - Installation Guide: 3Dfx Interactive Reference Boards and Related Software 2.6 General Information Welcome to the world of 3Dfx Interactive! We are releasing our latest product for your pleasure, and we hope you enjoy it! This distribution contains Version 2.3 of Glide. This version contains many significant changes that includes support for Voodoo RushÔ, optimization and bug fixes. This document will describe the installation procedure for the drivers and the current stat us of the driver. This revision of the driver now properly recognizes Voodoo GraphicsÔ boards that have been installed on a secondary PCI bus. Important Tips The following information highlights some known issues and alternative solutions. We will provide fixes for these issues in future releases. Using Glide 2.3 on Pentium ProÓ Systems This prerelease version of Glide for Voodoo Rush is not compatible with Pentium Pro processors. This issue will be addressed in a future release. There are no known problems with Pentium Pro processors and Voodoo Graphics. Voodoo Rush * If the application window completely covers the DOS box window or if the DOS box otherwise has zero area, DirectDraw terminates incorrectly. * When running an application in full screen mode, corruption may be observed on the first scanline at the top of the screen. * The pass through mode may not be toggled correctly, especially if a console application is activated. The workaround is to manually toggle pass through by entering CTRL-F9 on the keyboard. Multiple Glide windowed Applications * Cannot run multiple Glide windowed applications. Using The Trident ProVidia 9685-1 + Voodoo Rush reference design Card * Observed screen flashing problems in all the Demos and tests running Glide on the Trident part. * Experienced a corrupt cursor with Glide on the Trident part. * Trident card does not run on a PC with a SCSI PCI part. * Trident card does not run on a P6. * 2D drivers do not work well in high resolution modes > 800x600. Hardware Support 3Dfx Glide support is available for the following products: Obsidian (Pro) Board Glide 2.3 supports one Texelfx or two Texelfx chips . ICS and AT&T RAMDAC are supported as it comes with the Obsidian products. Scan Line Interleaved (SLI) configurations of the Obsidian and Obsidian Pro are supported. Righteous 3D™ (Orchid Technologies) This release of Glide supports the Righteous 3D board from Orchid. Monster 3D™ (Diamond Multimedia) This release of Glide supports the Monster 3D board from Diamond. Alliance Semiconductor ProMotion-AT3D Rev. A reference design and the Voodoo Rush reference design Daughterboard This release of Glide supports the Alliance AT3D Board and the Voodoo Rush Daughterboard. The Trident ProVidia 9685-1 + Voodoo Rush reference design Board This release of Glide supports The Trident ProVidia 9685-1 + Voodoo Rush reference design Board, subject to the restrictions noted above. Technical Support We highly recommend that you use the drivers provided by the vendors who developed your boards. Diamond Monster 3D and Righteous 3D board users can find the latest drivers at the Diamond website (www.diamondmm.com) and at the Orchid website (www.orchid.co m), respectively. Operating Systems Glide supports WindowsÓ 95, WindowsÓ NT 4.0, MS-DOSÓ, and MACÔ OS. There is no native support in the development release for OS/2Ó or Linux. DOS Notes If you are running within DOS (_not_ a DOS Prompt or DOS Shell under Windows for Workgroups, Windows 95, or OS/2) and you have less than 24MB of RAM you must set the environment variable DOS4GVM to the value 1. Windows 95 Notes If you are running under Win95 and you have less than 24MB RAM you must change your DOS properties settings. The value for DPMI memory must be changed from AUTO to 16384. The initial environment setting must also be changed from AUTO to a minimum of 4096 for some applications. Windows NT Notes Glide programs built for DOS4GW cannot be run under Windows NT. Glide Changes to Drivers 1. Hardware: Alliance AT3D and Voodoo Rush 2. glide.dll changed to glide2x.dll 3. sst.ini was removed 4. glide.lib changed to glide2x.lib (This library was imported) 5. API supports Glide applications running in a window 6. Glide API for linear frame buffer writes now contains stride information in order to support windowed applications and new hardware. 7. Supports DOS dynamically-linked libraries. Changes in Glide Version 2.3 Using Dual Video Cards Simultaneously Glide now supports running Voodoo Graphics and Voodoo Rush simultaneously in the same system, with certain restrictions. This can be achieved by arranging the search path so as to select the correct DLL when an application is run. Changes in Glide Version 2.2 These changes, originally described in the Glide 2.2 release notes, are repeated here for convenience. Some subroutines have been added in Glide 2.2, and in some cases, these replace routines in previous versions of Glide. The result is that there may be compatibility issues with existing applications. Changing existing Glide code will result in compatibility with future products and support windowed Glide applications with a minimum of effort. New Routines Several new routines have been added to support windowed Glide applications on Voodoo Rush, and to ensure compatibility with future hardware. GrSstWinOpen Allows for Glide in a window grSstWinClose Allows Glide applications to shut down and restart 3D engine safely grSstControl Used to inform glide of system events grLfbLock Changes the paradigm for LFB access, LFB access needed a notion of variable stride as well as a lockin notion for windowing systemsgrLfbUnlock grLfbUnlock See grLfbLock grLfbWriteRegion Locks are to be discouraged whenever possible in favor of optimized host memory BLTs which can be hardware accelerated grLfbReadRegion You may not read-lock FB RAM on an SLI system, we can, however read rectangles of FB RAM from an SLI system at the driver level. Routines Removed The following routines have been removed. The reasons for removal vary and are described in detail in the porting guide. For the most part, they represent areas where Glide’s old paradigms were incompatible with running in a window or running full-screen on systems, where the device to which Glide renders, is also the primary display adapter. * grSstOpen * grSstPassThru * grLfbBegin * grLfbEnd * guFbWriteRegion * guFbReadRegion * grLfbOrigin * grLfbwriteMode Bug Fixes * The primary focus of Glide 2.3 is support for Voodoo Rush and Glide in a window, so there were relatively few bug fixes. However, changes were made to solve the problem of sound breakup for several applications. * We no longer ship debug dlls. They will be distributed to Total Immersion members through 3Dfx Developer Support. Web Information To fully utilize our resources, visit website at http://www.3dfx.com/ Here, you will find useful links to the following: *If there is something that you cannot locate or would like to see here, we encourage you to e-mail your comments or suggestions to our news server news://news.3dfx.com. We always strive to provide the best support for our partners. * Products-http://www.3Dfx.com/products/products.html * FAQs- http://www.3Dfx.com/game_dev/general_faq.html * Technology Overviews- http://www.3Dfx.com/tech/tech.html * Game and Developer Information-http://www.3Dfx.com/game_dev/game_dev.html Development Support Total Immersion Program Total Immersion, the 3Dfx Interactive Developer Program is a collection of the top industry developers and publishers optimizing the hottest retail games for 3Dfx Interactive technology. Like the best games, the Total Immersion program is totally interacti ve and real time: we want your feedback so we can help make your products - and ours - truly great. Sign up for Total Immersion and become part of the inner circle of the new software elite. You’ll get to hang out with some of the best minds in the busines s and gain access to the big-league PC and coin-op markets via our roster of heavy-hitting industry partners. Just a few of the marketing and support benefits of being a Total Immersion developer are: * Co-marketing and promotional advertising and events with 3Dfx Interactive * Inside information from both 3Dfx Interactive and our industry-leading partners * A high-bandwidth, low-latency communication channel with 3Dfx Interactive partners, customers and other Total Immersion developers * Software Developer Kits (SDKs) to help you design and enhance your software using the advanced features found in 3Dfx Interactive products * Dedicated engineering support for your most radical game and tool development efforts via phone, e-mail, private newsgroups, and private access web site For more an application to the 3Dfx Interactive Developer Program or more information about Total Immersion, please e-mail devprogram@3dfx.com. Be sure to include all relevant contact information. Support Environment Resource Page To check out some cool sites that use Obsidian technology to deliver “affordable reality,” visit: * SAIC SIMTools-http://members.aol.com/simtools/index.htm * Gemini Technology-http://www.gemtech.com/ * MetaVR-http://www.metavr.com/3dfx.htm * Datapath Technologies-http://www.datapath.co.uk/ * Systems Technologies-http://www.systemstech.com/paramain.htm Development & Deployment As a member of Total Immersion, the 3Dfx Interactive Developer Program, game developers have access to dedicated engineering support for your most radical game and tool development efforts via phone, e-mail, private newsgroups, and private access web site. All technical and development issues are consulted by a well-versed and knowledgeable software engineering team. In addition to basic technical programming questions, the developer support team is on hand to aid in game development consulting. Utilize our staff to get the full suite of 3D advanced features from your 3Dfx optimized game. For more an application to the 3Dfx Interactive Developer Program or more information about Total Immersion, please e-mail devprogram@3dfx.com. Be sure to include all relevant contact information. Bug Reporting There is a new Bug Report form on the 3Dfx Interactive Developers Web Site. Please report problems using this form. If you are unable to access the Web Site and you must send e-mail, there is a form included on the CD. Look in \docs\3dfxbugs.txt for the proper format. You must use the keywords “Glide Bug” in the subject line for your submission to be processed. Developer Bug Submission Form 3Dfx Interactive, Inc. REQUIRED INFORMATION: Submitter: Company: Severity: 1=system crash/hang 2=feature severely broken 3=feature abnormality 4=cosmetic/enhancement request Hardware Product: (3Dfx Board Type) Rev: (Board Revision number) Software Product: (3Dfx Software, i.e., ATB, Glide, etc.) Version: (Software Version number, i.e., 2.0b, 2.0b1, etc.) OEM Video Board Vendor: (Name that card) Synopsis: (A brief description of the defect) Description: (A detailed description, including steps to recreate) Attached Files: (Files needed to recreate the problem) System: (System information for the computer used: processor type, speed, chip set, motherboard manufacturer, memory size) Operating System: (Windows 95, NT, DOS...) Compiler: (Watcom, MSVC...) 3DFX INTERACTIVE, INC. LICENSE AND CONFIDENTIALITY AGREEMENT LICENSE AND CONFIDENTIALITY: 3Dfx Interactive, Inc. (“3Dfx”) grants you the right to install the enclosed software and related documentation (collectively, the “Materials”) onto a single computer for your personal use. You may not use, copy, modify, sell , transfer or disclose any part of the Materials except as provided in this Agreement. You may only use the Materials in connection with the development of game titles, software products or demo software for 3Dfx products. RESTRICTIONS You may not: Sublicense or permit simultaneous use of the Materials by more than one user; Reverse engineer, decompile, or disassemble the enclosed software; Use the Materials for any purpose other than developing game titles, software products, or demo software for any platform or products other than 3Dfx products. Without limiting the generality of the foregoing, you may not use or disclose all or any part o f the Materials in connection with the development of products competitive with 3Dfx chips, drivers, APIs and other products; Make copies of the Materials other than for back-up purposes, and you may not use the back-up copies other than as a replacement for the original copy. You must include on the back-up copies all copyright and other notices included on the Materials; and E xport the Materials in violation of the export control laws of the United States of America and other countries. GENERATED CODE: 3Dfx hereby grants to you the right to include the object code “runtime” version of the enclosed software in your software product for the 3Dfx platform (the “Generated Code”) and the right to replicate and distribute (and have others repl icate and distribute) such object code “runtime” version of the enclosed software worldwide, but only as part of the Generated Code. You agree to indemnify 3Dfx and its affiliates against any loss, liability or expense (including reasonable legal fees) ari sing out of or in connection with the use, marketing, licensing or sale of the Generated Code or the maintenance, support or other services or activities related thereto. TERMINATION: Upon any violation of any of the provisions of this Agreement, your rig ht to use the Materials shall automatically terminate and you shall be obligated to return to 3Dfx or destroy all of your copies of the Materials. OWNERSHIP AND COPYRIGHT OF MATERIALS: Except for the license expressly granted hereunder, 3Dfx retains all r ights, title and interests in and to the Materials and all copies thereof. The Materials are copyrighted and are protected by United States copyright laws and international treaty provisions. You acknowledge that the Materials are valuable trade secrets of 3Dfx. You may not remove the copyright and other proprietary rights notices from the Materials. You agree that this Agreement shall be retained with all printed and electronic copies the software and documentation constituting the Materials. You agree to prevent any unauthorized copying of the Materials. Except as expressly provided herein, 3Dfx does not grant any express or implied right to you under 3Dfx patents, copyrights, trademarks, or trade secret information. NO WARRANTY; NO LIABILITY FOR DAMAGES: THE MATERIALS ARE PROVIDED “AS IS” WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND INCLUDING WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, NONINFRINGEMENT OF THIRD-PARTY INTELLECTUAL PROPERTY, OR FITNESS F OR ANY PARTICULAR PURPOSE. IN NO EVENT SHALL 3DFX BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DIRECT OR INDIRECT DAMAGES, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION, LOSS OF INFORMATION) ARISING OUT OF THE USE OF OR INABIL ITY TO USE THE MATERIALS, EVEN IF 3DFX HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Without limiting the generality of the foregoing, no warranty is made that the enclosed software will generate computer programs with the characteristics or specifi cations desired by you or that the Generated Code will be error-free. THESE DISCLAIMERS OF WARRANTY CONSTITUTE AN ESSENTIAL PART OF THIS AGREEMENT. Because some jurisdictions prohibit the exclusion or limitation of liability for damages, the above limitation may not apply to you and you may have other legal rights that vary by jurisdiction. NO SUPPORT: 3Dfx does not provide any support for the Materials. However, 3Dfx does have a newsgroup at its web site in which the enclosed software is discussed. 3Dfx does not, however, make any representations or warranties as to the accuracy of any statements or advice provided by any participant in the newsgroup. US GOVERNMENT RESTRICTED RIGHTS. Use, duplication or disclosure by the U.S. government is subject to restrictions set forth in subparagraphs (a) through (d) of the Commercial Computer-Restricted Rights clause at FAR 52.227-19 when applicable, or in subpar agraph ©(l)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or at 252.211-7015, or to 3Dfx’s standard commercial license, as applicable, and in similar clauses in the NASA FAR Supplement. Contractor/manufacturer is 3 Dfx Interactive, Inc., 4435 Fortran Drive, San Jose, California 95134. OTHER AGREEMENT: If you have executed another license agreement with 3Dfx with respect to the Materials, then notwithstanding any other term in this Agreement the terms of that licens e agreement shall control your use of the Materials. MISCELLANEOUS. Subject to the immediately preceding paragraph, this Agreement represents the complete agreement concerning this license and may amended only by a writing executed by both parties. If an y provision of this Agreement is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This Agreement shall be governed by California, U.S.A. law (except for conflict of law provisions). The applic ation the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. “3Dfx Interactive”, the 3Dfx Interactive logo, and other 3Dfx Interactive product names are trademarks, and in some jurisdictions may be registered trademarks, of 3Dfx Interactive or its affiliated companies. Other trademarks are the property of their respective owners. Copyright 1996, 1997 by 3Dfx Interactive, Inc. All rights reserved. 12/96 SDK NOTICE REGARDING SOFTWARE Any software that is made available to download from this site (“Software”) is the copyrighted work of 3Dfx Interactive, Inc. and/or its suppliers. Use of the Software is governed by the terms of the end user license agreement, if any, which accompanies o r is included with the Software (“License Agreement”). You will be unable to install any Software that is accompanied by or includes a License Agreement without first agreeing to the License Agreement terms. Reproduction or redistribution of the Software, including to any other server or location, not in accordance with the License Agreement is expressly prohibited.