Readme: | Short: SDL scripting with Hollywood Author: andreas@airsoftsoftwair.de (Andreas Falkenhahn) Uploader: andreas airsoftsoftwair de (Andreas Falkenhahn) Type: dev/hwood Version: 1.1 Architecture: ppc-amigaos; ppc-morphos
RebelSDL is a plugin for Hollywood that allows you to use SDL (Simple DirectMedia Layer) from Hollywood. This makes it possible to write scripts that utilize the host system's graphics hardware to create high-performance, butter-smooth 2D animation that is produced completely in hardware by the GPU of your graphics board. This leads to a huge performance boost over the classic Hollywood graphics API which is mostly implemented in software for maximum portability and compatibility. Especially systems with slower CPUs (like the Raspberry Pi) will benefit greatly fro hardware-accelerated drawing, scaling, and transformation offered by SDL.
SDL is a cross-platform development library designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware via OpenGL and Direct3D. It is used by video playback software, emulators, and popular games. More information about SDL can be obtained from http://www.libsdl.org. You can find good tutorials about learning SDL all over the web.
RebelSDL transparently replaces Hollywood's inbuilt display handler with its own display handler managed by SDL. Whenever RebelSDL is activated, Hollywood displays are automatically mapped to SDL windows and hardware brushes are mapped directly to SDL textures so that they can be drawn, scaled, and transformed in an extremely quick way on all supported systems. This is especially useful on Windows, Mac OS X, and Linux because Hollywood doesn't support hardware double buffers and hardware brushes on these platforms by default. With RebelSDL, however, hardware double buffers and hardware brushes can be used on these platforms now too. So RebelSDL can also act as a helper plugin here which adds this functionality to Hollywood without having you write a single line of SDL code to utilize it!
On top of that, RebelSDL offers wrapper functions for some useful commands of the SDL API, for example RebelSDL allows you to call SDL's joystick and game controller functions which are much more flexible than Hollywood's inbuilt joystick library. RebelSDL also allows you to access Hollywood hardware brushes as SDL textures and modify their properties via some dedicated SDL calls exposed by RebelSDL.
Finally, RebelSDL also replaces Hollywood's inbuilt audio driver with the audio driver offered by SDL. In contrast to the graphics driver SDL's audio driver probably doesn't have any advantage over Hollywood's inbuilt audio driver but by using it RebelSDL will make your program into a complete SDL application which doesn't only use SDL for graphics output but also for audio output.
RebelSDL utilizes the new display adapter plugin interface introduced with Hollywood 6.0. Thus, the plugin will not work with any older versions of Hollywood. It requires at least Hollywood 6.0. Whenever RebelSDL is activated, all graphics and audio output will automatically be routed through SDL. To benefit from hardware-accelered drawing, however, Hollywood scripts have to follow some rules as described in this manual.
RebelSDL comes with extensive documentation in various formats like PDF, HTML, AmigaGuide, and CHM that contains information about how to use this plugin. On top of that, many example scripts are included in the distribution archive to get you started really quickly.
All of this makes RebelSDL the ultimate scripting experience for all you SDL rebels by combining the best of both worlds into one powerful plugin: Hollywood's extensive and convenient multimedia function set and SDL's raw graphics power!
|