ModEnc is currently in Maintenance Mode: Changes could occur at any given moment, without advance warning.

AlphaImage

From ModEnc
Revision as of 17:52, 23 February 2007 by Nighthawk200 (talk | contribs) (Template Updated)
Jump to navigation Jump to search
Tiberian Dawn The Covert Operations Red Alert Counterstrike Aftermath Tiberian Sun Firestorm HyperPatch Red Alert 2 Yuri's Revenge Ares Generals Zero Hour Tiberium Wars Kane's Wrath
Flag: AlphaImage
File(s): rules(md).ini
Values: Strings, see below
Default: none/null
Applicable to: InfantryTypes, VehicleTypes, AircraftTypes, BuildingTypes


About Alpha Images

Simple lightpost test, using the original alphatst.shp

Alpha images are a very nice lighting feature used in Tiberian Sun, but left unused in Red Alert 2 and Yuri's Revenge. Alpha images are grayscale SHPs that are attached to, for example, a lightpost. If one is attached to an object, the object automatically starts emitting light, with the brightness of the light at a given pixel determined by the index number of the corresponding pixel of the alpha image. In other words: The light is modeled after the image and its brightness is defined by the brightness of the pixels. This allows a total customization of the light's shape.

Since alpha images can be defined per object (as opposed to globally) and there is no fixed file name, alpha images can be used to create custom lighting for every object you want; remember, however, that light does not follow around moving objects. So while it is possible to create shiny headlights for Grizzly Tanks, the light itself will be left behind where the Grizzly was spawned - while the Grizzly moves around the map just as always. Animated alpha images are not possible, either.


Benefits Drawbacks
No lag at all. "Tiled" lights cause lag when placing them down, overlapping, destroying, etc. Alpha images do not. Only affects brightness, not coloring.
Looks much better than the standard "tiled" light. Can only increase brightness, not decrease it.1
Customizable shape/amount/area of effect. Remains active even when the owner object is powered down, or when 'Turn off building' map action is applied.
Is known to cause building selection bracket discoloration, as well as discoloration of line trails.2

1Meaning you cannot build negative lightposts with alpha images.
2These are, however, barely visible, and usually don't affect your perception of the game.

Using Alpha Images

Using an alpha image is fairly easy: First of all, you need the actual image. Create it, turn it into an SHP, and store it your expand(md)##.mix. Once you have that, just put AlphaImage=yourAlphaImageFileName on your object, and everything should be fine.

The original, unused, lightpost alpha image should be called alphatst.shp, and is included in the game. It seems, however, to be wrongly named (sibmlr.shp). A correctly named alphatst.shp can be found at the bottom of this page.


A note on XCC Mod Creator
Alpha images seem to get corrupted when read from an ecache*.mix. Since XMC automatically puts SHPs in that file, you have to abuse a category like Video to have your alpha image(s) placed directly in the game directory. As long as it doesn't end up in ecache*.mix, there's no problem using alpha images with XMC.


The Alpha Image Palette

Alpha images are normal SHPs, but they do not have an associated palette. Rather, their color index is mapped to brightness values, making index #127 neutral, i.e. no light change, and #128-#255 gradually becoming brighter, with #255 being the brightest. The best way to illustrate this is to use a greyscale palette from black (index 0) to white (index 255) (see here) - the brighter the color is, the brighter the light will be.
Using any color below #127 will definately result in a distorted image, and probably in crashes. The reason for this is unknown.


Examples

LOOK DADDY, NO LAG!

The most prominent example of alpha image usage is DCoder's "LOOK DADDY, NO LAG!" screenshot. Other screenshots to note are Renegade's alpha test screenshots, illustrating not only how good correct alphas can look ingame, but also what happens if you use index 126 and below. Important to note here is that the full-palette screenshot was taken on Arena, after the same image had crashed the game to desktop (just by scrolling to where it was) on Bay of Pigs.

Image used as SHP
Ingame screenshot
Image used as SHP
Ingame screenshot
This section is rather small and research-centered; if you have more, actual-mod-screenshots, please add them.

Related files


See also

Tiled light specific flags: