Template:Superimpose/doc

{{Superimpose/doc}} is a utility which superimposes one image over another, and positions it relative to the top left corner of the bottom image. Although the original idea was to place a dot on a locator map based on editable coordinates, it can be used to precisely overlay any two images for any reason.

Usage

Example

The wikicode below will create the image at right:

{{Superimpose
  | base = US_Locator_Blank.svg
  | base_width = 288px
  | base_alt = U.S. map with state boundaries
  | base_caption = United States Locator Map
  | float = Red Dot.svg
  | float_width = 10px
  | float_alt = Boulder is in north central Colorado.
  | float_caption = Boulder, Colorado
  | x = 95
  | y = 80
}}

Using the Template

To get started, you can simply copy this blank definition into your page, and fill in the data.

{{Superimpose| base = 
  | base_width = 
  | base_alt = 
  | base_caption = 
  | float = 
  | float_width = 
  | float_alt = 
  | float_caption = 
  | x = 
  | y = 
}}

Parameter Definitions

• base: File name of the base (bottom) image
• base_width: Width to display the base image, in pixels
• base_alt: Alt text for the image, for visually impaired readers; see WP:ALT
• base_caption: Text to show when a user's mouse hovers over the base image
• float: File name of the top image
• float_width: Width to display the top image, in pixels
• float_alt: Alt text for the top image
• float_caption: Text to show when a user's mouse hovers over the top image
• x: distance to offset the top image from the left edge of the base image, in pixels or any other CSS-standard units
• y: distance to offset the top image from the top edge of the base image, in pixels or any other CSS-standard units

A Note about the Locator Dot

I originally built this template thinking I could use an SVG file with transparency (mostly for the dot in locator maps). However, it seems Internet Explorer users can't handle transparent PNGs without a fix that Wikimedia's not yet delivering, so for now I recommend using the GIF version in the example above. When IE better supports PNGs, we can swap the better format back in. —Papayoung ☯ 02:06, 26 October 2005 (UTC)