Gkinterface

Interface related functions.

Mouse related Functions

Those of these which come in Get/Set pairs are combined into a single entry below.

GetMouseLookMode/SetMouseLookMode

These relate to the mouselook mode. "True" with these refers to mouselook being on, false to mouselook being disabled.

gkinterface.SetMouseLookMode(true) -- enables mouselook mode
gkinterface.GetMouseLookMode() -- would return "true" now
gkinterface.SetMouseLookMode(false) -- disables mouselook mode
gkinterface.GetMouseLookMode() -- would return "false" now

GetMouseOptions/SetMouseOptions

I'm not sure what this does. The Get option returns the following data structure (on my machine)

{
    1 = {
        "name" = "X Axis",
        "value" = 1
    },
    2 = {
        "name" = "Y Axis",
        "value" = 1
    }
}

GetMousePosition

Definition: gkinterface.GetMousePosition() -> float percent_x, float percent_y

Description Returns two floats which designate how far across the screen the mouse pointer is in percent, as seen from the top left. E.g., if the mouse pointer is dead centre of the screen, this would return "0.5, 0.5" while if it were at the top left, this would return 0,0.

GetMouseSensitivity/SetMouseSensitivity

Get or set the mouse sensitivity. This can be set to values from 1-20 via the Controls menu, but really can go quite a bit higher. Negative values invert mouse movement (for both axis, so this is not a way to get "invert mouse" behaviour).

SetMouseCursor

to do

SetMouseCursorIndexImage

Definition:

Description:

Arguments:

Returns:
nothing

Example:

gkinterface.SetMouseCursorIndexImage(0, 'images/station/int_mouse_pointer.png', 0, 0)
gkinterface.SetMouseCursorIndexImage(1, 'images/station/int_mouse_pointer_no.png', 0.25, 0.25)
gkinterface.SetMouseCursorIndexImage(2, 'images/station/int_mouse_pointer_copy.png', 0, 0)
gkinterface.SetMouseCursorIndexImage(3, 'images/station/int_mouse_pointer.png', 0, 0)
gkinterface.SetMouseCursorIndexImage(4, 'images/station/int_mouse_pointer.png', 0, 0)

SetMouseHotspot

to do

Uncategorized Functions

BindCommand

Definition:
BindCommand(keycode, command) -> ?

Description
Binds a command to a key.

Arguments:
keycode - the keycode returned by GetInputCodeByName()
command - the command to be bound

Returns:

Example:

gkinterface.BindCommand(gkinterface.GetInputCodeByName("LeftArrow"), "+TurnLeft")

CreateTouchRegion

Definition:
CreateTouchRegion(?, ?, string command, boolean, boolean, boolean, boolean, boolean, boolean, number x, number y, number x2, number y2) -> number regionid

Description:
Creates a rectangular region on a touch enabled device that will respond to touch presses.
Arguments:
1: unknown
2: unknown
3: command - this is a string value which matches an in-game command
4: unknown
5: unknown
6: unknown
7: unknown
8: unknown
9: unknown
10: x - the x-coordinate for the upper-left corner
11: y - the y-coordinate for the upper-left corner
12: x2 - the x-coordinate for the lower-right corner
13: y2 - the y-coordinate for the lower-right corner

Returns:
regionid - an auto-incrementing number identifying the newly created region

Example:

gkinterface.CreateTouchRegion(nil, nil, "+turbo", false, false, false, false, false, false, 0, 792, 71, 855)

DestroyTouchRegion

Definition:
DestroyTouchRegion(number regionid) -> nil

Description:
Destroys a touch region.
Arguments:
regionid - the region id returned by CreateTouchRegion()

Returns:

Example:

gkinterface.DestroyTouchRegion(1)

Draw3DScene

Definition:
Draw3DScene(boolean draw)

Description:

Arguments:
draw - if true then draw 3D scene.

Returns:
nothing

Example:

gkinterface.Draw3DScene(false)

GetCommandForKeyboardBind

Definition:
GetCommandForKeyboardBind(number keycode) -> string command_down, command_up
Description:
Returns the commands bound to the keycode.

Arguments:
keycode - keycode of key.

Returns:
command_down - command bound to key down or nil
command_up - command bound to key release or nil (optional)

Example:

if gkinterface.GetCommandForKeyboardBind(65513) then print("key has a bind") end
print( gkinterface.GetCommandForKeyboardBind(116) ) -- returned say_channel

GetXResolution

Definition: gkinterface.GetXResolution -> int width

Description Returns the width of the current game resolution

Arguments None

Returns An int containing the current game screen width (e.g. 800)

GetYResolution

Definition: gkinterface.GetYResolution -> int width

Description Returns the height of the current game resolution

Arguments None

Returns An int containing the current game screen height (e.g. 600)

GKProcessCommand

* list of the Vendetta commands

* detailed explanation of the commands

IsAltKeyDown

Definition: gkinterface.IsAltKeyDown() -> bool pressed

Description Test if the Alt key is currently pressed.

Arguments None

Returns True if the either of the alt keys is currently pressed, false otherwise.

IsCtrlKeyDown

Definition: gkinterface.IsCtrlKeyDown() -> bool pressed

Description Test if the Ctrl key is currently pressed.

Arguments None

Returns True if the either of the ctrl keys is currently pressed, false otherwise.

IsShiftKeyDown

Definition: gkinterface.IsShiftKeyDown() -> bool pressed

Description Test if the shift key is currently pressed.

Arguments None

Returns True if the either of the shift keys is currently pressed, false otherwise.

IsTouchModeEnabled

Definition: gkinterface.IsTouchModeEnabled() -> bool

Description Test if the shift key is currently pressed.

Arguments None

Returns True if touch mode is enabled, false otherwise.

SetFOV

Definition: gkinterface.SetFOV(int angle) -> nil

Description Sets the Field of View angle in degrees (from 1 to 179). Note that this value is reset each time the player warps to another sector. It's not saved when the game is exited either. If you want to save this, you need to use Game.SetCVar

Arguments int angle -> the new angle for the field of view.

Returns nil