### PyDirectInput Testing Setup

Source: https://github.com/learncodebygaming/pydirectinput/blob/master/README.md

Instructions for setting up a virtual environment and installing PyDirectInput in an editable state for testing. This allows for direct modification and testing of the library's source code.

```bash
pip install -e .
python3 tests
```

--------------------------------

### PyDirectInput Installation

Source: https://github.com/learncodebygaming/pydirectinput/blob/master/README.md

Provides the command to install the PyDirectInput library using pip. This is the standard method for adding Python packages to your project.

```bash
pip install pydirectinput
```

--------------------------------

### Simulate Keyboard Key Down and Up Events

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Illustrates how to press (keyDown) and release (keyUp) keyboard keys without performing the opposite action. This is essential for holding keys in games for continuous actions like movement or sprinting. Examples include single key holds and combinations.

```python
import pydirectinput
import time

# Hold and release a single key
pydirectinput.keyDown('g')
time.sleep(0.05)
pydirectinput.keyUp('g')

# WASD movement in games
pydirectinput.keyDown('w')  # Start moving forward
time.sleep(1)
pydirectinput.keyUp('w')    # Stop moving

# Strafe right
pydirectinput.keyDown('d')
time.sleep(0.25)
pydirectinput.keyUp('d')

# Hold shift for sprinting
pydirectinput.keyDown('shift')
pydirectinput.keyDown('w')
time.sleep(2)
pydirectinput.keyUp('w')
pydirectinput.keyUp('shift')

# Arrow key controls
pydirectinput.keyDown('left')
time.sleep(0.25)
pydirectinput.keyUp('left')

pydirectinput.keyDown('right')
time.sleep(0.25)
pydirectinput.keyUp('right')
```

--------------------------------

### PyDirectInput Example Usage: Mouse and Keyboard Simulation

Source: https://github.com/learncodebygaming/pydirectinput/blob/master/README.md

Demonstrates basic mouse and keyboard control using PyDirectInput functions. This includes moving the cursor, clicking, pressing keys, and simulating key down/up events. It's designed to be a drop-in replacement for PyAutoGUI functions that may not work in certain applications.

```python
import pyautogui
import pydirectinput

pydirectinput.moveTo(100, 150) # Move the mouse to the x, y coordinates 100, 150.
pydirectinput.click() # Click the mouse at its current location.
pydirectinput.click(200, 220) # Click the mouse at the x, y coordinates 200, 220.
pydirectinput.move(None, 10)  # Move mouse 10 pixels down, that is, move the mouse relative to its current position.
pydirectinput.doubleClick() # Double click the mouse at the
pydirectinput.press('esc') # Simulate pressing the Escape key.
pydirectinput.keyDown('shift')
pydirectinput.keyUp('shift')
```

--------------------------------

### Supported Keyboard Keys in PyDirectInput

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Lists the various categories of keyboard keys supported by PyDirectInput, including letters, numbers, function keys, modifier keys, navigation keys, and special keys. Examples demonstrate how to press or hold these keys.

```python
import pydirectinput

# Letter keys (lowercase)
pydirectinput.press('a')  # a-z supported

# Number keys
pydirectinput.press('1')  # 0-9 supported

# Function keys
pydirectinput.press('f1')   # f1-f12 supported

# Modifier keys
pydirectinput.keyDown('shift')      # or 'shiftleft'
pydirectinput.keyDown('shiftright')
pydirectinput.keyDown('ctrl')       # or 'ctrlleft'
pydirectinput.keyDown('ctrlright')
pydirectinput.keyDown('alt')        # or 'altleft'
pydirectinput.keyDown('altright')
pydirectinput.keyDown('win')        # or 'winleft'
pydirectinput.keyDown('winright')

# Navigation keys
pydirectinput.press('up')
pydirectinput.press('down')
pydirectinput.press('left')
pydirectinput.press('right')
pydirectinput.press('home')
pydirectinput.press('end')
pydirectinput.press('pageup')
pydirectinput.press('pagedown')

# Special keys
pydirectinput.press('escape')  # or 'esc'
pydirectinput.press('enter')   # or 'return'
pydirectinput.press('tab')
pydirectinput.press('space')
pydirectinput.press('backspace')
pydirectinput.press('delete')  # or 'del'
pydirectinput.press('insert')
```

--------------------------------

### Execute Comprehensive Game Automation Workflow

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

A complete script demonstrating mouse movement, WASD keyboard simulation, mouse clicking, and text input for game automation scenarios.

```python
import pydirectinput
import time

def game_automation_example():
    pydirectinput.FAILSAFE = True
    pydirectinput.PAUSE = 0.05

    # Move mouse to center
    width, height = pydirectinput.size()
    pydirectinput.moveTo(width // 2, height // 2)

    # Movement and interaction
    pydirectinput.keyDown('w')
    time.sleep(1)
    pydirectinput.keyUp('w')

    pydirectinput.click()
    pydirectinput.typewrite('gg', interval=0.05)

if __name__ == '__main__':
    game_automation_example()
```

--------------------------------

### Configure PyDirectInput settings

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Global configuration options for managing fail-safe mechanisms and input pause durations to ensure script stability.

```python
import pydirectinput

# Enable/disable fail-safe (moves mouse to corner to abort)
pydirectinput.FAILSAFE = True  # Default: True

# Define fail-safe trigger points (screen corners)
pydirectinput.FAILSAFE_POINTS = [(0, 0)]  # Default: top-left corner

# Set pause duration between actions (in seconds)
pydirectinput.PAUSE = 0.1  # Default: 0.1 seconds
```

--------------------------------

### Simulate Numpad and Special Keys with PyDirectInput

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Demonstrates how to trigger specific non-alphanumeric keys such as numpad inputs, lock keys, and system keys like printscreen and apps menu.

```python
import pydirectinput

# Numpad keys
pydirectinput.press('numpad0')
pydirectinput.press('numpadenter')
pydirectinput.press('add')
pydirectinput.press('subtract')
pydirectinput.press('multiply')
pydirectinput.press('divide')
pydirectinput.press('decimal')
pydirectinput.press('numlock')

# Lock and other keys
pydirectinput.press('capslock')
pydirectinput.press('scrolllock')
pydirectinput.press('pause')
pydirectinput.press('printscreen')
pydirectinput.press('apps')
```

--------------------------------

### Simulate Key Presses with PyDirectInput

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Demonstrates the `press` function for simulating a single key press and release. It can accept a single key string or a list of keys to press sequentially. Options include specifying the number of presses and the interval between them.

```python
import pydirectinput

# Press a single key
pydirectinput.press('esc')

# Press Escape key
pydirectinput.press('escape')

# Press multiple keys in sequence
pydirectinput.press(['c', 'v', 't'])

# Press a key multiple times
pydirectinput.press('space', presses=3, interval=0.1)

# Function keys
pydirectinput.press('f1')
pydirectinput.press('f5')

# Navigation keys
pydirectinput.press('enter')
pydirectinput.press('tab')
pydirectinput.press('backspace')

# Press without pause after
pydirectinput.press('a', _pause=False)
```

--------------------------------

### Type Text with PyDirectInput

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Shows how to simulate typing text using `typewrite` and its alias `write`. These functions press each character of a given string sequentially. Users can control the interval between keystrokes and whether to pause after completion.

```python
import pydirectinput

# Type a word
pydirectinput.typewrite('hello')

# Type with interval between keystrokes
pydirectinput.typewrite('myword', interval=0.05)

# Using the write() alias
pydirectinput.write('username')

# Type a longer message
pydirectinput.write('gg wp', interval=0.1)

# Type without pause after completion
pydirectinput.typewrite('quick', _pause=False)
```

--------------------------------

### Simulate Mouse Clicks with PyDirectInput

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Demonstrates how to perform right clicks, middle clicks, double clicks, and triple clicks using PyDirectInput. These functions can be called at specific coordinates or the current mouse position and support customization for buttons and intervals.

```python
import pydirectinput

# Right click at coordinates
pydirectinput.rightClick(500, 300)

# Middle click (often used for scroll wheel click)
pydirectinput.middleClick()
pydirectinput.middleClick(250, 250)

# Double click at current position
pydirectinput.doubleClick()

# Double click at specific coordinates
pydirectinput.doubleClick(300, 400)

# Double right-click
pydirectinput.doubleClick(button='right')

# Triple click (useful for selecting paragraphs)
pydirectinput.tripleClick()

# Triple click at coordinates with custom interval
pydirectinput.tripleClick(200, 200, interval=0.05)
```

--------------------------------

### Simulate Mouse Button Down and Up Events

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Shows how to simulate pressing (mouseDown) and releasing (mouseUp) mouse buttons independently. This is crucial for drag-and-drop operations or holding buttons in games. Functions can specify coordinates and the mouse button to use.

```python
import pydirectinput
import time

# Press and hold left mouse button
pydirectinput.mouseDown()

# Move while holding (simulates drag)
pydirectinput.moveTo(500, 500)
time.sleep(0.5)

# Release left mouse button
pydirectinput.mouseUp()

# Hold right mouse button (e.g., for aiming in games)
pydirectinput.mouseDown(button='right')
time.sleep(2)
pydirectinput.mouseUp(button='right')

# Mouse down at specific coordinates
pydirectinput.mouseDown(x=100, y=100, button='left')
time.sleep(1)
pydirectinput.mouseUp(x=200, y=200, button='left')
```

--------------------------------

### Retrieve mouse and screen information

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Functions to obtain the current mouse cursor coordinates and the primary display resolution.

```python
import pydirectinput

# Get current mouse position
x, y = pydirectinput.position()
print(f"Mouse is at: ({x}, {y})")

# Get position with x override (keeps current y)
coords = pydirectinput.position(x=100)
print(f"Position with x override: {coords}")

# Get screen dimensions
width, height = pydirectinput.size()
print(f"Screen resolution: {width}x{height}")
```

--------------------------------

### Move mouse cursor

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Methods for moving the mouse to absolute coordinates or relative offsets, including support for raw win32 API movement.

```python
import pydirectinput
import time

# Move mouse to absolute coordinates
pydirectinput.moveTo(100, 150)

# Move mouse relative to current position
pydirectinput.moveRel(100, 0)   # Move 100 pixels right

# Raw relative movement (better for some DirectX games)
pydirectinput.moveRel(0, 400, relative=True)
```

--------------------------------

### Perform mouse clicks

Source: https://context7.com/learncodebygaming/pydirectinput/llms.txt

Functions to execute mouse clicks at specific locations or the current position, supporting multiple buttons and click counts.

```python
import pydirectinput

# Simple click at current position
pydirectinput.click()

# Click at specific coordinates
pydirectinput.click(200, 220)

# Right click
pydirectinput.click(button='right')

# Convenience left click
pydirectinput.leftClick(100, 200)
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.