From 00366b5f6d2c3a78e105239fbff54421a3dcdc5d Mon Sep 17 00:00:00 2001 From: MrSimbax Date: Mon, 27 Jul 2015 18:06:20 +0200 Subject: [PATCH] Add FilterX documentation --- help/cbot/E/destroy.txt | 2 +- help/cbot/E/radar.txt | 16 ++++- help/cbot/E/search.txt | 2 +- help/cbot/po/cbot.pot | 133 ++++++++++++++++++++++++++++++---------- help/cbot/po/de.po | 133 ++++++++++++++++++++++++++++++---------- help/cbot/po/fr.po | 133 ++++++++++++++++++++++++++++++---------- help/cbot/po/pl.po | 133 ++++++++++++++++++++++++++++++---------- help/cbot/po/ru.po | 133 ++++++++++++++++++++++++++++++---------- 8 files changed, 516 insertions(+), 169 deletions(-) diff --git a/help/cbot/E/destroy.txt b/help/cbot/E/destroy.txt index 940ca987..88a34c10 100644 --- a/help/cbot/E/destroy.txt +++ b/help/cbot/E/destroy.txt @@ -9,7 +9,7 @@ Destroys an object. \t;Return value: \c;\l;int\u cbot\int;\n; Normally an error stops the program. You can prevent the program from stopping on errors by using the \c;\l;errmode\u cbot\errmode;(0)\n; instruction. A value different from zero if an error occurred is then returned by \c;destroy()\n;. -\c;== 0 \n;The operation of destroying an object was started +\c;== 0 \n;The operation of destroying of an object was started \c;!= 0 \n;The instruction could not be done (e.g. nothing to destroy) \t;See also diff --git a/help/cbot/E/radar.txt b/help/cbot/E/radar.txt index 36900811..68c15b6b 100644 --- a/help/cbot/E/radar.txt +++ b/help/cbot/E/radar.txt @@ -12,7 +12,7 @@ Write in brackets the \l;name of the object\u cbot\category; that you look for. \n; \b;For specialists Syntax: -\s;\c;radar ( cat, angle, focus, min, max, sens );\n; +\s;\c;radar ( cat, angle, focus, min, max, sens, filter );\n; Detects an object according to several parameters. @@ -28,7 +28,7 @@ o \l;Array\u cbot\array; of categories of the objects that should be detected. F \s;bots[2] = WingedGrabber; \s;bots[3] = LeggedGrabber; \s;object nearestGrabber = radar(bots);\n; -o Keyword \const;Any\norm; if you are looking for any object. +o Keyword \const;Any\norm; if you are looking for any object (including even plants and so on). Filters may be useful to use with this keyword. \t;angle: \c;\l;float\u cbot\float;\n; (default value: \c;0\n;) Direction that the radar is facing, in degrees. @@ -48,6 +48,18 @@ Maximum detection distance, in meters. Objects that are farther away than the ma \t;sens: \c;\l;float\u cbot\float;\n; (default value: \c;1\n;) Determines which way the objects are detected. With value \c;1\n;, returns the closest object found in the specified zone. With value \c;-1\n;, the farthest object in the zone will be returned. +\t;filter: \c;\l;int\u cbot\int;\n; (default value: \c;\const;FilterNone\norm;\n;) +Determines which type of objects should be detected. Especially useful in use with an \l;array\u cbot\array; or \const;Any\norm;. The following filters are available: + +\c;\const;FilterNone\norm; \n;Detects everything (default) +\c;\const;FilterOnlyLanding\norm; \n;Detects only objects being on the ground +\c;\const;FilterOnlyFlying\norm; \n;Detects only objects not being on the ground +\c;\const;FilterFriendly\norm; \n;Detects only allies (objects in the same team) +\c;\const;FilterEnemy\norm; \n;Detects only enemies (objects in an other team except neutral) +\c;\const;FilterNeutral\norm; \n;Detects only neutral objects (e.g. resources) + +The last three are mainly useful in \l;code battles\u battles;. + \t;Return value: \c;\l;object\u cbot\object;\n; Returns the first object found that corresponds to the specified category in the specified zone. If no object was found, returns the value \c;\l;null\u cbot\null;\n;. diff --git a/help/cbot/E/search.txt b/help/cbot/E/search.txt index 8d7384f1..184dff22 100644 --- a/help/cbot/E/search.txt +++ b/help/cbot/E/search.txt @@ -14,7 +14,7 @@ o \l;Array\u cbot\array; of categories of the objects that should be detected. F \s;bots[3] = LeggedGrabber; \s;point p(50, 24, 0); \s;object grabberNearestThePoint = search(bots, p);\n; -o Keyword \const;Any\norm; if you are looking for any object. +o Keyword \const;Any\norm; if you are looking for any object (including even plants and so on). \t;position: \c;\l;point\u cbot\point;\n; (default value: \c;\l;this\u cbot\this;.\l;position\u cbot\object;\n;) \c;search\n; returns the object of the given category that is closest to the position indicated here. diff --git a/help/cbot/po/cbot.pot b/help/cbot/po/cbot.pot index 1f620359..f3805508 100644 --- a/help/cbot/po/cbot.pot +++ b/help/cbot/po/cbot.pot @@ -53,13 +53,13 @@ msgid "Time in seconds." msgstr "" #. type: \t; header -#: ../E/abstime.txt:10 ../E/acos.txt:11 ../E/aim.txt:23 ../E/array.txt:30 ../E/asin.txt:11 ../E/atan.txt:11 ../E/atan2.txt:16 ../E/bloc.txt:48 ../E/bool.txt:4 ../E/break.txt:24 ../E/build.txt:27 ../E/buildingenabled.txt:22 ../E/busy.txt:14 ../E/canbuild.txt:22 ../E/canresearch.txt:14 ../E/category.txt:107 ../E/ceil.txt:12 ../E/class.txt:70 ../E/close.txt:6 ../E/cond.txt:27 ../E/continue.txt:24 ../E/cos.txt:11 ../E/deletef.txt:9 ../E/delinfo.txt:13 ../E/destroy.txt:15 ../E/direct.txt:13 ../E/dist.txt:29 ../E/dist2d.txt:13 ../E/do.txt:27 ../E/drop.txt:28 ../E/eof.txt:13 ../E/errmode.txt:32 ../E/expr.txt:74 ../E/extern.txt:29 ../E/factory.txt:21 ../E/false.txt:4 ../E/file.txt:16 ../E/fire.txt:30 ../E/flatgrnd.txt:16 ../E/flatspace.txt:25 ../E/float.txt:24 ../E/floor.txt:12 ../E/for.txt:38 ../E/function.txt:129 ../E/goto.txt:34 ../E/grab.txt:28 ../E/if.txt:39 ../E/int.txt:18 ../E/jet.txt:14 ../E/message.txt:24 ../E/motor.txt:38 ../E/move.txt:21 ../E/nan.txt:14 ../E/new.txt:20 ../E/null.txt:4 ../E/object.txt:79 ../E/open.txt:18 ../E/openfile.txt:10 ../E/pencolor.txt:14 ../E/pendown.txt:17 ../E/penup.txt:11 ../E/penwidth.txt:14 ../E/point.txt:35 ../E/pointer.txt:51 ../E/pow.txt:14 ../E/private.txt:17 ../E/public.txt:49 ../E/radar.txt:66 ../E/rand.txt:8 ../E/readln.txt:18 ../E/receive.txt:16 ../E/recycle.txt:12 ../E/research.txt:18 ../E/researched.txt:14 ../E/researches.txt:27 ../E/retobj.txt:13 ../E/return.txt:29 ../E/round.txt:12 ../E/search.txt:25 ../E/send.txt:17 ../E/shield.txt:18 ../E/sin.txt:11 ../E/sizeof.txt:21 ../E/sniff.txt:16 ../E/space.txt:22 ../E/sqrt.txt:11 ../E/static.txt:20 ../E/strfind.txt:18 ../E/string.txt:32 ../E/strleft.txt:14 ../E/strlen.txt:12 ../E/strlower.txt:10 ../E/strmid.txt:18 ../E/strright.txt:14 ../E/strupper.txt:10 ../E/strval.txt:17 ../E/synchro.txt:23 ../E/takeoff.txt:15 ../E/tan.txt:11 ../E/term.txt:30 ../E/testinfo.txt:16 ../E/this.txt:52 ../E/thump.txt:12 ../E/topo.txt:13 ../E/true.txt:4 ../E/trunc.txt:12 ../E/turn.txt:32 ../E/type.txt:32 ../E/var.txt:66 ../E/void.txt:10 ../E/wait.txt:21 ../E/while.txt:46 ../E/writeln.txt:19 +#: ../E/abstime.txt:10 ../E/acos.txt:11 ../E/aim.txt:23 ../E/array.txt:30 ../E/asin.txt:11 ../E/atan.txt:11 ../E/atan2.txt:16 ../E/bloc.txt:48 ../E/bool.txt:4 ../E/break.txt:24 ../E/build.txt:27 ../E/buildingenabled.txt:22 ../E/busy.txt:14 ../E/canbuild.txt:22 ../E/canresearch.txt:14 ../E/category.txt:107 ../E/ceil.txt:12 ../E/class.txt:70 ../E/close.txt:6 ../E/cond.txt:27 ../E/continue.txt:24 ../E/cos.txt:11 ../E/deletef.txt:9 ../E/delinfo.txt:13 ../E/destroy.txt:15 ../E/direct.txt:13 ../E/dist.txt:29 ../E/dist2d.txt:13 ../E/do.txt:27 ../E/drop.txt:28 ../E/eof.txt:13 ../E/errmode.txt:32 ../E/expr.txt:74 ../E/extern.txt:29 ../E/factory.txt:21 ../E/false.txt:4 ../E/file.txt:16 ../E/fire.txt:30 ../E/flatgrnd.txt:16 ../E/flatspace.txt:25 ../E/float.txt:24 ../E/floor.txt:12 ../E/for.txt:38 ../E/function.txt:129 ../E/goto.txt:34 ../E/grab.txt:28 ../E/if.txt:39 ../E/int.txt:18 ../E/jet.txt:14 ../E/message.txt:24 ../E/motor.txt:38 ../E/move.txt:21 ../E/nan.txt:14 ../E/new.txt:20 ../E/null.txt:4 ../E/object.txt:79 ../E/open.txt:18 ../E/openfile.txt:10 ../E/pencolor.txt:14 ../E/pendown.txt:17 ../E/penup.txt:11 ../E/penwidth.txt:14 ../E/point.txt:35 ../E/pointer.txt:51 ../E/pow.txt:14 ../E/private.txt:17 ../E/public.txt:49 ../E/radar.txt:78 ../E/rand.txt:8 ../E/readln.txt:18 ../E/receive.txt:16 ../E/recycle.txt:12 ../E/research.txt:18 ../E/researched.txt:14 ../E/researches.txt:27 ../E/retobj.txt:13 ../E/return.txt:29 ../E/round.txt:12 ../E/search.txt:25 ../E/send.txt:17 ../E/shield.txt:18 ../E/sin.txt:11 ../E/sizeof.txt:21 ../E/sniff.txt:16 ../E/space.txt:22 ../E/sqrt.txt:11 ../E/static.txt:20 ../E/strfind.txt:18 ../E/string.txt:32 ../E/strleft.txt:14 ../E/strlen.txt:12 ../E/strlower.txt:10 ../E/strmid.txt:18 ../E/strright.txt:14 ../E/strupper.txt:10 ../E/strval.txt:17 ../E/synchro.txt:23 ../E/takeoff.txt:15 ../E/tan.txt:11 ../E/term.txt:30 ../E/testinfo.txt:16 ../E/this.txt:52 ../E/thump.txt:12 ../E/topo.txt:13 ../E/true.txt:4 ../E/trunc.txt:12 ../E/turn.txt:32 ../E/type.txt:32 ../E/var.txt:66 ../E/void.txt:10 ../E/wait.txt:21 ../E/while.txt:46 ../E/writeln.txt:19 #, no-wrap msgid "See also" msgstr "" #. type: Plain text -#: ../E/abstime.txt:11 ../E/aim.txt:24 ../E/array.txt:31 ../E/bool.txt:5 ../E/break.txt:25 ../E/busy.txt:15 ../E/cond.txt:28 ../E/continue.txt:25 ../E/deletef.txt:10 ../E/destroy.txt:16 ../E/direct.txt:14 ../E/dist.txt:30 ../E/dist2d.txt:14 ../E/drop.txt:29 ../E/errmode.txt:33 ../E/expr.txt:75 ../E/extern.txt:30 ../E/false.txt:5 ../E/fire.txt:31 ../E/flatgrnd.txt:17 ../E/flatspace.txt:26 ../E/float.txt:25 ../E/for.txt:39 ../E/function.txt:130 ../E/goto.txt:35 ../E/grab.txt:29 ../E/if.txt:40 ../E/int.txt:19 ../E/jet.txt:15 ../E/message.txt:25 ../E/move.txt:22 ../E/nan.txt:15 ../E/object.txt:80 ../E/openfile.txt:11 ../E/pencolor.txt:15 ../E/pendown.txt:18 ../E/penup.txt:12 ../E/penwidth.txt:15 ../E/point.txt:36 ../E/radar.txt:67 ../E/recycle.txt:13 ../E/retobj.txt:14 ../E/return.txt:30 ../E/search.txt:26 ../E/shield.txt:19 ../E/sizeof.txt:22 ../E/sniff.txt:17 ../E/space.txt:23 ../E/string.txt:33 ../E/takeoff.txt:16 ../E/term.txt:31 ../E/thump.txt:13 ../E/topo.txt:14 ../E/true.txt:5 ../E/turn.txt:33 ../E/type.txt:33 ../E/var.txt:67 ../E/void.txt:11 ../E/wait.txt:22 +#: ../E/abstime.txt:11 ../E/aim.txt:24 ../E/array.txt:31 ../E/bool.txt:5 ../E/break.txt:25 ../E/busy.txt:15 ../E/cond.txt:28 ../E/continue.txt:25 ../E/deletef.txt:10 ../E/destroy.txt:16 ../E/direct.txt:14 ../E/dist.txt:30 ../E/dist2d.txt:14 ../E/drop.txt:29 ../E/errmode.txt:33 ../E/expr.txt:75 ../E/extern.txt:30 ../E/false.txt:5 ../E/fire.txt:31 ../E/flatgrnd.txt:17 ../E/flatspace.txt:26 ../E/float.txt:25 ../E/for.txt:39 ../E/function.txt:130 ../E/goto.txt:35 ../E/grab.txt:29 ../E/if.txt:40 ../E/int.txt:19 ../E/jet.txt:15 ../E/message.txt:25 ../E/move.txt:22 ../E/nan.txt:15 ../E/object.txt:80 ../E/openfile.txt:11 ../E/pencolor.txt:15 ../E/pendown.txt:18 ../E/penup.txt:12 ../E/penwidth.txt:15 ../E/point.txt:36 ../E/radar.txt:79 ../E/recycle.txt:13 ../E/retobj.txt:14 ../E/return.txt:30 ../E/search.txt:26 ../E/shield.txt:19 ../E/sizeof.txt:22 ../E/sniff.txt:17 ../E/space.txt:23 ../E/string.txt:33 ../E/takeoff.txt:16 ../E/term.txt:31 ../E/thump.txt:13 ../E/topo.txt:14 ../E/true.txt:5 ../E/turn.txt:33 ../E/type.txt:33 ../E/var.txt:67 ../E/void.txt:11 ../E/wait.txt:22 #, no-wrap msgid "Programming, types and categories." msgstr "" @@ -3141,31 +3141,31 @@ msgid "Determines which way the objects are detected. With value 1, msgstr "" #. type: \t; header -#: ../E/radar.txt:51 ../E/retobj.txt:10 ../E/search.txt:22 +#: ../E/radar.txt:63 ../E/retobj.txt:10 ../E/search.txt:22 #, no-wrap msgid "Return value: object" msgstr "" #. type: Plain text -#: ../E/radar.txt:52 +#: ../E/radar.txt:64 #, no-wrap msgid "Returns the first object found that corresponds to the specified category in the specified zone. If no object was found, returns the value null." msgstr "" #. type: \t; header -#: ../E/cond.txt:21 ../E/radar.txt:54 +#: ../E/cond.txt:21 ../E/radar.txt:66 #, no-wrap msgid "Remark" msgstr "" #. type: Plain text -#: ../E/radar.txt:55 +#: ../E/radar.txt:67 #, no-wrap msgid "You do not have to give all the parameters. Here are two examples of instructions that are equivalent: " msgstr "" #. type: Source code -#: ../E/radar.txt:57 +#: ../E/radar.txt:69 #, no-wrap msgid "" "\tradar(Titanium, 0, 360, 0, 1000);\n" @@ -3173,7 +3173,7 @@ msgid "" msgstr "" #. type: Source code -#: ../E/radar.txt:60 +#: ../E/radar.txt:72 #, no-wrap msgid "" "\tradar(Titanium, 0, 90, 0, 1000);\n" @@ -3181,7 +3181,7 @@ msgid "" msgstr "" #. type: Plain text -#: ../E/radar.txt:63 +#: ../E/radar.txt:75 #, no-wrap msgid "" "When one or more parameters are not specified, the default values indicated above are used instead; only the first parameter is compulsory.\n" @@ -6690,12 +6690,6 @@ msgid "" "object nearestGrabber = radar(bots);" msgstr "" -#. type: Bullet: 'o' -#: ../E/radar.txt:31 ../E/search.txt:17 -#, no-wrap -msgid "Keyword Any if you are looking for any object." -msgstr "" - #. type: \t; header #: ../E/radar.txt:33 #, no-wrap @@ -6756,12 +6750,6 @@ msgstr "" msgid "position: point (default value: this.position)" msgstr "" -#. type: Source code -#: ../E/radar.txt:15 -#, no-wrap -msgid "radar ( cat, angle, focus, min, max, sens );" -msgstr "" - #. type: \t; header #: ../E/radar.txt:45 #, no-wrap @@ -6792,15 +6780,6 @@ msgstr "" msgid "Destroyer." msgstr "" -#. type: Plain text -#: ../E/destroy.txt:11 -#, no-wrap -msgid "" -"Normally an error stops the program. You can prevent the program from stopping on errors by using the errmode(0) instruction. A value different from zero if an error occurred is then returned by destroy().\n" -"== 0 The operation of destroying an object was started\n" -"!= 0 The instruction could not be done (e.g. nothing to destroy)" -msgstr "" - #. type: Plain text #: ../E/category.txt:10 #, no-wrap @@ -6826,6 +6805,97 @@ msgid "" " AlienNest Alien Nest" msgstr "" +#. type: Plain text +#: ../E/destroy.txt:11 +#, no-wrap +msgid "" +"Normally an error stops the program. You can prevent the program from stopping on errors by using the errmode(0) instruction. A value different from zero if an error occurred is then returned by destroy().\n" +"== 0 The operation of destroying of an object was started\n" +"!= 0 The instruction could not be done (e.g. nothing to destroy)" +msgstr "" + +#. type: Bullet: 'o' +#: ../E/search.txt:17 +#, no-wrap +msgid "Keyword Any if you are looking for any object (including even plants and so on)." +msgstr "" + +#. type: Source code +#: ../E/radar.txt:15 +#, no-wrap +msgid "radar ( cat, angle, focus, min, max, sens, filter );" +msgstr "" + +#. type: Bullet: 'o' +#: ../E/radar.txt:31 +#, no-wrap +msgid "Keyword Any if you are looking for any object (including even plants and so on). Filters may be useful to use with this keyword." +msgstr "" + +#. type: \t; header +#: ../E/radar.txt:51 +#, no-wrap +msgid "filter: int (default value: FilterNone)" +msgstr "" + +#. type: Plain text +#: ../E/radar.txt:52 +#, no-wrap +msgid "Determines which type of objects should be detected. Especially useful in use with an array or Any. The following filters are available:" +msgstr "" + +#. type: Plain text +#: ../E/radar.txt:61 +#, no-wrap +msgid "The last three are mainly useful in code battles." +msgstr "" + +#. type: Plain text +#: ../E/radar.txt:54 +#, no-wrap +msgid "" +"FilterNone Detects everything (default)\n" +"FilterOnlyLanding Detects only objects being on the ground\n" +"FilterOnlyFlying Detects only objects not being on the ground\n" +"FilterFriendly Detects only allies (objects in the same team)\n" +"FilterEnemy Detects only enemies (objects in an other team except neutral)\n" +"FilterNeutral Detects only neutral objects (e.g. resources)" +msgstr "" + +#~ msgid "" +#~ "FilterNone Detects everything (default).\n" +#~ "FilterOnlyLanding Detects only objects being on the ground\n" +#~ "FilterOnlyFlying Detects only objects not being on the ground\n" +#~ "FilterFriendly Detects only allies (objects in the same team).\n" +#~ "FilterEnemy Detects only enemies (objects in an other team except neutral).\n" +#~ "FilterNeutral Detects only neutral objects (e.g. resources)." +#~ msgstr "" + +#~ msgid "Determines which type of objects should be detected. Especially useful in use with an array or \\constAny. The following filters are available:" +#~ msgstr "" + +#~ msgid "" +#~ "FilterNone Detects everything (default).\n" +#~ "FilterOnlyLanding Detects only objects being on the ground\n" +#~ "FilterOnlyFlying Detects only objects not being on the ground\n" +#~ "FilterFriendly Detects only allies (objects in the same team).\n" +#~ "FilterEnemy Detects only enemies (objects in an other team except neutral).\n" +#~ "FilterNeutral Detects only neutral objects (e.g. resources).\n" +#~ "The last three are mainly useful in code battles." +#~ msgstr "" + +#~ msgid "Keyword Any if you are looking for any object." +#~ msgstr "" + +#~ msgid "radar ( cat, angle, focus, min, max, sens );" +#~ msgstr "" + +#~ msgid "" +#~ "Normally an error stops the program. You can prevent the program from stopping on errors by using the errmode(0) instruction. A value different from zero if an error occurred is then returned by destroy().\n" +#~ "== 0 The operation of destroying an object was started\n" +#~ "!= 0 The instruction could not be done (e.g. nothing to destroy)" +#~ msgstr "" + #~ msgid "" #~ "