SDL: Added an example of creating a window with position

From dc450ba90802005f12aec82857eef97d582cff96 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Thu, 28 Dec 2023 16:34:13 -0800
Subject: [PATCH] Added an example of creating a window with position

---
 docs/README-migration.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/README-migration.md b/docs/README-migration.md
index c2a58f185faa..f25731691a54 100644
--- a/docs/README-migration.md
+++ b/docs/README-migration.md
@@ -1323,7 +1323,21 @@ Rather than iterating over displays using display index, there is a new function
 }

-SDL_CreateWindow() has been simplified and no longer takes a window position. You can use SDL_CreateWindowWithProperties() if you need to set the window position when creating it.
+SDL_CreateWindow() has been simplified and no longer takes a window position. You can use SDL_CreateWindowWithProperties() if you need to set the window position when creating it, e.g.
+```c

  • SDL_PropertiesID props = SDL_CreateProperties();
  • SDL_SetStringProperty(props, title);
  • SDL_SetNumberProperty(props, “x”, x);
  • SDL_SetNumberProperty(props, “y”, y);
  • SDL_SetNumberProperty(props, “width”, width);
  • SDL_SetNumberProperty(props, “height”, height);
  • SDL_SetNumberProperty(props, “flags”, flags);
  • pWindow = SDL_CreateWindowWithProperties(props);
  • SDL_DestroyProperties(props);
  • if (window) {
  •    ...
    
  • }
    +```

The SDL_WINDOWPOS_UNDEFINED_DISPLAY() and SDL_WINDOWPOS_CENTERED_DISPLAY() macros take a display ID instead of display index. The display ID 0 has a special meaning in this case, and is used to indicate the primary display.