Some grammar correction in function document

This commit is contained in:
NovaRain
2023-06-05 10:54:36 +08:00
parent 21fe99a297
commit 9197966993
2 changed files with 16 additions and 15 deletions
+7 -7
View File
@@ -703,7 +703,7 @@
items:
- name: metarule2_explosions
detail: int metarule2_explosions(int arg1, int arg2)
doc: Was made as a dirty easy hack to allow to dynamically change some explosion parameters (ranged attack). All changed parameters are automatically reset to vanilla state after each attack action.
doc: Was made as a quick-and-dirty hack to enable dynamic changes to some explosion parameters for ranged attacks. All changed parameters are automatically reset to vanilla state after each attack action.
opcode: 0x8261
- name: set_attack_explosion_pattern
@@ -767,7 +767,7 @@
items:
- name: reg_anim_combat_check
detail: void reg_anim_combat_check(int enable)
doc: Allows to enable all `reg_anim_*` functions in combat (including vanilla functions) if set to 0. It is automatically reset at the end of each frame, so you need to call it before `reg_anim_begin` - `reg_anim_end` block.
doc: Allows enabling all `reg_anim_*` functions in combat (including vanilla functions) if set to 0. It is automatically reset at the end of each frame, so you need to call it before `reg_anim_begin` - `reg_anim_end` block.
opcode: 0x825c
- name: reg_anim_destroy
detail: void reg_anim_destroy(ObjectPtr)
@@ -1559,7 +1559,7 @@
- name: set_spray_settings
detail: void set_spray_settings(int centerMult, int centerDiv, int targetMult, int targetDiv)
doc: |
Allows to dynamically change the multipilers and divisors for the bullet distribution of burst attacks. All settings are automatically reset to default values (**ComputeSpray_\*** settings in ddraw.ini) after each attack action
Allows changing the multipliers and divisors for the bullet distribution of burst attacks dynamically. All settings are automatically reset to default values (**ComputeSpray_\*** settings in ddraw.ini) after each attack action
- Should be called before the calculation of the bullet distribution (e.g. in `HOOK_TOHIT` or `HOOK_AMMOCOST`)
- `centerDiv/targetDiv`: the minimum value of divisor is 1
- `centerMult/targetMult`: multiplier values are capped at divisor values
@@ -1569,9 +1569,9 @@
- name: set_combat_free_move
detail: void set_combat_free_move(int value)
doc: |
Allows to change "bonus move" points, that can only be used for moving, not attacking.
- Can be called from HOOK_COMBATTURN at the start of the turn (will not work on dude_obj)
- Can be called from HOOK_STDPROCEDURE with combat_proc event (will work for both NPC's and dude_obj)
Allows changing "bonus move" points (yellow lights on the interface bar) that can only be used for movement, not attacking
- Can be called from `HOOK_COMBATTURN` at the start of the turn (will not work on `dude_obj`)
- Can be called from `HOOK_STDPROCEDURE` with `combat_proc` event (will work on both NPCs and `dude_obj`)
- name: Car
items:
@@ -1830,7 +1830,7 @@
detail: string get_ini_string(string setting)
doc: |
Reads a string value from an ini file in the fallout directory.
- If file or key cannot be found, an empty string is returned.
- If the file or key cannot be found, an empty string is returned.
- If setting argument is in invalid format, -1 (integer) is returned.
opcode: 0x81eb
- name: get_ini_section
+9 -8
View File
@@ -126,7 +126,7 @@ FUNCTION REFERENCE
- Reads an integer value from an ini file in the Fallout directory.
- It only takes a single argument; seperate the file name, section and key with a `|` character, e.g. `myvar := get_ini_setting("myini.ini|mysec|var1")`.
- If the file or key cannot be found, -1 is returned.
- If setting argument is in invalid format, -1 is also returned
- If setting argument is in invalid format, -1 is also returned.
- The file name is limited to 63 chars, including the extension.
- The section name is limited to 32 characters.
- It can also be used to get sfall settings, by using ddraw.ini as the file name.
@@ -134,7 +134,7 @@ FUNCTION REFERENCE
-----
##### `string get_ini_string(string setting)`
- Reads a string value from an ini file in the Fallout directory.
- If file or key cannot be found, an empty string is returned.
- If the file or key cannot be found, an empty string is returned.
- If setting argument is in invalid format, -1 (integer) is returned.
-----
@@ -232,7 +232,7 @@ FUNCTION REFERENCE
-----
##### `void reg_anim_combat_check`
- Allows to enable all `reg_anim_*` functions in combat (including vanilla functions) if set to 0. It is automatically reset at the end of each frame, so you need to call it before `reg_anim_begin() ... reg_anim_end()` code block.
- Allows enabling all `reg_anim_*` functions in combat (including vanilla functions) if set to 0. It is automatically reset at the end of each frame, so you need to call it before `reg_anim_begin() ... reg_anim_end()` code block.
**Some additional `reg_anim_*` functions were introduced. They all work in the same convention as vanilla functions and use the same underlying code.**
@@ -265,7 +265,7 @@ FUNCTION REFERENCE
-----
##### `int/array metarule2_explosions(int arg1, int arg2, int arg3)`
- Was made as a dirty easy hack to allow to dynamically change some explosion parameters (ranged attack). All changed parameters are automatically reset to vanilla state after each attack action. Following macros are available in **sfall.h**:
- Was made as a quick-and-dirty hack to enable dynamic changes to some explosion parameters for ranged attacks. All changed parameters are automatically reset to vanilla state after each attack action. Following macros are available in **sfall.h**:
-----
##### `void set_attack_explosion_pattern(x, y)`
@@ -1071,7 +1071,7 @@ sfall_funcX metarule functions
##### set_spray_settings
`void sfall_func4("set_spray_settings", int centerMult, int centerDiv, int targetMult, int targetDiv)`
- Allows to dynamically change the multipilers and divisors for the bullet distribution of burst attacks. All settings are automatically reset to default values (**ComputeSpray_\*** settings in ddraw.ini) after each attack action
- Allows changing the multipliers and divisors for the bullet distribution of burst attacks dynamically. All settings are automatically reset to default values (**ComputeSpray_\*** settings in ddraw.ini) after each attack action
- Should be called before the calculation of the bullet distribution (e.g. in `HOOK_TOHIT` or `HOOK_AMMOCOST`)
- `centerDiv/targetDiv`: the minimum value of divisor is 1
- `centerMult/targetMult`: multiplier values are capped at divisor values
@@ -1081,9 +1081,10 @@ sfall_funcX metarule functions
##### set_combat_free_move
`void sfall_func1("set_combat_free_move", int value)`
- Allows to change "bonus move" points, that can only be used for moving, not attacking.
- Can be called from HOOK_COMBATTURN at the start of the turn (will not work on dude_obj)
- Can be called from HOOK_STDPROCEDURE with combat_proc event (will work for both NPC's and dude_obj)
- Allows changing "bonus move" points (yellow lights on the interface bar) that can only be used for movement, not attacking
- Can be called from `HOOK_COMBATTURN` at the start of the turn (will not work on `dude_obj`)
- Can be called from `HOOK_STDPROCEDURE` with `combat_proc` event (will work on both NPCs and `dude_obj`)
****
_See other documentation files (arrays.md, hookscripts.md) for related functions reference._