sfml-tutorials 官方教程 windows篇

系列文章

SFML-windows 篇
SFML-Events explained 篇
SFML-Keyboard, mouse and joystick 篇
SFML-Using OpenGL in a SFML window 篇
SFML-Drawing 2D stuff 篇
SFML-Shapes 篇
SFML-Sprites and textures 篇

打开一个windows

SFML中的窗口由sf：：Window类定义。可直接创建和打开窗口：

int main()
{
    sf::Window window(sf::VideoMode(800, 600), "My window");

    return 0;
}

---

第一个参数“视频模式”定义窗口的大小（内部大小，不带标题栏和边框）。这里，我们创建一个大小为800x600像素的窗口。
VideoMode类有一些有趣的静态函数来获取桌面分辨率，或者全屏模式的有效视频模式列表。
第二个参数只是窗口的标题。
此构造函数接受第三个可选参数：样式，它允许您选择所需的装饰和功能。可以使用以下样式的任意组合：
还有第四个可选参数，用于定义特定于OpenGL的选项，这些选项在专门的OpenGL教程中进行了解释。

---

如果要在构建sf：：window实例后创建窗口，或者使用不同的视频模式或标题重新创建窗口，可以改用create函数。它采用与构造函数完全相同的参数。

#include 

int main()
{
    sf::Window window;
    window.create(sf::VideoMode(800, 600), "My window");
    return 0;
}

---

执行windows

如果您尝试执行上面的代码，但没有任何内容代替“…”，你几乎看不到什么。首先，因为程序立即结束。其次，因为没有事件处理——所以即使您向代码中添加了一个无止境的循环，您也会看到一个死窗口，无法移动、调整大小或关闭。
让我们添加一些代码，使该程序更有趣：

#include 

int main()
{
    sf::Window window(sf::VideoMode(800, 600), "My window");

    // run the program as long as the window is open
    while (window.isOpen())
    {
        // check all the window's events that were triggered since the last iteration of the loop
        sf::Event event;
        while (window.pollEvent(event))
        {
            // "close requested" event: we close the window
            if (event.type == sf::Event::Closed)
                window.close();
        }
    }

    return 0;
}

上述代码将打开一个窗口，并在用户关闭它时终止。让我们详细看看它是如何工作的。

首先，我们添加了一个循环，确保在关闭窗口之前刷新/更新应用程序。大多数（如果不是全部）SFML程序都会有这种循环，有时称为主循环或游戏循环。

然后，我们想在游戏循环中做的第一件事就是检查发生的任何事件。请注意，我们使用while循环，以便在存在多个挂起事件的情况下处理所有挂起事件。如果事件处于挂起状态，则pollEvent函数返回true；如果没有事件，则返回false。

每当我们得到一个事件，我们必须检查它的类型（窗口关闭？按键？鼠标移动？操纵杆连接？…），如果我们对它感兴趣，就做出相应的反应。在这种情况下，我们只关心Event：：Closed事件，它是在用户想要关闭窗口时触发的。此时，窗口仍处于打开状态，我们必须使用close函数显式关闭它。这使您能够在关闭窗口之前执行某些操作，例如保存应用程序的当前状态或显示消息。
关闭窗口后，主循环退出，程序终止。

此时，您可能已经注意到，我们还没有讨论过在窗口中绘制一些东西。正如简介中所述，这不是sfml窗口模块的工作，如果要绘制精灵、文本或形状等内容，则必须跳转到sfml图形教程。

要绘制东西，也可以直接使用OpenGL，完全忽略sfml图形模块。窗口在内部创建一个OpenGL上下文，并准备接受您的OpenGL调用。您可以在相应的教程中了解更多信息。

不要期望在此窗口中看到有趣的内容：您可能会看到统一的颜色（黑色或白色），或者以前使用OpenGL的应用程序的最后内容，或者。。。还有别的。

---

绘制windows

当然，SFML允许您稍微使用windows。支持更改大小、位置、标题或图标等基本窗口操作，但与专用GUI库（Qt、wxWidgets）不同，SFML不提供高级功能。SFML窗口仅用于为OpenGL或SFML绘图提供环境。

您可以参考API文档以获得sf：：Window函数的完整列表。

如果您确实需要窗口的高级功能，您可以使用另一个库创建一个（甚至是一个完整的GUI），并将SFML嵌入其中。为此，您可以使用sf：：Window的另一个构造函数或创建函数，该函数接受现有窗口的特定于操作系统的句柄。在这种情况下，SFML将在给定窗口内创建图形上下文，并捕获其所有事件，而不会干扰父窗口管理。

sf::WindowHandle handle = /* specific to what you're doing and the library you're using */;
sf::Window window(handle);

---

如果您只需要一个额外的、非常特定的特性，也可以反过来做：创建一个SFML窗口，并获得其特定于操作系统的句柄来实现SFML本身不支持的功能。

sf::Window window(sf::VideoMode(800, 600), "SFML window");
sf::WindowHandle handle = window.getSystemHandle();

// you can now use the handle with OS specific functions

将SFML与其他库集成需要一些工作，这里将不进行描述，但您可以参考专门的教程、示例或论坛帖子。

---

控制帧速率

有时，当应用程序运行速度很快时，您可能会注意到诸如撕裂之类的视觉瑕疵。原因是应用程序的刷新率与监视器的垂直频率不同步，因此，前一帧的底部与下一帧的顶部混合。

此问题的解决方案是激活垂直同步。它由图形卡自动处理，可以通过setVerticalSyncEnabled功能轻松打开和关闭：

window.setVerticalSyncEnabled(true); // call it once, after creating the window

此调用后，应用程序将以与监视器刷新率相同的频率运行。

有时，setVerticalSyncEnabled不会产生任何效果：这很可能是因为在图形驱动程序的设置中，垂直同步被强制“关闭”。应将其设置为“由应用程序控制”。

---

在其他情况下，您可能还希望应用程序以给定的帧速率而不是监视器的频率运行。这可以通过调用setFramerateLimit来完成：

window.setFramerateLimit(60); // call it once, after creating the window

与setVerticalSyncEnabled不同，此功能由SFML本身实现，使用sf：：Clock和sf：：sleep的组合。一个重要的结果是，它不是百分之百可靠的，特别是对于高帧率：sf：：sleep的分辨率取决于底层操作系统和硬件，可以高达10或15毫秒。不要依赖此功能来实现精确计时。

---

windows的相关知识

下面是一个简短的列表，列出了使用SFML windows可以做什么和不能做什么。

您可以创建多个窗口

SFML允许您创建多个窗口，并可以在主线程中处理所有窗口，或者在自己的线程中处理每个窗口（但是…请参见下文）。在这种情况下，不要忘记为每个窗口都有一个事件循环。

尚未正确支持多个监视器

SFML不显式管理多个监视器。因此，您将无法选择窗口显示在哪个监视器上，也无法创建多个全屏窗口。这应该在将来的版本中得到改进。

必须在窗口线程中轮询事件

这是大多数操作系统的一个重要限制：事件循环（更准确地说，是pollEvent或waitEvent函数）必须在创建窗口的同一线程中调用。这意味着，如果要创建一个用于事件处理的专用线程，则必须确保该窗口也在该线程中创建。如果您真的想在线程之间分割事物，那么将事件处理保留在主线程中并移动其余的（渲染、物理、逻辑等）会更方便改为单独的线程。此配置还将与下面描述的其他限制兼容。

在macOS上，必须在主线程中管理窗口和事件

是的，这是真的；如果您试图在主线程以外的线程中创建窗口或处理事件，macOS不会同意。

在Windows上，大于桌面的窗口将无法正常运行

出于某种原因，Windows不喜欢比桌面大的窗口。这包括使用VideoMode：：getDesktopMode（）创建的窗口：添加了窗口装饰（边框和标题栏），最终得到的窗口略大于桌面。