OS4 DepotLogo by Alkaron 
(anonymous IP:,1831) 

   Bug tracker
   Locale browser


   o Audio (333)
   o Datatype (50)
   o Demo (198)
   o Development (572)
   o Document (21)
   o Driver (96)
   o Emulation (144)
   o Game (944)
   o Graphics (486)
   o Library (107)
   o Network (223)
   o Office (61)
   o Utility (875)
   o Video (65)

Total files: 4175

Full index file
Recent index file



Support the site

 Readme for:  Library » Hollywood » hwp_plananarama.lha


Description: Hollywood plugin for planar screen
Download: hwp_plananarama.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size: 48kb
Version: 1.0
Date: 12 Jan 2016
Author: andreas@airsoftsoftwair.de (Andreas Falkenhahn)
Submitter: uploader
Homepage: http://www.hollywood-mal.com/
Requirements: Amiga with ECS/AGA screens
Category: library/hollywood
License: Other
Distribute: yes
Min OS Version: 4.0
FileID: 9691
Comments: 0
Snapshots: 0
Videos: 0
Downloads: 39  (Current version)
121  (Accumulated)
Votes: 0 (0/0)  (30 days/7 days)

Show comments Show snapshots Show videos Show content Show crashlogs Replace file 

The Plananarama plugin allows Hollywood to run on planar (palette-based)
screens. This finally
makes it possible to run Hollywood scripts on plain AGA or ECS systems with no
graphics board
installed - for the first time since Hollywood 1.93 (released in March 2005)!
Starting with
version 2.0, Hollywood required CyberGraphX or Picasso96 to run. Since then,
many people have
asked for a revival of Hollywood's planar engine, so here it is, a real blast
from the past!
Thanks to Hollywood 6's greatly extended plugin API this feature could be
completely in plugin space. Once Plananarama is installed, all Hollywood scripts
will magically
run on palette screens again! All resolutions are supported - from 8-bit LowRes
to 1-bit
productivity SuperHighRes Interlace.

This plugin was first created during the development of Hollywood 6.0 a
proof-of-concept for
the flexibility of Hollywood 6.0's powerful display and bitmap adapters. This
plugin completely
replaces Hollywood's default display adapter and installs a custom one that is
able to run on
planar screens. 


This plugin requires at least Hollywood 6.0 since it uses the display and bitmap
adapter APIs
introduced with Hollywood 6.0.

Additionally, there are the following requirements:

- guigfx.library
- render.library (*)
- FBlit (**)
- some fast memory for FBlit

(*) Note that render.library is available in two flavours: The latest version is
v40.8. It is a
C port of the original render.library which was written in 68k assembler. The
assembler version
of render.library is much faster than the C version which is why you might want
to use the
assembler version instead. The latest assembler version of render.library is
v31.0. Plananarama
doesn't require v40, you can also use v31 if you care about performance.

(**) FBlit is not actually required but highly recommended because otherwise
your chip memory
will be gone in no time and Hollywood will run out of memory. So make sure you
install FBlit
first and you add Hollywood to its "Include" list in the "FAllocBitMap" tab. If
Hollywood is
included in this list, it will be able to place graphics in fast memory which is
needed since 2 MB of chip memory certainly won't be enough for Hollywood. Using
FBlit also has
the advantage that Hollywood can use the CPU for blitting which is much faster
than the blitter
on higher 68k CPUs or WinUAE anyway.


There are several ways to use this plugin: You can either activate the plugin
for a script by
()REQUIRE-ing it. To do this, simply put the following preprocessor command at
the top of your

    ()REQUIRE "Plananarama"

Or you can use the REQUIREPLUGINS argument from the command line or set the
tooltype of the very
same name. This is the preferred method to use if you don't want to modify the
scripts you want
to run with Plananarama, maybe because they should only use Plananarama on
AmigaOS 3 systems but
on other systems they should run without it. Here is an example:

    1> Hollywood Hollywood:Examples/Hollywood/3DText/3DText.hws -requireplugins
You can also use the REQUIREPLUGINS argument in the tooltypes. The tooltype
version would be:


When using the Hollywood GUI, you can route every Hollywood script launched from
the GUI
through the Plananarama plugin, by going to the "Prefs/Hollywood..." menu and
"-requireplugins plananarama" in the "Additional interpreter arguments" text


Plananarama supports several options which can be passed to ()REQUIRE or to the
arguments. See the Hollywood documentation to learn how to pass parameters to

The following options are currently available:

This can be "None", "FS" (the default), "Random", or "Edd". Here is a
description of the
different dither modes:
    "None"  : No dithering at all.    
    "FS"    : Floyd-Steinberg dithering. This is the default.
    "Random": Random dithering. This mode is significantly slower than
    "Edd"   : EDD dithering. This mode is faster than Floyd-Steinberg dithering.
Set the dither amount. This must be between 0 and 255. Currently this value is
of any
use only for the "Random" dither mode. Defaults to 40.

Enable automatic dithering. If set to TRUE, dithering is automatically activated
for drawing
a particular picture to a particular environment, when the loss of color
information would
exceed a certain threshold (see below). Defaults to TRUE.

The threshold for automatic dithering. The lower, the earlier automatic
dithering is activated.
Useful thresholds range between 10 and 10000. Refer to
render.library/RGBArrayDiversityA() for
further details. Better you do not use this tag unless you have a good reason
to. Let the user
customize it with the environment variable AUTODITHERTHRESHOLD. Defaults to 250.

Set the precision for pen allocations. This can be "Exact", "Image" (the
default), "Icon", or
"GUI". See graphics.library/ObtainBestPenA() for details. Note that the default
suffices for almost every application. Pens are obtained in an extremely
effective way. You
get excellent results even with lower precisions. Commodore's idea with
ObtainBestPenA() was
to create a fair and effective pen-sharing mechanism, and Plananarama behaves in
accordance to this intention. Never use insane patches for ObtainBestPenA(). 


a) Plananarama says "Cannot open guigfx.library!" but I have guigfx.library

guigfx.library requires render.library and will fail to open in case
render.library isn't
present so make sure you have render.library as well. If you do, make sure you
have the
right version of render.library. Some require an FPU and will fail to open if no
FPU is

b) My system crashes with a 8000000B software failure:

You are using a version of render.library that needs an FPU on a system without
an FPU.
Make sure to use the appropriate version for your system because some versions
of render.library
don't check if an FPU is present, they will just crash if there is none.

c) I'm getting an "Out of memory!" error but I have lots of fast memory.

First make sure you have installed FBlit. Then make sure that you've configured
FBlit correctly.
You have to add Hollywood to FBlit's "Include" list in the "FAllocBitMap" tab.
If Hollywood is
included in this list, it will be able to place graphics in fast memory which is
needed since 2 MB of chip memory certainly won't be enough for Hollywood. So
make sure you
configure FBlit correctly.

d) Plananarama is very slow:

If Plananarama performs poorly on your system then the reason might be that your
script is
drawing many images with alpha channel graphics, e.g. anti-aliased text/shapes
or images with
variable levels of transparency. These things do not make much sense on
palette-based screens
and they are very, very expensive on the CPU because Plananarama needs to remap
these images
from true colour chunky pixels to planar graphics all the time.

Thus, if you care about performance you should not use any alpha channel images
and transparency
should be limited to monochrome transparency (i.e. visible and invisible
pixels). The best idea
is to use a fixed set of prerendered graphics. When just drawing prerendered
graphics with no
changes concerning the colors, Plananarama should perform quite well on planar
screens and
scripts should also be usable on slower systems, though you still need a fast
CPU and some fast
memory of course.


Version 1.0:    (10-Jan-16)
- First release


More optimizations.


Please report any bugs or issues via the Hollywood forums at


This plugin is (C) Copyright 2014-2016 by Andreas Falkenhahn
Refer to the COPYING file in this package for conditions concerning distribution
of this plugin.
This plugin uses guigfx.library and render.library by Timm S. Müller. Parts of
this document
are based on the documentation of guigfx.library written by Timm S. Müller. For
support and more
plugins please visit http://www.hollywood-mal.com/.

File Version Size Date OS Dls Readme
hwp_ahx.lha1.3135kb30 Dec 20194.1180¤ Hwp_AHX - Hollywood plugin for Abyss' Highest eXperience
hwp_aiff.lha1.217kb06 Mar 20194.098¤ Hwp_AIFF - Hollywood plugin for AIFF file format
hwp_apng.lha1.12Mb30 Jul 20154.0238¤ Hwp_APNG - Hollywood plugin for APNG anims
hwp_avcodec.lha1.46Mb12 Jan 20184.0207¤ Hwp_AVCodec - Hollywood plugin for AVCodec
hwp_digibooster.lha1.1114kb30 Jul 20154.0215¤ Hwp_DigiBooster - Hollywood plugin for DigiBooster
hwp_flicanim.lha1.126kb30 Jul 20154.0299¤ Hwp_FLICAnim - Hollywood plugin for FLI/FLC anims
hwp_glgalore.lha1.13Mb12 Jan 20184.062¤ Hwp_GLGalore - Hollywood plugin for OpenGL
hwp_httpstreamer.lha1.174kb12 Jan 20184.074¤ Hwp_HTTPStreamer - Hollywood plugin for video/audio streaming
hwp_hurl.lha1.13Mb04 Jan 20214.046¤ HWP_hURL - The multi-protocol data transfer plugin
hwp_iconic.lha1.0109kb23 Jan 20224.013¤ Hwp_Iconic - Hollywood plugin for icon loader
hwp_jpeg2000.lha1.1415kb30 Jul 20154.0254¤ Hwp_JPEG2000 - Hollywood plugin for JPEG2000 images
hwp_malibu.lha1.4640kb13 Jan 20184.061¤ Hwp_Malibu - Run Scala presentations
hwp_moviesetter.lha1.257kb30 Jul 20154.0332¤ Hwp_MovieSetter - Hollywood plugin for MovieSetter anims
hwp_muiroyale.lha1.75Mb12 Jan 20184.0235¤ Hwp_muiroyale - Hollywood plugin for MUI GUIs
hwp_oggtheora.lha1.1920kb30 Jul 20154.0242¤ Hwp_OGGTheora - Hollywood plugin for Ogg Theora
hwp_oggvorbis.lha1.1709kb30 Jul 20154.0291¤ Hwp_OGGVorbis - Hollywood plugin for Ogg Vorbis
hwp_pcx.lha1.120kb30 Jul 20154.050¤ Hwp_PCX - Hollywood plugin for PCX file format
hwp_polybios.lha1.322Mb08 Dec 20204.151¤ hwp_polybios - plugin for Hollywood to easily create PDF
hwp_rapagui.lha1.26Mb12 Jan 20184.094¤ Hwp_RapaGUI - Hollywood plugin for GUI creation
hwp_rebelsdl.lha1.15Mb01 Oct 20204.142¤ Rebel SDL - plugin for Hollywood that allows you use SDL
hwp_sid.lha1.0203kb06 Mar 20194.066¤ HWP_Sid - This plugin allows Hollywood to load and play SID
hwp_sqlite3.lha1.2952kb12 Jan 20184.0171¤ Hwp_SQLite3 - Hollywood plugin for SQL databases
hwp_svgimage.lha1.34Mb06 Mar 20194.0184¤ Hwp_SVGImage - Hollywood plugin for loading SVG images
hwp_tiff.lha1.1811kb30 Jul 20154.0239¤ Hwp_TIFF - Hollywood plugin for TIFF images
hwp_vectorgfx.lha1.21Mb06 Mar 20194.0182¤ Hwp_VectorGFX - Hollywood plugin for vectorgraphics
hwp_xad.lha1.062kb12 Jan 20184.070¤ hwp_xad - Allow to open archives using the XAD system.
hwp_xmlparser.lha1.1389kb30 Jul 20154.0333¤ Hwp_XMLParser - Hollywood plugin for parsing XML files
hwp_xmp.lha1.02Mb06 Apr 20204.052¤ HWP_XMP - Play many module formats with Hollywood
hwp_yafa.lha1.174kb30 Jul 20154.047¤ Hwp_YAFA - Hollywood plugin for YAFA anims
hwp_zip.lha1.1302kb16 Jun 20194.084¤ hwp_zip - read and write zip archives for hollywood
Copyright © 2004-2022 by Björn Hagström All Rights Reserved