Ignore:
Timestamp:
03/05/22 03:06:47 (3 years ago)
Author:
sz
Message:

updated for Framsticks version 5.0rc20

File:
1 edited

Legend:

Unmodified
Added
Removed

  • java/Framclipse/com.framsticks.framclipse/res/framscript.xml

    r1110 r1171  
    182182                        <description><![CDATA["Lifespan" is the period during simulation of a creature when its performance measurement is enabled.]]></description>
    183183                </element>
    184                 <element name="distance" type="float"/>
    185                 <element name="c_velocity" type="float"/>
    186                 <element name="c_vertvelocity" type="float"/>
    187                 <element name="c_vertpos" type="float"/>
    188                 <element name="velocity" type="float"/>
    189                 <element name="vertpos" type="float"/>
    190                 <element name="vertvel" type="float"/>
     184                <element name="distance" type="float">
     185                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     186                </element>
     187                <element name="c_velocity" type="float">
     188                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     189                </element>
     190                <element name="c_vertvelocity" type="float">
     191                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     192                </element>
     193                <element name="c_vertpos" type="float">
     194                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     195                </element>
     196                <element name="velocity" type="float">
     197                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     198                </element>
     199                <element name="vertpos" type="float">
     200                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     201                </element>
     202                <element name="vertvel" type="float">
     203                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     204                </element>
    191205                <element name="pos_x" type="float" deprecated="true" flags="8195">
    192206                        <description><![CDATA[(pos_x,pos_y,pos_z) is the point of minimal coordinates ("bottom left corner") of the creature, including imaginary Part sizes (Part.s, usually 1.0). See also: Creature.moveAbs]]></description>
    … …  
    227241                </element>
    228242                <element name="centerOfGravity" type="XYZ" flags="3">
    229                         <description><![CDATA[Only updated once every 'perfperiod' steps!]]></description>
     243                        <description><![CDATA[Only updated once every 'perfperiod' steps! See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
    230244                </element>
    231245                <element name="numparts" type="integer" flags="3"/>
    … …  
    564578                        <description><![CDATA["Lifespan" is the period during simulation of a creature when its performance measurement is enabled.]]></description>
    565579                </element>
    566                 <element name="distance" type="float"/>
    567                 <element name="c_velocity" type="float"/>
    568                 <element name="c_vertvelocity" type="float"/>
    569                 <element name="c_vertpos" type="float"/>
    570                 <element name="velocity" type="float"/>
    571                 <element name="vertpos" type="float"/>
    572                 <element name="vertvel" type="float"/>
     580                <element name="distance" type="float">
     581                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     582                </element>
     583                <element name="c_velocity" type="float">
     584                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     585                </element>
     586                <element name="c_vertvelocity" type="float">
     587                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     588                </element>
     589                <element name="c_vertpos" type="float">
     590                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     591                </element>
     592                <element name="velocity" type="float">
     593                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     594                </element>
     595                <element name="vertpos" type="float">
     596                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     597                </element>
     598                <element name="vertvel" type="float">
     599                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     600                </element>
    573601                <element name="center_x" type="float" deprecated="true" flags="8192">
    574602                        <description><![CDATA[Center of gravity]]></description>
    … …  
    624652                        </arguments>
    625653                </element>
    626                 <element name="get" function="true" type="untyped" flags="256">
     654                <element name="get" function="true" type="untyped" flags="257">
    627655                        <description><![CDATA[Retrieves the named or indexed element (depending on the argument type: string or int). Accessing nonexistent keys is an error (use hasKey() if necessary).
    628656object.get(key) can be shortened to object[key].]]></description>
    … …  
    631659                        </arguments>
    632660                </element>
    633                 <element name="getKey" function="true" type="string" flags="256">
     661                <element name="getKey" function="true" type="string" flags="257">
    634662                        <description><![CDATA[Returns the key of the indexed element (0 <= index < size).]]></description>
    635663                        <arguments>
    … …  
    637665                        </arguments>
    638666                </element>
    639                 <element name="hasKey" function="true" type="integer" flags="256">
     667                <element name="hasKey" function="true" type="integer" flags="257">
    640668                        <description><![CDATA[Returns 1 (interpreted as true) if dictionary contains the supplied key, or 0 (false) otherwise.
    641669Example:
    … …  
    658686                        </arguments>
    659687                </element>
    660                 <element name="find" function="true" type="untyped" flags="256">
     688                <element name="find" function="true" type="untyped" flags="257">
    661689                        <description><![CDATA[Returns the element key or null if not found.]]></description>
    662690                        <arguments>
    … …  
    668696<arguments/></element>
    669697                <element name="toString" type="string" flags="257"/>
    670                 <element name="clone" function="true" type="Dictionary" flags="256">
     698                <element name="clone" function="true" type="Dictionary" flags="257">
    671699                        <description><![CDATA[The resulting clone is a shallow copy (contains the same object references as the original). A deep copy can be obtained through serialization: String.deserialize(String.serialize(object));]]></description>
    672700<arguments/></element>
    … …  
    873901                        <description><![CDATA[A sum of Genotype.instances values of all Genotypes in this gene pool.]]></description>
    874902                </element>
    875                 <element name="totalpop" type="integer" deprecated="true" flags="8195">
     903                <element name="totalpop" type="integer" deprecated="true" flags="8227">
    876904                        <description><![CDATA[Please use 'genotype_instances' instead of this field.]]></description>
    877905                </element>
    878906                <element name="fitness" type="string">
    879                         <description><![CDATA[(intended for advanced users)]]></description>
     907                        <description><![CDATA[(For advanced users)]]></description>
     908                </element>
     909                <element name="fitness_is_valid" type="integer" min="0" max="1" flags="35">
     910                        <description><![CDATA[(valid means can be compiled)]]></description>
     911                </element>
     912                <element name="fitness_step_limit" type="integer" min="0" max="1000000000" default="0">
     913                        <description><![CDATA[(For advanced users)]]></description>
     914                </element>
     915                <element name="fitness_time_limit" type="float" min="0" max="1e+09" default="0.0">
     916                        <description><![CDATA[(For advanced users)]]></description>
     917                </element>
     918                <element name="fitness_allowed_objs" type="string">
     919                        <description><![CDATA[Comma-separated names of object classes allowed in the fitness formula.]]></description>
    880920                </element>
    881921                <element name="fitfun" type="integer" min="0" max="1" default="0">
    … …  
    17801820Thus, if both parents have the same number of neurons, then this will be preserved in their children.]]></description>
    17811821                </element>
    1782                 <element name="f1_smX" type="float" min="0" max="100" default="0.05"/>
    1783                 <element name="f1_smJunct" type="float" min="0" max="100" default="0.02"/>
    1784                 <element name="f1_smComma" type="float" min="0" max="100" default="0.02"/>
    1785                 <element name="f1_smModif" type="float" min="0" max="100" default="0.1">
     1822                <element name="f1_smX" type="float" min="0" max="100" default="2.0"/>
     1823                <element name="f1_smJunct" type="float" min="0" max="100" default="2.0"/>
     1824                <element name="f1_smComma" type="float" min="0" max="100" default="0.5"/>
     1825                <element name="f1_smModif" type="float" min="0" max="100" default="2.5">
    17861826                        <description><![CDATA[Modifiers: LlRrCcQqFfMmIiEeWwAaSsDdGgBb]]></description>
    17871827                </element>
    … …  
    17901830(all: LlRrCcQqFfMmIiEeWwAaSsDdGgBb)]]></description>
    17911831                </element>
    1792                 <element name="f1_nmNeu" type="float" min="0" max="100" default="0.05">
     1832                <element name="f1_nmNeu" type="float" min="0" max="100" default="2.0">
    17931833                        <description><![CDATA[Adds a (connected) neuron or removes a neuron]]></description>
    17941834                </element>
    1795                 <element name="f1_nmConn" type="float" min="0" max="100" default="0.1">
    1796                         <description><![CDATA[]]></description>
    1797                 </element>
    1798                 <element name="f1_nmProp" type="float" min="0" max="100" default="0.1">
     1835                <element name="f1_nmConn" type="float" min="0" max="100" default="1.5">
     1836                        <description><![CDATA[]]></description>
     1837                </element>
     1838                <element name="f1_nmProp" type="float" min="0" max="100" default="1.0">
    17991839                        <description><![CDATA[]]></description>
    18001840                </element>
    18011841                <element name="f1_nmWei" type="float" min="0" max="100" default="1.0"/>
    1802                 <element name="f1_nmVal" type="float" min="0" max="100" default="0.05"/>
     1842                <element name="f1_nmVal" type="float" min="0" max="100" default="1.5"/>
    18031843                <element name="f2_mutAddOper" type="float" min="0" max="1" default="0.4">
    18041844                        <description><![CDATA[]]></description>
    … …  
    19221962                        <description><![CDATA[mutation: probability of deleting a production]]></description>
    19231963                </element>
    1924                 <element name="f9_mut" type="float" min="0" max="1" default="0.1">
    1925                         <description><![CDATA[How many genes should be mutated during single mutation (1=all genes, 0.1=ten percent)]]></description>
     1964                <element name="f9_mut" type="float" min="0" max="1" default="0.0">
     1965                        <description><![CDATA[How many genes should be mutated during a single mutation (1=all genes, 0.1=ten percent, 0=one gene)]]></description>
    19261966                </element>
    19271967                <element name="fF_xover" type="float" min="0.5" max="1" default="0.5">
    … …  
    19842024                </element>
    19852025                <element name="fH_mut_add_connection" type="float" min="0" max="1" default="0.33">
    1986                         <description><![CDATA[Probability of adding new connection handle]]></description>
     2026                        <description><![CDATA[Probability of adding new neuron connection handle]]></description>
    19872027                </element>
    19882028                <element name="fH_mut_deletion" type="float" min="0" max="1" default="0.1">
    … …  
    21732213-1 = validity is not known. This is a transient state. The value of "is_valid" will never be -1 when read. It is safe to treat is_valid as boolean in statements like "if (g.is_valid) ...". Setting "is_valid=-1" will make it 0 or 1 again. This third state (-1) is only needed for loading Genotype objects from files where the "is_valid" field might not be present.]]></description>
    21742214                </element>
    2175                 <element name="getConverted" function="true" type="Geno" flags="256">
     2215                <element name="getConverted" function="true" type="Geno" flags="257">
    21762216                        <arguments>
    21772217                                <argument name="format" type="string"/>
    21782218                        </arguments>
    21792219                </element>
    2180                 <element name="getConvertedWithCheckpoints" function="true" type="Geno" flags="256">
     2220                <element name="getConvertedWithCheckpoints" function="true" type="Geno" flags="257">
    21812221                        <description><![CDATA[See also Model.newWithCheckpoints()]]></description>
    21822222                        <arguments>
    … …  
    22612301                </element>
    22622302                <element name="lifespan" type="float">
    2263                         <description><![CDATA[Average life span]]></description>
     2303                        <description><![CDATA[See Creature.lifespan]]></description>
    22642304                </element>
    22652305                <element name="velocity" type="float">
    2266                         <description><![CDATA[Average velocity]]></description>
    2267                 </element>
    2268                 <element name="distance" type="float"/>
    2269                 <element name="vertvel" type="float"/>
    2270                 <element name="vertpos" type="float"/>
     2306                        <description><![CDATA[See Creature.velocity]]></description>
     2307                </element>
     2308                <element name="distance" type="float">
     2309                        <description><![CDATA[See Creature.distance]]></description>
     2310                </element>
     2311                <element name="vertvel" type="float">
     2312                        <description><![CDATA[See Creature.vertvel]]></description>
     2313                </element>
     2314                <element name="vertpos" type="float">
     2315                        <description><![CDATA[See Creature.vertpos]]></description>
     2316                </element>
    22712317                <element name="fit" type="float" flags="3"/>
    22722318                <element name="fit2" type="float" flags="3">
    … …  
    22902336-1 = validity is not known. This is a transient state. The value of "is_valid" will never be -1 when read. It is safe to treat is_valid as boolean in statements like "if (g.is_valid) ...". Setting "is_valid=-1" will make it 0 or 1 again. This third state (-1) is only needed for loading Genotype objects from files where the "is_valid" field might not be present.]]></description>
    22912337                </element>
    2292                 <element name="getNormalized" function="true" type="float" flags="32">
     2338                <element name="getNormalized" function="true" type="float" flags="33">
    22932339                        <arguments>
    22942340                                <argument name="property name or index" type="untyped"/>
    … …  
    23022348See also: num]]></description>
    23032349                </element>
    2304                 <element name="getModel" function="true" type="Model" flags="32"><arguments/></element>
     2350                <element name="getModel" function="true" type="Model" flags="33"><arguments/></element>
    23052351                <element name="splitInstances" function="true" type="void" flags="32"><arguments/></element>
    23062352                <element name="newFromString" function="true" type="Genotype" flags="32">
    … …  
    23312377                        </arguments>
    23322378                </element>
    2333                 <element name="clone" function="true" type="Genotype" flags="32">
     2379                <element name="clone" function="true" type="Genotype" flags="33">
    23342380                        <description><![CDATA[Returns a duplicated genotype, not attached to any gene pool. All genotype fields are copied including 'data' (for which Dictionary.clone() produces a shallow copy).]]></description>
    23352381<arguments/></element>
    … …  
    24542500                                <argument name="function name or index" type="untyped"/>
    24552501                                <argument name="arguments" type="Vector"/>
     2502                        </arguments>
     2503                </element>
     2504                <element name="readonly" type="integer" min="0" max="1" flags="257"/>
     2505                <element name="isReadonly" function="true" type="integer">
     2506                        <arguments>
     2507                                <argument type="Object"/>
     2508                        </arguments>
     2509                </element>
     2510                <element name="makeReadonly" function="true" type="Object">
     2511                        <arguments>
     2512                                <argument type="Object"/>
    24562513                        </arguments>
    24572514                </element>
    … …  
    24822539                <element name="i" type="string"/>
    24832540                <element name="Vstyle" type="string" default="joint"/>
    2484                 <element name="vr" type="float" min="0" max="1" default="1.0"/>
    2485                 <element name="vg" type="float" min="0" max="1" default="1.0" flags="1024"/>
    2486                 <element name="vb" type="float" min="0" max="1" default="1.0" flags="1024"/>
     2541                <element name="vr" type="float" min="0" max="1" default="0.5"/>
     2542                <element name="vg" type="float" min="0" max="1" default="0.5" flags="1024"/>
     2543                <element name="vb" type="float" min="0" max="1" default="0.5" flags="1024"/>
    24872544        </type>
    24882545        <type name="Loader" context="Global context">
    … …  
    26782735                <element name="z" type="float"/>
    26792736                <element name="pos" type="XYZ" flags="1"/>
    2680                 <element name="m" type="float"/>
     2737                <element name="m" type="float">
     2738                        <description><![CDATA[The mass of a MechPart is the same as the mass of its corresponding Part and cannot be changed. For f0, the mass of each Part is calculated as the number of its incident Joints. For f0s, the mass of each Part is calculated internally as its density*volume.]]></description>
     2739                </element>
    26812740                <element name="s" type="float"/>
    26822741                <element name="vol" type="float"/>
    … …  
    27432802                <element name="numneurons" type="integer" flags="259"/>
    27442803                <element name="numconnections" type="integer" flags="259"/>
    2745                 <element name="getPart" function="true" type="Part" flags="288">
     2804                <element name="getPart" function="true" type="Part" flags="289">
    27462805                        <arguments>
    27472806                                <argument name="index" type="integer"/>
    27482807                        </arguments>
    27492808                </element>
    2750                 <element name="getJoint" function="true" type="Joint" flags="288">
     2809                <element name="getJoint" function="true" type="Joint" flags="289">
    27512810                        <arguments>
    27522811                                <argument name="index" type="integer"/>
    27532812                        </arguments>
    27542813                </element>
    2755                 <element name="getNeuroDef" function="true" type="NeuroDef" flags="288">
     2814                <element name="getNeuroDef" function="true" type="NeuroDef" flags="289">
    27562815                        <arguments>
    27572816                                <argument name="index" type="integer"/>
    … …  
    27702829                <element name="bboxSize" type="XYZ" flags="257"/>
    27712830                <element name="numcheckpoints" type="integer" flags="259"/>
    2772                 <element name="getCheckpoint" function="true" type="Model" flags="288">
     2831                <element name="getCheckpoint" function="true" type="Model" flags="289">
    27732832                        <description><![CDATA[Checkpoint Model objects are only valid as long as the parent Model object exists.
    27742833See also: Model.newWithCheckpoints()
    … …  
    27992858var mg=ModelGeometry.forModel(GenePools[0][0].getModel()); mg.geom_density=2; GenePools[0][0].data->area=mg.area();
    28002859]]></description>
    2801                 <element name="geom_density" type="float" min="0.01" max="100" default="1.0">
    2802                         <description><![CDATA[Affects the geometry calculation precision]]></description>
     2860                <element name="geom_density" type="float" min="0.01" max="100" default="3.0">
     2861                        <description><![CDATA[The number of samples (per unit length in one dimension) that affects the precision of estimation of geometrical properties.]]></description>
    28032862                </element>
    28042863                <element name="forModel" function="true" type="ModelGeometry" flags="32">
    … …  
    28102869                <element name="volume" function="true" type="float" flags="288"><arguments/></element>
    28112870                <element name="area" function="true" type="float" flags="288"><arguments/></element>
     2871                <element name="voxels" function="true" type="Vector" flags="288">
     2872                        <description><![CDATA[Returns a Vector of Pt3D objects from a regular 3D grid (sampled according to ModelGeometry.geom_density) that are inside of the Model body (Parts and Joints).]]></description>
     2873<arguments/></element>
    28122874                <element name="sizesAndAxes" function="true" type="Vector" flags="288">
    28132875                        <description><![CDATA[The returned vector contains XYZ (sizes) and Orient (axes) objects.]]></description>
    … …  
    36083670                <element name="i" type="string"/>
    36093671                <element name="Vstyle" type="string" default="part"/>
    3610                 <element name="vr" type="float" min="0" max="1" default="1.0"/>
    3611                 <element name="vg" type="float" min="0" max="1" default="1.0" flags="1024"/>
    3612                 <element name="vb" type="float" min="0" max="1" default="1.0" flags="1024"/>
     3672                <element name="vr" type="float" min="0" max="1" default="0.5"/>
     3673                <element name="vg" type="float" min="0" max="1" default="0.5" flags="1024"/>
     3674                <element name="vb" type="float" min="0" max="1" default="0.5" flags="1024"/>
    36133675        </type>
    36143676        <type name="Population" context="Global context">
    3615 <description><![CDATA[A set of Creature objects, sharing some high level simulation properties (performance calculation, NN simulation, collision detection, event handling). The groups usually have different roles in the experiment (Creatures groups and Food group in standard.expdef).
     3677<description><![CDATA[A set of Creature objects, sharing some high level simulation properties (performance calculation, NN simulation, collision detection, event handling). The groups usually have different roles in the experiment (e.g. Creatures groups and Food group in standard.expdef).
    36163678You can iterate directly over Creatures in a Population using for(...in...) loops:
    36173679        for(var c in Populations[0]) Simulator.print(c.name);]]></description>
    … …  
    36293691                </element>
    36303692                <element name="initial_nn_active" type="integer" min="0" max="2" default="1">
    3631                         <description><![CDATA[Stabilization means no significant movement during a specified period of time.]]></description>
     3693                        <description><![CDATA[Stabilization means no significant movement during a specified period of time. See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
    36323694                </element>
    36333695                <element name="nn_paused" type="integer" min="0" max="1" default="0">
    … …  
    36353697                </element>
    36363698                <element name="perfperiod" type="integer" min="0" max="1000000" default="100">
    3637                         <description><![CDATA[Defines how often onUpdate() events are called and how often the built-in performance counters (distance, speed, etc.) are calculated.]]></description>
     3699                        <description><![CDATA[Defines how often onUpdate() events are called and how often the built-in performance counters (distance, speed, etc.) are calculated. See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
    36383700                </element>
    36393701                <element name="stabilperiod" type="integer" min="0" max="1000000" default="100">
    … …  
    36503712                </element>
    36513713                <element name="initial_perf_measuring" type="integer" min="0" max="2" default="1">
    3652                         <description><![CDATA[Stabilization means no significant movement during a specified period of time.]]></description>
     3714                        <description><![CDATA[Stabilization means no significant movement during a specified period of time. See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
    36533715                </element>
    36543716                <element name="colmask" type="integer" min="0" max="65535" default="0" deprecated="true" flags="8224">
    … …  
    49765038Thus, if both parents have the same number of neurons, then this will be preserved in their children.]]></description>
    49775039                </element>
    4978                 <element name="f1_smX" type="float" min="0" max="100" default="0.05"/>
    4979                 <element name="f1_smJunct" type="float" min="0" max="100" default="0.02"/>
    4980                 <element name="f1_smComma" type="float" min="0" max="100" default="0.02"/>
    4981                 <element name="f1_smModif" type="float" min="0" max="100" default="0.1">
     5040                <element name="f1_smX" type="float" min="0" max="100" default="2.0"/>
     5041                <element name="f1_smJunct" type="float" min="0" max="100" default="2.0"/>
     5042                <element name="f1_smComma" type="float" min="0" max="100" default="0.5"/>
     5043                <element name="f1_smModif" type="float" min="0" max="100" default="2.5">
    49825044                        <description><![CDATA[Modifiers: LlRrCcQqFfMmIiEeWwAaSsDdGgBb]]></description>
    49835045                </element>
    … …  
    49865048(all: LlRrCcQqFfMmIiEeWwAaSsDdGgBb)]]></description>
    49875049                </element>
    4988                 <element name="f1_nmNeu" type="float" min="0" max="100" default="0.05">
     5050                <element name="f1_nmNeu" type="float" min="0" max="100" default="2.0">
    49895051                        <description><![CDATA[Adds a (connected) neuron or removes a neuron]]></description>
    49905052                </element>
    4991                 <element name="f1_nmConn" type="float" min="0" max="100" default="0.1">
    4992                         <description><![CDATA[]]></description>
    4993                 </element>
    4994                 <element name="f1_nmProp" type="float" min="0" max="100" default="0.1">
     5053                <element name="f1_nmConn" type="float" min="0" max="100" default="1.5">
     5054                        <description><![CDATA[]]></description>
     5055                </element>
     5056                <element name="f1_nmProp" type="float" min="0" max="100" default="1.0">
    49955057                        <description><![CDATA[]]></description>
    49965058                </element>
    49975059                <element name="f1_nmWei" type="float" min="0" max="100" default="1.0"/>
    4998                 <element name="f1_nmVal" type="float" min="0" max="100" default="0.05"/>
     5060                <element name="f1_nmVal" type="float" min="0" max="100" default="1.5"/>
    49995061                <element name="f2_mutAddOper" type="float" min="0" max="1" default="0.4">
    50005062                        <description><![CDATA[]]></description>
    … …  
    51185180                        <description><![CDATA[mutation: probability of deleting a production]]></description>
    51195181                </element>
    5120                 <element name="f9_mut" type="float" min="0" max="1" default="0.1">
    5121                         <description><![CDATA[How many genes should be mutated during single mutation (1=all genes, 0.1=ten percent)]]></description>
     5182                <element name="f9_mut" type="float" min="0" max="1" default="0.0">
     5183                        <description><![CDATA[How many genes should be mutated during a single mutation (1=all genes, 0.1=ten percent, 0=one gene)]]></description>
    51225184                </element>
    51235185                <element name="fF_xover" type="float" min="0.5" max="1" default="0.5">
    … …  
    51805242                </element>
    51815243                <element name="fH_mut_add_connection" type="float" min="0" max="1" default="0.33">
    5182                         <description><![CDATA[Probability of adding new connection handle]]></description>
     5244                        <description><![CDATA[Probability of adding new neuron connection handle]]></description>
    51835245                </element>
    51845246                <element name="fH_mut_deletion" type="float" min="0" max="1" default="0.1">
    … …  
    56855747                        <description><![CDATA[]]></description>
    56865748                </element>
    5687                 <element name="simil_samples_num" type="integer" min="1" max="1048576" default="1048576">
     5749                <element name="simil_samples_num" type="integer" min="1" max="1048576" default="10000">
    56885750                        <description><![CDATA[]]></description>
    56895751                </element>
    … …  
    57285790                <element name="symResultC" type="float" flags="35"/>
    57295791                <element name="symResultD" type="float" flags="35"/>
    5730                 <element name="geom_density" type="float" min="0.01" max="100" default="1.0">
    5731                         <description><![CDATA[Affects the geometry calculation precision]]></description>
     5792                <element name="geom_density" type="float" min="0.01" max="100" default="3.0">
     5793                        <description><![CDATA[The number of samples (per unit length in one dimension) that affects the precision of estimation of geometrical properties.]]></description>
    57325794                </element>
    57335795                <element name="forModel" function="true" type="ModelGeometry" flags="32">
    … …  
    57395801                <element name="volume" function="true" type="float" flags="288"><arguments/></element>
    57405802                <element name="area" function="true" type="float" flags="288"><arguments/></element>
     5803                <element name="voxels" function="true" type="Vector" flags="288">
     5804                        <description><![CDATA[Returns a Vector of Pt3D objects from a regular 3D grid (sampled according to ModelGeometry.geom_density) that are inside of the Model body (Parts and Joints).]]></description>
     5805<arguments/></element>
    57415806                <element name="sizesAndAxes" function="true" type="Vector" flags="288">
    57425807                        <description><![CDATA[The returned vector contains XYZ (sizes) and Orient (axes) objects.]]></description>
    … …  
    57705835                        <description><![CDATA[]]></description>
    57715836                </element>
    5772                 <element name="simil_samples_num" type="integer" min="1" max="1048576" default="1048576">
     5837                <element name="simil_samples_num" type="integer" min="1" max="1048576" default="10000">
    57735838                        <description><![CDATA[]]></description>
    57745839                </element>
    … …  
    65096574                        </arguments>
    65106575                </element>
     6576                <element name="urlEncode" function="true" type="string">
     6577                        <arguments>
     6578                                <argument type="string"/>
     6579                        </arguments>
     6580                </element>
     6581                <element name="urlDecode" function="true" type="string">
     6582                        <arguments>
     6583                                <argument type="string"/>
     6584                        </arguments>
     6585                </element>
    65116586                <element name="SERIALIZATION_PREFIX" type="string" flags="1">
    65126587                        <description><![CDATA[String prefix used in the Framsticks file format to indicate object fields that contain serialized objects.]]></description>
    … …  
    65846659                        </arguments>
    65856660                </element>
    6586                 <element name="get" function="true" type="untyped" flags="256">
     6661                <element name="get" function="true" type="untyped" flags="257">
    65876662                        <description><![CDATA[object[position] can be always used instead of object.get(position)]]></description>
    65886663                        <arguments>
    … …  
    66086683                        </arguments>
    66096684                </element>
    6610                 <element name="find" function="true" type="integer" flags="256">
     6685                <element name="find" function="true" type="integer" flags="257">
    66116686                        <description><![CDATA[returns the element index or -1 if not found]]></description>
    66126687                        <arguments>
    … …  
    66326707                </element>
    66336708                <element name="iterator" type="Object" flags="257"/>
    6634                 <element name="clone" function="true" type="Vector" flags="256">
     6709                <element name="clone" function="true" type="Vector" flags="257">
    66356710                        <description><![CDATA[The resulting clone is a shallow copy (contains the same object references as the original). A deep copy can be obtained through serialization: String.deserialize(String.serialize(object));]]></description>
    66366711<arguments/></element>
    … …  
    68236898                        </arguments>
    68246899                </element>
    6825                 <element name="clone" function="true" type="XYZ" flags="256">
     6900                <element name="clone" function="true" type="XYZ" flags="257">
    68266901                        <description><![CDATA[Note: copying object references does not create new objects. Use clone() if a new object is needed.
    68276902
    … …  
    68766951                        </arguments>
    68776952                </element>
    6878                 <element name="get" function="true" type="float" flags="256">
     6953                <element name="get" function="true" type="float" flags="257">
    68796954                        <description><![CDATA[this function makes the XYZ objects "indexable" (so you can use [] for accessing subsequent fields, like in Vector)]]></description>
    68806955                        <arguments>
    … …  
    71707245                </element>
    71717246                <element name="lifespan" type="float">
    7172                         <description><![CDATA[Average life span]]></description>
     7247                        <description><![CDATA[See Creature.lifespan]]></description>
    71737248                </element>
    71747249                <element name="velocity" type="float">
    7175                         <description><![CDATA[Average velocity]]></description>
    7176                 </element>
    7177                 <element name="distance" type="float"/>
    7178                 <element name="vertvel" type="float"/>
    7179                 <element name="vertpos" type="float"/>
     7250                        <description><![CDATA[See Creature.velocity]]></description>
     7251                </element>
     7252                <element name="distance" type="float">
     7253                        <description><![CDATA[See Creature.distance]]></description>
     7254                </element>
     7255                <element name="vertvel" type="float">
     7256                        <description><![CDATA[See Creature.vertvel]]></description>
     7257                </element>
     7258                <element name="vertpos" type="float">
     7259                        <description><![CDATA[See Creature.vertpos]]></description>
     7260                </element>
    71807261                <element name="fit" type="float" flags="3"/>
    71817262                <element name="fit2" type="float" flags="3">
    … …  
    71997280-1 = validity is not known. This is a transient state. The value of "is_valid" will never be -1 when read. It is safe to treat is_valid as boolean in statements like "if (g.is_valid) ...". Setting "is_valid=-1" will make it 0 or 1 again. This third state (-1) is only needed for loading Genotype objects from files where the "is_valid" field might not be present.]]></description>
    72007281                </element>
    7201                 <element name="getNormalized" function="true" type="float" flags="32">
     7282                <element name="getNormalized" function="true" type="float" flags="33">
    72027283                        <arguments>
    72037284                                <argument name="property name or index" type="untyped"/>
    … …  
    72117292See also: num]]></description>
    72127293                </element>
    7213                 <element name="getModel" function="true" type="Model" flags="32"><arguments/></element>
     7294                <element name="getModel" function="true" type="Model" flags="33"><arguments/></element>
    72147295                <element name="splitInstances" function="true" type="void" flags="32"><arguments/></element>
    72157296                <element name="newFromString" function="true" type="Genotype" flags="32">
    … …  
    72407321                        </arguments>
    72417322                </element>
    7242                 <element name="clone" function="true" type="Genotype" flags="32">
     7323                <element name="clone" function="true" type="Genotype" flags="33">
    72437324                        <description><![CDATA[Returns a duplicated genotype, not attached to any gene pool. All genotype fields are copied including 'data' (for which Dictionary.clone() produces a shallow copy).]]></description>
    72447325<arguments/></element>
    … …  
    73277408                        <description><![CDATA["Lifespan" is the period during simulation of a creature when its performance measurement is enabled.]]></description>
    73287409                </element>
    7329                 <element name="distance" type="float"/>
    7330                 <element name="c_velocity" type="float"/>
    7331                 <element name="c_vertvelocity" type="float"/>
    7332                 <element name="c_vertpos" type="float"/>
    7333                 <element name="velocity" type="float"/>
    7334                 <element name="vertpos" type="float"/>
    7335                 <element name="vertvel" type="float"/>
     7410                <element name="distance" type="float">
     7411                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7412                </element>
     7413                <element name="c_velocity" type="float">
     7414                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7415                </element>
     7416                <element name="c_vertvelocity" type="float">
     7417                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7418                </element>
     7419                <element name="c_vertpos" type="float">
     7420                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7421                </element>
     7422                <element name="velocity" type="float">
     7423                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7424                </element>
     7425                <element name="vertpos" type="float">
     7426                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7427                </element>
     7428                <element name="vertvel" type="float">
     7429                        <description><![CDATA[See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
     7430                </element>
    73367431                <element name="pos_x" type="float" deprecated="true" flags="8195">
    73377432                        <description><![CDATA[(pos_x,pos_y,pos_z) is the point of minimal coordinates ("bottom left corner") of the creature, including imaginary Part sizes (Part.s, usually 1.0). See also: Creature.moveAbs]]></description>
    … …  
    73727467                </element>
    73737468                <element name="centerOfGravity" type="XYZ" flags="3">
    7374                         <description><![CDATA[Only updated once every 'perfperiod' steps!]]></description>
     7469                        <description><![CDATA[Only updated once every 'perfperiod' steps! See http://www.framsticks.com/a/al_params.html#exper-perfcalc]]></description>
    73757470                </element>
    73767471                <element name="numparts" type="integer" flags="3"/>
    … …  
    77747869                <element name="i" type="string"/>
    77757870                <element name="Vstyle" type="string" default="joint"/>
    7776                 <element name="vr" type="float" min="0" max="1" default="1.0"/>
    7777                 <element name="vg" type="float" min="0" max="1" default="1.0" flags="1024"/>
    7778                 <element name="vb" type="float" min="0" max="1" default="1.0" flags="1024"/>
     7871                <element name="vr" type="float" min="0" max="1" default="0.5"/>
     7872                <element name="vg" type="float" min="0" max="1" default="0.5" flags="1024"/>
     7873                <element name="vb" type="float" min="0" max="1" default="0.5" flags="1024"/>
    77797874        </type>
    77807875        <type name="Loader" context="Visual style definition">
    … …  
    78827977                <element name="i" type="string"/>
    78837978                <element name="Vstyle" type="string" default="part"/>
    7884                 <element name="vr" type="float" min="0" max="1" default="1.0"/>
    7885                 <element name="vg" type="float" min="0" max="1" default="1.0" flags="1024"/>
    7886                 <element name="vb" type="float" min="0" max="1" default="1.0" flags="1024"/>
     7979                <element name="vr" type="float" min="0" max="1" default="0.5"/>
     7980                <element name="vg" type="float" min="0" max="1" default="0.5" flags="1024"/>
     7981                <element name="vb" type="float" min="0" max="1" default="0.5" flags="1024"/>
    78877982        </type>
    78887983        <type name="Scene" context="Visual style definition">
    … …  
    81428237                </element>
    81438238        </type>
    8144         <type name="World" context="Visual style definition">
    8145 <description><![CDATA[Environment properties.]]></description>
    8146                 <element name="wrldtyp" type="integer" min="0" max="2" default="0"/>
    8147                 <element name="wrldsiz" type="float" min="10" max="10000" default="20.0">
    8148                         <description><![CDATA[Side length of the world]]></description>
    8149                 </element>
    8150                 <element name="wrldmap" type="string">
    8151                         <description><![CDATA[Description of the world (only applies to world types: "Blocks" or "Height field").
    8152 To generate a random landscape, use:
    8153    r[scaling] <sizex> <sizey> [seed]
    8154 To generate a custom landscape, provide height values:
    8155    m[scaling] <sizex> <sizey> digits...
    8156  or
    8157    M[scaling] <sizex> <sizey> numbers...
    8158 
    8159 "digits..." is a sequence of integer values 0,1,2,..,9. You may also use '-' and '|' characters for smooth slides between blocks.
    8160 "numbers..." is a sequence of floating point values, so the "M" option provides more freedom.
    8161 [scaling] is an optional linear scaling expression in the form of *FACTOR+OFFSET or *FACTOR-OFFSET, for example "r*0.1-2 5 5" creates a 5x5 random map with a 10% amplitude, shifted down by 2.
    8162 
    8163 See also the WorldMap object.]]></description>
    8164                 </element>
    8165                 <element name="wrldwat" type="float" min="-20" max="200" default="-1.0"/>
    8166                 <element name="wrldbnd" type="integer" min="0" max="2" default="0">
    8167                         <description><![CDATA[Teleporting a creature that is outside of the world area is attempted every 'performance sampling period' steps. Teleport succeeds only when the target location in the world is empty (there is no collision).]]></description>
    8168                 </element>
    8169                 <element name="wrldg" type="float" min="0" max="10" default="1.0">
    8170                         <description><![CDATA[You can adjust gravity for your experiments.
    8171 The "official" setting used to evaluate and compare creatures is 1.]]></description>
    8172                 </element>
    8173                 <element name="wrldchg" function="true" type="void" flags="32"><arguments/></element>
    8174                 <element name="simtype" type="integer" min="0" max="1" default="0">
    8175                         <description><![CDATA[MechaStick is a fast and simple primary Framsticks simulation engine.
    8176 ODE is Open Dynamics Engine by Russel Smith et al.
    8177 
    8178 NOTE: switching between simulation engines causes removal of all objects in the world (e.g. creatures).]]></description>
    8179                 </element>
    8180                 <element name="nnspeed" type="float" min="0" max="1000" default="1.0">
    8181                         <description><![CDATA[Number of neural network simulation steps in each physics simulation step]]></description>
    8182                 </element>
    8183                 <element name="rndcollisions" type="integer" min="0" max="1" default="1">
    8184                         <description><![CDATA[When enabled, custom collision handlers are invoked in random order. This can help remove unfair bias in some experiments - for example where the same collision order in each simulation step would cause some creatures colliding with food to consume energy while other colliding creatures would starve.]]></description>
    8185                 </element>
    8186                 <element name="signals" type="WorldSignals" flags="35"/>
    8187         </type>
    8188         <type name="WorldMap" context="Visual style definition">
    8189 <description><![CDATA[Environment details for "Blocks" and "Heightfield" world type. The most important concept is a "Map", which is the array of Map elements. Internally, Maps have more elements than could be deduced from the user-supplied World.wrldsiz, as additional rows of element are added to provide smooth transitions to the flat surroundings.
    8190 
    8191 Blocks: x/ysize=World.wrldsiz+4 rows of blocks (from which only 2+World.wrldsiz rows are placed within the world boundaries)
    8192 
    8193 Smooth: x/ysize=World.wrldsiz+2 rows of vertices (creating World.wrldsiz+1 rows of triangles, everything within the world boundaries)
    8194 ]]></description>
    8195                 <element name="xsize" type="integer" flags="1"/>
    8196                 <element name="ysize" type="integer" flags="1"/>
    8197                 <element name="getHeight" function="true" type="float">
    8198                         <description><![CDATA[Height at any 2d coordinate]]></description>
    8199                         <arguments>
    8200                                 <argument name="x" type="float"/>
    8201                                 <argument name="y" type="float"/>
    8202                         </arguments>
    8203                 </element>
    8204                 <element name="getMap" function="true" type="Object">
    8205                         <description><![CDATA[retrieve map cell object]]></description>
    8206                         <arguments>
    8207                                 <argument name="x" type="integer"/>
    8208                                 <argument name="y" type="integer"/>
    8209                         </arguments>
    8210                 </element>
    8211                 <element name="intersect" function="true" type="Vector">
    8212                         <description><![CDATA[Calculate the intersection point between the world surface and the ray projected from "3d point" towards the given direction. 3D points are actually 3-elements Vector objects. The resulting vector contains the additional fourth element - the intersection point distance. The function returns null if there is no intersection.
    8213 
    8214 See "standard_events.inc" file, which uses "intersect" for calculating the world coordinates corresponding to the user-clicked screen location.
    8215 Bugs: This function does not currently handle the heightfield environment correctly (works as if it was flat)]]></description>
    8216                         <arguments>
    8217                                 <argument name="3d point" type="Vector"/>
    8218                                 <argument name="3d direction" type="Vector"/>
    8219                                 <argument name="range" type="float"/>
    8220                         </arguments>
    8221                 </element>
    8222                 <element name="intersect" function="true" type="Vector">
    8223                         <description><![CDATA[Works like intersect(3d point,3d direction,range) for inifinite range, that is without limiting the intersection distance]]></description>
    8224                         <arguments>
    8225                                 <argument name="3d point" type="Vector"/>
    8226                                 <argument name="3d direction" type="Vector"/>
    8227                         </arguments>
    8228                 </element>
    8229         </type>
    82308239        <type name="Signal" context="Signal label formula">
    82318240                <element name="value" type="untyped" flags="1">
    … …  
    82878296        </type>
    82888297        <type name="CLI" context="Command line interface">
    8289 <description><![CDATA[Commandline support functions.]]></description>
     8298<description><![CDATA[Command-line support functions.]]></description>
    82908299                <element name="script" type="string"/>
    82918300                <element name="execute" function="true" type="void">
    … …  
    83258334                </element>
    83268335                <element name="listMacros" function="true" type="void"><arguments/></element>
     8336                <element name="findAndExpandMacro" function="true" type="string">
     8337                        <arguments>
     8338                                <argument name="text" type="string"/>
     8339                        </arguments>
     8340                </element>
    83278341                <element name="stdin" type="Object" flags="3"/>
    83288342                <element name="stdout" type="Object" flags="3"/>
    … …  
    84788492                <element name="newCreatureCharts" function="true"/>
    84798493                <element name="newSimStatsCharts" function="true"/>
    8480                 <element name="user_interaction" type="integer" min="0" max="31" default="31">
     8494                <element name="user_interaction" type="integer" min="0" max="255" default="127">
    84818495                        <description><![CDATA[Bit field:
    848284961 - menu access
    … …  
    848584998 - select creatures
    8486850016 - change ShowManager options in menu (including switching shows)
    8487 Bits 2-16 are not implemented in the old Framsticks Theater application.]]></description>
     850132 - change display mode (normal/VR/AR)
     850264 - extract genotype
     8503128 - change display mode buttons visibility
     8504Bits 2-128 are not implemented in the old Framsticks Theater application.]]></description>
    84888505                </element>
    84898506                <element name="world_visibility" type="integer" min="0" max="31" default="31">
    … …  
    85028519                        <description><![CDATA[Not implemented in the old Framsticks Theater application.]]></description>
    85038520                </element>
     8521                <element name="menu_group" type="string">
     8522                        <description><![CDATA[Default empty value means all groups. Groups can be also displayed as submenus by adding action parameters having ids of "showgroup_TheNameOfTheGroupToShow".
     8523Not implemented in the old Framsticks Theater application.]]></description>
     8524                </element>
    85048525                <element name="back_action" type="string">
    85058526                        <description><![CDATA[Not implemented in the old Framsticks Theater application.]]></description>
    … …  
    86148635                        <arguments>
    86158636                                <argument name="name" type="string"/>
     8637                        </arguments>
     8638                </element>
     8639                <element name="newMenu" function="true" type="GUIElement">
     8640                        <arguments>
     8641                                <argument name="name" type="string"/>
     8642                                <argument name="menu items" type="Object"/>
    86168643                        </arguments>
    86178644                </element>
    … …  
    87258752                        </arguments>
    87268753                </element>
     8754                <element name="getItemGUI" function="true" type="untyped">
     8755                        <description><![CDATA[Returns null if the requested item is scrolled out of view.]]></description>
     8756                        <arguments>
     8757                                <argument name="index" type="integer"/>
     8758                        </arguments>
     8759                </element>
    87278760                <element name="removeItem" function="true" type="void">
    87288761                        <arguments>
    … …  
    88078840                        <description><![CDATA[Button: 0=regular, 1=borderless
    88088841List: 0=regular, 1=invisible selection
    8809 Textfield: 0=dark border, 1=bright border]]></description>
     8842Textfield: 0=dark border, 1=bright borderModel: 0=no shadow, 1=with shadow]]></description>
    88108843                </element>
    88118844                <element name="feedback" type="integer"/>
    … …  
    88438876                                <argument name="duration" type="float"/>
    88448877                        </arguments>
     8878                </element>
     8879                <element name="gui_owner" type="GUIElement" flags="1">
     8880                        <description><![CDATA[GUIElement that owns this GUIElement's GUIContext.
     8881Multiple GUI context are currently only used for list items, with each item creating independent GUI namespace.
     8882Example:
     8883function onGUIEvent(elem, arg)
     8884{
     8885Simulator.print("clicked "+elem.name);
     8886Simulator.print("inside item #"+elem.gui_owner_item+" in the list "+elem.gui_owner.name);
     8887}
     8888]]></description>
     8889                </element>
     8890                <element name="gui_owner_item" type="integer" flags="1">
     8891                        <description><![CDATA[Index of the list item element owning this GUIElement's GUIContext. Valid when gui_owner is a list.]]></description>
     8892                </element>
     8893                <element name="gui" type="untyped" flags="1">
     8894                        <description><![CDATA[GUIContext of this GUIElement]]></description>
    88458895                </element>
    88468896        </type>
    … …  
    88808930                <element name="shine" type="integer" flags="256"/>
    88818931                <element name="texture" type="string" flags="256"/>
    8882                 <element name="shader" type="Shader" flags="256"/>
     8932                <element name="shader" type="string" flags="256"/>
    88838933        </type>
    88848934        <type name="Matrix" context="Framsticks Theater">
    … …  
    89899039                <element name="get" function="true" type="Obj3D" flags="256">
    89909040                        <arguments>
    8991                                 <argument name="index" type="integer"/>
     9041                                <argument name="or name" type="untyped"/>
    89929042                        </arguments>
    89939043                </element>
    … …  
    90409090                        </arguments>
    90419091                </element>
    9042         </type>
    9043         <type name="Shader" context="Framsticks Theater">
    9044 <description><![CDATA[Shader object]]></description>
    9045                 <element name="new" function="true" type="Shader">
    9046                         <arguments>
    9047                                 <argument name="flags" type="integer"/>
    9048                         </arguments>
    9049                 </element>
    9050                 <element name="vertex" type="string" flags="256"/>
    9051                 <element name="fragment" type="string" flags="256"/>
    90529092        </type>
    90539093        <type name="Sharing" context="Framsticks Theater">
Note: See TracChangeset for help on using the changeset viewer.