style: Format source code and support grouping client

client/clip.h

@@ -13,34 +13,37 @@
 #include <string>
 #include <vector>
 
-namespace clip {
+namespace clip
+{
 
-  // ======================================================================
-  // Low-level API to lock the clipboard/pasteboard and modify it
-  // ======================================================================
+// ======================================================================
+// Low-level API to lock the clipboard/pasteboard and modify it
+// ======================================================================
 
-  // Clipboard format identifier.
-  typedef size_t format;
+// Clipboard format identifier.
+typedef size_t format;
 
 #if CLIP_ENABLE_IMAGE
-  class image;
-  struct image_spec;
+class image;
+struct image_spec;
 #endif // CLIP_ENABLE_IMAGE
 
 #if CLIP_ENABLE_LIST_FORMATS
-  struct format_info {
+struct format_info {
     format id = 0;
     std::string name;
     format_info(const format id,
                 const std::string& name)
-      : id(id),
-        name(name) {
+        : id(id),
+          name(name)
+    {
     }
-  };
+};
 #endif // CLIP_ENABLE_LIST_FORMATS
 
-  class lock {
-  public:
+class lock
+{
+public:
     // You can give your current HWND as the "native_window_handle."
     // Windows clipboard functions use this handle to open/close
     // (lock/unlock) the clipboard. From the MSDN documentation we
@@ -79,62 +82,62 @@ namespace clip {
     std::vector<format_info> list_formats() const;
 #endif // CLIP_ENABLE_LIST_FORMATS
 
-  private:
+private:
     class impl;
     std::unique_ptr<impl> p;
-  };
+};
 
-  format register_format(const std::string& name);
+format register_format(const std::string& name);
 
-  // This format is when the clipboard has no content.
-  format empty_format();
+// This format is when the clipboard has no content.
+format empty_format();
 
-  // When the clipboard has UTF8 text.
-  format text_format();
+// When the clipboard has UTF8 text.
+format text_format();
 
 #if CLIP_ENABLE_IMAGE
-  // When the clipboard has an image.
-  format image_format();
+// When the clipboard has an image.
+format image_format();
 #endif
 
-  // Returns true if the clipboard has content of the given type.
-  bool has(format f);
+// Returns true if the clipboard has content of the given type.
+bool has(format f);
 
-  // Clears the clipboard content.
-  bool clear();
+// Clears the clipboard content.
+bool clear();
 
-  // ======================================================================
-  // Error handling
-  // ======================================================================
+// ======================================================================
+// Error handling
+// ======================================================================
 
-  enum class ErrorCode {
+enum class ErrorCode {
     CannotLock,
 #if CLIP_ENABLE_IMAGE
     ImageNotSupported,
 #endif
-  };
+};
 
-  typedef void (*error_handler)(ErrorCode code);
+typedef void (*error_handler)(ErrorCode code);
 
-  void set_error_handler(error_handler f);
-  error_handler get_error_handler();
+void set_error_handler(error_handler f);
+error_handler get_error_handler();
 
-  // ======================================================================
-  // Text
-  // ======================================================================
+// ======================================================================
+// Text
+// ======================================================================
 
-  // High-level API to put/get UTF8 text in/from the clipboard. These
-  // functions returns false in case of error.
-  bool set_text(const std::string& value);
-  bool get_text(std::string& value);
+// High-level API to put/get UTF8 text in/from the clipboard. These
+// functions returns false in case of error.
+bool set_text(const std::string& value);
+bool get_text(std::string& value);
 
-  // ======================================================================
-  // Image
-  // ======================================================================
+// ======================================================================
+// Image
+// ======================================================================
 
 #if CLIP_ENABLE_IMAGE
 
-  struct image_spec {
+struct image_spec {
     unsigned long width = 0;
     unsigned long height = 0;
     unsigned long bits_per_pixel = 0;
@@ -149,20 +152,21 @@ namespace clip {
     unsigned long alpha_shift = 0;
 
     unsigned long required_data_size() const;
-  };
+};
 
-  // The image data must contain straight RGB values
-  // (non-premultiplied by alpha). The image retrieved from the
-  // clipboard will be non-premultiplied too. Basically you will be
-  // always dealing with straight alpha images.
-  //
-  // Details: Windows expects premultiplied images on its clipboard
-  // content, so the library code make the proper conversion
-  // automatically. macOS handles straight alpha directly, so there is
-  // no conversion at all. Linux/X11 images are transferred in
-  // image/png format which are specified in straight alpha.
-  class image {
-  public:
+// The image data must contain straight RGB values
+// (non-premultiplied by alpha). The image retrieved from the
+// clipboard will be non-premultiplied too. Basically you will be
+// always dealing with straight alpha images.
+//
+// Details: Windows expects premultiplied images on its clipboard
+// content, so the library code make the proper conversion
+// automatically. macOS handles straight alpha directly, so there is
+// no conversion at all. Linux/X11 images are transferred in
+// image/png format which are specified in straight alpha.
+class image
+{
+public:
     image();
     image(const image_spec& spec);
     image(const void* data, const image_spec& spec);
@@ -173,38 +177,47 @@ namespace clip {
     image& operator=(const image& image);
     image& operator=(image&& image);
 
-    char* data() const { return m_data; }
-    const image_spec& spec() const { return m_spec; }
+    char* data() const
+    {
+        return m_data;
+    }
+    const image_spec& spec() const
+    {
+        return m_spec;
+    }
 
-    bool is_valid() const { return m_data != nullptr; }
+    bool is_valid() const
+    {
+        return m_data != nullptr;
+    }
     void reset();
 
-  private:
+private:
     void copy_image(const image& image);
     void move_image(image&& image);
 
     bool m_own_data;
     char* m_data;
     image_spec m_spec;
-  };
+};
 
-  // High-level API to set/get an image in/from the clipboard. These
-  // functions returns false in case of error.
-  bool set_image(const image& img);
-  bool get_image(image& img);
-  bool get_image_spec(image_spec& spec);
+// High-level API to set/get an image in/from the clipboard. These
+// functions returns false in case of error.
+bool set_image(const image& img);
+bool get_image(image& img);
+bool get_image_spec(image_spec& spec);
 
 #endif // CLIP_ENABLE_IMAGE
 
-  // ======================================================================
-  // Platform-specific
-  // ======================================================================
+// ======================================================================
+// Platform-specific
+// ======================================================================
 
-  // Only for X11: Sets the time (in milliseconds) that we must wait
-  // for the selection/clipboard owner to receive the content. This
-  // value is 1000 (one second) by default.
-  void set_x11_wait_timeout(int msecs);
-  int get_x11_wait_timeout();
+// Only for X11: Sets the time (in milliseconds) that we must wait
+// for the selection/clipboard owner to receive the content. This
+// value is 1000 (one second) by default.
+void set_x11_wait_timeout(int msecs);
+int get_x11_wait_timeout();
 
 } // namespace clip