Super Scroller Supplement

Super Image Scroller allows you to navigate back-and-forth or up-and-down on an specially prepared scrolling-picture. The scrolling-picture may be longer or wider than the screen, and is superimposed onto a full-screen picture. The scrolling-picture itself can have hotspots on it. Scrolling Control is done via Menu-Editor-created $ hotspots, or hotspots on the scrolling picture, as created by makesscr. cdi_sccr is used as a background plugin and runs until the user clicks a non-$ hotspot (on or off the scrolling-picture), which causes a branch to the script defined by the hotspot.

Plug-ins required for operation:

makesscr - a utility which manufactures the necessary scroller files for use with MediaMogul. Runs under OS-9 only.

cdi_cssr - the Mogul plugin which provides the scrolling feature.

makesscr

Assets to create before using plug-in:

• Foreground Picture - 384 x 240 or 384 x 280, CLUT7 or CLUT4
• Background Picture - 384 x 240 or 384 x 280, CLUT7 or CLUT4
• Menu for hotspots on Foreground Picture (i.e. NOT on scrolling picture). Use Menu Editor.
• Scrolling Picture - any dimensions as long as less than 100k or 300k bytes (non-DV or DV equipped player). CLUT7 or CLUT4
• Picture to define Scrolling Hotspots - same dimensions as Scrolling picture, but with flood-filled areas where hotspots are desired. CLUT7

Special preparations:

• The menu for the Foreground Picture is created in the MediaMogul Editor, using the $ hotspots as appropriate for $UP_BUTTON, $DOWN_BUTTON, $LEFT_BUTTON, $RIGHT_BUTTON, $WINDOW, and if you want a scroll bar, $SCROLL_BAR.
  
  
• The scrolling picture FILE size can be up to 100k bytes if the title is played on a base case player, or 300k bytes if a DV cartridge is guaranteed to be present in the player.
  
  
• The picture being used to define hotspot areas for the scrolling picture has flood-filled rectangles where you desire hotspots. The flood-filled picture must be a CLUT 7, with the flood color assigned to CLUT Entry 0. The makesscr utility will scan this picture for flooded areas (left-to-right, top-to-bottom) and define hotspots accordingly. As hot areas are defined by makesscr, it assigns each a "branch to name" prefix along with a .Sxx extension. For example, if you chose the prefix "goof" in makesscr, it would assign names like "goof.s01", "goof.s02", up to "goof.s64" (Mogul permits up to 64 hotspots per screen). Note that makesscr does not CREATE the scripts "goof.s01", "goof.s02", etc. It just tells cdi_sscr to branch to a script by that name, if clicked.
  

  Note: If you are creating MediaMogul titles on a Windows PC, the prefix name MUST be 4 characters or LESS! If you make the prefix longer, SuperScroller will work correctly from the ScriptWriter, but NOT in emulation, nor off the CD!

  
  
• The scroll bar itself will be dynamically drawn in the CLUT entry 0 color (of the Foreground Picture), by cdi_sscr when the title is played.
  
  
• cdi_sscr uses the "X" MediaMogul variable to specify where the scroll picture is "scrolled" to. If you place a value in X, the next time cdi_sscr attaches (runs), it will "pre-scroll" the picture to that spot. Also, just before cdi_sscr detaches (stops running) at a branch, it will record the current scroll position in X, for bookmarking purposes.
  
  
• makesscr is a utility that scans the foreground picture, background picture, scroll picture, Foreground menu, and scroll hotspot picture and creates a number of special files to be used in the MediaMogul script:
  
  
  • name.0 -- the file containing scroll picture information.
  • name.1, .2, .3 -- the file(s) containing the scroll picture itself.
  • name.mnu -- a menu file manufactured by makesscr, containing hotspot definitions for both scrolling and non-scrolling hotspots. Scrolling hotspot definitions are added after the "TIMEOUT" line, where Mogul itself will ignore them, but where cdi_sscr will "see" them.

How plug-in works:

A full-screen foreground picture is brought in first via a dissolve, cut, etc. Next, cdi_sscr is started up as a background process. 00:20 or so later, it begins to scan the background video plane for files that end in .0, .1, .2 or .3. As they load, it moves them elsewhere in memory. After all the .n files have been loaded, the full-screen background picture is loaded. It has to be loaded last, else it would be obliterated by a .n file. Finally, the makesscr manufactured menu file (something.mnu) is loaded, with WAIT. When cdi_sscr sees that a WAIT command has been done, it displays the scrolling picture and draws the scroll bar (if specified). It also retrieves the contents of variable "X" and scrolls the image to that spot. Clicking on $ hotspots invoke navigation of the scroller, etc. Clicking non-$ hotspots invoke a branch. cdi_sscr quits at the branch, storing the current scroll position in variable "X".

To properly setup a script to use SuperScroller:

• Load the Foreground picture
• Call cdi_sscr as a background plugin.
• Load the .0 file as a Background picture.
• Load the .1, .2, .3 file(s) as Background pictures.
• Load the Background picture itself.
• Load with WAIT, the .mnu menu file manufactured by makesscr

Examples:

Typical script:

00:00   	Skip_off      
00:00   	Dissolve      	/h0/PLUGINS/SCROLL/VIDEO/scrollr.dyu	00:20  
00:00   	Call_bg       	/h0/SUBROUT/cdi_sscr CURS_DOWN,PAGER,TRANSPARENT 5
00:20   	Background    	/h0/PLUGINS/SCROLL/VIDEO/vtr.0
01:10   	Background    	/h0/PLUGINS/SCROLL/VIDEO/vtr.1
02:00   	Background    	/h0/PLUGINS/SCROLL/VIDEO/scrollr.dyu
02:00   	Wait          	/h0/PLUGINS/SCROLL/MENUS/vscroll.mnu

;CA 4485479

VIDEO /H0/PLUGINS/SCROLL/VIDEO/SCROLLR.DYU
REGION $DOWN_BUTTON NO_RETURN D_RECT 396 464 480 544 36
REGION $UP_BUTTON NO_RETURN D_RECT 402 413 474 465 36
REGION $WINDOW NO_RETURN D_RECT 494 44 668 546 36
TIMEOUT / NO_RETURN
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s01 RETURN D_RECT 494 0 668 160
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s02 RETURN D_RECT 508 182 650 256
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s03 RETURN D_RECT 508 872 650 946
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s04 RETURN D_RECT 508 970 650 1044
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s05 RETURN D_RECT 508 1068 650 1142
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s06 RETURN D_RECT 508 1166 650 1240
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s07 RETURN D_RECT 508 1264 650 1338
REGION /h0/PLUGINS/SCROLL/SCRIPTS/scroll.s08 RETURN D_RECT 494 1374 666 1534