source/blender/windowmanager/intern/wm_window_private.h

/* SPDX-License-Identifier: GPL-2.0-or-later
 * Copyright 2019 Blender Foundation. All rights reserved. */

/** \file
 * \ingroup wm
 */
#pragma once

#include "BLI_sys_types.h"
#include "GHOST_Types.h"

/* *************** Message box *************** */
/* `WM_ghost_show_message_box` is implemented in `wm_windows.c` it is
 * defined here as it was implemented to be used for showing
 * a message to the user when the platform is not (fully) supported.
 *
 * In all other cases this message box should not be used. */
void WM_ghost_show_message_box(const char *title,
                               const char *message,
                               const char *help_label,
                               const char *continue_label,
                               const char *link,
                               GHOST_DialogOptions dialog_options);
File headers: SPDX License migration Use a shorter/simpler license convention, stops the header taking so much space. Follow the SPDX license specification: https://spdx.org/licenses - C/C++/objc/objc++ - Python - Shell Scripts - CMake, GNUmakefile While most of the source tree has been included - `./extern/` was left out. - `./intern/cycles` & `./intern/atomic` are also excluded because they use different header conventions. doc/license/SPDX-license-identifiers.txt has been added to list SPDX all used identifiers. See P2788 for the script that automated these edits. Reviewed By: brecht, mont29, sergey Ref D14069 2022-02-11 09:07:11 +11:00			`/* SPDX-License-Identifier: GPL-2.0-or-later`
			`* Copyright 2019 Blender Foundation. All rights reserved. */`
GPU: Platform Support Level Adds a check when starting blender if your platform is supported. We use a blacklist as drivers are updated more regular then blender (stable releases). The mechanism detects if the support level changed or has been validated by the user previously. Changes can happen due to users updating their drivers, but also when we change the support level in our code base. When the user has seen the limited support level message it is saved in the user config. It would be better to have a system specific config section, but currently not clear what could benefit from that. When the platform is unsupported or has limited support a dialog box will appear including a link to our user manual describing what to do. Windows Windows uses the MessageBox that is provided by the windows kernel. X11 We use a very lowlevel messagebox for X11. It is very limited in use and can be fine tuned when needed. SDL/APPLE There is no implementation for SDL or APPLE at this moment as the platform support feature targets mostly Windows users. Reviewed By: brecht Differential Revision: https://developer.blender.org/D5955 2019-10-03 16:21:23 +02:00
			`/** \file`
			`* \ingroup wm`
			`*/`
			`#pragma once`

			`#include "BLI_sys_types.h"`
			`#include "GHOST_Types.h"`

			`/* ************* Message box ************* */`
			/* `WM_ghost_show_message_box` is implemented in `wm_windows.c` it is
			`* defined here as it was implemented to be used for showing`
			`* a message to the user when the platform is not (fully) supported.`
			`*`
			`* In all other cases this message box should not be used. */`
			`void WM_ghost_show_message_box(const char *title,`
			`const char *message,`
GPU: show more descriptive labels on unsupported GPU dialog Thanks to Ray Molenkamp for the help with the Windows implementation. Fixes T70521 Differential Revision: https://developer.blender.org/D6023 2019-10-09 13:36:56 +02:00			`const char *help_label,`
			`const char *continue_label,`
GPU: Platform Support Level Adds a check when starting blender if your platform is supported. We use a blacklist as drivers are updated more regular then blender (stable releases). The mechanism detects if the support level changed or has been validated by the user previously. Changes can happen due to users updating their drivers, but also when we change the support level in our code base. When the user has seen the limited support level message it is saved in the user config. It would be better to have a system specific config section, but currently not clear what could benefit from that. When the platform is unsupported or has limited support a dialog box will appear including a link to our user manual describing what to do. Windows Windows uses the MessageBox that is provided by the windows kernel. X11 We use a very lowlevel messagebox for X11. It is very limited in use and can be fine tuned when needed. SDL/APPLE There is no implementation for SDL or APPLE at this moment as the platform support feature targets mostly Windows users. Reviewed By: brecht Differential Revision: https://developer.blender.org/D5955 2019-10-03 16:21:23 +02:00			`const char *link,`
			`GHOST_DialogOptions dialog_options);`