Yamyam: 1版をインポートしました

2018-06-28T18:37:24Z

1版をインポートしました

wiki>Brita: moved Dev:Source/GameEngine/Python API Clean Up to Dev:Source/GameEngine/2.49/Python API Clean Up

2014-08-07T14:02:53Z

moved Dev:Source/GameEngine/Python API Clean Up to Dev:Source/GameEngine/2.49/Python API Clean Up

新規ページ

= Introduction =
<div id="Introduction">
ben2610, cyborg_ar and Moguri are working on cleaning up the BGE Python API, the following are some changes they are working on.
</div>
= Goals =
<div id="Goals">
*[[#get_set|Create properties to replace most of the get/set functions.]]
*[[#Expose_more_properties|Expose more logic brick properties to Python.]]
*[[#Qualtity_and_readability|Improve the quality and readability of the code.]]
*[[#Clean_up_remaining_Python_functions.|Clean up remaining Python functions.]]
</div>
== Use properties instead of get/set functions for the bricks' settings ==
<div id="get_set">
Take for example, the setDLoc() method of the motion actuator. All this does is change a property of the logic brick, so instead it should simply be a property, dLoc.

Now, to copy a setting from one actuator to another, instead of:

<source lang="python">
motion.setDLoc(motion2.getDLoc()[:2],motion2.getDLoc()[3])
</source>

you simply have to use:

<source lang="python">
motion.dLoc = motion2.dLoc
</source>

This is much cleaner and easier to understand.

Functions that represent actions for example "instantAddObject()" will be left as such. Some functions for getting read-only data (like getEventList()) will probably be left too.
</div>
== Expose more logic brick properties to Python ==
<div id="Expose_more_properties">
There are a lot of properties that were never exposed. For example, ISensor now has usePosPulseMode, useNegPulseMode, frequency, level, and invert.
</div>
== Improve the quality and readability of the code ==
<div id="Qualtity_and_readability">
Currently the code is unorganized and can be hard to sift through. Almost every file uses its own rules for organization (or none at all). We are working on making sure each file uses a similar format, and adding comments to make things easier to find.

We are also working to change stuff like [http://pasteall.org/3341/cpp this] (yes, that's real code), to more proper code like [http://pasteall.org/3342/cpp this].
</div>
== Clean up remaining Python functions ==
<div id="Clean_up_remaining_Python_functions">
Not all functions will be replaced by properties. We will look at the remaining ones to make sure they are written well, such as using PyList when needed.
</div>

= Progress =
<div id="Progress">
Here are a couple of tables showing our progress so far. Right now it only lists sensors and actuators found in source\gameengine\GameLogic and Ketsji. KX_GameObject is also being cleaned up, but it isn't in one of the tables since it isn't a sensor or actuator.

Finished also means the brick's PyDoc has been updated.

Note: Ben implemented a new property framework for us to use. This makes updating the API a lot easier. However, we have to go through and re-update the ones we've done ;)

<br>

{|{{Css/prettytable|75%}}
|+ Progress so Far (Sensors)
|-
| width="150" align="center" | In Progress
| width="150" align="center" | Finished
| width="150" align="center" | Left To Do
|- valign="top"
|
*Near
*Radar
*Delay
*Actuator
*ISensor
*ILogic_Brick
*Mouse

|
*Always
*Keyboard
*Joystick
*Collision/Touch<br>

|
*Property
*Random

|}

<br>

{|{{Css/prettytable|75%}}
|+ Progress so Far (Actuators)
|-
| width="150" align="center" | In Progress
| width="150" align="center" | Done
| width="150" align="center" | Left
|- valign="top"
|
*None

|
*Action

|
*2D Filter
*Scene
*Property
*Random

|}
</div>

= Backwards Compatibility =

== What about my old code? ==

Code written for 2.48 should still be usable. We are keeping the old functions around for few a little bit (see [[#Timeline|Timeline]]), but they will be marked as deprecated. Using these functions will output a warning in the console. To disable the warnings, choose Game > Ignore Deprecation Warnings.

Blender 2.49 ships with a utility that updates old scripts to use the new API: in the text editor, choose Text > Text plugins > Convert BGE 2.49. The utility can introduce errors in some circumstances, so be sure to keep a backup and carefully review the changes that are made.

= Timeline =

== 2.49 ==

By 2.49 we hope to have the properties ready to go and include the deprecated methods. 2.49 will also include the cleaned up methods. Since 2.49 will support previous code, and code that will work in 2.50, 2.49 will act as a transition between 2.48 and 2.50.

== 2.50 ==

For 2.50 we plan to remove all the deprecated functions. This will break old scripts that have not been adapted to the new API. Scripts that run in 2.49 without deprecation warnings will be able to run fine in 2.50.

[[Category:Script]]

← 古い版	2018年6月28日 (木) 18:37時点における版
(相違点なし)

Dev:Source/GameEngine/2.49/Python API Clean Up - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Brita: moved Dev:Source/GameEngine/Python API Clean Up to Dev:Source/GameEngine/2.49/Python API Clean Up

Yamyam: 1版をインポートしました