ACiD View 6 for Windows   by Acid Productions

,gg """"Y$b ,d$P""Y$b ,d$P ,d$P""Y$$' ,d$P""Y$$' ,$$' `""" ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ",$$' ",$$' ,$$' ",$$' ,$$' ,$$' ",$$' """"""""""""""""""""" " "" "" " """ " ,$$' .$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$ ,d$"""Y$b ,$$' ,$$' ,$$ `"""""""' `"""""""' `"' `"""""""' ,$$' ,$$' ,$$' ,$$""""""' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' " " "" "" """ """"""""""""""" ,$$' ",$$' ,$$ ,$$' ",$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' `"""""""' `"' `"""""""' `"""""""""""' A Multi-format Image Viewer by ACiD Productions, LLC Coded by gz - Graphics by Alla Xul, Asphyx and Zerosynapse ┌┐─── ── ─ ─ ── ──────────────────────────────────────────────────┬─ ∙∙ └┼────────────────────────────────────────────────────────────────────┐ ││ Documentation & Update History of ACiD Productions LLC's ACiD View │∙ :│ │: ∙│ By gz and RaD Man of ACiD Productions, LLC(tm) ││ └────────────────────────────────────────────────────────────────────┼┐ ∙∙ ─┴───────────────────────────────────────────────── ── ─ ─ ── ───└┘ [ Current version of ACiD View: 6.10 / 2003-10-15∙06:10 ] Up to date versions of ACiD View may be found on the ACiD Website under the Info section, http://www.acid.org/. ┌────────────────────────────╖ │ Introduction to ACiD View ║ └════════════════════════════╝ We at ACiD Productions, LLC proudly present to you the first Windows-based viewer for the artscene. This highly innovative program is capable of displaying a wide variety of formats such as ANSI, ASCII, ADF, BIN, GIF, JPEG, PNG, RIPscrip & XBIN with additional supported formats underway. ACiD View for Windows utilizes its own internal ANSI routines making it capable of viewing ANSI without fussing with the configuration of an internal device driver. We hope that this version of ACiD View provides you with the countless hours of pleasure that we've sought after with its creation. ┌──────────────────────────╖ │ Features ║ └══════════════════════════╝ ■ Supports SAUCE descriptions in title bar and full SAUCE option ■ Navigate and view files from a ZIP or RAR without decompressing ■ Command Line viewing supported ■ Slide Show mode ■ Save-As PNG or AVI for ANSI animations ■ Windows File Type/File Extension registration ■ Drag and Drop Loading of image files into the viewer ■ History kept of Viewed Files, File Masks, and Recent Directories ■ Variable Speed ANSI viewing ■ Modem-Simulation for animated ANSI viewing (2,400-57,600 bps) ■ Multiple File Masking ■ Drive and Directory switching ■ Automatic Smooth Scrolling option for text-based viewing ■ 25-, and 50-line mode ANSI, ASCII and BIN viewing ■ Built in Text-mode fonts: Standard IBM PC, Amiga, and AcidView ■ ANSI and BIN Viewing in 80x25 or 80x50 text-modes ■ ANSI and BIN Viewing in 640 pixels wide (1/1, 8x16 font) - Normal ■ ANSI and BIN Viewing in 320 pixels wide (1/2, 4x8 font) - "MCGA" ■ ANSI and BIN Viewing in 160 pixels wide (1/4, 2x4 font) - "VGA" ■ ANSI and BIN Viewing in 80 pixels wide (1/8, 1x2 font) - "SVGA" ■ ANSI and BIN Viewing in Full Screen Mode ■ Palette options: Color, iCE-Color, Greyscale, and ASCII-only ■ Resident XBIN Font and XBIN Palette loading ■ Secret RIPscrip Level 0-1 viewing ■ (GIF) CompuServe [G]raphics [I]nterchange [F]ormat viewing ■ (JPEG) [J]oint [P]hotographic [E]xperts [G]roup JFIF viewing ■ (PNG) [P]ortable [N]etwork [G]raphics viewing ■ Full mouse support ┌──────────────────────────╖ │ System Requirements ║ └══════════════════════════╝ ■ VGA: Standard SVGA card in 640x480x16bit (1024x768 recommended) ■ CPU: Pentium 586 or better processor (Pentium II 686 recommended) ■ RAM: 2MB RAM required (10MB recommended) ■ OS: Microsoft Windows 95* or above. * = While ACiD View for Windows is coded with the users of Windows in mind, this version has been tested and reported to be compatible with both Linux under WineX and MacOS X using Virtual PC. ┌──────────────────────────╖ │ What ACiD View Displays ║ └══════════════════════════╝ ■ ACiD View will display any traditional text-mode format, not just ANSI, in several different sizes. Where as previous DOS versions had various "VGA modes" you could use to scale down the size of an ANSI, ACiD View utilizes your native display resolution and offers several different font sizes to accomplish the same effect. Supported sizes are: Normal (standard 8x16 font), Half-size (4x8), Quarter-size (2x4) and Eighth-size (1x2). ■ ACiD View shows GIF, JPEG and PNG graphics files. ■ Support for other popular BBS image formats is in development. ┌──────────────────────────╖ │ ACiD View Functions ║ └══════════════════════════╝ Function Keys KeyPad ┌─────────────────────────────┐ ┌──────┬──────┬──────┬─────┐ │ F1 = Help │ │ Num │ Next │ Prev │ - │ ├─────────────────────────────┤ │ Lock │ Font │ Font │ Res │ │ F2 = Toggle Full Screen │ ├──────┼──────┼──────┼─────┤ ├─────────────────────────────┤ │ Home │ Up │ Page │ │ │ F3 = Switch Font Size │ │ │ │ Up │ │ ├─────────────────────────────┤ ├──────┼──────┼──────┤ + │ │ F4 = Switch Character Set │ │ Left │ │ Right│ Res │ ├─────────────────────────────┤ │ │ │ │ │ │ F5 = Refresh Display │ ├──────┼──────┼──────┼─────┤ ├─────────────────────────────┤ │ End │ Down │ Page │ │ │ F6 = Toggle Smooth Scroll │ │ │ │ Down │ │ ├─────────────────────────────┤ ├──────┴──────┼──────┤Enter│ │ F7 = Toggle BPS │ │ Insert │ Del │ │ ├─────────────────────────────┤ │ │ │ │ │ F8 = Start Slide Show │ └─────────────┴──────┴─────┘ ├─────────────────────────────┤ │ F9* = Toggle Ext/Blinking* │ ├─────────────────────────────┤ │ F10 = Screen Capture to PNG │ ├─────────────────────────────┤ │ F11 = Show full SAUCE info │ └─────────────────────────────┘ ┌────╖ │ F1 ║ Quick-Help : Brief description of the keys. └════╝ ┌────╖ │ F2 ║ Full Screen : Toggles between the native video mode defined └════╝ under Windows and Full Screen mode. ┌────╖ │ F3 ║ Font Size : This determines the font size to be used while └════╝ displaying a text-based file. Normal, Full Scale is 8x16, MCGA 4x8, VGA 2x4 and SVGA 1x2. These heights are halved when in 50-Line mode. ┌────╖ │ F4 ║ Character Sets : Toggles which font will be used while displaying └════╝ a text-based file. Options are 25-Line, 50-Line, Amiga Topaz and "ACiD View" PC DOS character sets. ┌────╖ │ F5 ║ Refresh : Refreshes the display with the Modem Emulator └════╝ turned OFF, stripping the ANSI animation sequences. ┌────╖ │ F6 ║ Smooth Scroll : Toggles automatic smooth scrolling of a text-based └════╝ file. If off, the user must manually scroll down from the top of the file using the keyboard, mouse wheel or sliding elevator bar. ┌────╖ │ F7 ║ Modem Speed : Increases the modem emulator speed for text-based └════╝ files up to 57,600bps then restarting back at 2,400. ┌────╖ │ F8 ║ Slide Show : Start/Stop Slide Show. Refer to Slide Show context └════╝ menu for further details. The Escape key will also abort the Slide Show. ┌────╖ │ F9*║ Toggle Blink* : Determines if 16 background colors instead of └════╝ blinking will be used for ANSI and BIN display. ┌────╖ │F10 ║ Screen Capture : Captures the display to a PNG image file. └════╝ ┌────╖ │F11 ║ Display SAUCE : Displays full SAUCE information including the └════╝ extended COMMENT block. * = Not yet available in this version of ACiD View. ┌────────────────────╖ │ ACiD View Hot Keys ║ └════════════════════╝ CTRL+O : OPEN a specific file. CTRL+J : JUMP to Directory. Expands selected folder in browser. CTRL+UP : Opens PREVIOUS file. CTRL+DOWN : Opens NEXT file. ALT+LEFT : Go backward through navigational history log. ALT+RIGHT : Go forward through navigational history log. CTRL+LEFT : INCREASE resolution (by decreasing font size) CTRL+RIGHT : DECREASE resolution (by increasing font size) CTRL+1 : 2400 BPS Modem Emulation CTRL+2 : 4800 BPS Modem Emulation CTRL+3 : 9600 BPS Modem Emulation CTRL+4 : 14,400 BPS Modem Emulation CTRL+5 : 28,800 BPS Modem Emulation CTRL+6 : 38,400 BPS Modem Emulation CTRL+7 : 57,600 BPS Modem Emulation SHIFT+F5 : Refresh display with Modem Emulation turned ON. F5 : Refresh display with Modem Emulation turned OFF. ALT+ENTER : Display image in Full Screen mode. This can also be done with the F2 key. ┌──────────────────────────╖ │ ACiD View Mouse Controls ║ └══════════════════════════╝ LEFT-CLICK : Selects a file to view in the navigation window. MIDDLE-CLICK : Toggles between Full Screen and Windowed mode for text-based images. This can also be done with the F2 key. SCROLL-UP/DN : Scrolls the text-based image up and down in the image window. ┌────────────────────────────────────────╖ │ Using ACiD View with Windows Explorer ║ └════════════════════════════════════════╝ When ACiD View is selected as the default viewer for file type such as ANSI and ASCII, several options are available to the user from the Windows file Explorer. - Slide Show can be launched from Explorer by selecting any number of images supported by ACiD View and selecting "Slideshow" from the right-button context menu. - Drag and Drop Loading. Images can be dragged from Explorer right in to ACiD View for display. ┌─────────────────────────────────╖ │ ACiD View Slide Show Options ║ └═════════════════════════════════╝ Within the ACiD View GUI, there are several preference settings which can be configured. Full Screen Resolution - Four (4) resolutions are available to choose from if Full Screen mode is enabled; 640x400, 640x480, 1024x768 and the Desktop resolution. Slide Show: Files to be displayed in the Slide Show may be queued one of two ways, either by a standard ASCII text file list of files ("Text File") or by displaying the entire contents of a chosen Directory, RAR or ZIP file, the default being the current directory. Start Full Screen - This will start the Slide Show in Full Screen with the resolution specified above. Random - This will display the files queued in a random order. Cycle - This will endlessly cycle through all the files in the queue until the F8 or Escape key is pressed. Delay - This is the amount of time to pause before showing the next image in the queue. The default value is 2000 milliseconds. Other options such as File Mask, Font Size, Font Set, and Color are based on the current settings. ┌─────────────────────────────────╖ │ ACiD View Command Line Viewing ║ └═════════════════════════════════╝ ACiD View now supports a full set of command line switches which are useful to execute a Slide Show. At present, you can specify a specific file you would like to view from the command line using the following syntax: ACiDview.exe [drive:][path][filename] i.e.: ACiDview.exe R:\ACiD\Artpacks\Best_of\best.1994\SO-EVEND.ANS ACiD View for Windows Command Line Options: ACiDview.exe /X /R:# /F:# /C:# /D:# /S:[0|1] /Y:[0|1] /A:[0|1] (continued) /M:mask(s) @Inputname(s) /X - required to execute Slide Show. /R (Font Size) /F (Font Set) /C (Color) /D (Display) 0 - Normal 0 - Normal 0 - Normal 0 - 640x400 1 - MCGA 1 - 50 Lines 1 - Greyscale 1 - 640x480 2 - VGA 2 - Amiga 2 - ASCII 2 - 1024x768 3 - SVGA 3 - AcidView 3 - Desktop /S - If 0, start display in a WINDOWED mode. If 1, start FULL SCREEN using the display resolution specified with the /D switch (or use the default value in the registry). /A - If 0, then only show the files in the queue once. If 1, then continuously repeat the Slide Show AGAIN once all the files in queue have been shown. /Y - If 0, display files in the order they are queued. If 1, display queued files at RANDOM. /M - MASK(s) off semicolon delimited extension(s) listed in quotes, e.g. "/M:*.ans;*.jpg" to be displayed. @Inputname(s) - Space delimited file list that can include text file lists (ending in .TXT), directories (ending with \), compressed files (ending in .ZIP or .RAR), or supported graphics files. -=- Default values are loaded from the registry -=- Examples: ACiDview.exe /X acid-81a.rar acid-81b.rar This will start a SLIDE SHOW and display all supported images within acid-81a.rar and acid-81b.rar ACiDview.exe /X /R:0 /F:1 /C:0 /D:0 /S:1 /Y:1 /A:1 /M:*.ans (continued) acdu0194.zip acdu0294.zip favfiles.txt JD-DSOC2.ANS testdir\ A complex heap of options enabled, this example will begin a Slide Show using NORMAL attributes for the font size and color with a 50 LINE mode font set and FULL SCREEN display resolution of 640x480. ACiD View will proceed to display only the ANSI files ending in .ANS within the ZIPs, those listed in the text file favfiles.txt which end in .ANS, the local file JD-DSOC2.ANS, and finally all the .ANS files in the relative local directory testdir\, all in RANDOM order, repeating the Slide Show infinitely over and over until the F8 or Escape key is pressed. ┌─────────────────────────────────╖ │ ACiD View Windows Registry Keys ║ └═════════════════════════════════╝ To re-initialize the Windows file type/file extension registration, delete the following key: HKEY_CURRENT_USER\Software\ACiD\ACiDView\Settings\registered On slower computers, smooth scrolling parameters can be tweaked by modifying the following key: HKEY_CURRENT_USER\Software\ACiD\ACiDView\Settings\scrollAmt,scrollTimer ┌──────────────────────────╖ │ Acquisition Viewer 6.10 ║ └══════════════════════════╝ 1) Added Save-As PNG (F10) and Save-As AVI for ANSI animations. 2) Added ability to navigate and view files within a ZIP or RAR. 3) Added Slide Show mode. 4) Added extensive support for the Command Line. 5) Added XBIN font and XBIN palette loading. 6) Added a stripped-down ASCII palette for viewing of "Hidden Greets". 7) Added a history of Viewed Files, File Masks, and Recent Directories. 8) Added a choice of resolutions for Full Screen mode. 9) Added bottom status bar which displays Modem-Emulation information. 10) Improved emulation for Modem Speeds. 11) Faster loading and rendering. 12) Fixed bugs with update screen errors. 13) Better ANSImation support. 14) Improved Amiga Topaz font added which supports umlauts. 15) Added more hidden features. =) ┌──────────────────────────╖ │ Acquisition Viewer 6.00 ║ └══════════════════════════╝ 1) Initial public distribution of ACiD View for Microsoft Windows. ┌──────────────────────────╖ │ Credits ║ └══════════════════════════╝ Code and Interface Design: gz Splash Screens: Asphyx and Zerosynapse Windows Icons: Alla Xul Code Review: Eto, SIDS and Tasmaniac Additional Thanks: Bob Copeland (ANSIconv), CodeProject.com (Explorer Window), Rich Geldreich (jpgd), Glenn Randers-Pehrson (libpng), Gershon Elber & Eric S. Raymond (libungif), Christian Scheurer & Johannes Winkelmann (urarlib), Jean-loup Gailly & Mark Adler (zlib), and Venturus of Vandals for the superior Amiga Topaz character set font for DOS. Beta Testers: Anthem, Bhaal, Black Jack, Cat-Dog, Jashiin, Iron Lung, L4s3r, Phayzed, Sublinear, Wikkesh and Yce! Special Thanks: RaD Man ┌──────────────────────────╖ │ Bugs? ║ └══════════════════════════╝ If you have any suggestions or manage to find any bugs, please report them to the author, gz ([email protected]) and cc: RaD Man ([email protected]). →COMNTTodays magic keystrokes are: CTRL+ALT+9 = Enable 9th column for 9x16 fonts in normal rez. CTRL+ALT+R = Enable Hidden RIPscrip 0-1 emulation. SAUCE00ACiD View 6 Documentation gz & RaD Man ACiD Productions 20031015IE☺Pš☺♥