> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/hardware/card-readers/mms-dyna-devices/dynaflex-ii-ped/documentation/developers-manuals/dynaflex-ii-ped-programmers-manual/commands/user-interface/show-image.md).

# Show Image

## Command 0x1821 - Show Image (Display Only)

The host uses this command to trigger the device to immediately show a pre-loaded image on the display, provided the device is not in a mode that has exclusive use of the display (such as during a transaction). This is an immediate and temporary directive. For a solution that affects the device’s idle page behavior on a more permanent basis, see **Property 1.2.3.1.1.1 Custom Idle Page Image**. This command is different from **Command 0x1823 - Show Bitmap Image** in that the bitmaps are pre-loaded and persistently stored in the device and can not be composited with each other.

The sequence of events is as follows:

{% stepper %}
{% step %}

### Prepare the image slot

The host makes sure it has loaded the image into at least one of the device’s Custom Idle Page Image slots using **Command 0xD812 - Start Send File to Device (Unsecured)**.
{% endstep %}

{% step %}

### Ensure device is in Active/Idle

The host makes sure the device is in Active/Idle state (meaning the display is fully powered on and is not in a mode that has exclusive use of the display, such as processing a transaction).
{% endstep %}

{% step %}

### Call the Show Image command

The host calls this command to show the image loaded into the desired slot number.
{% endstep %}

{% step %}

### Display behavior

The device shows the specified image on the display until the device is no longer in Active/Idle.
{% endstep %}
{% endstepper %}

## Table - Request Data for Command 0x1821 - Show Image (Display Only)

<table><thead><tr><th>Tag</th><th width="74.33331298828125">Len</th><th width="256.3333740234375">Value / Description</th><th width="73.6666259765625">Typ</th><th width="74.3333740234375">Req</th><th width="98.666748046875">Default</th></tr></thead><tbody><tr><td>Beginning of any wrappers, at minimum including <a href="https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/3.0-messages-requests-responses-notifications-and-files/3.3-message-structure#table-11-request-message-format"><strong>Request Message</strong></a> </td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>1821 = <strong>Command 0x1821 - Show Image (Display Only)</strong></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>81</td><td>01</td><td><p>Custom Idle Page Image Number</p><ul><li>0x01 = Show custom image 1</li><li>0x02 = Show custom image 2</li><li>0x03 = Show custom image 3</li><li>0x04 = Show custom image 4</li></ul></td><td>B</td><td>R</td><td></td></tr><tr><td>82</td><td>01</td><td><p>Display Option</p><ul><li>0x00 = Default to cover/uncover the top status bar depends on the current status of the display. If the current display shows the top status bar, the Show Image command won’t cover the top status bar. If the current display doesn’t show the top status bar, the Show Image command will cover the top status bar.</li><li>0x01 = Cover the top status bar regardless of the current status of the display.</li><li>0x02 = Not cover the top status bar regardless of the current status of the display.</li></ul></td><td>B</td><td>O</td><td>0</td></tr><tr><td>83</td><td>01</td><td><p>Display Time</p><ul><li>0x00 = Show image until device changes state</li></ul></td><td>B</td><td>O</td><td>0</td></tr><tr><td>End of any wrappers, at minimum including <a href="https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/3.0-messages-requests-responses-notifications-and-files/3.3-message-structure#table-11-request-message-format"><strong>Request Message</strong></a> </td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## Table - Response Data for Command 0x1821 - Show Image (Display Only)

<table><thead><tr><th>Tag</th><th width="76.33331298828125">Len</th><th width="244">Value / Description</th><th width="77.66668701171875">Typ</th><th width="75.333251953125">Req</th><th width="97.3333740234375">Default</th></tr></thead><tbody><tr><td>Beginning of any wrappers, at minimum including <a href="https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/3.0-messages-requests-responses-notifications-and-files/3.3-message-structure#table-12-response-message-format"><strong>Response Message</strong></a> </td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>1821 = <strong>Command 0x1821 - Show Image (Display Only)</strong></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>No parameters.</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>End of any wrappers, at minimum including <a href="https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/3.0-messages-requests-responses-notifications-and-files/3.3-message-structure#table-12-response-message-format"><strong>Response Message</strong></a> </td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

If the request started successfully, the Request Status in the message wrapper is **All Good, Requested Operation Was Successful**.

## Table - Request Example

{% code title="Example (Hex)" %}

```
AA 00 81 04 01 2C 18 21 84 08 18 21 81 01 03 83 01 00
```

{% endcode %}

## Table - Response Example

{% code title="Example (Hex)" %}

```
AA 00 81 04 82 2C 18 21 82 04 00 00 00 00
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/hardware/card-readers/mms-dyna-devices/dynaflex-ii-ped/documentation/developers-manuals/dynaflex-ii-ped-programmers-manual/commands/user-interface/show-image.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.