This is a simple library that implements the mouse cursor in ACS.

This library takes into account the player's mouse sensitivity and Y invert settings to make the cursor work the same regardless of the settings.

while (true)
{
    // Get mouse input.
    UpdateCursor();
        
    // Draw the cursor at CursorX(), CursorY().
    HudSetPoint(CursorX(), CursorY());
    HudDrawText(1, "*");
    
    // Wait for next frame.
    Delay(1);
}       

The cursor's coordinates system matches that of HudMessages with SetHudSize. The default coordinate system is 640×480. You can override it using 'SetCursorArea(width, height)'.

void UpdateCursor()

Updates the cursor position using the input from ConsolePlayer (current computer).

fixed CursorX()

Returns the cursor's X position.

fixed CursorY()

Returns the cursor's Y position.

void CenterCursor()

Centers the cursor on the screen.

void SetCursorPosition(fixed x, fixed y)

Sets the cursor's position.

void SetCursorSpeed(fixed speed)

Sets the cursor's current speed multiplier.

Default is 1.0.

void SetCursorSpeedX(fixed speed)

Sets the cursor's current X speed multiplier.

Default is 1.0.

void SetCursorSpeedY(fixed speed)

Sets the cursor's current Y speed multiplier.

Default is 1.0.

void EnableCursorWrap(bool enable)

If enabled, the cursor when moved outside the screen, will teleport to the opposite edge of the screen.

void EnableCursorWrap(bool enable)

Enables/disables cursor wrapping on X axis only.

void EnableCursorWrap(bool enable)

Enables/disables cursor wrapping on Y axis only.

void SetCursorArea(fixed width, fixed height)

Sets the coordinate system for the cursor. You can use any size from 1.0 to several thousands for any axis. When SetCursorArea is called, the cursor is moved so that its relative position stays the same.

Default is 640×480 (width = 640.0, height = 480.0).

Example

SetCursorArea(1.0, 1.0);

Results in the following cursor coordinate system:

fixed CursorDeltaX()

Returns the last change in cursor's X position.

fixed CursorDeltaY()

Returns the last change in cursor's Y position.

fixed CursorMotionX()

Returns the attempted X-axis cursor motion. Equals to delta unless the cursor is blocked by the edge of the screen.

fixed CursorMotionY()

Returns the attempted Y-axis cursor motion. Equals to delta unless the cursor is blocked by the edge of the screen.