kannonier8/blender
1
0
Fork 0
forked from bartvdbraak/blender
Code Pull Requests Activity
0c7dce887c
blender/source/gameengine/PyDoc/bge.events.rst

252 lines
4.6 KiB
ReStructuredText
Raw Normal View History

epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
= Game Engine PyDocs = Document's headers trailing dots removed, to make them consistent with other docs.
2010-05-28 19:59:15 +00:00
Game Engine bge.events module
=============================
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
*****
Intro
*****
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
This module holds key constants for the SCA_KeyboardSensor.
.. module:: bge.events
.. code-block:: python
# Set a connected keyboard sensor to accept F1
import bge
co = bge.logic.getCurrentController()
# 'Keyboard' is a keyboard sensor
sensor = co.sensors["Keyboard"]
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
sensor.key = bge.events.F1KEY
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. code-block:: python
# Do the all keys thing
import bge
co = bge.logic.getCurrentController()
# 'Keyboard' is a keyboard sensor
sensor = co.sensors["Keyboard"]
for key,status in sensor.events:
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
# key[0] == bge.events.keycode, key[1] = status
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
if status == bge.logic.KX_INPUT_JUST_ACTIVATED:
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
if key == bge.events.WKEY:
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
# Activate Forward!
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
if key == bge.events.SKEY:
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
# Activate Backward!
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
if key == bge.events.AKEY:
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
# Activate Left!
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
if key == bge.events.DKEY:
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
# Activate Right!
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
.. code-block:: python
# The all keys thing without a keyboard sensor (but you will
# need an always sensor with pulse mode on)
import bge
# Just shortening names here
keyboard = bge.logic.keyboard
JUST_ACTIVATED = bge.logic.KX_INPUT_JUST_ACTIVATED
if keyboard.events[bge.events.WKEY] == JUST_ACTIVATED:
print("Activate Forward!")
if keyboard.events[bge.events.SKEY] == JUST_ACTIVATED:
print("Activate Backward!")
if keyboard.events[bge.events.AKEY] == JUST_ACTIVATED:
print("Activate Left!")
if keyboard.events[bge.events.DKEY] == JUST_ACTIVATED:
print("Activate Right!")
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
*********
Functions
*********
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. function:: EventToString(event)
Return the string name of a key event. Will raise a ValueError error if its invalid.
:arg event: key event from bge.keys or the keyboard sensor.
:type event: int
:rtype: string
.. function:: EventToCharacter(event, shift)
Return the string name of a key event. Returns an empty string if the event cant be represented as a character.
:type event: int
:arg event: key event from :mod:`bge.keys` or the keyboard sensor.
:type shift: bool
:arg shift: set to true if shift is held.
:rtype: string
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
****************
Keys (Constants)
****************
.. _mouse-keys:
==========
Mouse Keys
==========
.. data:: LEFTMOUSE
.. data:: MIDDLEMOUSE
.. data:: RIGHTMOUSE
.. data:: WHEELUPMOUSE
.. data:: WHEELDOWNMOUSE
.. data:: MOUSEX
.. data:: MOUSEY
== python api docs == bge.types --------- - removed lists if they were already available in bge.logic and crosslinked where the list contained description, moved the descriptions in bge.logic so we have useful thing in one place only - fixed a lot of bad formatting, like bad indentation and usage of TAB - changed from literal to codeblocks that smerch for the useful suggestion :) - whered appropriate I've moved code examples to the end, after notes and all it is blocking to have a big black block before actually see a method parameters or return type - have doubt about the list at bge.types.html#bge.types.SCA_MouseSensor.mode possibly tomorrow will ask Dalai bge.logic --------- - added sensor status list - cross linked with bge.types where needed - added a section "ShapeAction Actuator" because in bge.types these constants are docuemented, but in 2.5 I don't see the ShapeAction Actuator (anymore, or for now) I'll ask Dalai tomorrow or when possible (check bge.logic.html#shape-action-actuator once cambo rebuilds the docs) - moved descriptions from bge.types lists to logic page where appropriate - where possible, added custom directive :value: so we have a consistent way to show the value of constants
2010-06-07 23:50:43 +00:00
.. _keyboard-keys:
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
=============
Keyboard Keys
=============
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
-------------
Alphabet keys
-------------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: AKEY
.. data:: BKEY
.. data:: CKEY
.. data:: DKEY
.. data:: EKEY
.. data:: FKEY
.. data:: GKEY
.. data:: HKEY
.. data:: IKEY
.. data:: JKEY
.. data:: KKEY
.. data:: LKEY
.. data:: MKEY
.. data:: NKEY
.. data:: OKEY
.. data:: PKEY
.. data:: QKEY
.. data:: RKEY
.. data:: SKEY
.. data:: TKEY
.. data:: UKEY
.. data:: VKEY
.. data:: WKEY
.. data:: XKEY
.. data:: YKEY
.. data:: ZKEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
-----------
Number keys
-----------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: ZEROKEY
.. data:: ONEKEY
.. data:: TWOKEY
.. data:: THREEKEY
.. data:: FOURKEY
.. data:: FIVEKEY
.. data:: SIXKEY
.. data:: SEVENKEY
.. data:: EIGHTKEY
.. data:: NINEKEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
--------------
Modifiers Keys
--------------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: CAPSLOCKKEY
.. data:: LEFTCTRLKEY
.. data:: LEFTALTKEY
.. data:: RIGHTALTKEY
.. data:: RIGHTCTRLKEY
.. data:: RIGHTSHIFTKEY
.. data:: LEFTSHIFTKEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
----------
Arrow Keys
----------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: LEFTARROWKEY
.. data:: DOWNARROWKEY
.. data:: RIGHTARROWKEY
.. data:: UPARROWKEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
--------------
Numberpad Keys
--------------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: PAD0
.. data:: PAD1
.. data:: PAD2
.. data:: PAD3
.. data:: PAD4
.. data:: PAD5
.. data:: PAD6
.. data:: PAD7
.. data:: PAD8
.. data:: PAD9
.. data:: PADPERIOD
.. data:: PADSLASHKEY
.. data:: PADASTERKEY
.. data:: PADMINUS
.. data:: PADENTER
.. data:: PADPLUSKEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
-------------
Function Keys
-------------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: F1KEY
.. data:: F2KEY
.. data:: F3KEY
.. data:: F4KEY
.. data:: F5KEY
.. data:: F6KEY
.. data:: F7KEY
.. data:: F8KEY
.. data:: F9KEY
.. data:: F10KEY
.. data:: F11KEY
.. data:: F12KEY
.. data:: F13KEY
.. data:: F14KEY
.. data:: F15KEY
.. data:: F16KEY
.. data:: F17KEY
.. data:: F18KEY
.. data:: F19KEY
== python api docs == some more cleanup: - made structure in source/gameengine/PyDoc/bge.events.rst to be able to crosslink properly - cleaned notes and warnings syntax, and also now they are always the last elements after all the other tags - substituted some lists of possible values of a parameter with links to lists of values (not finished) like in bge.types.html#bge.types.SCA_PythonKeyboard - uncertain about some values, like in http://www.blender.org/documentation/250PythonDoc/bge.types.html#bge.types.SCA_ISensor.status (list of KX_SENSOR_INACTIVE,... etc aren't documented or non-existant, will investigate)
2010-06-03 14:26:38 +00:00
----------
Other Keys
----------
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: ACCENTGRAVEKEY
.. data:: BACKSLASHKEY
.. data:: BACKSPACEKEY
.. data:: COMMAKEY
.. data:: DELKEY
.. data:: ENDKEY
.. data:: EQUALKEY
.. data:: ESCKEY
.. data:: HOMEKEY
.. data:: INSERTKEY
.. data:: LEFTBRACKETKEY
.. data:: LINEFEEDKEY
.. data:: MINUSKEY
.. data:: PAGEDOWNKEY
.. data:: PAGEUPKEY
.. data:: PAUSEKEY
.. data:: PERIODKEY
.. data:: QUOTEKEY
.. data:: RIGHTBRACKETKEY
A bit of bge.events work: * A few places in the bge.events docs mentioned bge.keys, when it should have been bge.events * Created two aliases to bge.events.RETKEY: ENTERKEY and RETURNKEY * ENTERKEY and RETURNKEY have been added to the docs and RETKEY marked as deprecated * Added an example of using bge.logic.keyboard to the bge.events docs
2010-10-05 05:44:15 +00:00
.. data:: RETKEY (Deprecated: use bge.events.ENTERKEY or bge.events.RETURNKEY)
.. data:: ENTERKEY
.. data:: RETURNKEY
epydoc to sphinx markup for GameLogic module
2010-05-17 19:52:25 +00:00
.. data:: SEMICOLONKEY
.. data:: SLASHKEY
.. data:: SPACEKEY
.. data:: TABKEY
Copy Permalink