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
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:
MediaMogul utilities required to prepare assets:
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.
Assets to create before using plug-in:
makesscrutility 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
.Sxxextension. For example, if you chose the prefix "goof" in
makesscr, it would assign names like "
goof.s02", up to "
goof.s64" (Mogul permits up to 64 hotspots per screen). Note that
makesscrdoes not CREATE the scripts "
goof.s02", etc. It just tells
cdi_sscrto 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!
cdi_sscrwhen the title is played.
cdi_sscruses the "X" MediaMogul variable to specify where the scroll picture is "scrolled" to. If you place a value in X, the next time
cdi_sscrattaches (runs), it will "pre-scroll" the picture to that spot. Also, just before
cdi_sscrdetaches (stops running) at a branch, it will record the current scroll position in X, for bookmarking purposes.
makesscris 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_sscrwill "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:
cdi_sscras a background plugin.
.0file as a Background picture.
.1, .2, .3file(s) as Background pictures.
.mnumenu file manufactured by
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