Subj : ANSI Gallery help??
To : All
From : paulie420
Date : Sun Apr 11 2021 03:34 pm
So... I know how to use a different template for VIEWING an ANSI file - to where I can call a different template, but...
If I use the ANSI Gallery it revert to the stock one; how can I use the ANSI Gallery, and either.... have two ANSI Gallery versions?
Like can I call and ANSI Gallery and NOT user the stock ansigal.ans?
OR, can I use the stock ansigal.ans and call an ANSI Gallery, but USE one of my custom templates for the viewing of said files inside that /directory?
I've read all the docs in whatsnew.txt and... help?
(Heres all the docs I DID find on this issue and... while I understand how to view ONE file using a custom template with a GV command, I want to use the GA command, and either be able to use a custom ansigal.ans OR at least use my custom template when the ANSI Gallery displays said files. Lol... Everything below this is just docs on these items.)
-----------------------------------------------------------------------------
+ Mystic now has an internal ANSI gallery. A new menu command, 2 new
templates, a new percent bar configuration, and several new prompts come along with this. The new menu command is GA and takes a command line option that points to the root of where your ANSI files exist. This allows the user to move around through the directory structure starting at the root supplied in the command option data. The gallery allows for an unlimited "depth" in the directory structure with the only limitation being that each directory can have up to 1,000 files or folders in it. The gallery supports file downloads, first letter filename jumping, and full arrow/pageup/pagedown/home/end manuvering. The gallery will also attempt to import SAUCE tags on the fly while presenting the directory structure which will be sorted alphabetically on the fly. SAUCE data is available as Prompt Info codes in the prompts that go along with it. This stuff is CPU intensive and wasn't really viable "back in the day". A new percent bar configuration can be found in the language settings in MCFG for the Gallery Bar. This bar in the default template expects a bar length of 20. You will need to go set that up how you'd like it, and if you do not want to use it you can simply blank out the percent bar prompt. Two new templates go with this: ansigal.ans - Contains the main gallery screen. ScreenInfo codes !1 and !2 are used to define the top line and the bottom line in the file listing box. The actual content of the box is defined using prompts. ansigalh.ans- This is the help screen displayed when the user enters a ?. Enjoy! GV - View a display file in ANSI viewer Data: <template>;<helpfile>;<speed>;<filename>[;END] The ANSI viewer shows a file within the full screen, allowing the user to scroll up and down through the file using their arrow keys, page up/down, and home keys. The viewer also has the ability to extract and display SAUCE tags to get the artist and group information. Pressing SPACE will also display the file in a "traditional" BBS way, scrolling from start to finish using the supplied emulated baud rate. Several values are required in the DATA field for this command, separated by a semi-colon: <template> defines the template used for the viewer itself, found in the current theme's display (text) directory. For more information on configuration of the template, see **TO BE COMPLETED** section. <helpfile> defines the help file displayed when the user selects to show help from within the viewer. It should be in the text directory. <speed> defines the baud rate to emulate when displaying the file if the user selects <space> to display traditionally. Use a baud rate of 0 for a full speed display. <filename> defines the name of the file to actually display to the user. If no file extension is provided, ".ans" will be assumed. If no path is provided, Mystic will use the current theme's text directory. Optional paramenters: <END> if ";END" is added after the filename field, the viewer will start viewing at the end of the file instead of the beginning. Examples: Command: GV Data: ansigalv;ansigalh;38400;myansifile Command: GV Data: ansigalv;ansigal;0;myansifile;END The first example will execute the display file viewer using the template "ansigalv" and the help file "ansigalh" with the baud rate of 38400 if a user presses <space> to do a traditional view. The file "myansifile" is the display file, since it is missing a path and a file extension, Mystic will use ".ans" and the current theme text directory. The second example is the same as the first, except it displays the file at full speed instead of 38400 baud emulation, and also starts showing the file at the end of the file, rather than the beginning.
-----------------------------------------------------------------------------
