Wiki Page Content

Differences between revisions 1 and 8 (spanning 7 versions)
Revision 1 as of 2010-07-26 01:18:47
Size: 2837
Editor: SheenaSmith
Comment: create page, add content (7/14 changeset 4529)
Revision 8 as of 2010-09-26 00:39:24
Size: 1316
Editor: SheenaSmith
Comment: update content (w/ Sam); remove 'draft' note
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
A structure that contains <<Color2(purple,system-dependent window manager information)>>. A structure that contains system-dependent information about a window.
Line 11: Line 11:
||||||''For Win32 window management systems (Windows)''||
||SDL_version||'''version'''||^the version of SDL in use^||
||||||''For Windows''||
||SDL_version||'''version'''||the version field you fill in before you call [[SDL_GetWindowWMInfo]]()||
Line 14: Line 14:
Line 15: Line 16:
||SDL_version||'''version'''||^the version of SDL in use^||
||SDL_SYSWM_TYPE||'''subsystem'''||^the window manager type; see [[#Remarks|Remarks]] for details||
||union ???||'''info'''||^a union of window manager information^ ???||
||struct ???
||'''info.x11'''||^the struct containing window manager info^ ???||
||Display||'''info.x11.*display'''||the X11 display||
||Window||'''info.x11.window'''||the X11 display window||
||SDL_version||'''version'''||the version field you fill in before you call [[SDL_GetWindowWMInfo]]()||
||SDL_SYSWM_TYPE||'''subsystem'''||the windowing system type; see [[#Remarks|Remarks]] for details||
||Display||'''info.x11.display'''||the X11 display||
||Window||'''info.x11.window'''||the X11 window||
Line 23: Line 22:
For Win32 window management systems (Windows):
<<BR>>*<<BR>>
Line 26: Line 23:
typedef struct {
  SDL_version version;
  HWND window; /* The Win32 display window */
} SDL_SysWMinfo;
You can add your code example here
Line 31: Line 25:
<<Color2(green,Removed `HGLRC hglrc; /* The OpenGL context if any */` from old wiki example.)>><<BR>>
*

For X11 window management systems (Unix):
<<BR>>*<<BR>>
<<Color2(green,Should some of this example be changed/removed for 1.3 purposes?)>><<BR>>
{{{#!highlight cpp
typedef enum {
  SDL_SYSWM_X11
} SDL_SYSWM_TYPE;

typedef struct {
  SDL_version version;
  SDL_SYSWM_TYPE subsystem;
  union {
    struct {
      Display *display; /* The X11 display */
      Window window; /* The X11 display window */
      /* These locking functions should be called around
         any X11 functions using the display variable.
         They lock the event thread, so should not be
         called around event functions or from event filters.
      */
      void (*lock_func)(void);
      void (*unlock_func)(void);

      /* Introduced in SDL 1.0.2 */
      Window fswindow; /* The X11 fullscreen window */
      Window wmwindow; /* The X11 managed input window */

      /* Introduced in SDL 1.2.12 */
      Display *gfxdisplay; /* The X11 display to which rendering is done */
    } x11;
  } info;
} SDL_SysWMinfo;
}}}<<BR>>
*
Line 70: Line 27:
'''SDL_SYSWM_TYPE''' currently has only 1 value: `SDL_SYSWM_X11` ''For X11 window management systems (Unix)''
Line 72: Line 29:
When this structure is returned, it holds information about which low level system it is using, and will be one of SDL_SYSWM_TYPE.  This structure is filled in by [[SDL_GetWindowWMInfo]]().
Line 74: Line 31:
*This structure is filled in by [[SDL_GetWMInfo]].* <<Color2(green,Was this function replaced by SDL_!GetWindowWMInfo? Does the general idea of this remark still apply in 1.3?)>>  When [[SDL_GetWindowWMInfo]]() returns the structure holds information specific to the low level windowing system being used, which is one of SDL_SYSWM_TYPE.
 ||SDL_SYSWM_X11||the X11 windowing system||
Line 80: Line 38:
[[CategoryStruct]] [[CategoryStruct]], [[CategorySWM]]

DRAFT

SDL_SysWMinfo

A structure that contains system-dependent information about a window.

Data Fields

For Windows

SDL_version

version

the version field you fill in before you call SDL_GetWindowWMInfo()

HWND

window

the Win32 display window

For X11 window management systems (Unix)

SDL_version

version

the version field you fill in before you call SDL_GetWindowWMInfo()

SDL_SYSWM_TYPE

subsystem

the windowing system type; see Remarks for details

Display

info.x11.display

the X11 display

Window

info.x11.window

the X11 window

Code Examples

You can add your code example here

Remarks

For X11 window management systems (Unix)

  • This structure is filled in by SDL_GetWindowWMInfo().

    When SDL_GetWindowWMInfo() returns the structure holds information specific to the low level windowing system being used, which is one of SDL_SYSWM_TYPE.

    SDL_SYSWM_X11

    the X11 windowing system


CategoryStruct, CategorySWM

None: SDL_SysWMinfo (last edited 2016-12-01 08:58:06 by realitix)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit