ansi_escape/doc/cursor.md

1.2 KiB

Cursor control

Move to spesific coordinates

To move the terminal cursor using positional coordinates use the following function:

ansi_escape.cursor_position()

If the function name is to long you can use:

ansi_escape.cup()

instead.

ansi_escape.cup() #sets position to 1,1
ansi_escape.cursor_position(row=5) #sets cursor position to row 5 and column 1
ansi_escape.cup(column=16) #sets cursor position to column 16 and row 1
ansi_escape.cursor_position(row=30, column=3) #sets cursor position to row 30 and column 3

Move cursor from current position

For relative movements use:

ansi_escape(direction, cells)

direction can be:

  • "up"
  • "down"
  • "forward"
  • "backward"
    It is the direction the cursor moves towards.

cells is an optional argumant which specifies how many character cells you want to move the cursor.

Move cursor to spesific horisontal position

Use:

ansi_escape.cursor_horisontal_absolute(column)
#or
ansi_escape.cha(column)

column can be omitted and will then default to 1.
This will not affect the vertical coordinates of the cursor.