Cursor

API
Example
Permissions
listenPosition
Starts listening to changes to the cursor position. Takes a callback function as an argument, which sends a Position whenever called. A promise is triggered after setting the listener that provides access to a Cancellable stream, so that you can turn off the listener.
1
import { cursor } from '@oliveai/ldk';
2
​
3
let cursorStream: Cancellable;
4
​
5
cursor.listenPosition((position) => {
6
    console.log(`Cursor position: ${position.x}/${position.y}`);
7
}).then((cancellable: Cancellable) => {
8
    cursorStream = cancellable;
9
});
Copied!
position
Retrieves the cursor's current position.
1
import { clipboard } from '@oliveai/ldk';
2
​
3
// Function that is called after position() is successful
4
// Provides the cursor's position when position() was executed
5
const callback = (position) => {
6
    console.log(`Cursor position: ${position.x}/${position.y}`);
7
};
8
​
9
clipboard.position().then(callback);
Copied!
In this example, we are going to use the Cursor and Keyboard aptitudes to provide the required coordinates to the Screen aptitude's ocr() function.  
We'll use listenCharacter() to get cursor position. Move your cursor to the top left corner of the area you want to perform OCR on, then press 's' or 'S' to capture those coordinates. Then move your cursor to the bottom right corner of the area you want, and press 'a' or 'A' to get the second coordinates. Then we can calculate ocrCoordinates according to the cursor positions, and then pass it to the ocr() function.
​
1
let check = 0;
2
async function runOCRWithCursorPosition() {
3
  let topParam: number;
4
  let leftParam: number;
5
  let topParam1: number;
6
  let leftParam1: number;
7
​
8
  const listener1 = await keyboard.listenCharacter(async (char) => {
9
    console.debug('Hotkey pressed', 'response', char);
10
    if (char === 's' || char === 'S') {
11
      const position = await cursor.position();
12
      // we have to convert position.x to integer 
13
      // ocrCoordinates only takes integers in our backdend.
14
      leftParam = parseInt(position.x.toString(), 10);
15
      topParam = parseInt(position.y.toString(), 10);
16
      console.log('First time cursor position:', topParam, leftParam);
17
      listener1.cancel();
18
      check = 1;
19
    }
20
  });
21
​
22
  const listener2 = await keyboard.listenCharacter(async (char) => {
23
    console.debug('Hotkey pressed', 'response', char);
24
    if ((char === 'a' || char === 'A') && check === 1) {
25
      const position1 = await cursor.position();
26
      leftParam1 = parseInt(position1.x.toString(), 10);
27
      topParam1 = parseInt(position1.y.toString(), 10);
28
      console.log('Second time cursor Position:', topParam1, leftParam1);
29
      listener2.cancel();
30
​
31
      const width = Math.abs(leftParam1 - leftParam);
32
      const height = Math.abs(topParam1 - topParam);
33
​
34
      const ocrCoordinates = {
35
        top: topParam,
36
        left: leftParam,
37
        width,
38
        height,
39
      };
40
      const result = await screen.ocr(ocrCoordinates);
41
​
42
      console.log('OCR Results: ');
43
      console.log(JSON.stringify(result));
44
      console.log('result: ', rebuildImage(result));
45
      writeWhisper(`result`, rebuildImage(result));
46
​
47
      console.log('got OCR coordinates:');
48
      console.log(
49
        ocrCoordinates.top,
50
        ocrCoordinates.left,
51
        ocrCoordinates.width,
52
        ocrCoordinates.height,
53
      );
54
      console.log('performing ocr with coordinates...');
55
    }
56
  });
57
}
58
​
Copied!
Now we can wrap up runOCRWithCursorPosition with our Whisper! 
1
 async function testOCRUsingCursor() {
2
  try {
3
    await runOCRWithCursorPosition();
4
  } catch (error) {
5
    console.log('error: ');
6
    console.log(error);
7
  }
8
}
9
​
10
const writeWhisperCursorTest = (label: string, body: string) =>
11
  whisper.create({
12
    label,
13
    onClose: () => {
14
      console.log(`Closed Whisper`);
15
    },
16
    components: [
17
      {
18
        body,
19
        type: whisper.WhisperComponentType.Markdown,
20
      },
21
      {
22
        type: whisper.WhisperComponentType.Button,
23
        label: 'Perform OCR',
24
        onClick: (error, incomingWhisper) => {
25
          incomingWhisper.close((e) => console.error(e));
26
          testOCRUsingCursor();
27
        },
28
      },
29
    ],
30
  });
31
​
32
​
33
const testOCRUsingCursorAptitude = () => {
34
    try {
35
      await writeWhisperCursorTest(`OCR`, `Starting OCR app`);
36
      await sleep(10000);
37
    } catch (e) {
38
      console.error(e);
39
    }
40
});
Copied!
To use the Cursor aptitude, simply set the following permissions in your package.json under the ldk object.
1
...
2
"ldk": {
3
  "permissions": {
4
    "cursor": {},
5
    ...
6
  }
7
},
Copied!

APTITUDES - Previous

Clipboard

Next - APTITUDES

Document

Last modified 9h ago

Copy link