mirror of
https://github.com/grumpycoders/pcsx-redux.git
synced 2025-04-02 10:41:54 -04:00
72 lines
1.8 KiB
Markdown
72 lines
1.8 KiB
Markdown
# Clip Library
|
|
*Copyright (c) 2015-2021 David Capello*
|
|
|
|
Modified in 2022 for PCSX-Redux by Nicolas "Pixel" Noble
|
|
|
|
Modifications:
|
|
- Removed the libpng dependency, added a dependency on stb image writer.
|
|
- Added png import / export to the `image` class.
|
|
- Some minor cleanup.
|
|
|
|
Original code at https://github.com/dacap/clip
|
|
|
|
[](LICENSE.txt)
|
|
|
|
Library to copy/retrieve content to/from the clipboard/pasteboard.
|
|
|
|
## Features
|
|
|
|
Available features on Windows, macOS, and Linux (X11):
|
|
|
|
* Copy/paste UTF-8 text.
|
|
* Copy/paste user-defined data.
|
|
* Copy/paste RGB/RGBA images. This library use non-premultiplied alpha RGB values.
|
|
|
|
## Example
|
|
|
|
```cpp
|
|
#include "clip.h"
|
|
#include <iostream>
|
|
|
|
int main() {
|
|
clip::set_text("Hello World");
|
|
|
|
std::string value;
|
|
clip::get_text(value);
|
|
std::cout << value << "\n";
|
|
}
|
|
```
|
|
|
|
## User-defined clipboard formats
|
|
|
|
```cpp
|
|
#include "clip.h"
|
|
|
|
int main() {
|
|
clip::format my_format =
|
|
clip::register_format("com.appname.FormatName");
|
|
|
|
int value = 32;
|
|
|
|
clip::lock l;
|
|
l.clear();
|
|
l.set_data(clip::text_format(), "Alternative text for value 32");
|
|
l.set_data(my_format, &value, sizeof(int));
|
|
}
|
|
```
|
|
|
|
## Platform specific details
|
|
|
|
* If two versions of your application (32-bit and 64-bit) can run at
|
|
at the same time, remember to avoid storing data types that could
|
|
change depending on the platform (e.g. `size_t`) in your custom
|
|
format data.
|
|
* **Windows**:
|
|
- [Limited number of clipboard formats on Windows](http://blogs.msdn.com/b/oldnewthing/archive/2015/03/19/10601208.aspx)
|
|
* **Linux**:
|
|
- To be able to copy/paste on Linux you need `libx11-dev`/`libX11-devel` package.
|
|
|
|
## Who is using this library?
|
|
|
|
[Check the wiki](https://github.com/dacap/clip/wiki#who-is-using-clip)
|
|
to know what projects are using the `clip` library.
|