Troubleshooting
HMI Text Runs Off the Screen After Downloading the Project
Short answer
The panel and the project are both fine: the engineering PC's Windows display scaling is above 100%, so the downloaded layout lands past the panel edge even though the editor and offline simulation look correct. Set the scale to 100%, restart the PC, then redownload.
On this page
Text that sits inside the screen in your HMI editor and in offline simulation, then runs past the edge on the physical panel, is a display-scaling fault on the engineering PC. The project is fine and the panel is fine. In the case behind this article, an EasyBuilder Pro project on a Weintek panel, the PC ran Windows at 125% scaling; setting it to 100%, restarting the PC, and downloading again put every string back inside the screen. The restart is part of the fix: changing the scale and reopening the editor without restarting leaves the panel text cut off exactly as before.
What the symptom tells you #
Four observations pin the fault to the PC before you touch any object property:
| What you see | What it means |
|---|---|
| Layout correct in the editor | Object positions fit the resolution of the selected HMI model |
| Layout correct in offline simulation | The compiled project renders correctly on the PC |
| Same HMI model in the project and on the panel | A model or resolution mismatch is ruled out |
| Only the downloaded panel clips text | The difference enters between the PC and the panel, so check the PC display setup first |
When the editor, the simulation and the model selection all agree and only the panel disagrees, the panel is faithfully rendering coordinates that were already wrong when they left the PC.
The fix: 100% scaling and a restart #
- Right-click the desktop and open Display settings.
- Set the scaling to 100%.
- Restart the PC. Do not skip this step.
- Open the project and confirm the HMI model selected in it matches the panel.
- Download the project to the HMI again.
- Restore your preferred scale, such as 125%, only after the download completes.
One safety note: do this download when the operator interface is allowed to go dark, not while someone is running the machine from that screen.
If the download never starts at all, that is a connection problem rather than a scaling one; the steps to upload an HMI program without the right cable pinout cover that path separately.
Why 125% scaling pushes text off the panel #
Windows display scaling changes the pixel metrics the operating system reports to applications. The editor previews and simulates under those scaled metrics, so both views look right on the PC. The panel knows nothing about the PC's scale; it renders the downloaded layout on its own native pixel grid. When the two disagree, text that fit the preview lands past the panel edge, worst near the right and bottom edges where the accumulated offset is largest.
The scale change does not fully apply to a running Windows session. Until the PC restarts, the editor looks normal while still producing the distorted download, and closing and reopening the editor does not clear it. The same symptom, with the same 100% fix, is reported on other vendors' HMI engineering software as well, so treat any scale above 100% as a fault condition on an HMI engineering PC.
Worked example: the safe area at 125% on an 800-pixel panel #
Inputs:
- Display scale on the engineering PC: 125%, a factor of 1.25. This is the value found on the PC in the reported case.
- Panel resolution: 800 x 480 px. An illustrative input for a typical widescreen HMI; the arithmetic is identical for any panel size.
- A label whose right edge sits at x = 700 px in the editor layout, an example input.
Rule in words: a layout produced under scaled metrics reaches the panel multiplied by the scale factor, so the usable width in editor coordinates is the panel width divided by that factor.
Arithmetic:
- Usable width: 800 ÷ 1.25 = 640 px.
- Usable height: 480 ÷ 1.25 = 384 px.
- The label's right edge as the panel sees it: 700 × 1.25 = 875 px.
- Clipped width: 875 − 800 = 75 px.
Result: at 125% scaling, any object whose layout coordinates pass 640 px of width or 384 px of height lands partly off an 800 x 480 panel, and the example label loses its last 75 px.
Decision: 640 ÷ 800 = 80%, so if your screens use more than 80% of the panel's width or height in layout coordinates, expect clipping at 125%. Fix the scaling; do not redesign the screens to fit a distorted download.
If text still clips after the scaling fix #
| Pattern on the panel | Likely cause | Action |
|---|---|---|
| Whole objects shifted or clipped, mostly near the right and bottom edges | The scale change never took effect in the session | Repeat the 100% setting, restart the PC, and redownload |
| Only long tag-driven strings overflow their own box | Text object setup | Enable text wrapping on the object and raise its string size |
| Layout wrong on the panel but correct in offline and online simulation | Panel-side settings | Review the administrator's hidden menu on the panel for changes |
| Layout wrong in simulation too | Wrong HMI model in the project | Reselect the correct model so its resolution is applied |
| Text hidden near a screen corner | An on-panel button | On the CMT range the initial setup does not use a floating circular button, but one configured later to sit in a corner can cover text |
Confirming the panel matches the simulation #
- Run offline simulation and note the screens with the longest or edge-most strings.
- Open the same screens on the downloaded panel and compare string by string.
- Check the previously clipped strings first, then the tag-driven strings at their longest values.
- If any string still differs, repeat the 100%-scaling-and-restart cycle once; if the fault survives that, work through the table above.
The same panel-versus-simulation discipline applies when you test HMI simulation against a live PLC: the PC-side view is a preview, and the machine-side view is the truth.
Questions asked
Does the fault also appear in online simulation?
No, and that is the trap. Online and offline simulation both run on the engineering PC and inherit its scaled display metrics, so both can look correct while the physical panel clips the same strings. Only the panel itself renders the project at native pixel resolution, so verify the edge-most strings on the panel after every download.
Why was the PC at 125% scaling in the first place?
Windows applies 125% scaling by default on many high-resolution laptop panels, because interface elements would look too small at native resolution. A new engineering laptop therefore arrives ready to cause this fault, and any scaling value above 100% is enough to distort a downloaded layout.
Can the scale go back to 125% after the download?
Yes. The project stored in the HMI does not change when the PC scale changes later, so restoring a comfortable scale after the download finishes is safe. Every future download from that PC needs the same sequence again: set 100%, restart the PC, then download.
A single long string still overflows its text box at 100% scaling. Is that the same fault?
No, that is the text object, not the PC. Enable text wrapping on the object and set the string size above the longest value the connected tag can hold, then redownload. Also note that an ASCII object with multi-line display enabled does not wrap a line that was entered as one long string, so string sizing has to do the work there.
Is anything wrong with the HMI itself?
No. The fault travels with the engineering PC, not with the panel or the project file. Downloading the same project from a PC already at 100% scaling produces a correct screen, which is also the quickest way to confirm the diagnosis before changing your main PC's settings.