DISTRHO
/
JUCE
mirror of https://github.com/DISTRHO/JUCE
1
0
Fork 0
Code Releases 1 Activity
The JUCE cross-platform C++ framework, with DISTRHO/KXStudio specific changes
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
14070 Commits
9 Branches
5.0GB
Tree: e6509fcb51
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'e6509fcb51'
${ noResults }
JUCE/modules/juce_gui_basics/native/juce_XWindowSystem_linux.h

357 lines
13KB
Raw Blame History 

  1. /*

  2.   ==============================================================================

  3. 

  4.    This file is part of the JUCE library.

  5.    Copyright (c) 2022 - Raw Material Software Limited

  6. 

  7.    JUCE is an open source library subject to commercial or open-source

  8.    licensing.

  9. 

  10.    By using JUCE, you agree to the terms of both the JUCE 7 End-User License

  11.    Agreement and JUCE Privacy Policy.

  12. 

  13.    End User License Agreement: www.juce.com/juce-7-licence

  14.    Privacy Policy: www.juce.com/juce-privacy-policy

  15. 

  16.    Or: You may also use this code under the terms of the GPL v3 (see

  17.    www.gnu.org/licenses).

  18. 

  19.    JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER

  20.    EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE

  21.    DISCLAIMED.

  22. 

  23.   ==============================================================================

  24. */

  25. 

  26. namespace juce

  27. {

  28. 

  29. //==============================================================================

  30. namespace XWindowSystemUtilities

  31. {

  32.     //==============================================================================

  33.     /** A handy struct that uses XLockDisplay and XUnlockDisplay to lock the X server

  34.         using RAII.

  35. 

  36.         @tags{GUI}

  37.     */

  38.     struct ScopedXLock

  39.     {

  40.         ScopedXLock();

  41.         ~ScopedXLock();

  42.     };

  43. 

  44.     //==============================================================================

  45.     /** Gets a specified window property and stores its associated data, freeing it

  46.         on deletion.

  47. 

  48.         @tags{GUI}

  49.     */

  50.     struct GetXProperty

  51.     {

  52.         GetXProperty (::Display* display, ::Window windowH, Atom property,

  53.                       long offset, long length, bool shouldDelete, Atom requestedType);

  54.         ~GetXProperty();

  55. 

  56.         bool success = false;

  57.         unsigned char* data = nullptr;

  58.         unsigned long numItems = 0, bytesLeft = 0;

  59.         Atom actualType;

  60.         int actualFormat = -1;

  61.     };

  62. 

  63.     //==============================================================================

  64.     /** Initialises and stores some atoms for the display.

  65. 

  66.         @tags{GUI}

  67.     */

  68.     struct Atoms

  69.     {

  70.         enum ProtocolItems

  71.         {

  72.             TAKE_FOCUS = 0,

  73.             DELETE_WINDOW = 1,

  74.             PING = 2

  75.         };

  76. 

  77.         Atoms() = default;

  78.         explicit Atoms (::Display*);

  79. 

  80.         static Atom getIfExists (::Display*, const char* name);

  81.         static Atom getCreating (::Display*, const char* name);

  82. 

  83.         static String getName (::Display*, Atom);

  84.         static bool isMimeTypeFile (::Display*, Atom);

  85. 

  86.         static constexpr unsigned long DndVersion = 3;

  87. 

  88.         Atom protocols, protocolList[3], changeState, state, userTime, activeWin, pid, windowType, windowState, windowStateHidden,

  89.              XdndAware, XdndEnter, XdndLeave, XdndPosition, XdndStatus, XdndDrop, XdndFinished, XdndSelection,

  90.              XdndTypeList, XdndActionList, XdndActionDescription, XdndActionCopy, XdndActionPrivate,

  91.              XembedMsgType, XembedInfo, allowedActions[5], allowedMimeTypes[4], utf8String, clipboard, targets;

  92.     };

  93. 

  94.     //==============================================================================

  95.     /** Represents a setting according to the XSETTINGS specification.

  96. 

  97.         @tags{GUI}

  98.     */

  99.     struct XSetting

  100.     {

  101.         enum class Type

  102.         {

  103.             integer,

  104.             string,

  105.             colour,

  106.             invalid

  107.         };

  108. 

  109.         XSetting() = default;

  110. 

  111.         XSetting (const String& n, int v)            : name (n), type (Type::integer), integerValue (v)  {}

  112.         XSetting (const String& n, const String& v)  : name (n), type (Type::string),  stringValue (v)   {}

  113.         XSetting (const String& n, const Colour& v)  : name (n), type (Type::colour),  colourValue (v)   {}

  114. 

  115.         bool isValid() const noexcept  { return type != Type::invalid; }

  116. 

  117.         String name;

  118.         Type type = Type::invalid;

  119. 

  120.         int integerValue = -1;

  121.         String stringValue;

  122.         Colour colourValue;

  123.     };

  124. 

  125.     /** Parses and stores the X11 settings for a display according to the XSETTINGS

  126.         specification.

  127. 

  128.         @tags{GUI}

  129.     */

  130.     class XSettings

  131.     {

  132.     public:

  133.         static std::unique_ptr<XSettings> createXSettings (::Display*);

  134. 

  135.         //==============================================================================

  136.         void update();

  137.         ::Window getSettingsWindow() const noexcept  { return settingsWindow; }

  138. 

  139.         XSetting getSetting (const String& settingName) const;

  140. 

  141.         //==============================================================================

  142.         struct Listener

  143.         {

  144.             virtual ~Listener() = default;

  145.             virtual void settingChanged (const XSetting& settingThatHasChanged) = 0;

  146.         };

  147. 

  148.         void addListener (Listener* listenerToAdd)        { listeners.add (listenerToAdd); }

  149.         void removeListener (Listener* listenerToRemove)  { listeners.remove (listenerToRemove); }

  150. 

  151.     private:

  152.         ::Display* display = nullptr;

  153.         ::Window settingsWindow = None;

  154.         Atom settingsAtom;

  155. 

  156.         int lastUpdateSerial = -1;

  157. 

  158.         std::unordered_map<String, XSetting> settings;

  159.         ListenerList<Listener> listeners;

  160. 

  161.         XSettings (::Display*, Atom, ::Window);

  162. 

  163.         //==============================================================================

  164.         JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (XSettings)

  165.     };

  166. }

  167. 

  168. //==============================================================================

  169. class LinuxComponentPeer;

  170. 

  171. class XWindowSystem  : public DeletedAtShutdown

  172. {

  173. public:

  174.     //==============================================================================

  175.     ::Window createWindow (::Window parentWindow, LinuxComponentPeer*) const;

  176.     void destroyWindow    (::Window);

  177. 

  178.     void setTitle (::Window, const String&) const;

  179.     void setIcon (::Window , const Image&) const;

  180.     void setVisible (::Window, bool shouldBeVisible) const;

  181.     void setBounds (::Window, Rectangle<int>, bool fullScreen) const;

  182.     void updateConstraints (::Window) const;

  183. 

  184.     ComponentPeer::OptionalBorderSize getBorderSize (::Window) const;

  185.     Rectangle<int> getWindowBounds (::Window, ::Window parentWindow);

  186.     Point<int> getPhysicalParentScreenPosition() const;

  187. 

  188.     bool contains (::Window, Point<int> localPos) const;

  189. 

  190.     void setMinimised (::Window, bool shouldBeMinimised) const;

  191.     bool isMinimised  (::Window) const;

  192. 

  193.     void setMaximised (::Window, bool shouldBeMinimised) const;

  194. 

  195.     void toFront  (::Window, bool makeActive) const;

  196.     void toBehind (::Window, ::Window otherWindow) const;

  197. 

  198.     bool isFocused (::Window) const;

  199.     bool grabFocus (::Window) const;

  200. 

  201.     bool canUseSemiTransparentWindows() const;

  202.     bool canUseARGBImages() const;

  203.     bool isDarkModeActive() const;

  204. 

  205.     int getNumPaintsPendingForWindow (::Window);

  206.     void processPendingPaintsForWindow (::Window);

  207.     void addPendingPaintForWindow (::Window);

  208.     void removePendingPaintForWindow (::Window);

  209. 

  210.     Image createImage (bool isSemiTransparentWindow, int width, int height, bool argb) const;

  211.     void blitToWindow (::Window, Image, Rectangle<int> destinationRect, Rectangle<int> totalRect) const;

  212. 

  213.     void setScreenSaverEnabled (bool enabled) const;

  214. 

  215.     Point<float> getCurrentMousePosition() const;

  216.     void setMousePosition (Point<float> pos) const;

  217. 

  218.     Cursor createCustomMouseCursorInfo (const Image&, Point<int> hotspot) const;

  219.     void deleteMouseCursor (Cursor cursorHandle) const;

  220.     Cursor createStandardMouseCursor (MouseCursor::StandardCursorType) const;

  221.     void showCursor (::Window, Cursor cursorHandle) const;

  222. 

  223.     bool isKeyCurrentlyDown (int keyCode) const;

  224.     ModifierKeys getNativeRealtimeModifiers() const;

  225. 

  226.     Array<Displays::Display> findDisplays (float masterScale) const;

  227. 

  228.     ::Window createKeyProxy (::Window);

  229.     void deleteKeyProxy (::Window) const;

  230. 

  231.     bool externalDragFileInit (LinuxComponentPeer*, const StringArray& files, bool canMove, std::function<void()>&& callback) const;

  232.     bool externalDragTextInit (LinuxComponentPeer*, const String& text, std::function<void()>&& callback) const;

  233. 

  234.     void copyTextToClipboard (const String&);

  235.     String getTextFromClipboard() const;

  236.     String getLocalClipboardContent() const noexcept  { return localClipboardContent; }

  237. 

  238.     ::Display* getDisplay() const noexcept                            { return display; }

  239.     const XWindowSystemUtilities::Atoms& getAtoms() const noexcept    { return atoms; }

  240.     XWindowSystemUtilities::XSettings* getXSettings() const noexcept  { return xSettings.get(); }

  241. 

  242.     bool isX11Available() const noexcept  { return xIsAvailable; }

  243. 

  244.     void startHostManagedResize (::Window window,

  245.                                  Point<int> mouseDown,

  246.                                  ResizableBorderComponent::Zone zone);

  247. 

  248.     static String getWindowScalingFactorSettingName()  { return "Gdk/WindowScalingFactor"; }

  249.     static String getThemeNameSettingName()            { return "Net/ThemeName"; }

  250. 

  251.     //==============================================================================

  252.     void handleWindowMessage (LinuxComponentPeer*, XEvent&) const;

  253.     bool isParentWindowOf (::Window, ::Window possibleChild) const;

  254. 

  255.     //==============================================================================

  256.     JUCE_DECLARE_SINGLETON (XWindowSystem, false)

  257. 

  258. private:

  259.     XWindowSystem();

  260.     ~XWindowSystem();

  261. 

  262.     //==============================================================================

  263.     struct VisualAndDepth

  264.     {

  265.         Visual* visual;

  266.         int depth;

  267.     };

  268. 

  269.     struct DisplayVisuals

  270.     {

  271.         explicit DisplayVisuals (::Display*);

  272. 

  273.         VisualAndDepth getBestVisualForWindow (bool) const;

  274.         bool isValid() const noexcept;

  275. 

  276.         Visual* visual16Bit = nullptr;

  277.         Visual* visual24Bit = nullptr;

  278.         Visual* visual32Bit = nullptr;

  279.     };

  280. 

  281.     bool initialiseXDisplay();

  282.     void destroyXDisplay();

  283. 

  284.     //==============================================================================

  285.     ::Window getFocusWindow (::Window) const;

  286. 

  287.     bool isFrontWindow (::Window) const;

  288. 

  289.     //==============================================================================

  290.     void xchangeProperty (::Window, Atom, Atom, int, const void*, int) const;

  291. 

  292.     void removeWindowDecorations (::Window) const;

  293.     void addWindowButtons        (::Window, int) const;

  294.     void setWindowType           (::Window, int) const;

  295. 

  296.     void initialisePointerMap();

  297.     void deleteIconPixmaps (::Window) const;

  298.     void updateModifierMappings() const;

  299. 

  300.     long getUserTime (::Window) const;

  301.     bool isHidden (Window) const;

  302.     bool isIconic (Window) const;

  303. 

  304.     void initialiseXSettings();

  305. 

  306.     //==============================================================================

  307.     void handleKeyPressEvent        (LinuxComponentPeer*, XKeyEvent&) const;

  308.     void handleKeyReleaseEvent      (LinuxComponentPeer*, const XKeyEvent&) const;

  309.     void handleWheelEvent           (LinuxComponentPeer*, const XButtonPressedEvent&, float) const;

  310.     void handleButtonPressEvent     (LinuxComponentPeer*, const XButtonPressedEvent&, int) const;

  311.     void handleButtonPressEvent     (LinuxComponentPeer*, const XButtonPressedEvent&) const;

  312.     void handleButtonReleaseEvent   (LinuxComponentPeer*, const XButtonReleasedEvent&) const;

  313.     void handleMotionNotifyEvent    (LinuxComponentPeer*, const XPointerMovedEvent&) const;

  314.     void handleEnterNotifyEvent     (LinuxComponentPeer*, const XEnterWindowEvent&) const;

  315.     void handleLeaveNotifyEvent     (LinuxComponentPeer*, const XLeaveWindowEvent&) const;

  316.     void handleFocusInEvent         (LinuxComponentPeer*) const;

  317.     void handleFocusOutEvent        (LinuxComponentPeer*) const;

  318.     void handleExposeEvent          (LinuxComponentPeer*, XExposeEvent&) const;

  319.     void handleConfigureNotifyEvent (LinuxComponentPeer*, XConfigureEvent&) const;

  320.     void handleGravityNotify        (LinuxComponentPeer*) const;

  321.     void propertyNotifyEvent        (LinuxComponentPeer*, const XPropertyEvent&) const;

  322.     void handleMappingNotify        (XMappingEvent&) const;

  323.     void handleClientMessageEvent   (LinuxComponentPeer*, XClientMessageEvent&, XEvent&) const;

  324.     void handleXEmbedMessage        (LinuxComponentPeer*, XClientMessageEvent&) const;

  325. 

  326.     void dismissBlockingModals      (LinuxComponentPeer*) const;

  327.     void dismissBlockingModals      (LinuxComponentPeer*, const XConfigureEvent&) const;

  328.     void updateConstraints          (::Window, ComponentPeer&) const;

  329. 

  330.     ::Window findTopLevelWindowOf (::Window) const;

  331. 

  332.     static void windowMessageReceive (XEvent&);

  333. 

  334.     //==============================================================================

  335.     bool xIsAvailable = false;

  336. 

  337.     XWindowSystemUtilities::Atoms atoms;

  338.     ::Display* display = nullptr;

  339.     std::unique_ptr<DisplayVisuals> displayVisuals;

  340.     std::unique_ptr<XWindowSystemUtilities::XSettings> xSettings;

  341. 

  342.    #if JUCE_USE_XSHM

  343.     std::map<::Window, int> shmPaintsPendingMap;

  344.    #endif

  345. 

  346.     int shmCompletionEvent = 0;

  347.     int pointerMap[5] = {};

  348.     String localClipboardContent;

  349. 

  350.     Point<int> parentScreenPosition;

  351. 

  352.     //==============================================================================

  353.     JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (XWindowSystem)

  354. };

  355. 

  356. } // namespace juce