Bleep¶
Change the current dialogue bleep sound and its pitch in Dialogue mode from an AnimID data, Entity field or specified directly.
Syntax¶
(1)
|bleep,animid|
(2)
|bleep,entity|
(3)
|bleep,sound,pitch|
(4)
|bleep,sound,pitch,volume|
Parameters¶
animid
: int¶
The AnimID to get its bleep and pitch as the new dialogue bleep sound. This must be a valid AnimID or an exception will be thrown. While the AnimIDs data are using the enum format to index them, this parameter assumes the int format as it will convert it before indexing.
entity
: @
int | @this
, @caller
, @
string¶
The Entity id or designator to get its bleep and pitch as the new dialogue bleep sound. The @
indicates to use syntax (2) as not providing it will use syntax (1) which will have this parameter be interpreted as animid
which may cause an exception to be thrown. The int form represents an Entity id and it must be a valid int or an exception will be thrown. For other values:
this
: Refers to the tailtarget.caller
: Refers to the caller.- Anything else: Refers to a define if it exists, otherwise, this is interpreted as a regular Entity id which will cause an exception to be thrown.
The string form still must resolve to a non null entity or an exception will be thrown.
sound
: string¶
The new bleep sound id to set the new dialogue bleep sound. This must be a valid bleep sound id or an exception will be thrown. This value is essentially the filename of the dialogue bleep sound without extension and without the Dialogue
at the beginning. The files are located at Audio/Sounds/Dialogue
from the project's resources directory. This gives the following valid values:
Value | Description |
---|---|
0 | A mid range pitch, brief and very fast sound |
1 | A high pitch, brief and fast sound |
2 | A typewriter sound |
3 | A high pitch, long and slow sound |
3old | A louder version of 3 |
4 | A robotic sound |
5 | A low pitch and slow sound |
6 | A higher pitch, brief and fast sound |
7 | A low pitch, long and fast sound |
8 | A very low pitch, long and fast sound |
9 | A very high pitch, brief and fast sound |
10 | A very high pitch, brief and slow sound |
11 | A high pitch, brief and slow sound |
12 | A high pitch, slow and distorted sound |
13 | A low pitch, long and slow sound |
14 | A mid range pitch, brief and fast sound |
15 | A very low pitch, long and slow sound |
16 | A very low pitch, brief and very slow sound |
Any other value will cause an exception to be thrown.
pitch
: float¶
The pitch value to set the dialogue bleep. This must be a valid float or an exception will be thrown. The default value at the start of a SetText call is 1.0 which is the normal pitch of the sound.
volume
: float¶
The pitch volume to set the dialogue bleep. This must be a valid float or an exception will be thrown. The default value at the start of a SetText call is the size's magnitude which would be 1.0 if no scaling is desired and it is the normal volume.
Remarks¶
This command allows to override the normal behavior of the dialogue bleep, pitch and volume done during the Dialogue setup phase where the properties will be set using the AnimID data of the parent's Entity and the volume to the size's magnitude. Once this command is processed, every automatic bleep sound done in Letter processing will be using the new bleep settings.
It is not possible to change the volume using syntax (1) and (2).