---
title: mode
framework: tvml
role: article
role_heading: Article
path: tvml/mode
---

# mode

Specifies how an image is displayed.

## Overview

Overview Use the mode attribute to define how an image is displayed in the oneupTemplate and showcaseTemplate elements. The showcaseTemplate element can only use the showcase oneup attribute value. The oneupTemplate can only use the oneup caption attribute value. Clicking an image alternates between the selected modes. Here’s an example that displays images in showcaseTemplate in showcase mode: <document>     <showcaseTemplate mode="showcase">         <background>             <img src="path to images on your server/Car_Movie_1920x1080.png" />         </background>         <banner>             <title>Scenes</title>             <row>                 <button>                     <text>Slideshow</text>                 </button>                 <button>                     <text>Screensaver</text>                 </button>             </row>         </banner>         <carousel>             <section>                 <lockup>                     <img src="path to images on your server/Car_Movie_453x255_C.png" width="453" height="255" />                     <title>Scene 1</title>                 </lockup>                 <lockup>                     <img src="path to images on your server/Car_Movie_500x600.png" width="500" height="600" />                     <title>Scene 2</title>                 </lockup>             </section>         </carousel>     </showcaseTemplate> </document> Values for mode Elements that Use mode oneupTemplate showcaseTemplate

## See Also

### Image Display

- [aspectFill](tvml/aspectfill.md)
- [contentsMode](tvml/contentsmode.md)
- [opaque](tvml/opaque.md)
- [type](tvml/type.md)
- [value](tvml/value.md)