|
1 | | -# MousePos |
2 | | -The MousePos plugin is a simple yet powerful plugin for Rainmeter, designed to retrieve the current mouse position on your screen. You can display the mouse cursor's X or Y coordinates using this plugin. |
| 1 | +# MousePos - Rainmeter Plugin |
| 2 | + |
| 3 | +The **MousePos** plugin is a simple yet powerful plugin for **Rainmeter**, designed to retrieve the current mouse position on your screen. You can display the mouse cursor's **X** or **Y** coordinates using this plugin. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- Retrieve the **X** and **Y** position of the mouse cursor. |
| 8 | +- Supports two types of measurements: **MouseX** and **MouseY**. |
| 9 | +- Easy to integrate with Rainmeter skins. |
| 10 | +- Written in C# using Rainmeter's plugin system. |
| 11 | + |
| 12 | +## Installation |
| 13 | + |
| 14 | +1. **Download the latest release** of **MousePos**. |
| 15 | +2. **Install the plugin** by copying `MousePos.dll` into your Rainmeter's `Plugins` folder: |
| 16 | + - Typically, the folder path is: |
| 17 | + `C:\Users\<YourUsername>\Documents\Rainmeter\Plugins\` |
| 18 | +3. After installation, you can use it in your Rainmeter skins. |
| 19 | + |
| 20 | +## Usage |
| 21 | + |
| 22 | +### 1. Add the plugin to your Rainmeter skin. |
| 23 | + |
| 24 | +In your `.ini` skin file, define a measure that uses the **MousePos** plugin. You can specify whether you want the X or Y coordinate of the mouse. |
| 25 | + |
| 26 | +```ini |
| 27 | +[Rainmeter] |
| 28 | +Update=50 |
| 29 | +BackGroundMode=2 |
| 30 | +SolidColor=ffffff |
| 31 | + |
| 32 | +[MeasureMouseX] |
| 33 | +Measure=Plugin |
| 34 | +Plugin=MousePos |
| 35 | +MeasureType=MouseX |
| 36 | +DynamicVariables=1 |
| 37 | + |
| 38 | +[MeasureMouseY] |
| 39 | +Measure=Plugin |
| 40 | +Plugin=MousePos |
| 41 | +MeasureType=MouseY |
| 42 | +DynamicVariables=1 |
| 43 | + |
| 44 | +[MeterMouseX] |
| 45 | +Meter=STRING |
| 46 | +X=10 |
| 47 | +Y=10 |
| 48 | +FontColor=10,10,10 |
| 49 | +Text=Mouse X: [MeasureMouseX] |
| 50 | +DynamicVariables=1 |
| 51 | +Antialias=1 |
| 52 | + |
| 53 | +[MeterMouseY] |
| 54 | +Meter=STRING |
| 55 | +X=10 |
| 56 | +Y=30 |
| 57 | +FontColor=10,10,10 |
| 58 | +Text=Mouse Y: [MeasureMouseY] |
| 59 | +DynamicVariables=1 |
| 60 | +Antialias=1 |
| 61 | +``` |
| 62 | + |
| 63 | +In this example: |
| 64 | +- **MeasureType=MouseX** will get the X position of the mouse. |
| 65 | +- **MeasureType=MouseY** will get the Y position of the mouse. |
| 66 | + |
| 67 | + |
| 68 | + |
| 69 | +## Parameters |
| 70 | + |
| 71 | +- **MeasureType**: Defines what measurement to fetch. Can be `MouseX` (for X coordinate) or `MouseY` (for Y coordinate). |
| 72 | + |
| 73 | +## Troubleshooting |
| 74 | + |
| 75 | +- Ensure the `MousePos.dll` file is correctly placed in the **Rainmeter Plugins** folder. |
| 76 | +- If you don't see the position, check the Rainmeter logs for any errors related to the plugin. |
| 77 | + |
| 78 | +## Contributing |
| 79 | + |
| 80 | +If you'd like to contribute to this project, you can: |
| 81 | +- Fork the repository. |
| 82 | +- Create a branch for your feature or fix. |
| 83 | +- Submit a pull request. |
| 84 | + |
| 85 | +Please ensure that your code follows the existing style and includes necessary documentation or tests. |
| 86 | + |
| 87 | +## License |
| 88 | + |
| 89 | +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. |
| 90 | + |
0 commit comments