Welcome to mirror list, hosted at ThFree Co, Russian Federation.

bge.types.SCA_RandomActuator.rst « bge_types « rst « python_api « doc - git.blender.org/blender.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 683572292621376a07f73a3728e04116358a8380 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
SCA_RandomActuator(SCA_IActuator)
=================================

.. module:: bge.types

base class --- :class:`SCA_IActuator`

.. class:: SCA_RandomActuator(SCA_IActuator)

   Random Actuator

   .. attribute:: seed

      Seed of the random number generator.

      :type: integer.

      Equal seeds produce equal series. If the seed is 0, the generator will produce the same value on every call.

   .. attribute:: para1

      the first parameter of the active distribution.

      :type: float, read-only.

      Refer to the documentation of the generator types for the meaning of this value. 

   .. attribute:: para2

      the second parameter of the active distribution.

      :type: float, read-only

      Refer to the documentation of the generator types for the meaning of this value.

   .. attribute:: distribution

      Distribution type. (read-only). Can be one of :ref:`these constants <logic-random-distributions>`

      :type: integer

   .. attribute:: propName

      the name of the property to set with the random value.

      :type: string

      If the generator and property types do not match, the assignment is ignored.

   .. method:: setBoolConst(value)

      Sets this generator to produce a constant boolean value.

      :arg value: The value to return.
      :type value: boolean

   .. method:: setBoolUniform()

      Sets this generator to produce a uniform boolean distribution.

      The generator will generate True or False with 50% chance.

   .. method:: setBoolBernouilli(value)

      Sets this generator to produce a Bernouilli distribution.

      :arg value: Specifies the proportion of False values to produce.

         * 0.0: Always generate True
         * 1.0: Always generate False
      :type value: float

   .. method:: setIntConst(value)

      Sets this generator to always produce the given value.

      :arg value: the value this generator produces.
      :type value: integer

   .. method:: setIntUniform(lower_bound, upper_bound)

      Sets this generator to produce a random value between the given lower and
      upper bounds (inclusive).

      :type lower_bound: integer
      :type upper_bound: integer

   .. method:: setIntPoisson(value)

      Generate a Poisson-distributed number.

      This performs a series of Bernouilli tests with parameter value.
      It returns the number of tries needed to achieve succes.

      :type value: float

   .. method:: setFloatConst(value)

      Always generate the given value.

      :type value: float

   .. method:: setFloatUniform(lower_bound, upper_bound)

      Generates a random float between lower_bound and upper_bound with a
      uniform distribution.

      :type lower_bound: float
      :type upper_bound: float

   .. method:: setFloatNormal(mean, standard_deviation)

      Generates a random float from the given normal distribution.

      :arg mean: The mean (average) value of the generated numbers
      :type mean: float
      :arg standard_deviation: The standard deviation of the generated numbers.
      :type standard_deviation: float

   .. method:: setFloatNegativeExponential(half_life)

      Generate negative-exponentially distributed numbers.

      The half-life 'time' is characterized by half_life.
      
      :type half_life: float