Skip to content

Conversation

@pamoroso
Copy link
Contributor

To address issue #1622 this PR updates the SDL pixel scaling instructions and covers more ways of making text and Medley's screen bigger.

Update the SDL pixel scaling instructions and cover more ways of making text and Medley's screen bigger.

Signed-off-by: Paolo Amoroso <[email protected]>
@pamoroso pamoroso requested review from masinter and stumbo September 19, 2025 11:04
There are two ways to build and run the Maiko virtual machine/host interface layer
that underlies Medley: running under X Windows ([XQuartz](https://www.xquartz.org/)) and running in a native window
that underlies Medley: running under X Windows ([XQuartz](https://www.xquartz.org/) on macOS) and running in a native window
using [SDL](https://www.libsdl.org/). Full instructions for building Maiko for X Windows are [here](https://github.com/Interlisp/maiko).
Copy link
Member

@masinter masinter Sep 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where are the instructions for buliding maiko under SDL? Shouldn't it mention SDL2 vs SDL3?
We build an SDL for cygwin... should we build one for MacOS? Are the performance probles with very slow display related to SDL use?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current FAQ as well as this PR defer to the Maiko README for building instructions and integrate it with SDL information. Should we add SDL instructions to the README and just point to it from the FAQ/PR?

Since SDL3 is experimental we may assume SDL in current documentation. And SDL2 vs SDL3 probably belongs more in the Maiko README than the FAQ.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nbriggs In the September 24, 2025 external meeting we agreed it would be better for the Maiko README to also mention how to build with SDL. This way the FAQ could refer to the README and focus on the -ps option.

Could you please update the README? Would you prefer me to do it?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will do it - but not until I've sorted out the pending updates/merges. It should get instructions on how to build with CMake (and the cmake-gui) as well as the ./makeright path. Only SDL2 is currently supported, and the key bindings for SDL2 are not up-to-date.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, no problem.

```

Windows supports pixel scaling for individual applications, including Medley. Refer to the Windows documentation for how to change this setting.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there a search string to search windows documentation with?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wanted to link to the relevant documentation but googling for Windows pixel scaling turned up much noise and little useful material. Not being familiar with Windows I'm not even sure "pixel scaling" is the correct name of the feature to search for.

Copy link
Member

@masinter masinter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think in the FAQ itself there's limited advice we can give until we fix up some of the problems that arise.... Can we fix FONTSET so it actually works to increase the font resolution?

Is the limit on screen size real? BIGBITMAP doesn't work in Maiko?

What is the real limit on the screen size -- isn't the width rounded up?

Windows supports pixel scaling for individual applications, including Medley. Refer to the Windows documentation for how to change this setting.

To make text bigger in most windows, from Medley call the Lisp function `FONTSET` with an appropriate size specification. For example, at an Interlisp Exec evaluate
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where is FONTSET documented? There isn't really a 'size' specification just keywords in an ALIST that isn't used in SEdit.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The IRM documents FONTSET and the Medley primer provides an example. I mean "size" as a generic proxy to the actual specification to pass to the function. But since it's confusing I may replace it with "call the Lisp function FONTSET" and let the example that comes immediately next clarify what the argument should be.

We may leave here the description of FONTSET to document what's already available and fix the feature later, or don't mention FONTSET until we fix the feature. What do you suggest?

As for the frame buffer size, is it better to just generically mention limitations of how Maiko implements graphics? After all it's not that important here for a user who just wants to make Medley's window bigger.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants