~4Dgifts/toolbox/src/exampleCode/video/scrollmon README scrollmon 1.1 An application for creating realtime scrolling credits or titles (graphics) for video production. Credits can be constructed from either anti-aliased text or SGI rgb images. scrollmon, when executed reads a description file, defaultly credits.txt in the local directory, and builds a series of bitmaps that it scrolls in a 4.0 Glx window. The scrolling attributes such as the speed, color, etc are based on the parameters in the file and on the command line. NEW for 1.1! -=-=-=--=-=- There are now menus as part of the interface that let you either re-read the credits file or open an entirely different one while the app is running. It also does a better job of refreshing the graphics if you obscure the credits window. Lastly there is a second button on the control panel that basically starts the reroll of the credits. Using this in conjunction with the stop start button you can set up the credits for a roll eg. press the stop button then press the rescroll button, now when you press the go button it will start the credits from the beginning. Not perfect but it should help with the timing of the roll. The options to scrollmon are as follows: # scrollmon -help usage: scrollmon [-options ...] [credits file] where options include: -p[erf] show performance indicator and perf msgs -d[ebug] print debug messages -f[ps] <frames per second> set update rate, default = refresh rate -s[peed] <scan lines> set speed by # of scan lines to move in y -w[idth] <# pixels> window width in pixels (default 640) -h[eight] <# pixels> window height in pixels (default 480) -h[elp] print this usage message The precise regularity of the graphics updates is key to having smooth, non- interrupted scrolled graphics for video. Although it is not always possible to guarantee this 100% because of other system activity it is possible to significantly increase the likelihood of this behavior by raising the priority of the process to NDPHIMIN and setting the process such that it is immune to process swapout. This program is built with code that does this but in order for this to be executed the process must be run as root or run setuid with root permissions. As stated above, the credits source file defaults to credits.txt in the local directory. The one included with this example has a header which describes all the directives possible for the description of the credit elements. # # **** Definitions for commands ***** # # All command lines begin with a ':' followed by one of the following # command words and their associated parameters # : COLOR <red value> <green value> <blue value> <colorname> - black is defnd # : FONT <fontname> <pointsize> <colorname> <justify(C,L,R)> <angle> <spacing> # : IMAGE <filename> <x offset> <y offset> # : LMARGIN <# of pixels from the left> # : RMARGIN <# of pixels from the right> # : BGCOL <colorname> - defaults to black # # All lines beginning with a '#' are comment lines. # All other lines are lines of text which will be rendered with the most # recent FONT command properties. # Currently, scrollmon's video button is non-functional. In a future release you will be able to combine the text and images with live video in the same window and record the resulting composite images. NOTE: For use on Irix 4.0.x This application was built to run in a 5.1.x environment but can be built to run on 4.0.x systems. Use Makefile.irix4 to build on 4.0.x machines. In order to have the colored pixmaps work correctly you should install the X resource defaults contained in Scrollmon either by using the 'xrdb -merge' command or by including the lines in that file in you .Xdefaults file or bye using the "run" script included in the source directory. BUGS: Because of a bug in the libwfm library this application will not run on a remote machine (dgl error). If you want this functionality you can replace the libwfm calls with the equivalent libfm calls. You will lose the ability to render anti-aliased fonts, however.
Source
Documentation
Images
Bitmaps
Reference
Subdirectories