diff --git a/404.html b/404.html index b048242e9..b18d72233 100644 --- a/404.html +++ b/404.html @@ -1 +1 @@ - - sfall sfall | Sfall documentation Link Search Menu Expand Document
sfall

404

Page not found :(

The requested page could not be found.

+ sfall | Sfall documentation Skip to main content Link Menu Expand (external link) Document Search Copy Copied

404

Page not found :(

The requested page could not be found.

diff --git a/alter-min-max/index.html b/alter-min-max/index.html index 8481e16fe..138dd86fb 100644 --- a/alter-min-max/index.html +++ b/alter-min-max/index.html @@ -1,7 +1,7 @@ - Alter min/max - sfall Alter min/max | sfall Link Search Menu Expand Document
sfall

Alter min/max

The set_stat_max/min functions can be used to set the valid ranges on stats. Values returned by get_current_stat will be clamped to this range. The set_pc_ function only affects the player, the set_npc_ functions only affects other critters, and the set_ functions affects both.

Functions

set_npc_stat_max 

void set_npc_stat_max(int stat, int value)
+             Alter min/max | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Alter min/max 
 
The set_stat_max/min functions can be used to set the valid ranges on stats. Values returned by get_current_stat will be clamped to this range. The set_pc_ function only affects the player, the set_npc_ functions only affects other critters, and the set_ functions affects both.
 
  Functions 
 
 
  set_npc_stat_max 
 
void set_npc_stat_max(int stat, int value)
 
 
  set_npc_stat_min 
 
void set_npc_stat_min(int stat, int value)
 
 
  set_pc_stat_max 
 
void set_pc_stat_max(int stat, int value)
 
 
  set_pc_stat_min 
 
void set_pc_stat_min(int stat, int value)
 
 
  set_stat_max 
 
void set_stat_max(int stat, int value)
 
 
  set_stat_min 
 
void set_stat_min(int stat, int value)
-
 
 
 
 
  
+
diff --git a/animations/index.html b/animations/index.html index f32fca7da..0cb4e90d3 100644 --- a/animations/index.html +++ b/animations/index.html @@ -1,9 +1,9 @@ - Animations - sfall Animations | sfall Link Search Menu Expand Document
sfall

Animations

Functions

reg_anim_animate_and_hide 

void reg_anim_animate_and_hide(ObjectPtr, int animID, int delay)
+             Animations | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Animations 
 
  Functions 
 
 
  reg_anim_animate_and_hide 
 
void reg_anim_animate_and_hide(ObjectPtr, int animID, int delay)
 
 
Exactly like reg_anim_animate but the object will automatically disappear after the last animation frame (but not destroyed).
 
  reg_anim_callback 
 
void reg_anim_callback(procedure proc)
 
 
Adds the given procedure to an animation sequence-list and executes it in the registered sequence.
 
  reg_anim_change_fid 
 
void reg_anim_change_fid(ObjectPtr, int FID, int delay)
 
 
Should work like art_change_fid_num but in reg_anim sequence.
 
  reg_anim_combat_check 
 
void reg_anim_combat_check(int enable)
-
 
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.
 
  reg_anim_destroy 
 
void reg_anim_destroy(ObjectPtr)
+
 
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.
 
  reg_anim_destroy 
 
void reg_anim_destroy(ObjectPtr)
 
 
Given object is destroyed at the end of current animation set.
 
  reg_anim_light 
 
void reg_anim_light(ObjectPtr, int light, int delay)
 
 
Change light of any object. Light argument is a light radius (0-8), but you can use highest 2 bytes to pass light intensity as well (example: 0xFFFF0008 - intensity 65535 and radius 8). If highest 2 bytes are 0, intensity will not be changed. Intensity range is from 0 to 65535 (0xFFFF)
 
  reg_anim_take_out 
 
void reg_anim_take_out(ObjectPtr, holdFrameID, delay)
 
 
Plays “take out weapon” animation for given holdFrameID. It is not required to have such weapon in critter’s inventory.
 
  reg_anim_turn_towards 
 
void reg_anim_turn_towards(ObjectPtr, int tile/target, delay)
-
 
Makes object change its direction to face given tile num or target object.
 
 
 
 
  
+

Makes object change its direction to face given tile number or target object.

diff --git a/array-functions/index.html b/array-functions/index.html index 08e3a9490..ecf4db744 100644 --- a/array-functions/index.html +++ b/array-functions/index.html @@ -1,14 +1,14 @@ - Array functions - sfall Array functions | sfall Link Search Menu Expand Document
sfall

Array functions

Functions

array_key 

mixed array_key(int arrayID, int index)
+             Array functions | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Array functions 
 
  Functions 
 
 
  array_key 
 
mixed array_key(int arrayID, int index)
 
 
Don’t use it directly; it is generated by the compiler in foreach loops.
 
  arrayexpr 
 
int arrayexpr(mixed key, mixed value)
 
 
Don’t use it directly; it is used by compiler to create array expressions.
 
  create_array 
 
int create_array(int size, int nothing)
 
 
Creates permanent array (but not “saved”).
 
  fix_array 
 
void fix_array(int arrayID)
 
 
Changes “temporary” array into “permanent” (“permanent” arrays are not automatically saved into savegames).
 
  free_array 
 
void free_array(int arrayID)
 
 
Deletes any array.
 
  get_array 
 
mixed get_array(int arrayID, mixed key)
-
 
Returns array value by key or index (shorthand: arrayID[key]).
 
  len_array 
 
int len_array(int arrayID)
+
 
Returns array value by key or index (shorthand: arrayID[key]).
 
     
  • If array with given arrayID doesn’t exist, returns 0.
    •  
 
  len_array 
 
int len_array(int arrayID)
 
 
Returns number of elements or key=>value pairs in a given array.
 
  load_array 
 
int load_array(mixed key)
 
 
Load array from savegame data by the same key provided in “save_array”.
 
  resize_array 
 
void resize_array(int arrayID, int size)
 
 
Changes array size.
 
  save_array 
 
void save_array(mixed key, int arrayID)
 
 
Array is saved (arrayID is associated with given “key”).
 
  scan_array 
 
mixed scan_array(int arrayID, mixed value)
 
 
Searches for a first occurence of given value inside given array.
 
  set_array 
 
void set_array(int arrayID, mixed key, mixed value)
 
 
Sets array value (shorthand: arrayID[key] := value).
 
  temp_array 
 
int temp_array(int size, int nothing)
-
 
Works exactly like “create_array”, only created array becomes “temporary.”
 
 
 
 
  
+

Works exactly like “create_array”, only created array becomes “temporary.”

diff --git a/arrays/index.html b/arrays/index.html index 675da1dca..6b4ff2501 100644 --- a/arrays/index.html +++ b/arrays/index.html @@ -1,4 +1,4 @@ - Arrays - sfall Arrays | sfall Link Search Menu Expand Document
sfall

Arrays

sfall introduces new method of storing variables - arrays.

Array is basically a container which can store variable number of values (elements). Each element in array can be of any type. Arrays can be extremely useful for some more advanced scripting, in conjunction with loops. See array function reference here.

Arrays concept

Array elements are accessed by index or key. For example:

// this code puts some string in array "list" at index 5:
+             Arrays | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Arrays 
 
sfall introduces new method of storing variables - arrays.
 
Array is basically a container which can store variable number of values (elements). Each element in array can be of any type. Arrays can be extremely useful for some more advanced scripting, in conjunction with loops. See array function reference here.
  
  Arrays concept 
 
Array elements are accessed by index or key. For example:
 
// this code puts some string in array "list" at index 5:
 list[5] := "Value";
 
 
There are 2 different types of arrays currently available:
 
     
  •  
    Lists - a set of values with specific size (number of elements), where all elements have numeric indexes starting from zero (0) up to array length minus one.
     
    For example:
     
    // this creates list with 3 elements. Element "A" has index 0, element "B" has index 1, element "C" - 2
 list := ["A", "B", "C"];
@@ -64,4 +64,4 @@
         // kaboom!!!
     end
 end
-
     
      Array operators reference 
     
    *mixed means any type
     
       
    • int create_array(int size, int flags): 
         
      • creates permanent array (but not “saved”)
        •  
      • if size >= 0, creates list with given size
        •  
      • if size == -1, creates map (associative array)
        •  
      • if size == -1 and flags == 2, creates a “lookup” map (associative array) in which the values of existing keys are read-only and can’t be updated. This type of array allows you to store a zero (0) key value 
           
        • NOTE: in earlier versions (up to 4.1.3/3.8.13) the second argument is not used, just use 0
          •  
         
        •  
      • returns arrayID (valid until array is deleted)
        •  
       
      •  
    • int temp_array(int size, int flags): 
         
      • works exactly like create_array, only created array becomes “temporary”
        •  
       
      •  
    • void fix_array(int arrayID): 
         
      • changes “temporary” array into “permanent” (“permanent” arrays are not automatically saved into savegames)
        •  
       
      •  
    • void set_array(int arrayID, mixed key, mixed value): 
         
      • sets array value
        •  
      • if used on list, “key” must be numeric and within valid index range (0..size-1)
        •  
      • if used on map, key can be of any type
        •  
      • to “unset” a value from map, just set it to zero (0) 
           
        • NOTE: to add a value of 0 for the key, use the float value of 0.0
          •  
         
        •  
      • this works exactly like statement: arrayID[key] := value;
        •  
       
      •  
    • mixed get_array(int arrayID, mixed key): 
         
      • returns array value by key or index
        •  
      • if key doesn’t exist or index is not in valid range, returns 0
        •  
      • works exactly like expression: (arrayID[key])
        •  
       
      •  
    • void resize_array(int arrayID, int size): 
         
      • changes array size
        •  
      • applicable to maps too, but only to reduce elements
        •  
      • there are number of special negative values of “size” which perform various operations on the array, use macros sort_array, sort_array_reverse, reverse_array, shuffle_array from sfall.h header
        •  
       
      •  
    • void free_array(int arrayID): 
         
      • deletes any array
        •  
      • if array was “saved”, it will be removed from a savegame
        •  
       
      •  
    • mixed scan_array(int arrayID, mixed value): 
         
      • searches for a first occurence of given value inside given array
        •  
      • if value is found, returns it’s index (for lists) or key (for maps)
        •  
      • if value is not found, returns -1 (be careful, as -1 can be a valid key for a map)
        •  
       
      •  
    • int len_array(int arrayID): 
         
      • returns number of elements or key=>value pairs in a given array
        •  
      • if array is not found, returns -1 (can be used to check if given array exist)
        •  
       
      •  
    • mixed array_key(int arrayID, int index): 
         
      • don’t use it directly; it is generated by the compiler in foreach loops
        •  
      • for lists, returns index back (no change)
        •  
      • for maps, returns a key at the specified numeric index (don’t rely on the order in which keys are stored though)
        •  
      • can be checked if given array is associative or not, by using index (-1): 0 - array is list, 1 - array is map
        •  
       
      •  
    • int arrayexpr(mixed key, mixed value): 
         
      • don’t use it directly; it is used by compiler to create array expressions
        •  
      • assigns value to a given key in an array, created by last create_array or temp_array call
        •  
      • always returns 0
        •  
       
      •  
    • void save_array(mixed key, int arrayID): 
         
      • makes the array saveable; it will be saved in sfallgv.sav file when saving the game
        •  
      • arrayID is associated with given “key”
        •  
      • array becomes permanent (if it was temporary) and “saved”
        •  
      • key can be of any type (int, float or string)
        •  
      • if you specify 0 as the key for the array ID, it will make the array “unsaved”
        •  
       
      •  
    • int load_array(mixed key): 
         
      • loads array from savegame data by the same key provided in save_array
        •  
      • returns array ID or zero (0) if none found
        •  
       
      •  
     
      Backward compatibility notes 
     
    For those who used arrays in their mods before sfall 3.4:
     
       
    •  
      There is an INI parameter ArraysBehavior in Misc section of ddraw.ini. If set to 0, all scripts which used sfall arrays before should work. This basically changes that create_array will create permanent arrays which are “saved” by default and their IDs are also permanent. It is 1 by default.
       
      •  
    •  
      NOTE: Starting from sfall 4.3.3/3.8.33, the ArraysBehavior option is removed, and arrays always work in ArraysBehavior=1 mode. Make sure to review your scripts if you need to save arrays into savegames.
       
      •  
    •  
      How savegame compatibility is handled?
       Saved arrays are stored in sfallgv.sav file (in savegame) in new (more flexible) format, just after the old arrays. So basically, when you load older savegame, sfall will load arrays from old format and save them to new format on next game save. If you load savegame made with sfall 3.4 using sfall 3.3 (for example), the game shouldn’t crash, but all arrays will be lost.
       
      •  
    •  
      Previously you had to specify size in bytes for array elements. This parameter is now ignored and you can store strings of arbitrary length in arrays.
       
      •  
     
     
    Table of contents
      
 
 
 
  
+

Array operators reference

*mixed means any type

  • int create_array(int size, int flags):
    • creates permanent array (but not “saved”)
    • if size >= 0, creates list with given size
    • if size == -1, creates map (associative array)
    • if size == -1 and flags == 2, creates a “lookup” map (associative array) in which the values of existing keys are read-only and can’t be updated. This type of array allows you to store a zero (0) key value
      • NOTE: in earlier versions (up to 4.1.3/3.8.13) the second argument is not used, just use 0
    • returns arrayID (valid until array is deleted)
  • int temp_array(int size, int flags):
    • works exactly like create_array, only created array becomes “temporary”
  • void fix_array(int arrayID):
    • changes “temporary” array into “permanent” (“permanent” arrays are not automatically saved into savegames)
  • void set_array(int arrayID, mixed key, mixed value):
    • sets array value
    • if used on list, “key” must be numeric and within valid index range (0..size-1)
    • if used on map, key can be of any type
    • to “unset” a value from map, just set it to zero (0)
      • NOTE: to add a value of 0 for the key, use the float value of 0.0
    • this works exactly like statement: arrayID[key] := value;
  • mixed get_array(int arrayID, mixed key):
    • returns array value by key or index
    • if key doesn’t exist or index is not in valid range, returns 0
    • works exactly like expression: (arrayID[key])
  • void resize_array(int arrayID, int size):
    • changes array size
    • applicable to maps too, but only to reduce elements
    • there are number of special negative values of “size” which perform various operations on the array, use macros sort_array, sort_array_reverse, reverse_array, shuffle_array from sfall.h header
  • void free_array(int arrayID):
    • deletes any array
    • if array was “saved”, it will be removed from a savegame
  • mixed scan_array(int arrayID, mixed value):
    • searches for a first occurrence of given value inside given array
    • if value is found, returns it’s index (for lists) or key (for maps)
    • if value is not found, returns -1 (be careful, as -1 can be a valid key for a map)
  • int len_array(int arrayID):
    • returns number of elements or key=>value pairs in a given array
    • if array is not found, returns -1 (can be used to check if given array exist)
  • mixed array_key(int arrayID, int index):
    • don’t use it directly; it is generated by the compiler in foreach loops
    • for lists, returns index back (no change)
    • for maps, returns a key at the specified numeric index (don’t rely on the order in which keys are stored though)
    • can be checked if given array is associative or not, by using index (-1): 0 - array is list, 1 - array is map
  • int arrayexpr(mixed key, mixed value):
    • don’t use it directly; it is used by compiler to create array expressions
    • assigns value to a given key in an array, created by last create_array or temp_array call
    • always returns 0
  • void save_array(mixed key, int arrayID):
    • makes the array saveable; it will be saved in sfallgv.sav file when saving the game
    • arrayID is associated with given “key”
    • array becomes permanent (if it was temporary) and “saved”
    • key can be of any type (int, float or string)
    • if you specify 0 as the key for the array ID, it will make the array “unsaved”
  • int load_array(mixed key):
    • loads array from savegame data by the same key provided in save_array
    • returns array ID or zero (0) if none found

Backward compatibility notes

For those who used arrays in their mods before sfall 3.4:

  • There is an INI parameter ArraysBehavior in Misc section of ddraw.ini. If set to 0, all scripts which used sfall arrays before should work. This basically changes that create_array will create permanent arrays which are “saved” by default and their IDs are also permanent. It is 1 by default.

  • NOTE: Starting from sfall 4.3.3/3.8.33, the ArraysBehavior option is removed, and arrays always work in ArraysBehavior=1 mode. Make sure to review your scripts if you need to save arrays into savegames.

  • How savegame compatibility is handled?
    Saved arrays are stored in sfallgv.sav file (in savegame) in new (more flexible) format, just after the old arrays. So basically, when you load older savegame, sfall will load arrays from old format and save them to new format on next game save. If you load savegame made with sfall 3.4 using sfall 3.3 (for example), the game shouldn’t crash, but all arrays will be lost.

  • Previously you had to specify size in bytes for array elements. This parameter is now ignored and you can store strings of arbitrary length in arrays.

Table of contents

diff --git a/art-and-appearance/index.html b/art-and-appearance/index.html index 1569ea838..d8c77753b 100644 --- a/art-and-appearance/index.html +++ b/art-and-appearance/index.html @@ -1,6 +1,6 @@ - Art and appearance - sfall Art and appearance | sfall Link Search Menu Expand Document
sfall

Art and appearance

Functions

art_cache_clear

sfall.h

void art_cache_clear()
+             Art and appearance | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Art and appearance 
 
  Functions 
 
 
  art_cache_clear 
 
sfall.h
 
void art_cache_clear()
 
 
Clears the cache of FRM image files loaded into memory.
 
  art_exists 
 
int art_exists(int artFID)
 
 
checks if given artFID exists in the game. Useful when you want to check if critter can use specific weapon: art_exists((artFid bwand 0xffff0fff) bwor (weaponAnim * 0x1000)).
 
  refresh_pc_art 
 
void refresh_pc_art
 
 
  set_hero_race 
 
void set_hero_race(int style)
 
 
  set_hero_style 
 
void set_hero_style(int style)
-
 
 
 
 
  
+
diff --git a/assets/css/just-the-docs-dark.css b/assets/css/just-the-docs-dark.css index fb411d176..d5021ac42 100644 --- a/assets/css/just-the-docs-dark.css +++ b/assets/css/just-the-docs-dark.css @@ -1,4 +1,264 @@ @charset "UTF-8"; +.highlight, pre.highlight { background: #f9f9f9; color: #383942; } + +.highlight pre { background: #f9f9f9; } + +.highlight .hll { background: #f9f9f9; } + +.highlight .c { color: #9fa0a6; font-style: italic; } + +.highlight .err { color: #fff; background-color: #e05151; } + +.highlight .k { color: #a625a4; } + +.highlight .l { color: #50a04f; } + +.highlight .n { color: #383942; } + +.highlight .o { color: #383942; } + +.highlight .p { color: #383942; } + +.highlight .cm { color: #9fa0a6; font-style: italic; } + +.highlight .cp { color: #9fa0a6; font-style: italic; } + +.highlight .c1 { color: #9fa0a6; font-style: italic; } + +.highlight .cs { color: #9fa0a6; font-style: italic; } + +.highlight .ge { font-style: italic; } + +.highlight .gs { font-weight: 700; } + +.highlight .kc { color: #a625a4; } + +.highlight .kd { color: #a625a4; } + +.highlight .kn { color: #a625a4; } + +.highlight .kp { color: #a625a4; } + +.highlight .kr { color: #a625a4; } + +.highlight .kt { color: #a625a4; } + +.highlight .ld { color: #50a04f; } + +.highlight .m { color: #b66a00; } + +.highlight .s { color: #50a04f; } + +.highlight .na { color: #b66a00; } + +.highlight .nb { color: #ca7601; } + +.highlight .nc { color: #ca7601; } + +.highlight .no { color: #ca7601; } + +.highlight .nd { color: #ca7601; } + +.highlight .ni { color: #ca7601; } + +.highlight .ne { color: #ca7601; } + +.highlight .nf { color: #383942; } + +.highlight .nl { color: #ca7601; } + +.highlight .nn { color: #383942; } + +.highlight .nx { color: #383942; } + +.highlight .py { color: #ca7601; } + +.highlight .nt { color: #e35549; } + +.highlight .nv { color: #ca7601; } + +.highlight .ow { font-weight: 700; } + +.highlight .w { color: #f8f8f2; } + +.highlight .mf { color: #b66a00; } + +.highlight .mh { color: #b66a00; } + +.highlight .mi { color: #b66a00; } + +.highlight .mo { color: #b66a00; } + +.highlight .sb { color: #50a04f; } + +.highlight .sc { color: #50a04f; } + +.highlight .sd { color: #50a04f; } + +.highlight .s2 { color: #50a04f; } + +.highlight .se { color: #50a04f; } + +.highlight .sh { color: #50a04f; } + +.highlight .si { color: #50a04f; } + +.highlight .sx { color: #50a04f; } + +.highlight .sr { color: #0083bb; } + +.highlight .s1 { color: #50a04f; } + +.highlight .ss { color: #0083bb; } + +.highlight .bp { color: #ca7601; } + +.highlight .vc { color: #ca7601; } + +.highlight .vg { color: #ca7601; } + +.highlight .vi { color: #e35549; } + +.highlight .il { color: #b66a00; } + +.highlight .gu { color: #75715e; } + +.highlight .gd { color: #e05151; } + +.highlight .gi { color: #43d089; } + +.highlight .language-json .w + .s2 { color: #e35549; } + +.highlight .language-json .kc { color: #0083bb; } + +.highlight, pre.highlight { background: #31343f; color: #dee2f7; } + +.highlight pre { background: #31343f; } + +.highlight .hll { background: #31343f; } + +.highlight .c { color: #63677e; font-style: italic; } + +.highlight .err { color: #960050; background-color: #1e0010; } + +.highlight .k { color: #e19ef5; } + +.highlight .l { color: #a3eea0; } + +.highlight .n { color: #dee2f7; } + +.highlight .o { color: #dee2f7; } + +.highlight .p { color: #dee2f7; } + +.highlight .cm { color: #63677e; font-style: italic; } + +.highlight .cp { color: #63677e; font-style: italic; } + +.highlight .c1 { color: #63677e; font-style: italic; } + +.highlight .cs { color: #63677e; font-style: italic; } + +.highlight .ge { font-style: italic; } + +.highlight .gs { font-weight: 700; } + +.highlight .kc { color: #e19ef5; } + +.highlight .kd { color: #e19ef5; } + +.highlight .kn { color: #e19ef5; } + +.highlight .kp { color: #e19ef5; } + +.highlight .kr { color: #e19ef5; } + +.highlight .kt { color: #e19ef5; } + +.highlight .ld { color: #a3eea0; } + +.highlight .m { color: #eddc96; } + +.highlight .s { color: #a3eea0; } + +.highlight .na { color: #eddc96; } + +.highlight .nb { color: #fdce68; } + +.highlight .nc { color: #fdce68; } + +.highlight .no { color: #fdce68; } + +.highlight .nd { color: #fdce68; } + +.highlight .ni { color: #fdce68; } + +.highlight .ne { color: #fdce68; } + +.highlight .nf { color: #dee2f7; } + +.highlight .nl { color: #fdce68; } + +.highlight .nn { color: #dee2f7; } + +.highlight .nx { color: #dee2f7; } + +.highlight .py { color: #fdce68; } + +.highlight .nt { color: #f9867b; } + +.highlight .nv { color: #fdce68; } + +.highlight .ow { font-weight: 700; } + +.highlight .w { color: #f8f8f2; } + +.highlight .mf { color: #eddc96; } + +.highlight .mh { color: #eddc96; } + +.highlight .mi { color: #eddc96; } + +.highlight .mo { color: #eddc96; } + +.highlight .sb { color: #a3eea0; } + +.highlight .sc { color: #a3eea0; } + +.highlight .sd { color: #a3eea0; } + +.highlight .s2 { color: #a3eea0; } + +.highlight .se { color: #a3eea0; } + +.highlight .sh { color: #a3eea0; } + +.highlight .si { color: #a3eea0; } + +.highlight .sx { color: #a3eea0; } + +.highlight .sr { color: #7be2f9; } + +.highlight .s1 { color: #a3eea0; } + +.highlight .ss { color: #7be2f9; } + +.highlight .bp { color: #fdce68; } + +.highlight .vc { color: #fdce68; } + +.highlight .vg { color: #fdce68; } + +.highlight .vi { color: #f9867b; } + +.highlight .il { color: #eddc96; } + +.highlight .gu { color: #75715e; } + +.highlight .gd { color: #f92672; } + +.highlight .gi { color: #a6e22e; } + /*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */ /* Document ========================================================================== */ /** 1. Correct the line height in all browsers. 2. Prevent adjustments of font size after orientation changes in iOS. */ @@ -108,27 +368,27 @@ template { display: none; } /** Add the correct display in IE 10. */ [hidden] { display: none; } -* { box-sizing: border-box; } +:root { color-scheme: dark; } -::selection { color: #fff; background: #2c84fa; } +* { box-sizing: border-box; } -html { font-size: 14px !important; scroll-behavior: smooth; } -@media (min-width: 31.25rem) { html { font-size: 16px !important; } } +html { font-size: 0.875rem !important; scroll-behavior: smooth; } +@media (min-width: 31.25rem) { html { font-size: 1rem !important; } } -body { font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; font-size: inherit; line-height: 1.4; color: #e6e1e8; background-color: #27262b; } +body { font-family: system-ui, -apple-system, blinkmacsystemfont, "Segoe UI", roboto, "Helvetica Neue", arial, sans-serif, "Segoe UI Emoji"; font-size: inherit; line-height: 1.4; color: #e6e1e8; background-color: #27262b; overflow-wrap: break-word; } ol, ul, dl, pre, address, blockquote, table, div, hr, form, fieldset, noscript .table-wrapper { margin-top: 0; } -h1, h2, h3, h4, h5, h6 { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #f5f6fa; } +h1, h2, h3, h4, h5, h6, #toctitle { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #f5f6fa; } p { margin-top: 1em; margin-bottom: 1em; } a { color: #2c84fa; text-decoration: none; } -a:not([class]) { text-decoration: none; background-image: linear-gradient(#44434d 0%, #44434d 100%); background-repeat: repeat-x; background-position: 0 100%; background-size: 1px 1px; } -a:not([class]):hover { background-image: linear-gradient(rgba(44, 132, 250, 0.45) 0%, rgba(44, 132, 250, 0.45) 100%); background-size: 1px 1px; } +a:not([class]) { text-decoration: underline; text-decoration-color: #44434d; text-underline-offset: 2px; } +a:not([class]):hover { text-decoration-color: rgba(44, 132, 250, 0.45); } -code { font-family: "SFMono-Regular", Menlo, Consolas, Monospace; font-size: 0.75em; line-height: 1.4; } +code { font-family: "SFMono-Regular", menlo, consolas, monospace; font-size: 0.75em; line-height: 1.4; } figure, pre { margin: 0; } @@ -138,35 +398,37 @@ img { max-width: 100%; height: auto; } hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #44434d; border: 0; } +blockquote { margin: 10px 0; margin-block-start: 0; margin-inline-start: 0; padding-left: 1rem; border-left: 3px solid #44434d; } + .side-bar { z-index: 0; display: flex; flex-wrap: wrap; background-color: #27262b; } -@media (min-width: 50rem) { .side-bar { flex-wrap: nowrap; position: fixed; width: 248px; height: 100%; flex-direction: column; border-right: 1px solid #44434d; align-items: flex-end; } } -@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 1064px) / 2 + 264px); min-width: 264px; } } +@media (min-width: 50rem) { .side-bar { flex-flow: column nowrap; position: fixed; width: 15.5rem; height: 100%; border-right: 1px solid #44434d; align-items: flex-end; } } +@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 66.5rem) / 2 + 16.5rem); min-width: 16.5rem; } } -@media (min-width: 50rem) { .main { position: relative; max-width: 800px; margin-left: 248px; } } -@media (min-width: 66.5rem) { .main { margin-left: calc( (100% - 1064px) / 2 + 264px ); } } +@media (min-width: 50rem) { .main { position: relative; max-width: 50rem; margin-left: 15.5rem; } } +@media (min-width: 66.5rem) { .main { margin-left: Max(16.5rem, calc((100% - 66.5rem) / 2 + 16.5rem)); } } .main-content-wrap { padding-right: 1rem; padding-left: 1rem; padding-top: 1rem; padding-bottom: 1rem; } @media (min-width: 50rem) { .main-content-wrap { padding-right: 2rem; padding-left: 2rem; } } @media (min-width: 50rem) { .main-content-wrap { padding-top: 2rem; padding-bottom: 2rem; } } .main-header { z-index: 0; display: none; background-color: #27262b; } -@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 60px; background-color: #27262b; border-bottom: 1px solid #44434d; } } +@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 3.75rem; background-color: #27262b; border-bottom: 1px solid #44434d; } } .main-header.nav-open { display: block; } @media (min-width: 50rem) { .main-header.nav-open { display: flex; } } .site-nav, .site-header, .site-footer { width: 100%; } -@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 264px; } } +@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 16.5rem; } } .site-nav { display: none; } .site-nav.nav-open { display: block; } @media (min-width: 50rem) { .site-nav { display: block; padding-top: 3rem; padding-bottom: 1rem; overflow-y: auto; flex: 1 1 auto; } } -.site-header { display: flex; min-height: 60px; align-items: center; } -@media (min-width: 50rem) { .site-header { height: 60px; max-height: 60px; border-bottom: 1px solid #44434d; } } +.site-header { display: flex; min-height: 3.75rem; align-items: center; } +@media (min-width: 50rem) { .site-header { height: 3.75rem; max-height: 3.75rem; border-bottom: 1px solid #44434d; } } -.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #f5f6fa; font-size: 18px !important; } +.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #f5f6fa; font-size: 1.125rem !important; } @media (min-width: 50rem) { .site-title { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-title { font-size: 24px !important; line-height: 1.25; } } +@media (min-width: 31.25rem) { .site-title { font-size: 1.5rem !important; line-height: 1.25; } } @media (min-width: 50rem) { .site-title { padding-top: 0.5rem; padding-bottom: 0.5rem; } } .site-button { display: flex; height: 100%; padding: 1rem; align-items: center; } @@ -179,31 +441,29 @@ hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #44434d; border: body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } @media (min-width: 50rem) { body { position: static; padding-bottom: 0; } } -.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 11px !important; } +.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 0.6875rem !important; } @media (min-width: 50rem) { .site-footer { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-footer { font-size: 12px !important; } } +@media (min-width: 31.25rem) { .site-footer { font-size: 0.75rem !important; } } @media (min-width: 50rem) { .site-footer { position: static; justify-self: end; } } .icon { width: 1.5rem; height: 1.5rem; color: #2c84fa; } .main-content { line-height: 1.6; } .main-content ol, .main-content ul, .main-content dl, .main-content pre, .main-content address, .main-content blockquote, .main-content .table-wrapper { margin-top: 0.5em; } -.main-content a { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.main-content a { overflow: hidden; text-overflow: ellipsis; } .main-content ul, .main-content ol { padding-left: 1.5em; } .main-content li .highlight { margin-top: 0.25rem; } .main-content ol { list-style-type: none; counter-reset: step-counter; } .main-content ol > li { position: relative; } -.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 12px !important; } -@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 14px !important; } } +.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 0.875rem !important; } } @media (min-width: 31.25rem) { .main-content ol > li::before { top: 0.11em; } } .main-content ol > li ol { counter-reset: sub-counter; } -.main-content ol > li ol li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } +.main-content ol > li ol > li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } .main-content ul { list-style: none; } .main-content ul > li::before { position: absolute; margin-left: -1.4em; color: #959396; content: "•"; } -.main-content .task-list { padding-left: 0; } -.main-content .task-list-item { display: flex; align-items: center; } .main-content .task-list-item::before { content: ""; } -.main-content .task-list-item-checkbox { margin-right: 0.6em; } +.main-content .task-list-item-checkbox { margin-right: 0.6em; margin-left: -1.4em; } .main-content hr + * { margin-top: 0; } .main-content h1:first-of-type { margin-top: 0.5em; } .main-content dl { display: grid; grid-template: auto / 10em 1fr; } @@ -216,25 +476,26 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .main-content .anchor-heading { position: absolute; right: -1rem; width: 1.5rem; height: 100%; padding-right: 0.25rem; padding-left: 0.25rem; overflow: visible; } @media (min-width: 50rem) { .main-content .anchor-heading { right: auto; left: -1.5rem; } } .main-content .anchor-heading svg { display: inline-block; width: 100%; height: 100%; color: #2c84fa; visibility: hidden; } -.main-content .anchor-heading:hover svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } +.main-content .anchor-heading:hover svg, .main-content .anchor-heading:focus svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } .main-content summary { cursor: pointer; } -.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6 { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } -.main-content h1:first-child, .main-content h2:first-child, .main-content h3:first-child, .main-content h4:first-child, .main-content h5:first-child, .main-content h6:first-child { margin-top: 0.5rem; } -.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge { margin-top: 1em; } -.main-content h1 + p, .main-content h2 + p, .main-content h3 + p, .main-content h4 + p, .main-content h5 + p, .main-content h6 + p { margin-top: 0; } +.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6, .main-content #toctitle { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } +.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h1 + .sectionbody .listingblock, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h2 + .sectionbody .listingblock, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h3 + .sectionbody .listingblock, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h4 + .sectionbody .listingblock, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h5 + .sectionbody .listingblock, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge, .main-content h6 + .sectionbody .listingblock, .main-content #toctitle + table, .main-content #toctitle + .table-wrapper, .main-content #toctitle + .code-example, .main-content #toctitle + .highlighter-rouge, .main-content #toctitle + .sectionbody .listingblock { margin-top: 1em; } +.main-content h1 + p:not(.label), .main-content h2 + p:not(.label), .main-content h3 + p:not(.label), .main-content h4 + p:not(.label), .main-content h5 + p:not(.label), .main-content h6 + p:not(.label), .main-content #toctitle + p:not(.label) { margin-top: 0; } +.main-content > h1:first-child, .main-content > h2:first-child, .main-content > h3:first-child, .main-content > h4:first-child, .main-content > h5:first-child, .main-content > h6:first-child, .main-content > .sect1:first-child > h2, .main-content > .sect2:first-child > h3, .main-content > .sect3:first-child > h4, .main-content > .sect4:first-child > h5, .main-content > .sect5:first-child > h6 { margin-top: 0.5rem; } .nav-list { padding: 0; margin-top: 0; margin-bottom: 0; list-style: none; } -.nav-list .nav-list-item { font-size: 14px !important; position: relative; margin: 0; } -@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 16px !important; } } -@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 14px !important; } } +.nav-list .nav-list-item { font-size: 0.875rem !important; position: relative; margin: 0; } +@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 1rem !important; } } +@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 0.875rem !important; } } .nav-list .nav-list-item .nav-list-link { display: block; min-height: 3rem; padding-top: 0.25rem; padding-bottom: 0.25rem; line-height: 2.5rem; padding-right: 3rem; padding-left: 1rem; } @media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-link { min-height: 2rem; line-height: 1.5rem; padding-right: 2rem; padding-left: 2rem; } } +.nav-list .nav-list-item .nav-list-link.external > svg { width: 1rem; height: 1rem; vertical-align: text-bottom; } .nav-list .nav-list-item .nav-list-link.active { font-weight: 600; text-decoration: none; } .nav-list .nav-list-item .nav-list-link:hover, .nav-list .nav-list-item .nav-list-link.active { background-image: linear-gradient(-90deg, #201f23 0%, rgba(32, 31, 35, 0.8) 80%, rgba(32, 31, 35, 0) 100%); } -.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding-top: 0.75rem; padding-right: 0.75rem; padding-bottom: 0.75rem; padding-left: 0.75rem; color: #2c84fa; } -@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding-top: 0.5rem; padding-right: 0.5rem; padding-bottom: 0.5rem; padding-left: 0.5rem; } } +.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding: 0.75rem; color: #2c84fa; } +@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding: 0.5rem; } } .nav-list .nav-list-item .nav-list-expander:hover { background-image: linear-gradient(-90deg, #201f23 0%, rgba(32, 31, 35, 0.8) 100%); } .nav-list .nav-list-item .nav-list-expander svg { transform: rotate(90deg); } .nav-list .nav-list-item > .nav-list { display: none; padding-left: 0.75rem; list-style: none; } @@ -244,13 +505,18 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .nav-list .nav-list-item.active > .nav-list-expander svg { transform: rotate(-90deg); } .nav-list .nav-list-item.active > .nav-list { display: block; } -.nav-category { padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 1rem; font-weight: 600; text-align: end; text-transform: uppercase; border-bottom: 1px solid #44434d; font-size: 11px !important; } -@media (min-width: 31.25rem) { .nav-category { font-size: 12px !important; } } -@media (min-width: 50rem) { .nav-category { padding-right: 2rem; padding-left: 2rem; margin-top: 1rem; text-align: start; } +.nav-category { padding: 0.5rem 1rem; font-weight: 600; text-align: start; text-transform: uppercase; border-bottom: 1px solid #44434d; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .nav-category { font-size: 0.75rem !important; } } +@media (min-width: 50rem) { .nav-category { padding: 0.5rem 2rem; margin-top: 1rem; text-align: start; } .nav-category:first-child { margin-top: 0; } } -.aux-nav { height: 100%; overflow-x: auto; font-size: 11px !important; } -@media (min-width: 31.25rem) { .aux-nav { font-size: 12px !important; } } +.nav-list.nav-category-list > .nav-list-item { margin: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list { padding: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-link { color: #2c84fa; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-expander { color: #2c84fa; } + +.aux-nav { height: 100%; overflow-x: auto; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .aux-nav { font-size: 0.75rem !important; } } .aux-nav .aux-nav-list { display: flex; height: 100%; padding: 0; margin: 0; list-style: none; } .aux-nav .aux-nav-list-item { display: inline-block; height: 100%; padding: 0; margin: 0; } @media (min-width: 50rem) { .aux-nav { padding-right: 1rem; } } @@ -259,36 +525,36 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .breadcrumb-nav-list { padding-left: 0; margin-bottom: 0.75rem; list-style: none; } -.breadcrumb-nav-list-item { display: table-cell; font-size: 11px !important; } -@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 12px !important; } } +.breadcrumb-nav-list-item { display: table-cell; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 0.75rem !important; } } .breadcrumb-nav-list-item::before { display: none; } .breadcrumb-nav-list-item::after { display: inline-block; margin-right: 0.5rem; margin-left: 0.5rem; color: #959396; content: "/"; } .breadcrumb-nav-list-item:last-child::after { content: ""; } -h1, .text-alpha { font-size: 32px !important; line-height: 1.25; font-weight: 300; } -@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 36px !important; } } +h1, .text-alpha { font-size: 2rem !important; line-height: 1.25; font-weight: 300; } +@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 2.25rem !important; } } -h2, .text-beta { font-size: 18px !important; } -@media (min-width: 31.25rem) { h2, .text-beta { font-size: 24px !important; line-height: 1.25; } } +h2, .text-beta, #toctitle { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { h2, .text-beta, #toctitle { font-size: 1.5rem !important; line-height: 1.25; } } -h3, .text-gamma { font-size: 16px !important; } -@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 18px !important; } } +h3, .text-gamma { font-size: 1rem !important; } +@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 1.125rem !important; } } -h4, .text-delta { font-size: 11px !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } -@media (min-width: 31.25rem) { h4, .text-delta { font-size: 12px !important; } } +h4, .text-delta { font-size: 0.6875rem !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } +@media (min-width: 31.25rem) { h4, .text-delta { font-size: 0.75rem !important; } } h4 code { text-transform: none; } -h5, .text-epsilon { font-size: 12px !important; color: #44434d; } -@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 14px !important; } } +h5, .text-epsilon { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 0.875rem !important; } } -h6, .text-zeta { font-size: 11px !important; color: #44434d; } -@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 12px !important; } } +h6, .text-zeta { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 0.75rem !important; } } -.text-small { font-size: 11px !important; } -@media (min-width: 31.25rem) { .text-small { font-size: 12px !important; } } +.text-small { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .text-small { font-size: 0.75rem !important; } } -.text-mono { font-family: "SFMono-Regular", Menlo, Consolas, Monospace !important; } +.text-mono { font-family: "SFMono-Regular", menlo, consolas, monospace !important; } .text-left { text-align: left !important; } @@ -296,18 +562,18 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .text-right { text-align: right !important; } -.label, .label-blue { display: inline-block; padding-top: 0.16em; padding-right: 0.56em; padding-bottom: 0.16em; padding-left: 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 11px !important; border-radius: 12px; } -@media (min-width: 31.25rem) { .label, .label-blue { font-size: 12px !important; } } +.label:not(g), .label-blue:not(g) { display: inline-block; padding: 0.16em 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 0.6875rem !important; border-radius: 12px; } +@media (min-width: 31.25rem) { .label:not(g), .label-blue:not(g) { font-size: 0.75rem !important; } } -.label-green { background-color: #009c7b; } +.label-green:not(g) { background-color: #009c7b; } -.label-purple { background-color: #5e41d0; } +.label-purple:not(g) { background-color: #5e41d0; } -.label-red { background-color: #e94c4c; } +.label-red:not(g) { background-color: #e94c4c; } -.label-yellow { color: #44434d; background-color: #f7d12e; } +.label-yellow:not(g) { color: #44434d; background-color: #f7d12e; } -.btn { display: inline-block; box-sizing: border-box; padding-top: 0.3em; padding-right: 1em; padding-bottom: 0.3em; padding-left: 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #2c84fa; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #302d36; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } +.btn { display: inline-block; box-sizing: border-box; padding: 0.3em 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #2c84fa; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #302d36; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } .btn:focus { text-decoration: none; outline: none; box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:focus:hover, .btn.selected:focus { box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:hover, .btn.zeroclipboard-is-hover { color: #227efa; } @@ -341,14 +607,16 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .btn-green:active, .btn-green.selected, .btn-green.zeroclipboard-is-active { background-color: #0f9e73; background-image: none; box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15); } .btn-green.selected:hover { background-color: #0d8662; } +.btn-reset { background: none; border: none; margin: 0; text-align: inherit; font: inherit; border-radius: 0; appearance: none; } + .search { position: relative; z-index: 2; flex-grow: 1; height: 4rem; padding: 0.5rem; transition: padding linear 200ms; } @media (min-width: 50rem) { .search { position: relative !important; width: auto !important; height: 100% !important; padding: 0; transition: none; } } .search-input-wrap { position: relative; z-index: 1; height: 3rem; overflow: hidden; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); transition: height linear 200ms; } -@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 536px; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } +@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 33.5rem; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } -.search-input { position: absolute; width: 100%; height: 100%; padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 2.5rem; font-size: 16px; background-color: #302d36; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } -@media (min-width: 50rem) { .search-input { padding-top: 1rem; padding-bottom: 1rem; padding-left: 3.5rem; font-size: 14px; background-color: #27262b; transition: padding-left linear 200ms; } } +.search-input { position: absolute; width: 100%; height: 100%; padding: 0.5rem 1rem 0.5rem 2.5rem; font-size: 1rem; color: #e6e1e8; background-color: #302d36; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } +@media (min-width: 50rem) { .search-input { padding: 0.5rem 1rem 0.5rem 3.5rem; font-size: 0.875rem; background-color: #27262b; transition: padding-left linear 200ms; } } .search-input:focus { outline: 0; } .search-input:focus + .search-label .search-icon { color: #2c84fa; } @@ -357,45 +625,45 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-label .search-icon { width: 1.2rem; height: 1.2rem; align-self: center; color: #959396; } .search-results { position: absolute; left: 0; display: none; width: 100%; max-height: calc(100% - 4rem); overflow-y: auto; background-color: #302d36; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } -@media (min-width: 50rem) { .search-results { top: 100%; width: 536px; max-height: calc(100vh - 200%) !important; } } +@media (min-width: 50rem) { .search-results { top: 100%; width: 33.5rem; max-height: calc(100vh - 200%) !important; } } -.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 14px !important; } -@media (min-width: 31.25rem) { .search-results-list { font-size: 16px !important; } } -@media (min-width: 50rem) { .search-results-list { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 14px !important; } } +.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .search-results-list { font-size: 1rem !important; } } +@media (min-width: 50rem) { .search-results-list { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 0.875rem !important; } } .search-results-list-item { padding: 0; margin: 0; } -.search-result { display: block; padding-top: 0.25rem; padding-right: 0.75rem; padding-bottom: 0.25rem; padding-left: 0.75rem; } +.search-result { display: block; padding: 0.25rem 0.75rem; } .search-result:hover, .search-result.active { background-color: #201f23; } .search-result-title { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; } @media (min-width: 31.25rem) { .search-result-title { display: inline-block; width: 40%; padding-right: 0.5rem; vertical-align: top; } } .search-result-doc { display: flex; align-items: center; word-wrap: break-word; } -.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 14px !important; } } -@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 11px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 12px !important; } } +.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.875rem !important; } } +@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 0.6875rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.75rem !important; } } .search-result-doc .search-result-icon { width: 1rem; height: 1rem; margin-right: 0.5rem; color: #2c84fa; flex-shrink: 0; } .search-result-doc .search-result-doc-title { overflow: auto; } .search-result-section { margin-left: 1.5rem; word-wrap: break-word; } -.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 9px !important; } -@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 10px !important; } } +.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 0.625rem !important; } } -.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #44434d; font-size: 11px !important; } -@media (min-width: 31.25rem) { .search-result-previews { font-size: 12px !important; } } +.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #44434d; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .search-result-previews { font-size: 0.75rem !important; } } @media (min-width: 31.25rem) { .search-result-previews { display: inline-block; width: 60%; padding-left: 0.5rem; margin-left: 0; vertical-align: top; } } .search-result-preview + .search-result-preview { margin-top: 0.25rem; } .search-result-highlight { font-weight: bold; } -.search-no-result { padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-no-result { font-size: 14px !important; } } +.search-no-result { padding: 0.5rem 0.75rem; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-no-result { font-size: 0.875rem !important; } } .search-button { position: fixed; right: 1rem; bottom: 1rem; display: flex; width: 3.5rem; height: 3.5rem; background-color: #302d36; border: 1px solid rgba(44, 132, 250, 0.3); border-radius: 1.75rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); align-items: center; justify-content: center; } @@ -403,7 +671,7 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-active .search { position: fixed; top: 0; left: 0; width: 100%; height: 100%; padding: 0; } .search-active .search-input-wrap { height: 4rem; border-radius: 0; } -@media (min-width: 50rem) { .search-active .search-input-wrap { width: 536px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } +@media (min-width: 50rem) { .search-active .search-input-wrap { width: 33.5rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } .search-active .search-input { background-color: #302d36; } @media (min-width: 50rem) { .search-active .search-input { padding-left: 2.3rem; } } @media (min-width: 50rem) { .search-active .search-label { padding-left: 0.6rem; } } @@ -417,8 +685,8 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } table { display: table; min-width: 100%; border-collapse: separate; } -th, td { font-size: 12px !important; min-width: 120px; padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; background-color: #302d36; border-bottom: 1px solid rgba(68, 67, 77, 0.5); border-left: 1px solid #44434d; } -@media (min-width: 31.25rem) { th, td { font-size: 14px !important; } } +th, td { font-size: 0.75rem !important; min-width: 7.5rem; padding: 0.5rem 0.75rem; background-color: #302d36; border-bottom: 1px solid rgba(68, 67, 77, 0.5); border-left: 1px solid #44434d; } +@media (min-width: 31.25rem) { th, td { font-size: 0.875rem !important; } } th:first-of-type, td:first-of-type { border-left: 0; } tbody tr:last-of-type th, tbody tr:last-of-type td { border-bottom: 0; } @@ -426,160 +694,40 @@ tbody tr:last-of-type td { padding-bottom: 0.75rem; } thead th { border-bottom: 1px solid #44434d; } -code { padding: 0.2em 0.15em; font-weight: 400; background-color: #302d36; border: 1px solid #44434d; border-radius: 4px; } +:not(pre, figure) > code { padding: 0.2em 0.15em; font-weight: 400; background-color: #31343f; border: 1px solid #44434d; border-radius: 4px; } a:visited code { border-color: #44434d; } -div.highlighter-rouge { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; overflow-x: auto; background-color: #302d36; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -div.highlighter-rouge div.highlight, div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } - -figure.highlight { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; background-color: #302d36; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; } - -.highlight .table-wrapper { padding: 0; margin: 0; border: 0; box-shadow: none; } -.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 11px !important; min-width: 0; padding: 0; background-color: #302d36; border: 0; } -@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 12px !important; } } -.highlight .table-wrapper td.gl { padding-right: 0.75rem; } -.highlight .table-wrapper pre { margin: 0; line-height: 2; } - -.highlight .c { color: #586e75; } - -.highlight .err { color: #93a1a1; } - -.highlight .g { color: #93a1a1; } - -.highlight .k { color: #859900; } - -.highlight .l { color: #93a1a1; } - -.highlight .n { color: #93a1a1; } - -.highlight .o { color: #859900; } - -.highlight .x { color: #cb4b16; } - -.highlight .p { color: #93a1a1; } - -.highlight .cm { color: #586e75; } - -.highlight .cp { color: #859900; } - -.highlight .c1 { color: #586e75; } - -.highlight .cs { color: #859900; } - -.highlight .gd { color: #2aa198; } +div.highlighter-rouge, div.listingblock > div.content, figure.highlight { margin-top: 0; margin-bottom: 0.75rem; background-color: #31343f; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; position: relative; padding: 0; } +div.highlighter-rouge > button, div.listingblock > div.content > button, figure.highlight > button { width: 0.75rem; opacity: 0; position: absolute; top: 0; right: 0; border: 0.75rem solid #31343f; background-color: #31343f; color: #e6e1e8; box-sizing: content-box; } +div.highlighter-rouge > button svg, div.listingblock > div.content > button svg, figure.highlight > button svg { fill: #e6e1e8; } +div.highlighter-rouge > button:active, div.listingblock > div.content > button:active, figure.highlight > button:active { text-decoration: none; outline: none; opacity: 1; } +div.highlighter-rouge > button:focus, div.listingblock > div.content > button:focus, figure.highlight > button:focus { opacity: 1; } +div.highlighter-rouge:hover > button, div.listingblock > div.content:hover > button, figure.highlight:hover > button { cursor: copy; opacity: 1; } -.highlight .ge { font-style: italic; color: #93a1a1; } +div.highlighter-rouge div.highlight { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } -.highlight .gr { color: #dc322f; } +div.listingblock { margin-top: 0; margin-bottom: 0.75rem; } +div.listingblock div.content { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.listingblock div.content > pre, div.listingblock code { padding: 0; margin: 0; border: 0; } -.highlight .gh { color: #cb4b16; } +figure.highlight pre, figure.highlight :not(pre) > code { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } -.highlight .gi { color: #859900; } - -.highlight .go { color: #93a1a1; } - -.highlight .gp { color: #93a1a1; } - -.highlight .gs { font-weight: bold; color: #93a1a1; } - -.highlight .gu { color: #cb4b16; } - -.highlight .gt { color: #93a1a1; } - -.highlight .kc { color: #cb4b16; } - -.highlight .kd { color: #268bd2; } - -.highlight .kn { color: #859900; } - -.highlight .kp { color: #859900; } - -.highlight .kr { color: #268bd2; } - -.highlight .kt { color: #dc322f; } - -.highlight .ld { color: #93a1a1; } - -.highlight .m { color: #2aa198; } - -.highlight .s { color: #2aa198; } - -.highlight .na { color: #555; } - -.highlight .nb { color: #b58900; } - -.highlight .nc { color: #268bd2; } - -.highlight .no { color: #cb4b16; } - -.highlight .nd { color: #268bd2; } - -.highlight .ni { color: #cb4b16; } - -.highlight .ne { color: #cb4b16; } - -.highlight .nf { color: #268bd2; } - -.highlight .nl { color: #555; } - -.highlight .nn { color: #93a1a1; } - -.highlight .nx { color: #555; } - -.highlight .py { color: #93a1a1; } - -.highlight .nt { color: #268bd2; } - -.highlight .nv { color: #268bd2; } - -.highlight .ow { color: #859900; } - -.highlight .w { color: #93a1a1; } - -.highlight .mf { color: #2aa198; } - -.highlight .mh { color: #2aa198; } - -.highlight .mi { color: #2aa198; } - -.highlight .mo { color: #2aa198; } - -.highlight .sb { color: #586e75; } - -.highlight .sc { color: #2aa198; } - -.highlight .sd { color: #93a1a1; } - -.highlight .s2 { color: #2aa198; } - -.highlight .se { color: #cb4b16; } - -.highlight .sh { color: #93a1a1; } - -.highlight .si { color: #2aa198; } - -.highlight .sx { color: #2aa198; } - -.highlight .sr { color: #dc322f; } - -.highlight .s1 { color: #2aa198; } - -.highlight .ss { color: #2aa198; } - -.highlight .bp { color: #268bd2; } - -.highlight .vc { color: #268bd2; } +.highlight .table-wrapper { padding: 0.75rem 0; margin: 0; border: 0; box-shadow: none; } +.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.6875rem !important; min-width: 0; padding: 0; background-color: #31343f; border: 0; } +@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.75rem !important; } } +.highlight .table-wrapper td.gl { width: 1em; padding-right: 0.75rem; padding-left: 0.75rem; } +.highlight .table-wrapper pre { margin: 0; line-height: 2; } -.highlight .vg { color: #268bd2; } +.code-example, .listingblock > .title { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #44434d; border-radius: 4px; } +.code-example + .highlighter-rouge, .code-example + .sectionbody .listingblock, .code-example + .content, .code-example + figure.highlight, .listingblock > .title + .highlighter-rouge, .listingblock > .title + .sectionbody .listingblock, .listingblock > .title + .content, .listingblock > .title + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #44434d; border-bottom: 1px solid #44434d; border-left: 1px solid #44434d; border-top-left-radius: 0; border-top-right-radius: 0; } -.highlight .vi { color: #268bd2; } +code.language-mermaid { padding: 0; background-color: inherit; border: 0; } -.highlight .il { color: #2aa198; } +.highlight, pre.highlight { background: #31343f; color: #dee2f7; } -.code-example { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #44434d; border-radius: 4px; } -.code-example + .highlighter-rouge, .code-example + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #44434d; border-bottom: 1px solid #44434d; border-left: 1px solid #44434d; border-top-left-radius: 0; border-top-right-radius: 0; } +.highlight pre { background: #31343f; } .text-grey-dk-000 { color: #959396 !important; } @@ -1006,35 +1154,35 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; .v-align-top { vertical-align: top !important; } -.fs-1 { font-size: 9px !important; } -@media (min-width: 31.25rem) { .fs-1 { font-size: 10px !important; } } +.fs-1 { font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .fs-1 { font-size: 0.625rem !important; } } -.fs-2 { font-size: 11px !important; } -@media (min-width: 31.25rem) { .fs-2 { font-size: 12px !important; } } +.fs-2 { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .fs-2 { font-size: 0.75rem !important; } } -.fs-3 { font-size: 12px !important; } -@media (min-width: 31.25rem) { .fs-3 { font-size: 14px !important; } } +.fs-3 { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .fs-3 { font-size: 0.875rem !important; } } -.fs-4 { font-size: 14px !important; } -@media (min-width: 31.25rem) { .fs-4 { font-size: 16px !important; } } +.fs-4 { font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .fs-4 { font-size: 1rem !important; } } -.fs-5 { font-size: 16px !important; } -@media (min-width: 31.25rem) { .fs-5 { font-size: 18px !important; } } +.fs-5 { font-size: 1rem !important; } +@media (min-width: 31.25rem) { .fs-5 { font-size: 1.125rem !important; } } -.fs-6 { font-size: 18px !important; } -@media (min-width: 31.25rem) { .fs-6 { font-size: 24px !important; line-height: 1.25; } } +.fs-6 { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { .fs-6 { font-size: 1.5rem !important; line-height: 1.25; } } -.fs-7 { font-size: 24px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-7 { font-size: 32px !important; } } +.fs-7 { font-size: 1.5rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-7 { font-size: 2rem !important; } } -.fs-8 { font-size: 32px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-8 { font-size: 36px !important; } } +.fs-8 { font-size: 2rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-8 { font-size: 2.25rem !important; } } -.fs-9 { font-size: 36px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-9 { font-size: 42px !important; } } +.fs-9 { font-size: 2.25rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-9 { font-size: 2.625rem !important; } } -.fs-10 { font-size: 42px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-10 { font-size: 48px !important; } } +.fs-10 { font-size: 2.625rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-10 { font-size: 3rem !important; } } .fw-300 { font-weight: 300 !important; } @@ -2243,7 +2391,12 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; @media print { .site-footer, .site-button, #edit-this-page, #back-to-top, .site-nav, .main-header { display: none !important; } .side-bar { width: 100%; height: auto; border-right: 0 !important; } .site-header { border-bottom: 1px solid #44434d; } - .site-title { font-size: 16px !important; font-weight: 700 !important; } + .site-title { font-size: 1rem !important; font-weight: 700 !important; } .text-small { font-size: 8pt !important; } pre.highlight { border: 1px solid #44434d; } .main { max-width: none; margin-left: 0; } } +a.skip-to-main { left: -999px; position: absolute; top: auto; width: 1px; height: 1px; overflow: hidden; z-index: -999; } + +a.skip-to-main:focus, a.skip-to-main:active { color: #2c84fa; background-color: #27262b; left: auto; top: auto; width: 30%; height: auto; overflow: auto; margin: 10px 35%; padding: 5px; border-radius: 15px; border: 4px solid #264caf; text-align: center; font-size: 1.2em; z-index: 999; } + +div.opaque { background-color: #27262b; } diff --git a/assets/css/just-the-docs-default.css b/assets/css/just-the-docs-default.css index c14cf6be8..3ff10812a 100644 --- a/assets/css/just-the-docs-default.css +++ b/assets/css/just-the-docs-default.css @@ -1,4 +1,136 @@ @charset "UTF-8"; +.highlight, pre.highlight { background: #f9f9f9; color: #383942; } + +.highlight pre { background: #f9f9f9; } + +.highlight .hll { background: #f9f9f9; } + +.highlight .c { color: #9fa0a6; font-style: italic; } + +.highlight .err { color: #fff; background-color: #e05151; } + +.highlight .k { color: #a625a4; } + +.highlight .l { color: #50a04f; } + +.highlight .n { color: #383942; } + +.highlight .o { color: #383942; } + +.highlight .p { color: #383942; } + +.highlight .cm { color: #9fa0a6; font-style: italic; } + +.highlight .cp { color: #9fa0a6; font-style: italic; } + +.highlight .c1 { color: #9fa0a6; font-style: italic; } + +.highlight .cs { color: #9fa0a6; font-style: italic; } + +.highlight .ge { font-style: italic; } + +.highlight .gs { font-weight: 700; } + +.highlight .kc { color: #a625a4; } + +.highlight .kd { color: #a625a4; } + +.highlight .kn { color: #a625a4; } + +.highlight .kp { color: #a625a4; } + +.highlight .kr { color: #a625a4; } + +.highlight .kt { color: #a625a4; } + +.highlight .ld { color: #50a04f; } + +.highlight .m { color: #b66a00; } + +.highlight .s { color: #50a04f; } + +.highlight .na { color: #b66a00; } + +.highlight .nb { color: #ca7601; } + +.highlight .nc { color: #ca7601; } + +.highlight .no { color: #ca7601; } + +.highlight .nd { color: #ca7601; } + +.highlight .ni { color: #ca7601; } + +.highlight .ne { color: #ca7601; } + +.highlight .nf { color: #383942; } + +.highlight .nl { color: #ca7601; } + +.highlight .nn { color: #383942; } + +.highlight .nx { color: #383942; } + +.highlight .py { color: #ca7601; } + +.highlight .nt { color: #e35549; } + +.highlight .nv { color: #ca7601; } + +.highlight .ow { font-weight: 700; } + +.highlight .w { color: #f8f8f2; } + +.highlight .mf { color: #b66a00; } + +.highlight .mh { color: #b66a00; } + +.highlight .mi { color: #b66a00; } + +.highlight .mo { color: #b66a00; } + +.highlight .sb { color: #50a04f; } + +.highlight .sc { color: #50a04f; } + +.highlight .sd { color: #50a04f; } + +.highlight .s2 { color: #50a04f; } + +.highlight .se { color: #50a04f; } + +.highlight .sh { color: #50a04f; } + +.highlight .si { color: #50a04f; } + +.highlight .sx { color: #50a04f; } + +.highlight .sr { color: #0083bb; } + +.highlight .s1 { color: #50a04f; } + +.highlight .ss { color: #0083bb; } + +.highlight .bp { color: #ca7601; } + +.highlight .vc { color: #ca7601; } + +.highlight .vg { color: #ca7601; } + +.highlight .vi { color: #e35549; } + +.highlight .il { color: #b66a00; } + +.highlight .gu { color: #75715e; } + +.highlight .gd { color: #e05151; } + +.highlight .gi { color: #43d089; } + +.highlight .language-json .w + .s2 { color: #e35549; } + +.highlight .language-json .kc { color: #0083bb; } + .navigation { padding-top: 1rem !important; } .main-content { padding-top: 1rem !important; } @@ -116,27 +248,27 @@ template { display: none; } /** Add the correct display in IE 10. */ [hidden] { display: none; } -* { box-sizing: border-box; } +:root { color-scheme: light; } -::selection { color: #fff; background: #2869e6; } +* { box-sizing: border-box; } -html { font-size: 14px !important; scroll-behavior: smooth; } -@media (min-width: 31.25rem) { html { font-size: 16px !important; } } +html { font-size: 0.875rem !important; scroll-behavior: smooth; } +@media (min-width: 31.25rem) { html { font-size: 1rem !important; } } -body { font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; font-size: inherit; line-height: 1.4; color: #5c5962; background-color: #fff; } +body { font-family: system-ui, -apple-system, blinkmacsystemfont, "Segoe UI", roboto, "Helvetica Neue", arial, sans-serif, "Segoe UI Emoji"; font-size: inherit; line-height: 1.4; color: #5c5962; background-color: #fff; overflow-wrap: break-word; } ol, ul, dl, pre, address, blockquote, table, div, hr, form, fieldset, noscript .table-wrapper { margin-top: 0; } -h1, h2, h3, h4, h5, h6 { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #27262b; } +h1, h2, h3, h4, h5, h6, #toctitle { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #27262b; } p { margin-top: 1em; margin-bottom: 1em; } a { color: #2869e6; text-decoration: none; } -a:not([class]) { text-decoration: none; background-image: linear-gradient(#eeebee 0%, #eeebee 100%); background-repeat: repeat-x; background-position: 0 100%; background-size: 1px 1px; } -a:not([class]):hover { background-image: linear-gradient(rgba(40, 105, 230, 0.45) 0%, rgba(40, 105, 230, 0.45) 100%); background-size: 1px 1px; } +a:not([class]) { text-decoration: underline; text-decoration-color: #eeebee; text-underline-offset: 2px; } +a:not([class]):hover { text-decoration-color: rgba(40, 105, 230, 0.45); } -code { font-family: "SFMono-Regular", Menlo, Consolas, Monospace; font-size: 0.75em; line-height: 1.4; } +code { font-family: "SFMono-Regular", menlo, consolas, monospace; font-size: 0.75em; line-height: 1.4; } figure, pre { margin: 0; } @@ -146,35 +278,37 @@ img { max-width: 100%; height: auto; } hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #eeebee; border: 0; } +blockquote { margin: 10px 0; margin-block-start: 0; margin-inline-start: 0; padding-left: 1rem; border-left: 3px solid #eeebee; } + .side-bar { z-index: 0; display: flex; flex-wrap: wrap; background-color: #f5f6fa; } -@media (min-width: 50rem) { .side-bar { flex-wrap: nowrap; position: fixed; width: 248px; height: 100%; flex-direction: column; border-right: 1px solid #eeebee; align-items: flex-end; } } -@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 1064px) / 2 + 264px); min-width: 264px; } } +@media (min-width: 50rem) { .side-bar { flex-flow: column nowrap; position: fixed; width: 15.5rem; height: 100%; border-right: 1px solid #eeebee; align-items: flex-end; } } +@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 66.5rem) / 2 + 16.5rem); min-width: 16.5rem; } } -@media (min-width: 50rem) { .main { position: relative; max-width: 800px; margin-left: 248px; } } -@media (min-width: 66.5rem) { .main { margin-left: calc( (100% - 1064px) / 2 + 264px ); } } +@media (min-width: 50rem) { .main { position: relative; max-width: 50rem; margin-left: 15.5rem; } } +@media (min-width: 66.5rem) { .main { margin-left: Max(16.5rem, calc((100% - 66.5rem) / 2 + 16.5rem)); } } .main-content-wrap { padding-right: 1rem; padding-left: 1rem; padding-top: 1rem; padding-bottom: 1rem; } @media (min-width: 50rem) { .main-content-wrap { padding-right: 2rem; padding-left: 2rem; } } @media (min-width: 50rem) { .main-content-wrap { padding-top: 2rem; padding-bottom: 2rem; } } .main-header { z-index: 0; display: none; background-color: #f5f6fa; } -@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 60px; background-color: #fff; border-bottom: 1px solid #eeebee; } } +@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 3.75rem; background-color: #fff; border-bottom: 1px solid #eeebee; } } .main-header.nav-open { display: block; } @media (min-width: 50rem) { .main-header.nav-open { display: flex; } } .site-nav, .site-header, .site-footer { width: 100%; } -@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 264px; } } +@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 16.5rem; } } .site-nav { display: none; } .site-nav.nav-open { display: block; } @media (min-width: 50rem) { .site-nav { display: block; padding-top: 3rem; padding-bottom: 1rem; overflow-y: auto; flex: 1 1 auto; } } -.site-header { display: flex; min-height: 60px; align-items: center; } -@media (min-width: 50rem) { .site-header { height: 60px; max-height: 60px; border-bottom: 1px solid #eeebee; } } +.site-header { display: flex; min-height: 3.75rem; align-items: center; } +@media (min-width: 50rem) { .site-header { height: 3.75rem; max-height: 3.75rem; border-bottom: 1px solid #eeebee; } } -.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #27262b; font-size: 18px !important; } +.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #27262b; font-size: 1.125rem !important; } @media (min-width: 50rem) { .site-title { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-title { font-size: 24px !important; line-height: 1.25; } } +@media (min-width: 31.25rem) { .site-title { font-size: 1.5rem !important; line-height: 1.25; } } @media (min-width: 50rem) { .site-title { padding-top: 0.5rem; padding-bottom: 0.5rem; } } .site-button { display: flex; height: 100%; padding: 1rem; align-items: center; } @@ -187,31 +321,29 @@ hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #eeebee; border: body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } @media (min-width: 50rem) { body { position: static; padding-bottom: 0; } } -.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 11px !important; } +.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 0.6875rem !important; } @media (min-width: 50rem) { .site-footer { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-footer { font-size: 12px !important; } } +@media (min-width: 31.25rem) { .site-footer { font-size: 0.75rem !important; } } @media (min-width: 50rem) { .site-footer { position: static; justify-self: end; } } .icon { width: 1.5rem; height: 1.5rem; color: #2869e6; } .main-content { line-height: 1.6; } .main-content ol, .main-content ul, .main-content dl, .main-content pre, .main-content address, .main-content blockquote, .main-content .table-wrapper { margin-top: 0.5em; } -.main-content a { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.main-content a { overflow: hidden; text-overflow: ellipsis; } .main-content ul, .main-content ol { padding-left: 1.5em; } .main-content li .highlight { margin-top: 0.25rem; } .main-content ol { list-style-type: none; counter-reset: step-counter; } .main-content ol > li { position: relative; } -.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 12px !important; } -@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 14px !important; } } +.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 0.875rem !important; } } @media (min-width: 31.25rem) { .main-content ol > li::before { top: 0.11em; } } .main-content ol > li ol { counter-reset: sub-counter; } -.main-content ol > li ol li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } +.main-content ol > li ol > li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } .main-content ul { list-style: none; } .main-content ul > li::before { position: absolute; margin-left: -1.4em; color: #959396; content: "•"; } -.main-content .task-list { padding-left: 0; } -.main-content .task-list-item { display: flex; align-items: center; } .main-content .task-list-item::before { content: ""; } -.main-content .task-list-item-checkbox { margin-right: 0.6em; } +.main-content .task-list-item-checkbox { margin-right: 0.6em; margin-left: -1.4em; } .main-content hr + * { margin-top: 0; } .main-content h1:first-of-type { margin-top: 0.5em; } .main-content dl { display: grid; grid-template: auto / 10em 1fr; } @@ -224,25 +356,26 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .main-content .anchor-heading { position: absolute; right: -1rem; width: 1.5rem; height: 100%; padding-right: 0.25rem; padding-left: 0.25rem; overflow: visible; } @media (min-width: 50rem) { .main-content .anchor-heading { right: auto; left: -1.5rem; } } .main-content .anchor-heading svg { display: inline-block; width: 100%; height: 100%; color: #2869e6; visibility: hidden; } -.main-content .anchor-heading:hover svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } +.main-content .anchor-heading:hover svg, .main-content .anchor-heading:focus svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } .main-content summary { cursor: pointer; } -.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6 { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } -.main-content h1:first-child, .main-content h2:first-child, .main-content h3:first-child, .main-content h4:first-child, .main-content h5:first-child, .main-content h6:first-child { margin-top: 0.5rem; } -.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge { margin-top: 1em; } -.main-content h1 + p, .main-content h2 + p, .main-content h3 + p, .main-content h4 + p, .main-content h5 + p, .main-content h6 + p { margin-top: 0; } +.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6, .main-content #toctitle { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } +.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h1 + .sectionbody .listingblock, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h2 + .sectionbody .listingblock, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h3 + .sectionbody .listingblock, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h4 + .sectionbody .listingblock, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h5 + .sectionbody .listingblock, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge, .main-content h6 + .sectionbody .listingblock, .main-content #toctitle + table, .main-content #toctitle + .table-wrapper, .main-content #toctitle + .code-example, .main-content #toctitle + .highlighter-rouge, .main-content #toctitle + .sectionbody .listingblock { margin-top: 1em; } +.main-content h1 + p:not(.label), .main-content h2 + p:not(.label), .main-content h3 + p:not(.label), .main-content h4 + p:not(.label), .main-content h5 + p:not(.label), .main-content h6 + p:not(.label), .main-content #toctitle + p:not(.label) { margin-top: 0; } +.main-content > h1:first-child, .main-content > h2:first-child, .main-content > h3:first-child, .main-content > h4:first-child, .main-content > h5:first-child, .main-content > h6:first-child, .main-content > .sect1:first-child > h2, .main-content > .sect2:first-child > h3, .main-content > .sect3:first-child > h4, .main-content > .sect4:first-child > h5, .main-content > .sect5:first-child > h6 { margin-top: 0.5rem; } .nav-list { padding: 0; margin-top: 0; margin-bottom: 0; list-style: none; } -.nav-list .nav-list-item { font-size: 14px !important; position: relative; margin: 0; } -@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 16px !important; } } -@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 14px !important; } } +.nav-list .nav-list-item { font-size: 0.875rem !important; position: relative; margin: 0; } +@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 1rem !important; } } +@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 0.875rem !important; } } .nav-list .nav-list-item .nav-list-link { display: block; min-height: 3rem; padding-top: 0.25rem; padding-bottom: 0.25rem; line-height: 2.5rem; padding-right: 3rem; padding-left: 1rem; } @media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-link { min-height: 2rem; line-height: 1.5rem; padding-right: 2rem; padding-left: 2rem; } } +.nav-list .nav-list-item .nav-list-link.external > svg { width: 1rem; height: 1rem; vertical-align: text-bottom; } .nav-list .nav-list-item .nav-list-link.active { font-weight: 600; text-decoration: none; } .nav-list .nav-list-item .nav-list-link:hover, .nav-list .nav-list-item .nav-list-link.active { background-image: linear-gradient(-90deg, #ebedf5 0%, rgba(235, 237, 245, 0.8) 80%, rgba(235, 237, 245, 0) 100%); } -.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding-top: 0.75rem; padding-right: 0.75rem; padding-bottom: 0.75rem; padding-left: 0.75rem; color: #2869e6; } -@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding-top: 0.5rem; padding-right: 0.5rem; padding-bottom: 0.5rem; padding-left: 0.5rem; } } +.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding: 0.75rem; color: #2869e6; } +@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding: 0.5rem; } } .nav-list .nav-list-item .nav-list-expander:hover { background-image: linear-gradient(-90deg, #ebedf5 0%, rgba(235, 237, 245, 0.8) 100%); } .nav-list .nav-list-item .nav-list-expander svg { transform: rotate(90deg); } .nav-list .nav-list-item > .nav-list { display: none; padding-left: 0.75rem; list-style: none; } @@ -252,13 +385,18 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .nav-list .nav-list-item.active > .nav-list-expander svg { transform: rotate(-90deg); } .nav-list .nav-list-item.active > .nav-list { display: block; } -.nav-category { padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 1rem; font-weight: 600; text-align: end; text-transform: uppercase; border-bottom: 1px solid #eeebee; font-size: 11px !important; } -@media (min-width: 31.25rem) { .nav-category { font-size: 12px !important; } } -@media (min-width: 50rem) { .nav-category { padding-right: 2rem; padding-left: 2rem; margin-top: 1rem; text-align: start; } +.nav-category { padding: 0.5rem 1rem; font-weight: 600; text-align: start; text-transform: uppercase; border-bottom: 1px solid #eeebee; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .nav-category { font-size: 0.75rem !important; } } +@media (min-width: 50rem) { .nav-category { padding: 0.5rem 2rem; margin-top: 1rem; text-align: start; } .nav-category:first-child { margin-top: 0; } } -.aux-nav { height: 100%; overflow-x: auto; font-size: 11px !important; } -@media (min-width: 31.25rem) { .aux-nav { font-size: 12px !important; } } +.nav-list.nav-category-list > .nav-list-item { margin: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list { padding: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-link { color: #2869e6; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-expander { color: #2869e6; } + +.aux-nav { height: 100%; overflow-x: auto; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .aux-nav { font-size: 0.75rem !important; } } .aux-nav .aux-nav-list { display: flex; height: 100%; padding: 0; margin: 0; list-style: none; } .aux-nav .aux-nav-list-item { display: inline-block; height: 100%; padding: 0; margin: 0; } @media (min-width: 50rem) { .aux-nav { padding-right: 1rem; } } @@ -267,36 +405,36 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .breadcrumb-nav-list { padding-left: 0; margin-bottom: 0.75rem; list-style: none; } -.breadcrumb-nav-list-item { display: table-cell; font-size: 11px !important; } -@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 12px !important; } } +.breadcrumb-nav-list-item { display: table-cell; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 0.75rem !important; } } .breadcrumb-nav-list-item::before { display: none; } .breadcrumb-nav-list-item::after { display: inline-block; margin-right: 0.5rem; margin-left: 0.5rem; color: #959396; content: "/"; } .breadcrumb-nav-list-item:last-child::after { content: ""; } -h1, .text-alpha { font-size: 32px !important; line-height: 1.25; font-weight: 300; } -@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 36px !important; } } +h1, .text-alpha { font-size: 2rem !important; line-height: 1.25; font-weight: 300; } +@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 2.25rem !important; } } -h2, .text-beta { font-size: 18px !important; } -@media (min-width: 31.25rem) { h2, .text-beta { font-size: 24px !important; line-height: 1.25; } } +h2, .text-beta, #toctitle { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { h2, .text-beta, #toctitle { font-size: 1.5rem !important; line-height: 1.25; } } -h3, .text-gamma { font-size: 16px !important; } -@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 18px !important; } } +h3, .text-gamma { font-size: 1rem !important; } +@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 1.125rem !important; } } -h4, .text-delta { font-size: 11px !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } -@media (min-width: 31.25rem) { h4, .text-delta { font-size: 12px !important; } } +h4, .text-delta { font-size: 0.6875rem !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } +@media (min-width: 31.25rem) { h4, .text-delta { font-size: 0.75rem !important; } } h4 code { text-transform: none; } -h5, .text-epsilon { font-size: 12px !important; color: #44434d; } -@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 14px !important; } } +h5, .text-epsilon { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 0.875rem !important; } } -h6, .text-zeta { font-size: 11px !important; color: #44434d; } -@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 12px !important; } } +h6, .text-zeta { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 0.75rem !important; } } -.text-small { font-size: 11px !important; } -@media (min-width: 31.25rem) { .text-small { font-size: 12px !important; } } +.text-small { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .text-small { font-size: 0.75rem !important; } } -.text-mono { font-family: "SFMono-Regular", Menlo, Consolas, Monospace !important; } +.text-mono { font-family: "SFMono-Regular", menlo, consolas, monospace !important; } .text-left { text-align: left !important; } @@ -304,18 +442,18 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .text-right { text-align: right !important; } -.label, .label-blue { display: inline-block; padding-top: 0.16em; padding-right: 0.56em; padding-bottom: 0.16em; padding-left: 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 11px !important; border-radius: 12px; } -@media (min-width: 31.25rem) { .label, .label-blue { font-size: 12px !important; } } +.label:not(g), .label-blue:not(g) { display: inline-block; padding: 0.16em 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 0.6875rem !important; border-radius: 12px; } +@media (min-width: 31.25rem) { .label:not(g), .label-blue:not(g) { font-size: 0.75rem !important; } } -.label-green { background-color: #009c7b; } +.label-green:not(g) { background-color: #009c7b; } -.label-purple { background-color: #5e41d0; } +.label-purple:not(g) { background-color: #5e41d0; } -.label-red { background-color: #e94c4c; } +.label-red:not(g) { background-color: #e94c4c; } -.label-yellow { color: #44434d; background-color: #f7d12e; } +.label-yellow:not(g) { color: #44434d; background-color: #f7d12e; } -.btn { display: inline-block; box-sizing: border-box; padding-top: 0.3em; padding-right: 1em; padding-bottom: 0.3em; padding-left: 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #2869e6; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #f7f7f7; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } +.btn { display: inline-block; box-sizing: border-box; padding: 0.3em 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #2869e6; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #f7f7f7; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } .btn:focus { text-decoration: none; outline: none; box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:focus:hover, .btn.selected:focus { box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:hover, .btn.zeroclipboard-is-hover { color: #1f63e5; } @@ -349,14 +487,16 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .btn-green:active, .btn-green.selected, .btn-green.zeroclipboard-is-active { background-color: #0f9e73; background-image: none; box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15); } .btn-green.selected:hover { background-color: #0d8662; } +.btn-reset { background: none; border: none; margin: 0; text-align: inherit; font: inherit; border-radius: 0; appearance: none; } + .search { position: relative; z-index: 2; flex-grow: 1; height: 4rem; padding: 0.5rem; transition: padding linear 200ms; } @media (min-width: 50rem) { .search { position: relative !important; width: auto !important; height: 100% !important; padding: 0; transition: none; } } .search-input-wrap { position: relative; z-index: 1; height: 3rem; overflow: hidden; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); transition: height linear 200ms; } -@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 536px; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } +@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 33.5rem; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } -.search-input { position: absolute; width: 100%; height: 100%; padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 2.5rem; font-size: 16px; background-color: #fff; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } -@media (min-width: 50rem) { .search-input { padding-top: 1rem; padding-bottom: 1rem; padding-left: 3.5rem; font-size: 14px; background-color: #fff; transition: padding-left linear 200ms; } } +.search-input { position: absolute; width: 100%; height: 100%; padding: 0.5rem 1rem 0.5rem 2.5rem; font-size: 1rem; color: #5c5962; background-color: #fff; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } +@media (min-width: 50rem) { .search-input { padding: 0.5rem 1rem 0.5rem 3.5rem; font-size: 0.875rem; background-color: #fff; transition: padding-left linear 200ms; } } .search-input:focus { outline: 0; } .search-input:focus + .search-label .search-icon { color: #2869e6; } @@ -365,45 +505,45 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-label .search-icon { width: 1.2rem; height: 1.2rem; align-self: center; color: #959396; } .search-results { position: absolute; left: 0; display: none; width: 100%; max-height: calc(100% - 4rem); overflow-y: auto; background-color: #fff; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } -@media (min-width: 50rem) { .search-results { top: 100%; width: 536px; max-height: calc(100vh - 200%) !important; } } +@media (min-width: 50rem) { .search-results { top: 100%; width: 33.5rem; max-height: calc(100vh - 200%) !important; } } -.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 14px !important; } -@media (min-width: 31.25rem) { .search-results-list { font-size: 16px !important; } } -@media (min-width: 50rem) { .search-results-list { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 14px !important; } } +.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .search-results-list { font-size: 1rem !important; } } +@media (min-width: 50rem) { .search-results-list { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 0.875rem !important; } } .search-results-list-item { padding: 0; margin: 0; } -.search-result { display: block; padding-top: 0.25rem; padding-right: 0.75rem; padding-bottom: 0.25rem; padding-left: 0.75rem; } +.search-result { display: block; padding: 0.25rem 0.75rem; } .search-result:hover, .search-result.active { background-color: #ebedf5; } .search-result-title { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; } @media (min-width: 31.25rem) { .search-result-title { display: inline-block; width: 40%; padding-right: 0.5rem; vertical-align: top; } } .search-result-doc { display: flex; align-items: center; word-wrap: break-word; } -.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 14px !important; } } -@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 11px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 12px !important; } } +.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.875rem !important; } } +@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 0.6875rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.75rem !important; } } .search-result-doc .search-result-icon { width: 1rem; height: 1rem; margin-right: 0.5rem; color: #2869e6; flex-shrink: 0; } .search-result-doc .search-result-doc-title { overflow: auto; } .search-result-section { margin-left: 1.5rem; word-wrap: break-word; } -.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 9px !important; } -@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 10px !important; } } +.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 0.625rem !important; } } -.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #eeebee; font-size: 11px !important; } -@media (min-width: 31.25rem) { .search-result-previews { font-size: 12px !important; } } +.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #eeebee; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .search-result-previews { font-size: 0.75rem !important; } } @media (min-width: 31.25rem) { .search-result-previews { display: inline-block; width: 60%; padding-left: 0.5rem; margin-left: 0; vertical-align: top; } } .search-result-preview + .search-result-preview { margin-top: 0.25rem; } .search-result-highlight { font-weight: bold; } -.search-no-result { padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-no-result { font-size: 14px !important; } } +.search-no-result { padding: 0.5rem 0.75rem; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-no-result { font-size: 0.875rem !important; } } .search-button { position: fixed; right: 1rem; bottom: 1rem; display: flex; width: 3.5rem; height: 3.5rem; background-color: #fff; border: 1px solid rgba(40, 105, 230, 0.3); border-radius: 1.75rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); align-items: center; justify-content: center; } @@ -411,7 +551,7 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-active .search { position: fixed; top: 0; left: 0; width: 100%; height: 100%; padding: 0; } .search-active .search-input-wrap { height: 4rem; border-radius: 0; } -@media (min-width: 50rem) { .search-active .search-input-wrap { width: 536px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } +@media (min-width: 50rem) { .search-active .search-input-wrap { width: 33.5rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } .search-active .search-input { background-color: #fff; } @media (min-width: 50rem) { .search-active .search-input { padding-left: 2.3rem; } } @media (min-width: 50rem) { .search-active .search-label { padding-left: 0.6rem; } } @@ -425,8 +565,8 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } table { display: table; min-width: 100%; border-collapse: separate; } -th, td { font-size: 12px !important; min-width: 120px; padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; background-color: #fff; border-bottom: 1px solid rgba(238, 235, 238, 0.5); border-left: 1px solid #eeebee; } -@media (min-width: 31.25rem) { th, td { font-size: 14px !important; } } +th, td { font-size: 0.75rem !important; min-width: 7.5rem; padding: 0.5rem 0.75rem; background-color: #fff; border-bottom: 1px solid rgba(238, 235, 238, 0.5); border-left: 1px solid #eeebee; } +@media (min-width: 31.25rem) { th, td { font-size: 0.875rem !important; } } th:first-of-type, td:first-of-type { border-left: 0; } tbody tr:last-of-type th, tbody tr:last-of-type td { border-bottom: 0; } @@ -434,160 +574,40 @@ tbody tr:last-of-type td { padding-bottom: 0.75rem; } thead th { border-bottom: 1px solid #eeebee; } -code { padding: 0.2em 0.15em; font-weight: 400; background-color: #f5f6fa; border: 1px solid #eeebee; border-radius: 4px; } +:not(pre, figure) > code { padding: 0.2em 0.15em; font-weight: 400; background-color: #f5f6fa; border: 1px solid #eeebee; border-radius: 4px; } a:visited code { border-color: #eeebee; } -div.highlighter-rouge { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; overflow-x: auto; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -div.highlighter-rouge div.highlight, div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } - -figure.highlight { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; } - -.highlight .table-wrapper { padding: 0; margin: 0; border: 0; box-shadow: none; } -.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 11px !important; min-width: 0; padding: 0; background-color: #f5f6fa; border: 0; } -@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 12px !important; } } -.highlight .table-wrapper td.gl { padding-right: 0.75rem; } -.highlight .table-wrapper pre { margin: 0; line-height: 2; } - -.highlight .c { color: #586e75; } - -.highlight .err { color: #93a1a1; } - -.highlight .g { color: #93a1a1; } - -.highlight .k { color: #859900; } - -.highlight .l { color: #93a1a1; } - -.highlight .n { color: #93a1a1; } - -.highlight .o { color: #859900; } - -.highlight .x { color: #cb4b16; } - -.highlight .p { color: #93a1a1; } - -.highlight .cm { color: #586e75; } - -.highlight .cp { color: #859900; } - -.highlight .c1 { color: #586e75; } - -.highlight .cs { color: #859900; } - -.highlight .gd { color: #2aa198; } - -.highlight .ge { font-style: italic; color: #93a1a1; } - -.highlight .gr { color: #dc322f; } - -.highlight .gh { color: #cb4b16; } - -.highlight .gi { color: #859900; } - -.highlight .go { color: #93a1a1; } - -.highlight .gp { color: #93a1a1; } - -.highlight .gs { font-weight: bold; color: #93a1a1; } - -.highlight .gu { color: #cb4b16; } - -.highlight .gt { color: #93a1a1; } - -.highlight .kc { color: #cb4b16; } - -.highlight .kd { color: #268bd2; } - -.highlight .kn { color: #859900; } - -.highlight .kp { color: #859900; } - -.highlight .kr { color: #268bd2; } - -.highlight .kt { color: #dc322f; } - -.highlight .ld { color: #93a1a1; } +div.highlighter-rouge, div.listingblock > div.content, figure.highlight { margin-top: 0; margin-bottom: 0.75rem; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; position: relative; padding: 0; } +div.highlighter-rouge > button, div.listingblock > div.content > button, figure.highlight > button { width: 0.75rem; opacity: 0; position: absolute; top: 0; right: 0; border: 0.75rem solid #f5f6fa; background-color: #f5f6fa; color: #5c5962; box-sizing: content-box; } +div.highlighter-rouge > button svg, div.listingblock > div.content > button svg, figure.highlight > button svg { fill: #5c5962; } +div.highlighter-rouge > button:active, div.listingblock > div.content > button:active, figure.highlight > button:active { text-decoration: none; outline: none; opacity: 1; } +div.highlighter-rouge > button:focus, div.listingblock > div.content > button:focus, figure.highlight > button:focus { opacity: 1; } +div.highlighter-rouge:hover > button, div.listingblock > div.content:hover > button, figure.highlight:hover > button { cursor: copy; opacity: 1; } -.highlight .m { color: #2aa198; } +div.highlighter-rouge div.highlight { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } -.highlight .s { color: #2aa198; } +div.listingblock { margin-top: 0; margin-bottom: 0.75rem; } +div.listingblock div.content { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.listingblock div.content > pre, div.listingblock code { padding: 0; margin: 0; border: 0; } -.highlight .na { color: #555; } +figure.highlight pre, figure.highlight :not(pre) > code { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } -.highlight .nb { color: #b58900; } - -.highlight .nc { color: #268bd2; } - -.highlight .no { color: #cb4b16; } - -.highlight .nd { color: #268bd2; } - -.highlight .ni { color: #cb4b16; } - -.highlight .ne { color: #cb4b16; } - -.highlight .nf { color: #268bd2; } - -.highlight .nl { color: #555; } - -.highlight .nn { color: #93a1a1; } - -.highlight .nx { color: #555; } - -.highlight .py { color: #93a1a1; } - -.highlight .nt { color: #268bd2; } - -.highlight .nv { color: #268bd2; } - -.highlight .ow { color: #859900; } - -.highlight .w { color: #93a1a1; } - -.highlight .mf { color: #2aa198; } - -.highlight .mh { color: #2aa198; } - -.highlight .mi { color: #2aa198; } - -.highlight .mo { color: #2aa198; } - -.highlight .sb { color: #586e75; } - -.highlight .sc { color: #2aa198; } - -.highlight .sd { color: #93a1a1; } - -.highlight .s2 { color: #2aa198; } - -.highlight .se { color: #cb4b16; } - -.highlight .sh { color: #93a1a1; } - -.highlight .si { color: #2aa198; } - -.highlight .sx { color: #2aa198; } - -.highlight .sr { color: #dc322f; } - -.highlight .s1 { color: #2aa198; } - -.highlight .ss { color: #2aa198; } - -.highlight .bp { color: #268bd2; } - -.highlight .vc { color: #268bd2; } +.highlight .table-wrapper { padding: 0.75rem 0; margin: 0; border: 0; box-shadow: none; } +.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.6875rem !important; min-width: 0; padding: 0; background-color: #f5f6fa; border: 0; } +@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.75rem !important; } } +.highlight .table-wrapper td.gl { width: 1em; padding-right: 0.75rem; padding-left: 0.75rem; } +.highlight .table-wrapper pre { margin: 0; line-height: 2; } -.highlight .vg { color: #268bd2; } +.code-example, .listingblock > .title { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #eeebee; border-radius: 4px; } +.code-example + .highlighter-rouge, .code-example + .sectionbody .listingblock, .code-example + .content, .code-example + figure.highlight, .listingblock > .title + .highlighter-rouge, .listingblock > .title + .sectionbody .listingblock, .listingblock > .title + .content, .listingblock > .title + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #eeebee; border-bottom: 1px solid #eeebee; border-left: 1px solid #eeebee; border-top-left-radius: 0; border-top-right-radius: 0; } -.highlight .vi { color: #268bd2; } +code.language-mermaid { padding: 0; background-color: inherit; border: 0; } -.highlight .il { color: #2aa198; } +.highlight, pre.highlight { background: #f5f6fa; color: #5c5962; } -.code-example { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #eeebee; border-radius: 4px; } -.code-example + .highlighter-rouge, .code-example + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #eeebee; border-bottom: 1px solid #eeebee; border-left: 1px solid #eeebee; border-top-left-radius: 0; border-top-right-radius: 0; } +.highlight pre { background: #f5f6fa; } .text-grey-dk-000 { color: #959396 !important; } @@ -1014,35 +1034,35 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; .v-align-top { vertical-align: top !important; } -.fs-1 { font-size: 9px !important; } -@media (min-width: 31.25rem) { .fs-1 { font-size: 10px !important; } } +.fs-1 { font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .fs-1 { font-size: 0.625rem !important; } } -.fs-2 { font-size: 11px !important; } -@media (min-width: 31.25rem) { .fs-2 { font-size: 12px !important; } } +.fs-2 { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .fs-2 { font-size: 0.75rem !important; } } -.fs-3 { font-size: 12px !important; } -@media (min-width: 31.25rem) { .fs-3 { font-size: 14px !important; } } +.fs-3 { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .fs-3 { font-size: 0.875rem !important; } } -.fs-4 { font-size: 14px !important; } -@media (min-width: 31.25rem) { .fs-4 { font-size: 16px !important; } } +.fs-4 { font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .fs-4 { font-size: 1rem !important; } } -.fs-5 { font-size: 16px !important; } -@media (min-width: 31.25rem) { .fs-5 { font-size: 18px !important; } } +.fs-5 { font-size: 1rem !important; } +@media (min-width: 31.25rem) { .fs-5 { font-size: 1.125rem !important; } } -.fs-6 { font-size: 18px !important; } -@media (min-width: 31.25rem) { .fs-6 { font-size: 24px !important; line-height: 1.25; } } +.fs-6 { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { .fs-6 { font-size: 1.5rem !important; line-height: 1.25; } } -.fs-7 { font-size: 24px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-7 { font-size: 32px !important; } } +.fs-7 { font-size: 1.5rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-7 { font-size: 2rem !important; } } -.fs-8 { font-size: 32px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-8 { font-size: 36px !important; } } +.fs-8 { font-size: 2rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-8 { font-size: 2.25rem !important; } } -.fs-9 { font-size: 36px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-9 { font-size: 42px !important; } } +.fs-9 { font-size: 2.25rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-9 { font-size: 2.625rem !important; } } -.fs-10 { font-size: 42px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-10 { font-size: 48px !important; } } +.fs-10 { font-size: 2.625rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-10 { font-size: 3rem !important; } } .fw-300 { font-weight: 300 !important; } @@ -2251,7 +2271,12 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; @media print { .site-footer, .site-button, #edit-this-page, #back-to-top, .site-nav, .main-header { display: none !important; } .side-bar { width: 100%; height: auto; border-right: 0 !important; } .site-header { border-bottom: 1px solid #eeebee; } - .site-title { font-size: 16px !important; font-weight: 700 !important; } + .site-title { font-size: 1rem !important; font-weight: 700 !important; } .text-small { font-size: 8pt !important; } pre.highlight { border: 1px solid #eeebee; } .main { max-width: none; margin-left: 0; } } +a.skip-to-main { left: -999px; position: absolute; top: auto; width: 1px; height: 1px; overflow: hidden; z-index: -999; } + +a.skip-to-main:focus, a.skip-to-main:active { color: #2869e6; background-color: #fff; left: auto; top: auto; width: 30%; height: auto; overflow: auto; margin: 10px 35%; padding: 5px; border-radius: 15px; border: 4px solid #5e41d0; text-align: center; font-size: 1.2em; z-index: 999; } + +div.opaque { background-color: #fff; } diff --git a/assets/css/just-the-docs-head-nav.css b/assets/css/just-the-docs-head-nav.css new file mode 100644 index 000000000..3a6c14bfe --- /dev/null +++ b/assets/css/just-the-docs-head-nav.css @@ -0,0 +1,3 @@ +div.opaque { background-color: #fff; } + +.nav-list .nav-list-item .nav-list-link { background-image: linear-gradient(-90deg, #ebedf5 0%, rgba(235, 237, 245, 0.8) 80%, rgba(235, 237, 245, 0) 100%); } diff --git a/assets/css/just-the-docs-light.css b/assets/css/just-the-docs-light.css index 49214f2ad..342d41039 100644 --- a/assets/css/just-the-docs-light.css +++ b/assets/css/just-the-docs-light.css @@ -1,4 +1,136 @@ @charset "UTF-8"; +.highlight, pre.highlight { background: #f9f9f9; color: #383942; } + +.highlight pre { background: #f9f9f9; } + +.highlight .hll { background: #f9f9f9; } + +.highlight .c { color: #9fa0a6; font-style: italic; } + +.highlight .err { color: #fff; background-color: #e05151; } + +.highlight .k { color: #a625a4; } + +.highlight .l { color: #50a04f; } + +.highlight .n { color: #383942; } + +.highlight .o { color: #383942; } + +.highlight .p { color: #383942; } + +.highlight .cm { color: #9fa0a6; font-style: italic; } + +.highlight .cp { color: #9fa0a6; font-style: italic; } + +.highlight .c1 { color: #9fa0a6; font-style: italic; } + +.highlight .cs { color: #9fa0a6; font-style: italic; } + +.highlight .ge { font-style: italic; } + +.highlight .gs { font-weight: 700; } + +.highlight .kc { color: #a625a4; } + +.highlight .kd { color: #a625a4; } + +.highlight .kn { color: #a625a4; } + +.highlight .kp { color: #a625a4; } + +.highlight .kr { color: #a625a4; } + +.highlight .kt { color: #a625a4; } + +.highlight .ld { color: #50a04f; } + +.highlight .m { color: #b66a00; } + +.highlight .s { color: #50a04f; } + +.highlight .na { color: #b66a00; } + +.highlight .nb { color: #ca7601; } + +.highlight .nc { color: #ca7601; } + +.highlight .no { color: #ca7601; } + +.highlight .nd { color: #ca7601; } + +.highlight .ni { color: #ca7601; } + +.highlight .ne { color: #ca7601; } + +.highlight .nf { color: #383942; } + +.highlight .nl { color: #ca7601; } + +.highlight .nn { color: #383942; } + +.highlight .nx { color: #383942; } + +.highlight .py { color: #ca7601; } + +.highlight .nt { color: #e35549; } + +.highlight .nv { color: #ca7601; } + +.highlight .ow { font-weight: 700; } + +.highlight .w { color: #f8f8f2; } + +.highlight .mf { color: #b66a00; } + +.highlight .mh { color: #b66a00; } + +.highlight .mi { color: #b66a00; } + +.highlight .mo { color: #b66a00; } + +.highlight .sb { color: #50a04f; } + +.highlight .sc { color: #50a04f; } + +.highlight .sd { color: #50a04f; } + +.highlight .s2 { color: #50a04f; } + +.highlight .se { color: #50a04f; } + +.highlight .sh { color: #50a04f; } + +.highlight .si { color: #50a04f; } + +.highlight .sx { color: #50a04f; } + +.highlight .sr { color: #0083bb; } + +.highlight .s1 { color: #50a04f; } + +.highlight .ss { color: #0083bb; } + +.highlight .bp { color: #ca7601; } + +.highlight .vc { color: #ca7601; } + +.highlight .vg { color: #ca7601; } + +.highlight .vi { color: #e35549; } + +.highlight .il { color: #b66a00; } + +.highlight .gu { color: #75715e; } + +.highlight .gd { color: #e05151; } + +.highlight .gi { color: #43d089; } + +.highlight .language-json .w + .s2 { color: #e35549; } + +.highlight .language-json .kc { color: #0083bb; } + /*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */ /* Document ========================================================================== */ /** 1. Correct the line height in all browsers. 2. Prevent adjustments of font size after orientation changes in iOS. */ @@ -108,27 +240,27 @@ template { display: none; } /** Add the correct display in IE 10. */ [hidden] { display: none; } -* { box-sizing: border-box; } +:root { color-scheme: light; } -::selection { color: #fff; background: #7253ed; } +* { box-sizing: border-box; } -html { font-size: 14px !important; scroll-behavior: smooth; } -@media (min-width: 31.25rem) { html { font-size: 16px !important; } } +html { font-size: 0.875rem !important; scroll-behavior: smooth; } +@media (min-width: 31.25rem) { html { font-size: 1rem !important; } } -body { font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; font-size: inherit; line-height: 1.4; color: #5c5962; background-color: #fff; } +body { font-family: system-ui, -apple-system, blinkmacsystemfont, "Segoe UI", roboto, "Helvetica Neue", arial, sans-serif, "Segoe UI Emoji"; font-size: inherit; line-height: 1.4; color: #5c5962; background-color: #fff; overflow-wrap: break-word; } ol, ul, dl, pre, address, blockquote, table, div, hr, form, fieldset, noscript .table-wrapper { margin-top: 0; } -h1, h2, h3, h4, h5, h6 { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #27262b; } +h1, h2, h3, h4, h5, h6, #toctitle { margin-top: 0; margin-bottom: 1em; font-weight: 500; line-height: 1.25; color: #27262b; } p { margin-top: 1em; margin-bottom: 1em; } a { color: #7253ed; text-decoration: none; } -a:not([class]) { text-decoration: none; background-image: linear-gradient(#eeebee 0%, #eeebee 100%); background-repeat: repeat-x; background-position: 0 100%; background-size: 1px 1px; } -a:not([class]):hover { background-image: linear-gradient(rgba(114, 83, 237, 0.45) 0%, rgba(114, 83, 237, 0.45) 100%); background-size: 1px 1px; } +a:not([class]) { text-decoration: underline; text-decoration-color: #eeebee; text-underline-offset: 2px; } +a:not([class]):hover { text-decoration-color: rgba(114, 83, 237, 0.45); } -code { font-family: "SFMono-Regular", Menlo, Consolas, Monospace; font-size: 0.75em; line-height: 1.4; } +code { font-family: "SFMono-Regular", menlo, consolas, monospace; font-size: 0.75em; line-height: 1.4; } figure, pre { margin: 0; } @@ -138,35 +270,37 @@ img { max-width: 100%; height: auto; } hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #eeebee; border: 0; } +blockquote { margin: 10px 0; margin-block-start: 0; margin-inline-start: 0; padding-left: 1rem; border-left: 3px solid #eeebee; } + .side-bar { z-index: 0; display: flex; flex-wrap: wrap; background-color: #f5f6fa; } -@media (min-width: 50rem) { .side-bar { flex-wrap: nowrap; position: fixed; width: 248px; height: 100%; flex-direction: column; border-right: 1px solid #eeebee; align-items: flex-end; } } -@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 1064px) / 2 + 264px); min-width: 264px; } } +@media (min-width: 50rem) { .side-bar { flex-flow: column nowrap; position: fixed; width: 15.5rem; height: 100%; border-right: 1px solid #eeebee; align-items: flex-end; } } +@media (min-width: 66.5rem) { .side-bar { width: calc((100% - 66.5rem) / 2 + 16.5rem); min-width: 16.5rem; } } -@media (min-width: 50rem) { .main { position: relative; max-width: 800px; margin-left: 248px; } } -@media (min-width: 66.5rem) { .main { margin-left: calc( (100% - 1064px) / 2 + 264px ); } } +@media (min-width: 50rem) { .main { position: relative; max-width: 50rem; margin-left: 15.5rem; } } +@media (min-width: 66.5rem) { .main { margin-left: Max(16.5rem, calc((100% - 66.5rem) / 2 + 16.5rem)); } } .main-content-wrap { padding-right: 1rem; padding-left: 1rem; padding-top: 1rem; padding-bottom: 1rem; } @media (min-width: 50rem) { .main-content-wrap { padding-right: 2rem; padding-left: 2rem; } } @media (min-width: 50rem) { .main-content-wrap { padding-top: 2rem; padding-bottom: 2rem; } } .main-header { z-index: 0; display: none; background-color: #f5f6fa; } -@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 60px; background-color: #fff; border-bottom: 1px solid #eeebee; } } +@media (min-width: 50rem) { .main-header { display: flex; justify-content: space-between; height: 3.75rem; background-color: #fff; border-bottom: 1px solid #eeebee; } } .main-header.nav-open { display: block; } @media (min-width: 50rem) { .main-header.nav-open { display: flex; } } .site-nav, .site-header, .site-footer { width: 100%; } -@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 264px; } } +@media (min-width: 66.5rem) { .site-nav, .site-header, .site-footer { width: 16.5rem; } } .site-nav { display: none; } .site-nav.nav-open { display: block; } @media (min-width: 50rem) { .site-nav { display: block; padding-top: 3rem; padding-bottom: 1rem; overflow-y: auto; flex: 1 1 auto; } } -.site-header { display: flex; min-height: 60px; align-items: center; } -@media (min-width: 50rem) { .site-header { height: 60px; max-height: 60px; border-bottom: 1px solid #eeebee; } } +.site-header { display: flex; min-height: 3.75rem; align-items: center; } +@media (min-width: 50rem) { .site-header { height: 3.75rem; max-height: 3.75rem; border-bottom: 1px solid #eeebee; } } -.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #27262b; font-size: 18px !important; } +.site-title { padding-right: 1rem; padding-left: 1rem; flex-grow: 1; display: flex; height: 100%; align-items: center; padding-top: 0.75rem; padding-bottom: 0.75rem; color: #27262b; font-size: 1.125rem !important; } @media (min-width: 50rem) { .site-title { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-title { font-size: 24px !important; line-height: 1.25; } } +@media (min-width: 31.25rem) { .site-title { font-size: 1.5rem !important; line-height: 1.25; } } @media (min-width: 50rem) { .site-title { padding-top: 0.5rem; padding-bottom: 0.5rem; } } .site-button { display: flex; height: 100%; padding: 1rem; align-items: center; } @@ -179,31 +313,29 @@ hr { height: 1px; padding: 0; margin: 2rem 0; background-color: #eeebee; border: body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } @media (min-width: 50rem) { body { position: static; padding-bottom: 0; } } -.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 11px !important; } +.site-footer { padding-right: 1rem; padding-left: 1rem; position: absolute; bottom: 0; left: 0; padding-top: 1rem; padding-bottom: 1rem; color: #959396; font-size: 0.6875rem !important; } @media (min-width: 50rem) { .site-footer { padding-right: 2rem; padding-left: 2rem; } } -@media (min-width: 31.25rem) { .site-footer { font-size: 12px !important; } } +@media (min-width: 31.25rem) { .site-footer { font-size: 0.75rem !important; } } @media (min-width: 50rem) { .site-footer { position: static; justify-self: end; } } .icon { width: 1.5rem; height: 1.5rem; color: #7253ed; } .main-content { line-height: 1.6; } .main-content ol, .main-content ul, .main-content dl, .main-content pre, .main-content address, .main-content blockquote, .main-content .table-wrapper { margin-top: 0.5em; } -.main-content a { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.main-content a { overflow: hidden; text-overflow: ellipsis; } .main-content ul, .main-content ol { padding-left: 1.5em; } .main-content li .highlight { margin-top: 0.25rem; } .main-content ol { list-style-type: none; counter-reset: step-counter; } .main-content ol > li { position: relative; } -.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 12px !important; } -@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 14px !important; } } +.main-content ol > li::before { position: absolute; top: 0.2em; left: -1.6em; color: #959396; content: counter(step-counter); counter-increment: step-counter; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .main-content ol > li::before { font-size: 0.875rem !important; } } @media (min-width: 31.25rem) { .main-content ol > li::before { top: 0.11em; } } .main-content ol > li ol { counter-reset: sub-counter; } -.main-content ol > li ol li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } +.main-content ol > li ol > li::before { content: counter(sub-counter,lower-alpha); counter-increment: sub-counter; } .main-content ul { list-style: none; } .main-content ul > li::before { position: absolute; margin-left: -1.4em; color: #959396; content: "•"; } -.main-content .task-list { padding-left: 0; } -.main-content .task-list-item { display: flex; align-items: center; } .main-content .task-list-item::before { content: ""; } -.main-content .task-list-item-checkbox { margin-right: 0.6em; } +.main-content .task-list-item-checkbox { margin-right: 0.6em; margin-left: -1.4em; } .main-content hr + * { margin-top: 0; } .main-content h1:first-of-type { margin-top: 0.5em; } .main-content dl { display: grid; grid-template: auto / 10em 1fr; } @@ -216,25 +348,26 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .main-content .anchor-heading { position: absolute; right: -1rem; width: 1.5rem; height: 100%; padding-right: 0.25rem; padding-left: 0.25rem; overflow: visible; } @media (min-width: 50rem) { .main-content .anchor-heading { right: auto; left: -1.5rem; } } .main-content .anchor-heading svg { display: inline-block; width: 100%; height: 100%; color: #7253ed; visibility: hidden; } -.main-content .anchor-heading:hover svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } +.main-content .anchor-heading:hover svg, .main-content .anchor-heading:focus svg, .main-content h1:hover > .anchor-heading svg, .main-content h2:hover > .anchor-heading svg, .main-content h3:hover > .anchor-heading svg, .main-content h4:hover > .anchor-heading svg, .main-content h5:hover > .anchor-heading svg, .main-content h6:hover > .anchor-heading svg { visibility: visible; } .main-content summary { cursor: pointer; } -.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6 { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } -.main-content h1:first-child, .main-content h2:first-child, .main-content h3:first-child, .main-content h4:first-child, .main-content h5:first-child, .main-content h6:first-child { margin-top: 0.5rem; } -.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge { margin-top: 1em; } -.main-content h1 + p, .main-content h2 + p, .main-content h3 + p, .main-content h4 + p, .main-content h5 + p, .main-content h6 + p { margin-top: 0; } +.main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6, .main-content #toctitle { position: relative; margin-top: 1.5em; margin-bottom: 0.25em; } +.main-content h1 + table, .main-content h1 + .table-wrapper, .main-content h1 + .code-example, .main-content h1 + .highlighter-rouge, .main-content h1 + .sectionbody .listingblock, .main-content h2 + table, .main-content h2 + .table-wrapper, .main-content h2 + .code-example, .main-content h2 + .highlighter-rouge, .main-content h2 + .sectionbody .listingblock, .main-content h3 + table, .main-content h3 + .table-wrapper, .main-content h3 + .code-example, .main-content h3 + .highlighter-rouge, .main-content h3 + .sectionbody .listingblock, .main-content h4 + table, .main-content h4 + .table-wrapper, .main-content h4 + .code-example, .main-content h4 + .highlighter-rouge, .main-content h4 + .sectionbody .listingblock, .main-content h5 + table, .main-content h5 + .table-wrapper, .main-content h5 + .code-example, .main-content h5 + .highlighter-rouge, .main-content h5 + .sectionbody .listingblock, .main-content h6 + table, .main-content h6 + .table-wrapper, .main-content h6 + .code-example, .main-content h6 + .highlighter-rouge, .main-content h6 + .sectionbody .listingblock, .main-content #toctitle + table, .main-content #toctitle + .table-wrapper, .main-content #toctitle + .code-example, .main-content #toctitle + .highlighter-rouge, .main-content #toctitle + .sectionbody .listingblock { margin-top: 1em; } +.main-content h1 + p:not(.label), .main-content h2 + p:not(.label), .main-content h3 + p:not(.label), .main-content h4 + p:not(.label), .main-content h5 + p:not(.label), .main-content h6 + p:not(.label), .main-content #toctitle + p:not(.label) { margin-top: 0; } +.main-content > h1:first-child, .main-content > h2:first-child, .main-content > h3:first-child, .main-content > h4:first-child, .main-content > h5:first-child, .main-content > h6:first-child, .main-content > .sect1:first-child > h2, .main-content > .sect2:first-child > h3, .main-content > .sect3:first-child > h4, .main-content > .sect4:first-child > h5, .main-content > .sect5:first-child > h6 { margin-top: 0.5rem; } .nav-list { padding: 0; margin-top: 0; margin-bottom: 0; list-style: none; } -.nav-list .nav-list-item { font-size: 14px !important; position: relative; margin: 0; } -@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 16px !important; } } -@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 14px !important; } } +.nav-list .nav-list-item { font-size: 0.875rem !important; position: relative; margin: 0; } +@media (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 1rem !important; } } +@media (min-width: 50rem) { .nav-list .nav-list-item { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .nav-list .nav-list-item { font-size: 0.875rem !important; } } .nav-list .nav-list-item .nav-list-link { display: block; min-height: 3rem; padding-top: 0.25rem; padding-bottom: 0.25rem; line-height: 2.5rem; padding-right: 3rem; padding-left: 1rem; } @media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-link { min-height: 2rem; line-height: 1.5rem; padding-right: 2rem; padding-left: 2rem; } } +.nav-list .nav-list-item .nav-list-link.external > svg { width: 1rem; height: 1rem; vertical-align: text-bottom; } .nav-list .nav-list-item .nav-list-link.active { font-weight: 600; text-decoration: none; } .nav-list .nav-list-item .nav-list-link:hover, .nav-list .nav-list-item .nav-list-link.active { background-image: linear-gradient(-90deg, #ebedf5 0%, rgba(235, 237, 245, 0.8) 80%, rgba(235, 237, 245, 0) 100%); } -.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding-top: 0.75rem; padding-right: 0.75rem; padding-bottom: 0.75rem; padding-left: 0.75rem; color: #7253ed; } -@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding-top: 0.5rem; padding-right: 0.5rem; padding-bottom: 0.5rem; padding-left: 0.5rem; } } +.nav-list .nav-list-item .nav-list-expander { position: absolute; right: 0; width: 3rem; height: 3rem; padding: 0.75rem; color: #7253ed; } +@media (min-width: 50rem) { .nav-list .nav-list-item .nav-list-expander { width: 2rem; height: 2rem; padding: 0.5rem; } } .nav-list .nav-list-item .nav-list-expander:hover { background-image: linear-gradient(-90deg, #ebedf5 0%, rgba(235, 237, 245, 0.8) 100%); } .nav-list .nav-list-item .nav-list-expander svg { transform: rotate(90deg); } .nav-list .nav-list-item > .nav-list { display: none; padding-left: 0.75rem; list-style: none; } @@ -244,13 +377,18 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .nav-list .nav-list-item.active > .nav-list-expander svg { transform: rotate(-90deg); } .nav-list .nav-list-item.active > .nav-list { display: block; } -.nav-category { padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 1rem; font-weight: 600; text-align: end; text-transform: uppercase; border-bottom: 1px solid #eeebee; font-size: 11px !important; } -@media (min-width: 31.25rem) { .nav-category { font-size: 12px !important; } } -@media (min-width: 50rem) { .nav-category { padding-right: 2rem; padding-left: 2rem; margin-top: 1rem; text-align: start; } +.nav-category { padding: 0.5rem 1rem; font-weight: 600; text-align: start; text-transform: uppercase; border-bottom: 1px solid #eeebee; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .nav-category { font-size: 0.75rem !important; } } +@media (min-width: 50rem) { .nav-category { padding: 0.5rem 2rem; margin-top: 1rem; text-align: start; } .nav-category:first-child { margin-top: 0; } } -.aux-nav { height: 100%; overflow-x: auto; font-size: 11px !important; } -@media (min-width: 31.25rem) { .aux-nav { font-size: 12px !important; } } +.nav-list.nav-category-list > .nav-list-item { margin: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list { padding: 0; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-link { color: #7253ed; } +.nav-list.nav-category-list > .nav-list-item > .nav-list > .nav-list-item > .nav-list-expander { color: #7253ed; } + +.aux-nav { height: 100%; overflow-x: auto; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .aux-nav { font-size: 0.75rem !important; } } .aux-nav .aux-nav-list { display: flex; height: 100%; padding: 0; margin: 0; list-style: none; } .aux-nav .aux-nav-list-item { display: inline-block; height: 100%; padding: 0; margin: 0; } @media (min-width: 50rem) { .aux-nav { padding-right: 1rem; } } @@ -259,36 +397,36 @@ body { position: relative; padding-bottom: 4rem; overflow-y: scroll; } .breadcrumb-nav-list { padding-left: 0; margin-bottom: 0.75rem; list-style: none; } -.breadcrumb-nav-list-item { display: table-cell; font-size: 11px !important; } -@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 12px !important; } } +.breadcrumb-nav-list-item { display: table-cell; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .breadcrumb-nav-list-item { font-size: 0.75rem !important; } } .breadcrumb-nav-list-item::before { display: none; } .breadcrumb-nav-list-item::after { display: inline-block; margin-right: 0.5rem; margin-left: 0.5rem; color: #959396; content: "/"; } .breadcrumb-nav-list-item:last-child::after { content: ""; } -h1, .text-alpha { font-size: 32px !important; line-height: 1.25; font-weight: 300; } -@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 36px !important; } } +h1, .text-alpha { font-size: 2rem !important; line-height: 1.25; font-weight: 300; } +@media (min-width: 31.25rem) { h1, .text-alpha { font-size: 2.25rem !important; } } -h2, .text-beta { font-size: 18px !important; } -@media (min-width: 31.25rem) { h2, .text-beta { font-size: 24px !important; line-height: 1.25; } } +h2, .text-beta, #toctitle { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { h2, .text-beta, #toctitle { font-size: 1.5rem !important; line-height: 1.25; } } -h3, .text-gamma { font-size: 16px !important; } -@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 18px !important; } } +h3, .text-gamma { font-size: 1rem !important; } +@media (min-width: 31.25rem) { h3, .text-gamma { font-size: 1.125rem !important; } } -h4, .text-delta { font-size: 11px !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } -@media (min-width: 31.25rem) { h4, .text-delta { font-size: 12px !important; } } +h4, .text-delta { font-size: 0.6875rem !important; font-weight: 400; text-transform: uppercase; letter-spacing: 0.1em; } +@media (min-width: 31.25rem) { h4, .text-delta { font-size: 0.75rem !important; } } h4 code { text-transform: none; } -h5, .text-epsilon { font-size: 12px !important; color: #44434d; } -@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 14px !important; } } +h5, .text-epsilon { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { h5, .text-epsilon { font-size: 0.875rem !important; } } -h6, .text-zeta { font-size: 11px !important; color: #44434d; } -@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 12px !important; } } +h6, .text-zeta { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { h6, .text-zeta { font-size: 0.75rem !important; } } -.text-small { font-size: 11px !important; } -@media (min-width: 31.25rem) { .text-small { font-size: 12px !important; } } +.text-small { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .text-small { font-size: 0.75rem !important; } } -.text-mono { font-family: "SFMono-Regular", Menlo, Consolas, Monospace !important; } +.text-mono { font-family: "SFMono-Regular", menlo, consolas, monospace !important; } .text-left { text-align: left !important; } @@ -296,18 +434,18 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .text-right { text-align: right !important; } -.label, .label-blue { display: inline-block; padding-top: 0.16em; padding-right: 0.56em; padding-bottom: 0.16em; padding-left: 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 11px !important; border-radius: 12px; } -@media (min-width: 31.25rem) { .label, .label-blue { font-size: 12px !important; } } +.label:not(g), .label-blue:not(g) { display: inline-block; padding: 0.16em 0.56em; margin-right: 0.5rem; margin-left: 0.5rem; color: #fff; text-transform: uppercase; vertical-align: middle; background-color: #2869e6; font-size: 0.6875rem !important; border-radius: 12px; } +@media (min-width: 31.25rem) { .label:not(g), .label-blue:not(g) { font-size: 0.75rem !important; } } -.label-green { background-color: #009c7b; } +.label-green:not(g) { background-color: #009c7b; } -.label-purple { background-color: #5e41d0; } +.label-purple:not(g) { background-color: #5e41d0; } -.label-red { background-color: #e94c4c; } +.label-red:not(g) { background-color: #e94c4c; } -.label-yellow { color: #44434d; background-color: #f7d12e; } +.label-yellow:not(g) { color: #44434d; background-color: #f7d12e; } -.btn { display: inline-block; box-sizing: border-box; padding-top: 0.3em; padding-right: 1em; padding-bottom: 0.3em; padding-left: 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #7253ed; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #f7f7f7; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } +.btn { display: inline-block; box-sizing: border-box; padding: 0.3em 1em; margin: 0; font-family: inherit; font-size: inherit; font-weight: 500; line-height: 1.5; color: #7253ed; text-decoration: none; vertical-align: baseline; cursor: pointer; background-color: #f7f7f7; border-width: 0; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); appearance: none; } .btn:focus { text-decoration: none; outline: none; box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:focus:hover, .btn.selected:focus { box-shadow: 0 0 0 3px rgba(0, 0, 255, 0.25); } .btn:hover, .btn.zeroclipboard-is-hover { color: #6a4aec; } @@ -341,14 +479,16 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .btn-green:active, .btn-green.selected, .btn-green.zeroclipboard-is-active { background-color: #0f9e73; background-image: none; box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15); } .btn-green.selected:hover { background-color: #0d8662; } +.btn-reset { background: none; border: none; margin: 0; text-align: inherit; font: inherit; border-radius: 0; appearance: none; } + .search { position: relative; z-index: 2; flex-grow: 1; height: 4rem; padding: 0.5rem; transition: padding linear 200ms; } @media (min-width: 50rem) { .search { position: relative !important; width: auto !important; height: 100% !important; padding: 0; transition: none; } } .search-input-wrap { position: relative; z-index: 1; height: 3rem; overflow: hidden; border-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); transition: height linear 200ms; } -@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 536px; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } +@media (min-width: 50rem) { .search-input-wrap { position: absolute; width: 100%; max-width: 33.5rem; height: 100% !important; border-radius: 0; box-shadow: none; transition: width ease 400ms; } } -.search-input { position: absolute; width: 100%; height: 100%; padding-top: 0.5rem; padding-right: 1rem; padding-bottom: 0.5rem; padding-left: 2.5rem; font-size: 16px; background-color: #fff; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } -@media (min-width: 50rem) { .search-input { padding-top: 1rem; padding-bottom: 1rem; padding-left: 3.5rem; font-size: 14px; background-color: #fff; transition: padding-left linear 200ms; } } +.search-input { position: absolute; width: 100%; height: 100%; padding: 0.5rem 1rem 0.5rem 2.5rem; font-size: 1rem; color: #5c5962; background-color: #fff; border-top: 0; border-right: 0; border-bottom: 0; border-left: 0; border-radius: 0; } +@media (min-width: 50rem) { .search-input { padding: 0.5rem 1rem 0.5rem 3.5rem; font-size: 0.875rem; background-color: #fff; transition: padding-left linear 200ms; } } .search-input:focus { outline: 0; } .search-input:focus + .search-label .search-icon { color: #7253ed; } @@ -357,45 +497,45 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-label .search-icon { width: 1.2rem; height: 1.2rem; align-self: center; color: #959396; } .search-results { position: absolute; left: 0; display: none; width: 100%; max-height: calc(100% - 4rem); overflow-y: auto; background-color: #fff; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } -@media (min-width: 50rem) { .search-results { top: 100%; width: 536px; max-height: calc(100vh - 200%) !important; } } +@media (min-width: 50rem) { .search-results { top: 100%; width: 33.5rem; max-height: calc(100vh - 200%) !important; } } -.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 14px !important; } -@media (min-width: 31.25rem) { .search-results-list { font-size: 16px !important; } } -@media (min-width: 50rem) { .search-results-list { font-size: 12px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 14px !important; } } +.search-results-list { padding-left: 0; margin-bottom: 0.25rem; list-style: none; font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .search-results-list { font-size: 1rem !important; } } +@media (min-width: 50rem) { .search-results-list { font-size: 0.75rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-results-list { font-size: 0.875rem !important; } } .search-results-list-item { padding: 0; margin: 0; } -.search-result { display: block; padding-top: 0.25rem; padding-right: 0.75rem; padding-bottom: 0.25rem; padding-left: 0.75rem; } +.search-result { display: block; padding: 0.25rem 0.75rem; } .search-result:hover, .search-result.active { background-color: #ebedf5; } .search-result-title { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; } @media (min-width: 31.25rem) { .search-result-title { display: inline-block; width: 40%; padding-right: 0.5rem; vertical-align: top; } } .search-result-doc { display: flex; align-items: center; word-wrap: break-word; } -.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 14px !important; } } -@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 11px !important; } } -@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 12px !important; } } +.search-result-doc.search-result-doc-parent { opacity: 0.5; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.875rem !important; } } +@media (min-width: 50rem) { .search-result-doc.search-result-doc-parent { font-size: 0.6875rem !important; } } +@media (min-width: 50rem) and (min-width: 31.25rem) { .search-result-doc.search-result-doc-parent { font-size: 0.75rem !important; } } .search-result-doc .search-result-icon { width: 1rem; height: 1rem; margin-right: 0.5rem; color: #7253ed; flex-shrink: 0; } .search-result-doc .search-result-doc-title { overflow: auto; } .search-result-section { margin-left: 1.5rem; word-wrap: break-word; } -.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 9px !important; } -@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 10px !important; } } +.search-result-rel-url { display: block; margin-left: 1.5rem; overflow: hidden; color: #959396; text-overflow: ellipsis; white-space: nowrap; font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .search-result-rel-url { font-size: 0.625rem !important; } } -.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #eeebee; font-size: 11px !important; } -@media (min-width: 31.25rem) { .search-result-previews { font-size: 12px !important; } } +.search-result-previews { display: block; padding-top: 0.5rem; padding-bottom: 0.5rem; padding-left: 1rem; margin-left: 0.5rem; color: #959396; word-wrap: break-word; border-left: 1px solid; border-left-color: #eeebee; font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .search-result-previews { font-size: 0.75rem !important; } } @media (min-width: 31.25rem) { .search-result-previews { display: inline-block; width: 60%; padding-left: 0.5rem; margin-left: 0; vertical-align: top; } } .search-result-preview + .search-result-preview { margin-top: 0.25rem; } .search-result-highlight { font-weight: bold; } -.search-no-result { padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; font-size: 12px !important; } -@media (min-width: 31.25rem) { .search-no-result { font-size: 14px !important; } } +.search-no-result { padding: 0.5rem 0.75rem; font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .search-no-result { font-size: 0.875rem !important; } } .search-button { position: fixed; right: 1rem; bottom: 1rem; display: flex; width: 3.5rem; height: 3.5rem; background-color: #fff; border: 1px solid rgba(114, 83, 237, 0.3); border-radius: 1.75rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); align-items: center; justify-content: center; } @@ -403,7 +543,7 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } .search-active .search { position: fixed; top: 0; left: 0; width: 100%; height: 100%; padding: 0; } .search-active .search-input-wrap { height: 4rem; border-radius: 0; } -@media (min-width: 50rem) { .search-active .search-input-wrap { width: 536px; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } +@media (min-width: 50rem) { .search-active .search-input-wrap { width: 33.5rem; box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08); } } .search-active .search-input { background-color: #fff; } @media (min-width: 50rem) { .search-active .search-input { padding-left: 2.3rem; } } @media (min-width: 50rem) { .search-active .search-label { padding-left: 0.6rem; } } @@ -417,8 +557,8 @@ h6, .text-zeta { font-size: 11px !important; color: #44434d; } table { display: table; min-width: 100%; border-collapse: separate; } -th, td { font-size: 12px !important; min-width: 120px; padding-top: 0.5rem; padding-right: 0.75rem; padding-bottom: 0.5rem; padding-left: 0.75rem; background-color: #fff; border-bottom: 1px solid rgba(238, 235, 238, 0.5); border-left: 1px solid #eeebee; } -@media (min-width: 31.25rem) { th, td { font-size: 14px !important; } } +th, td { font-size: 0.75rem !important; min-width: 7.5rem; padding: 0.5rem 0.75rem; background-color: #fff; border-bottom: 1px solid rgba(238, 235, 238, 0.5); border-left: 1px solid #eeebee; } +@media (min-width: 31.25rem) { th, td { font-size: 0.875rem !important; } } th:first-of-type, td:first-of-type { border-left: 0; } tbody tr:last-of-type th, tbody tr:last-of-type td { border-bottom: 0; } @@ -426,160 +566,40 @@ tbody tr:last-of-type td { padding-bottom: 0.75rem; } thead th { border-bottom: 1px solid #eeebee; } -code { padding: 0.2em 0.15em; font-weight: 400; background-color: #f5f6fa; border: 1px solid #eeebee; border-radius: 4px; } +:not(pre, figure) > code { padding: 0.2em 0.15em; font-weight: 400; background-color: #f5f6fa; border: 1px solid #eeebee; border-radius: 4px; } a:visited code { border-color: #eeebee; } -div.highlighter-rouge { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; overflow-x: auto; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -div.highlighter-rouge div.highlight, div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } - -figure.highlight { padding: 0.75rem; margin-top: 0; margin-bottom: 0.75rem; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; } -figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; } - -.highlight .table-wrapper { padding: 0; margin: 0; border: 0; box-shadow: none; } -.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 11px !important; min-width: 0; padding: 0; background-color: #f5f6fa; border: 0; } -@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 12px !important; } } -.highlight .table-wrapper td.gl { padding-right: 0.75rem; } -.highlight .table-wrapper pre { margin: 0; line-height: 2; } - -.highlight .c { color: #586e75; } - -.highlight .err { color: #93a1a1; } - -.highlight .g { color: #93a1a1; } - -.highlight .k { color: #859900; } - -.highlight .l { color: #93a1a1; } - -.highlight .n { color: #93a1a1; } - -.highlight .o { color: #859900; } - -.highlight .x { color: #cb4b16; } - -.highlight .p { color: #93a1a1; } - -.highlight .cm { color: #586e75; } - -.highlight .cp { color: #859900; } - -.highlight .c1 { color: #586e75; } - -.highlight .cs { color: #859900; } - -.highlight .gd { color: #2aa198; } - -.highlight .ge { font-style: italic; color: #93a1a1; } - -.highlight .gr { color: #dc322f; } - -.highlight .gh { color: #cb4b16; } - -.highlight .gi { color: #859900; } - -.highlight .go { color: #93a1a1; } - -.highlight .gp { color: #93a1a1; } - -.highlight .gs { font-weight: bold; color: #93a1a1; } - -.highlight .gu { color: #cb4b16; } - -.highlight .gt { color: #93a1a1; } - -.highlight .kc { color: #cb4b16; } - -.highlight .kd { color: #268bd2; } - -.highlight .kn { color: #859900; } - -.highlight .kp { color: #859900; } - -.highlight .kr { color: #268bd2; } - -.highlight .kt { color: #dc322f; } - -.highlight .ld { color: #93a1a1; } +div.highlighter-rouge, div.listingblock > div.content, figure.highlight { margin-top: 0; margin-bottom: 0.75rem; background-color: #f5f6fa; border-radius: 4px; box-shadow: none; -webkit-overflow-scrolling: touch; position: relative; padding: 0; } +div.highlighter-rouge > button, div.listingblock > div.content > button, figure.highlight > button { width: 0.75rem; opacity: 0; position: absolute; top: 0; right: 0; border: 0.75rem solid #f5f6fa; background-color: #f5f6fa; color: #5c5962; box-sizing: content-box; } +div.highlighter-rouge > button svg, div.listingblock > div.content > button svg, figure.highlight > button svg { fill: #5c5962; } +div.highlighter-rouge > button:active, div.listingblock > div.content > button:active, figure.highlight > button:active { text-decoration: none; outline: none; opacity: 1; } +div.highlighter-rouge > button:focus, div.listingblock > div.content > button:focus, figure.highlight > button:focus { opacity: 1; } +div.highlighter-rouge:hover > button, div.listingblock > div.content:hover > button, figure.highlight:hover > button { cursor: copy; opacity: 1; } -.highlight .m { color: #2aa198; } +div.highlighter-rouge div.highlight { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.highlighter-rouge pre.highlight, div.highlighter-rouge code { padding: 0; margin: 0; border: 0; } -.highlight .s { color: #2aa198; } +div.listingblock { margin-top: 0; margin-bottom: 0.75rem; } +div.listingblock div.content { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } +div.listingblock div.content > pre, div.listingblock code { padding: 0; margin: 0; border: 0; } -.highlight .na { color: #555; } +figure.highlight pre, figure.highlight :not(pre) > code { overflow-x: auto; padding: 0.75rem; margin: 0; border: 0; } -.highlight .nb { color: #b58900; } - -.highlight .nc { color: #268bd2; } - -.highlight .no { color: #cb4b16; } - -.highlight .nd { color: #268bd2; } - -.highlight .ni { color: #cb4b16; } - -.highlight .ne { color: #cb4b16; } - -.highlight .nf { color: #268bd2; } - -.highlight .nl { color: #555; } - -.highlight .nn { color: #93a1a1; } - -.highlight .nx { color: #555; } - -.highlight .py { color: #93a1a1; } - -.highlight .nt { color: #268bd2; } - -.highlight .nv { color: #268bd2; } - -.highlight .ow { color: #859900; } - -.highlight .w { color: #93a1a1; } - -.highlight .mf { color: #2aa198; } - -.highlight .mh { color: #2aa198; } - -.highlight .mi { color: #2aa198; } - -.highlight .mo { color: #2aa198; } - -.highlight .sb { color: #586e75; } - -.highlight .sc { color: #2aa198; } - -.highlight .sd { color: #93a1a1; } - -.highlight .s2 { color: #2aa198; } - -.highlight .se { color: #cb4b16; } - -.highlight .sh { color: #93a1a1; } - -.highlight .si { color: #2aa198; } - -.highlight .sx { color: #2aa198; } - -.highlight .sr { color: #dc322f; } - -.highlight .s1 { color: #2aa198; } - -.highlight .ss { color: #2aa198; } - -.highlight .bp { color: #268bd2; } - -.highlight .vc { color: #268bd2; } +.highlight .table-wrapper { padding: 0.75rem 0; margin: 0; border: 0; box-shadow: none; } +.highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.6875rem !important; min-width: 0; padding: 0; background-color: #f5f6fa; border: 0; } +@media (min-width: 31.25rem) { .highlight .table-wrapper td, .highlight .table-wrapper pre { font-size: 0.75rem !important; } } +.highlight .table-wrapper td.gl { width: 1em; padding-right: 0.75rem; padding-left: 0.75rem; } +.highlight .table-wrapper pre { margin: 0; line-height: 2; } -.highlight .vg { color: #268bd2; } +.code-example, .listingblock > .title { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #eeebee; border-radius: 4px; } +.code-example + .highlighter-rouge, .code-example + .sectionbody .listingblock, .code-example + .content, .code-example + figure.highlight, .listingblock > .title + .highlighter-rouge, .listingblock > .title + .sectionbody .listingblock, .listingblock > .title + .content, .listingblock > .title + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #eeebee; border-bottom: 1px solid #eeebee; border-left: 1px solid #eeebee; border-top-left-radius: 0; border-top-right-radius: 0; } -.highlight .vi { color: #268bd2; } +code.language-mermaid { padding: 0; background-color: inherit; border: 0; } -.highlight .il { color: #2aa198; } +.highlight, pre.highlight { background: #f5f6fa; color: #5c5962; } -.code-example { padding: 0.75rem; margin-bottom: 0.75rem; overflow: auto; border: 1px solid #eeebee; border-radius: 4px; } -.code-example + .highlighter-rouge, .code-example + figure.highlight { position: relative; margin-top: -1rem; border-right: 1px solid #eeebee; border-bottom: 1px solid #eeebee; border-left: 1px solid #eeebee; border-top-left-radius: 0; border-top-right-radius: 0; } +.highlight pre { background: #f5f6fa; } .text-grey-dk-000 { color: #959396 !important; } @@ -1006,35 +1026,35 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; .v-align-top { vertical-align: top !important; } -.fs-1 { font-size: 9px !important; } -@media (min-width: 31.25rem) { .fs-1 { font-size: 10px !important; } } +.fs-1 { font-size: 0.5625rem !important; } +@media (min-width: 31.25rem) { .fs-1 { font-size: 0.625rem !important; } } -.fs-2 { font-size: 11px !important; } -@media (min-width: 31.25rem) { .fs-2 { font-size: 12px !important; } } +.fs-2 { font-size: 0.6875rem !important; } +@media (min-width: 31.25rem) { .fs-2 { font-size: 0.75rem !important; } } -.fs-3 { font-size: 12px !important; } -@media (min-width: 31.25rem) { .fs-3 { font-size: 14px !important; } } +.fs-3 { font-size: 0.75rem !important; } +@media (min-width: 31.25rem) { .fs-3 { font-size: 0.875rem !important; } } -.fs-4 { font-size: 14px !important; } -@media (min-width: 31.25rem) { .fs-4 { font-size: 16px !important; } } +.fs-4 { font-size: 0.875rem !important; } +@media (min-width: 31.25rem) { .fs-4 { font-size: 1rem !important; } } -.fs-5 { font-size: 16px !important; } -@media (min-width: 31.25rem) { .fs-5 { font-size: 18px !important; } } +.fs-5 { font-size: 1rem !important; } +@media (min-width: 31.25rem) { .fs-5 { font-size: 1.125rem !important; } } -.fs-6 { font-size: 18px !important; } -@media (min-width: 31.25rem) { .fs-6 { font-size: 24px !important; line-height: 1.25; } } +.fs-6 { font-size: 1.125rem !important; } +@media (min-width: 31.25rem) { .fs-6 { font-size: 1.5rem !important; line-height: 1.25; } } -.fs-7 { font-size: 24px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-7 { font-size: 32px !important; } } +.fs-7 { font-size: 1.5rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-7 { font-size: 2rem !important; } } -.fs-8 { font-size: 32px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-8 { font-size: 36px !important; } } +.fs-8 { font-size: 2rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-8 { font-size: 2.25rem !important; } } -.fs-9 { font-size: 36px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-9 { font-size: 42px !important; } } +.fs-9 { font-size: 2.25rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-9 { font-size: 2.625rem !important; } } -.fs-10 { font-size: 42px !important; line-height: 1.25; } -@media (min-width: 31.25rem) { .fs-10 { font-size: 48px !important; } } +.fs-10 { font-size: 2.625rem !important; line-height: 1.25; } +@media (min-width: 31.25rem) { .fs-10 { font-size: 3rem !important; } } .fw-300 { font-weight: 300 !important; } @@ -2243,7 +2263,12 @@ figure.highlight pre, figure.highlight code { padding: 0; margin: 0; border: 0; @media print { .site-footer, .site-button, #edit-this-page, #back-to-top, .site-nav, .main-header { display: none !important; } .side-bar { width: 100%; height: auto; border-right: 0 !important; } .site-header { border-bottom: 1px solid #eeebee; } - .site-title { font-size: 16px !important; font-weight: 700 !important; } + .site-title { font-size: 1rem !important; font-weight: 700 !important; } .text-small { font-size: 8pt !important; } pre.highlight { border: 1px solid #eeebee; } .main { max-width: none; margin-left: 0; } } +a.skip-to-main { left: -999px; position: absolute; top: auto; width: 1px; height: 1px; overflow: hidden; z-index: -999; } + +a.skip-to-main:focus, a.skip-to-main:active { color: #7253ed; background-color: #fff; left: auto; top: auto; width: 30%; height: auto; overflow: auto; margin: 10px 35%; padding: 5px; border-radius: 15px; border: 4px solid #5e41d0; text-align: center; font-size: 1.2em; z-index: 999; } + +div.opaque { background-color: #fff; } diff --git a/assets/images/just-the-docs.png b/assets/images/just-the-docs.png deleted file mode 100644 index 81c33065f..000000000 Binary files a/assets/images/just-the-docs.png and /dev/null differ diff --git a/assets/images/search.svg b/assets/images/search.svg deleted file mode 100644 index 421ca4df0..000000000 --- a/assets/images/search.svg +++ /dev/null @@ -1 +0,0 @@ -Search diff --git a/assets/js/just-the-docs.js b/assets/js/just-the-docs.js index 67412ac90..5f8d1afde 100644 --- a/assets/js/just-the-docs.js +++ b/assets/js/just-the-docs.js @@ -29,13 +29,15 @@ function initNav() { } if (target) { e.preventDefault(); - target.parentNode.classList.toggle('active'); + target.ariaPressed = target.parentNode.classList.toggle('active'); } }); const siteNav = document.getElementById('site-nav'); const mainHeader = document.getElementById('main-header'); const menuButton = document.getElementById('menu-button'); + + disableHeadStyleSheets(); jtd.addEvent(menuButton, 'click', function(e){ e.preventDefault(); @@ -43,12 +45,30 @@ function initNav() { if (menuButton.classList.toggle('nav-open')) { siteNav.classList.add('nav-open'); mainHeader.classList.add('nav-open'); + menuButton.ariaPressed = true; } else { siteNav.classList.remove('nav-open'); mainHeader.classList.remove('nav-open'); + menuButton.ariaPressed = false; } }); } + +// The element is assumed to include the following stylesheets: +// 0. a to /assets/css/just-the-docs-default.css +// 1. a to /assets/css/just-the-docs-head-nav.css +// 2. a Audio | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Audio

Functions

eax_available 

int eax_available()

Obsolete since sfall 2.1a. Always returns 0.

play_sfall_sound 

int play_sfall_sound(string file, int mode)

Used to play mp3/wav/wma files. The path given is relative to the Fallout folder. Specify mode as 1 to loop the file continuously, 2 to replace the current background game music with playing the specified file in loop mode, or 0 to play the file once. If you don’t wish to loop, play_sfall_sound returns 0. If you do loop, it returns an id which can be passed back to stop_sfall_sound when you want to stop the effect. All sounds effects will be stopped on game reload, looping or not. Does not require AllowDShowSound to be set to 1 in ddraw.ini.

Starting from sfall 4.2.8/3.8.28, you can pass a value in the mode argument for a reduced sound volume. To set the volume, You need to convert the number to hexadecimal and use the argument format 0xZZZZ000Y, where ZZZZ is the volume reduction value in range from 0 to 32767 (the value 32767 is mute), and Y is the playback mode.

set_eax_environment 

void set_eax_environment(int environment)

Obsolete since sfall 2.1a. Has no effect.

stop_sfall_sound 

void stop_sfall_sound(int soundID)
-

Stops looping mp3/wav/wma files previously launched by play_sfall_sound. All sounds effects will be stopped on game reload, looping or not. Does not require AllowDShowSound to be set to 1 in ddraw.ini.

+

Stops looping mp3/wav/wma files previously launched by play_sfall_sound. All sounds effects will be stopped on game reload, looping or not. Does not require AllowDShowSound to be set to 1 in ddraw.ini.

diff --git a/best-practices/index.html b/best-practices/index.html index 248680584..7756f1681 100644 --- a/best-practices/index.html +++ b/best-practices/index.html @@ -1,4 +1,4 @@ - Best practices - sfall Best practices | sfall Link Search Menu Expand Document
sfall

Best practices

Mod compatibility

  1. If it can be done in a global script, do it in a global script. Combined with hooks, they are extremely powerful, possibilities ranging from creating new perks to UI scripting to prototype altering on-the-fly. While scripting does take a bit longer to get started, and hacking prototypes directly with GUI programs might look easier at first, consider that:
    • Scripts from different mods modifying the same thing can actually be compatible with each other. Binary files can’t.
    • Scripts can be version controlled and thus are much more easier to maintain.

  2. If you’re using set_sfall_return, always couple it with set_sfall_arg for the corresponding arg(s), unless you have a specific reason not to. Detailed explanation is available here.

  3. Pick yourself a 2-3 character modding prefix. Use it for:
    • global script names
    • global variable names and saved array names
    • debug messages

This will ensure (to some degree), that another mod doesn’t overwrite your scripts, doesn’t mess with your global variables, and that debug messages coming from your scripts can be distinguished easily.

For example, if you pick prefix “a_”, your script could be named gl_a_myscript.int, and might look like this:

    #define NAME "gl_a_myscript"
+             Best practices | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Best practices 
  
  Mod compatibility 
 
     
  1. If it can be done in a global script, do it in a global script. Combined with hooks, they are extremely powerful, possibilities ranging from creating new perks to UI scripting to prototype altering on-the-fly. While scripting does take a bit longer to get started, and hacking prototypes directly with GUI programs might look easier at first, consider that: 
       
    • Scripts from different mods modifying the same thing can actually be compatible with each other. Binary files can’t.
      •  
    • Scripts can be version controlled and thus are much more easier to maintain.
      •  
     
    2.  
  2.  
    If you’re using set_sfall_return, always couple it with set_sfall_arg for the corresponding arg(s), unless you have a specific reason not to. Detailed explanation is available here.
     
    3.  
  3. Pick yourself a 2-3 character modding prefix. Use it for: 
       
    • global script names
      •  
    • global variable names and saved array names
      •  
    • debug messages
      •  
     
    4.  
 
This will ensure (to some degree), that another mod doesn’t overwrite your scripts, doesn’t mess with your global variables, and that debug messages coming from your scripts can be distinguished easily.
 
For example, if you pick prefix “a_”, your script could be named gl_a_myscript.int, and might look like this:
 
    #define NAME "gl_a_myscript"
     #define ndebug(message) debug_msg(NAME + ": " + message + "\n")
 
     procedure start begin
@@ -8,4 +8,4 @@
       end
     end
     ...
-
 
  Performance 
 
     
  1. Do not abuse set_global_script_repeat. Whenever possible, register your script as a hook instead. You can register the same procedure at multiple hook points, if necessary. 
       
    • If you have set_global_script_repeat(300) in your script, you’re probably doing something wrong. That’s an invocation every 3-5 seconds, approximately.
      •  
    • If you have set_global_script_repeat(30), you are definitely doing something wrong. Look for suitable hooks harder, think of another way for implementing it, ask fellow modders for help.
      •  
     
    2.  
 
 
 
 
  
+

Performance

  1. Do not abuse set_global_script_repeat. Whenever possible, register your script as a hook instead. You can register the same procedure at multiple hook points, if necessary.
    • If you have set_global_script_repeat(300) in your script, you’re probably doing something wrong. That’s an invocation every 3-5 seconds, approximately.
    • If you have set_global_script_repeat(30), you are definitely doing something wrong. Look for suitable hooks harder, think of another way for implementing it, ask fellow modders for help.
diff --git a/call_offset_vx/index.html b/call_offset_vx/index.html index 7bf384c68..f058a8661 100644 --- a/call_offset_vx/index.html +++ b/call_offset_vx/index.html @@ -1,4 +1,4 @@ - call_offset_vX - sfall call_offset_vX | sfall Link Search Menu Expand Document
sfall

call_offset_vX

Can be used to call arbitrary functions inside Fallout. Different versions are used to call functions with different numbers of arguments. None of these functions will work unless AllowUnsafeScripting is enabled in ddraw.ini.

Functions

call_offset_r0

UNSAFE

int call_offset_r0(int address)
+             call_offset_vX | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  call_offset_vX 
 
Can be used to call arbitrary functions inside Fallout. Different versions are used to call functions with different numbers of arguments. None of these functions will work unless AllowUnsafeScripting is enabled in ddraw.ini.
 
  Functions 
 
 
  call_offset_r0 
 
UNSAFE
 
int call_offset_r0(int address)
 
 
  call_offset_r1 
 
UNSAFE
 
int call_offset_r1(int address, int arg1)
 
 
  call_offset_r2 
 
UNSAFE
 
int call_offset_r2(int address, int arg1, int arg2)
 
 
  call_offset_r3 
 
UNSAFE
 
int call_offset_r3(int address, int arg1, int arg2, int arg3)
@@ -8,4 +8,4 @@
 
 
  call_offset_v2 
 
UNSAFE
 
void call_offset_v2(int address, int arg1, int arg2)
 
 
  call_offset_v3 
 
UNSAFE
 
void call_offset_v3(int address, int arg1, int arg2, int arg3)
 
 
  call_offset_v4 
 
UNSAFE
 
void call_offset_v4(int address, int arg1, int arg2, int arg3, int arg4)
-
 
 
 
 
  
+
diff --git a/car/index.html b/car/index.html index 6c80d77f6..cfb2f50b8 100644 --- a/car/index.html +++ b/car/index.html @@ -1,4 +1,4 @@ - Car - sfall Car | sfall Link Search Menu Expand Document
sfall

Car

Functions

car_gas_amount

sfall.h

int car_gas_amount()
+             Car | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Car 
 
  Functions 
 
 
  car_gas_amount 
 
sfall.h
 
int car_gas_amount()
 
 
Returns the current amount of fuel in player’s car (between 0 and 80000). To change fuel amount, use vanilla function: metarule(METARULE_GIVE_CAR_GAS, amount) - amount can be positive or negative.
 
  set_car_current_town 
 
void set_car_current_town(int town)
 
 
Changes the current town index for the player’s car.
 
  set_car_intface_art 
 
sfall.h
 
void set_car_intface_art(int artIndex)
-
 
     
  • Changes the interface art (index in intrface.lst) for the car image on the world map interface
    •  
  • Should be called before going to the world map
    •  
  • Vanilla art index is 433
    •  
 
 
 
 
  
+
  • Changes the interface art (index in intrface.lst) for the car image on the world map interface
  • Should be called before going to the world map
  • Vanilla art index is 433
diff --git a/combat/index.html b/combat/index.html index a820ebeed..78af756ff 100644 --- a/combat/index.html +++ b/combat/index.html @@ -1,17 +1,20 @@ - Combat - sfall Combat | sfall Link Search Menu Expand Document
sfall

Combat

Subcategories

Functions

attack_is_aimed

sfall.h

bool attack_is_aimed()
+             Combat | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Combat 
 
  Subcategories 
  
  Functions 
 
 
  attack_is_aimed 
 
sfall.h
 
bool attack_is_aimed()
 
 
Returns 1 if the aimed attack mode is selected, 0 otherwise.
 
  block_combat 
 
void block_combat(bool value)
 
 
Deny the player to enter combat mode.
 
  combat_data 
 
mixed combat_data
 
 
     
  • returns a pointer to the C_ATTACK_* data for the current combat attack process (see defined constants in define_extra.h)
    •  
  • can be used in conjunction with the get_object_data and set_object_data functions example: sfall_func3("set_object_data", sfall_func0("combat_data"), C_ATTACK_UNUSED, 255);
    •  
 
  disable_aimed_shots 
 
void disable_aimed_shots(int pid)
 
 
Allows overriding the normal rules regarding which weapons are allowed to make aimed attacks. (e.g. weapons that cause explosive damage normally cannot normally make aimed shots.) stops a weapon from making aimed shots even if it normally coulld. Affects player and NPCs alike. The list of edited weapons is not saved over game loads, so you need to call the function once at each reload. Use a pid of 0 to represent unarmed.
 
  force_aimed_shots 
 
void force_aimed_shots(int pid)
 
 
Allows overriding the normal rules regarding which weapons are allowed to make aimed attacks. (e.g. weapons that cause explosive damage normally cannot normally make aimed shots.) Will allow a weapon to make aimed shots even if it normally couldn’t. Affects player and NPCs alike. Does not override the effects of the fast shot trait. The list of edited weapons is not saved over game loads, so you need to call the function once at each reload. Use a pid of 0 to represent unarmed.
 
  get_attack_type 
 
int get_attack_type
 
 
  get_bodypart_hit_modifier 
 
int get_bodypart_hit_modifier(int bodypart)
-
 
Gets the hit percentage modifiers for aiming at specific bodyparts. Valid bodypart id’s are from 0 to 8.
 
  get_critical_table 
 
int get_critical_table(int crittertype, int bodypart, int level, int valuetype)
-
 
Gets current critical table. For details see critical hit tables. Requires OverrideCriticalTable to be set to 1 in ddraw.ini. (Disabled by default, because it noticably increases loading times.)
 
  get_critter_current_ap 
 
int get_critter_current_ap(CritterPtr)
+
 
Gets the hit percentage modifiers for aiming at specific bodyparts. Valid bodypart id’s are from 0 to 8.
 
  get_combat_free_move 
 
sfall.h
 
int get_combat_free_move()
+
 
Returns available “bonus move” points of the current critter’s turn. For NPCs, this is always 0 unless changed by set_combat_free_move
 
  get_critical_table 
 
int get_critical_table(int crittertype, int bodypart, int level, int valuetype)
+
 
Gets current critical table. For details see critical hit tables. Requires OverrideCriticalTable to be enabled in ddraw.ini (already enabled by default).
 
  get_critter_current_ap 
 
int get_critter_current_ap(CritterPtr)
 
 
Should only be used during the target critters turn while in combat. Calling it outside of combat typically returns the critters max ap, but don’t rely on that behaviour. (Specifically, if the critter has never before entered combat, it will probably return the critters base ap ignoring any extra bonuses from perks etc.)
 
  get_last_attacker 
 
ObjectPtr get_last_attacker(ObjectPtr critter)
 
 
Will return the last critter to deliberately launch an attack against the argument critter. If a critter has not launched/received an attack, it will return 0. Outside of combat always returns 0.
 
  get_last_target 
 
ObjectPtr get_last_target(ObjectPtr critter)
 
 
Will return the last critter to be deliberately attacked. Outside of combat always returns 0.
 
  reset_critical_table 
 
void reset_critical_table(int crittertype, int bodypart, int level, int valuetype)
 
 
Resets the critical table to default (or to the contents of CriticalOverrides.ini, if it exists). For details see ‘http://falloutmods.wikia.com/wiki/Critical_hit_tables’. Requires OverrideCriticalTable to be set to 1 in ddraw.ini. (Disabled by default, because it noticably increases loading times.)
 
  set_bodypart_hit_modifier 
 
void set_bodypart_hit_modifier(int bodypart, int value)
-
 
Alters the hit percentage modifiers for aiming at specific bodyparts. Valid bodypart id’s are from 0 to 8. Changes are not saved, and will reset to the defaults (or to the values specified in ddraw.ini if they exist) at each reload.
 
  set_critical_table 
 
void set_critical_table(int crittertype, int bodypart, int level, int valuetype, int value)
-
 
Used for modifying the critical table. For details see critical hit tables. Changes are not saved, and will reset to the defaults, (or to the contents of CriticalOverrides.ini, if it exists) at each game reload. Requires OverrideCriticalTable to be set to 1 in ddraw.ini. (Disabled by default, because it noticably increases loading times.)
 
  set_critter_burst_disable 
 
void set_critter_burst_disable(int critter, int disable)
+
 
Alters the hit percentage modifiers for aiming at specific bodyparts. Valid bodypart id’s are from 0 to 8. Changes are not saved, and will reset to the defaults (or to the values specified in ddraw.ini if they exist) at each reload.
 
  set_combat_free_move 
 
sfall.h
 
void set_combat_free_move(int value)
+
 
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)
    •  
 
  set_critical_table 
 
void set_critical_table(int crittertype, int bodypart, int level, int valuetype, int value)
+
 
Used for modifying the critical table. For details see critical hit tables. Changes are not saved, and will reset to the defaults (or to the contents of CriticalOverrides.ini, if it exists) at each game reload. Requires OverrideCriticalTable to be enabled in ddraw.ini (already enabled by default).
 
  set_critter_burst_disable 
 
void set_critter_burst_disable(int critter, int disable)
 
 
  set_critter_current_ap 
 
void set_critter_current_ap(CritterPtr, int ap)
-
 
Should only be used during the target critters turn while in combat.
 
 
 
 
  
+

Should only be used during the target critters turn while in combat.

set_spray_settings

sfall.h

void set_spray_settings(int centerMult, int centerDiv, int targetMult, int targetDiv)
+

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
  • NOTE: refer to the description of ComputeSpray_* settings in ddraw.ini for details of the bullet distribution of burst attacks
diff --git a/cursor/index.html b/cursor/index.html index 774a3911b..2d523510c 100644 --- a/cursor/index.html +++ b/cursor/index.html @@ -1,3 +1,3 @@ - Cursor - sfall Cursor | sfall Link Search Menu Expand Document
sfall

Cursor

Functions

get_cursor_mode

sfall.h

int get_cursor_mode()
+             Cursor | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Cursor 
 
  Functions 
 
 
  get_cursor_mode 
 
sfall.h
 
int get_cursor_mode()
 
 
Returns the current cursor mode. Values: 0 - movement cursor, 1 - command cursor, 2 - targeting cursor, 4 to 10 are Skilldex skills (yellow targeting cursor).
 
  set_cursor_mode 
 
sfall.h
 
void set_cursor_mode(int mode)
-
 
Sets the current cursor mode.
 
 
 
 
  
+

Sets the current cursor mode.

diff --git a/data-types/index.html b/data-types/index.html index 64aa41830..ab4a57fb9 100644 --- a/data-types/index.html +++ b/data-types/index.html @@ -1 +1 @@ - Data types - sfall Data types | sfall Link Search Menu Expand Document
sfall

Data types

Data types mentioned in this document

  • array - array ID to be used with array-related functions (actually an integer)
  • any - any type
  • bool - boolean (in fact, int: True is 1 and False is 0)
  • int - integer number
  • mixed - type depends on exact use case
  • float - floating point number
  • ObjectPtr - pointer to a game object (actually an integer)
  • proc - procedure name (used in register_hook_proc)
  • string - string (text) value
  • void - means opcode does not return any value
+ Data types | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Data types

Data types mentioned in this document

  • array - array ID to be used with array-related functions (actually an integer)
  • any - any type
  • bool - boolean (in fact, int: True is 1 and False is 0)
  • int - integer number
  • mixed - type depends on exact use case
  • float - floating point number
  • ObjectPtr - pointer to a game object (actually an integer)
  • proc - procedure name (used in register_hook_proc)
  • string - string (text) value
  • void - means opcode does not return any value
diff --git a/direct-memory-access/index.html b/direct-memory-access/index.html index 02050cec9..05bdd2b00 100644 --- a/direct-memory-access/index.html +++ b/direct-memory-access/index.html @@ -1 +1 @@ - Direct memory access - sfall Direct memory access | sfall Link Search Menu Expand Document
sfall

Direct memory access

Subcategories

+ Direct memory access | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Direct memory access

Subcategories

diff --git a/explosions/index.html b/explosions/index.html index 6b1cbb56e..d002b3b7f 100644 --- a/explosions/index.html +++ b/explosions/index.html @@ -1,7 +1,7 @@ - Explosions - sfall Explosions | sfall Link Search Menu Expand Document
sfall

Explosions

Functions

get_explosion_damage

sfall.h

array get_explosion_damage(itemPid)
+             Explosions | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Explosions 
 
  Functions 
 
 
  get_explosion_damage 
 
sfall.h
 
array get_explosion_damage(itemPid)
 
 
Returns an array of the minimum and maximum damage of the explosive item.
 
  item_make_explosive 
 
sfall.h
 
void item_make_explosive(int pid, int activePid, int minDamage, int maxDamage)
-
 
     
  • makes the specified item (pid) an explosive item like Dynamite or Plastic Explosives
    •  
  • maxDamage is optional
    •  
  • activePid is for an item with an active timer, can be the same as the pid argument
    •  
  • the item proto must be “Misc Item” type and have “Use” action flag
    •  
  • minDamage/maxDamage are the minimum and maximum explosion damage
    •  
  • using the function on an item that is already set as an explosive will override its previous settings
    •  
  • NOTE: this function does not work for pids of Dynamite and Plastic Explosives
    •  
 
  metarule2_explosions 
 
int metarule2_explosions(int arg1, int arg2)
-
 
Was made as a dirty easy hack to allow dynamically change some explosion parameters (ranged attack). All changed parameters are reset to vanilla state automatically after each attack action.
 
  set_attack_explosion_art 
 
sfall.h
 
void set_attack_explosion_art(x, y)
+
 
     
  • makes the specified item (pid) an explosive item like Dynamite or Plastic Explosives
    •  
  • maxDamage is optional
    •  
  • activePid is for an item with an active timer, can be the same as the pid argument
    •  
  • the item proto must be the Misc Item type and have the Use action flag
    •  
  • minDamage/maxDamage are the minimum and maximum explosion damage
    •  
  • using the function on an item that is already set as an explosive will override its previous settings
    •  
  • NOTE: this function does not work for pids of Dynamite and Plastic Explosives
    •  
 
  metarule2_explosions 
 
int metarule2_explosions(int arg1, int arg2)
+
 
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.
 
  set_attack_explosion_art 
 
sfall.h
 
void set_attack_explosion_art(x, y)
 
 
Y not used and X is a misc frame ID (last 3 bytes, without object type) to use for the next explosion.
 
  set_attack_explosion_pattern 
 
sfall.h
 
void set_attack_explosion_pattern(x, y)
 
 
Currently Y is not used and X means: 1 - reduced explosion pattern (3 effects are spawned instead of 7), 0 - full pattern.
 
  set_attack_explosion_radius 
 
sfall.h
 
void set_attack_explosion_radius(x)
 
 
Changes radius at which explosion will hit secondary targets for the next attack (from the experiments it is limited to something around 8 by the engine).
 
  set_attack_is_explosion_fire 
 
sfall.h
 
void set_attack_is_explosion_fire
@@ -9,4 +9,4 @@
 
 
Sets the minimum and maximum damage for Dynamite. Changed damage will be reset each time the player reloads the game.
 
  set_explosion_max_targets 
 
sfall.h
 
void set_explosion_max_targets(x)
 
 
Sets the maximum number of additional targets for an explosion, valid range: 1..6 (default is 6).
 
  set_explosion_radius 
 
sfall.h
 
void set_explosion_radius(grenade, rocket)
 
 
Sets a permanent radius of the explosion for grenades and/or rockets. Passing 0 means not changing the corresponding radius. Changed radius will be reset each time the player reloads the game.
 
  set_plastic_damage 
 
sfall.h
 
void set_plastic_damage(minDmg, maxDmg)
-
 
Sets the minimum and maximum damage for Plastic Explosives. Changed damage will be reset each time the player reloads the game.
 
 
 
 
  
+

Sets the minimum and maximum damage for Plastic Explosives. Changed damage will be reset each time the player reloads the game.

diff --git a/feed.xml b/feed.xml index 8094d99a7..45d6e0657 100644 --- a/feed.xml +++ b/feed.xml @@ -1 +1 @@ -Jekyll2022-07-09T23:49:09+00:00/feed.xmlsfallSfall documentation \ No newline at end of file +Jekyll2023-10-03T04:03:39+00:00/feed.xmlsfallSfall documentation \ No newline at end of file diff --git a/funcx/index.html b/funcx/index.html index f6be9945b..fd04714b2 100644 --- a/funcx/index.html +++ b/funcx/index.html @@ -1,4 +1,4 @@ - funcX - sfall funcX | sfall Link Search Menu Expand Document
sfall

funcX

Functions

sfall_func0 

any sfall_func0(char* funcName)
+             funcX | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  funcX 
 
  Functions 
 
 
  sfall_func0 
 
any sfall_func0(char* funcName)
 
 
Calls script function with given name and no arguments.
 
  sfall_func1 
 
any sfall_func1(char* funcName, arg1)
 
 
Calls script function with given name and 1 argument.
 
  sfall_func2 
 
any sfall_func2(char* funcName, arg1, arg2)
 
 
Calls script function with given name and 2 arguments.
 
  sfall_func3 
 
any sfall_func3(char* funcName, arg1, arg2, arg3)
@@ -7,4 +7,4 @@
 
 
Calls script function with given name and 5 arguments.
 
  sfall_func6 
 
any sfall_func6(char* funcName, arg1, arg2, arg3, arg4, arg5, arg6)
 
 
Calls script function with given name and 6 arguments
 
  sfall_func7 
 
any sfall_func7(string funcName, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
 
 
Calls script function with given name and 7 arguments
 
  sfall_func8 
 
any sfall_func8(string funcName, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
-
 
Calls script function with given name and 8 arguments
 
 
 
 
  
+

Calls script function with given name and 8 arguments

diff --git a/global-script-functions/index.html b/global-script-functions/index.html index eed5be224..719df2cae 100644 --- a/global-script-functions/index.html +++ b/global-script-functions/index.html @@ -1,4 +1,4 @@ - Global script functions - sfall Global script functions | sfall Link Search Menu Expand Document
sfall

Global script functions

Functions

available_global_script_types 

int available_global_script_types
+             Global script functions | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Global script functions 
 
  Functions 
 
 
  available_global_script_types 
 
int available_global_script_types
 
 
  set_global_script_repeat 
 
void set_global_script_repeat(int frames)
 
 
Only has an effect on the script it is called from. Every global script needs its own game_loaded block to correctly set up repeat rate. Will have no effect if called on a non-global script.
 
  set_global_script_type 
 
void set_global_script_type(int type)
-
 
Only has an effect on the script it is called from. Every global script needs its own game_loaded block to correctly set up the script type.
 
 
 
 
  
+

Only has an effect on the script it is called from. Every global script needs its own game_loaded block to correctly set up the script type.

diff --git a/global-scripts/index.html b/global-scripts/index.html index f9ed485a9..38d02b41c 100644 --- a/global-scripts/index.html +++ b/global-scripts/index.html @@ -1 +1 @@ - Global scripts - sfall Global scripts | sfall Link Search Menu Expand Document
sfall

Global scripts

As well as the new functions, sfall also adds global scripts. These run independent of any loaded maps, but do not have an attached object. (i.e. using self_obj without using set_self first will crash the script.) To use a global script, the script must have a name which begins with gl and contains a procedure called start, map_enter_p_proc, map_exit_p_proc, or map_update_p_proc. The start procedure will be executed once when the player loads a saved game or starts a new game. The map_*_p_proc procedures will be executed once when a map is being entered/left/updated. If you wish the script to be executed repeatedly, call set_global_script_repeat on the first run of the start procedure using the number of frames between each run as the argument. (0 disables the script, 1 runs it every frame, 2 runs it every other frame etc.)

Global scripts have multiple modes, which can be set using the set_global_script_type function.

  • In the default mode (i.e. mode 0) their execution is linked to the local map game loop, so the script will not run in dialogs or on the world map. [Using mode 1 requires the input wrapper to be enabled. Use available_global_script_types to check what is available.] - Obsolete.
  • In mode 1 their execution is linked to the player input, and so they will run whenever the mouse cursor is visible on screen, including the world map, character dialogs etc.
  • In mode 2, execution is linked to the world map loop, so the script will only be executed on the world map and not on the local map or in any dialog windows.
  • Mode 3 is a combination of modes 0 and 2, so scripts will be executed on both local maps and the world map, but not in dialog windows.
+ Global scripts | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Global scripts

As well as the new functions, sfall also adds global scripts. These run independent of any loaded maps, but do not have an attached object (i.e. using self_obj without using set_self first will crash the script).

To use a global script, the script must have a name which begins with gl and contains a procedure called start, map_enter_p_proc, map_exit_p_proc, or map_update_p_proc. The start procedure will be executed once when the player loads a saved game or starts a new game. The map_*_p_proc procedures will be executed once when a map is being entered/left/updated. If you wish the script to be executed repeatedly, call set_global_script_repeat on the first run of the start procedure using the number of frames between each run as the argument (0 disables the script, 1 runs it every frame, 2 runs it every other frame etc.).

Global scripts have multiple modes, which can be set using the set_global_script_type function.

  • In the default mode (i.e. mode 0) their execution is linked to the local map game loop, so the script will not run in dialogs or on the world map. [Using mode 1 requires the input wrapper to be enabled. Use available_global_script_types to check what is available.] - Obsolete.
  • In mode 1 their execution is linked to the player input, and so they will run whenever the mouse cursor is visible on screen, including the world map, character dialogs etc.
  • In mode 2, execution is linked to the world map loop, so the script will only be executed on the world map and not on the local map or in any dialog windows.
  • Mode 3 is a combination of modes 0 and 2, so scripts will be executed on both local maps and the world map, but not in dialog windows.
diff --git a/global-variables/index.html b/global-variables/index.html index 0a6f18bac..b4b8fb9bf 100644 --- a/global-variables/index.html +++ b/global-variables/index.html @@ -1,4 +1,4 @@ - Global variables - sfall Global variables | sfall Link Search Menu Expand Document
sfall

Global variables

These functions require an EXACTLY 8 characters long, case sensitive string for the variable name. The variables behave the same as normal Fallout globals, except that they don’t have to be declared beforehand in vault13.gam. Trying to get a variable which hasn’t been set will always return 0. The functions are intended for use when a patch to a mod requires the addition of a new global variable, a case which would otherwise require the player to start a new game.

Functions

get_sfall_global_float 

float get_sfall_global_float(string/int varname)
+             Global variables | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Global variables 
 
These functions require an EXACTLY 8 characters long, case sensitive string for the variable name. The variables behave the same as normal Fallout globals, except that they don’t have to be declared beforehand in vault13.gam. Trying to get a variable which hasn’t been set will always return 0. The functions are intended for use when a patch to a mod requires the addition of a new global variable, a case which would otherwise require the player to start a new game.
 
  Functions 
 
 
  get_sfall_global_float 
 
float get_sfall_global_float(string/int varname)
 
 
  get_sfall_global_int 
 
int get_sfall_global_int(string/int varname)
 
 
  set_sfall_global 
 
void set_sfall_global(string/int varname, int/float value)
-
 
 
 
 
  
+
diff --git a/graphics/index.html b/graphics/index.html index 41270adf2..8936a0776 100644 --- a/graphics/index.html +++ b/graphics/index.html @@ -1,4 +1,4 @@ - Graphics - sfall Graphics | sfall Link Search Menu Expand Document
sfall

Graphics

The graphics functions are only available if the user is using graphics mode 4 or 5. Use graphics_funcs_available to check; it returns 1 if you can use them or 0 if you can’t. Calling graphics functions when graphics_funcs_available returns 0 will do nothing.

Functions

activate_shader 

void activate_shader(int ID)
+             Graphics | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Graphics 
 
The graphics functions are only available if the user is using graphics mode 4 or 5. Use graphics_funcs_available to check; it returns 1 if you can use them or 0 if you can’t. Calling graphics functions when graphics_funcs_available returns 0 will do nothing.
 
  Functions 
 
 
  activate_shader 
 
void activate_shader(int ID)
 
 
  deactivate_shader 
 
void deactivate_shader(int ID)
 
 
  force_graphics_refresh 
 
void force_graphics_refresh(bool enabled)
 
 
Forces the screen to redraw at times when it normally wouldn’t. If you’re using animated shader, turning this option on is recommended.
 
  free_shader 
 
void free_shader(int ID)
@@ -14,4 +14,4 @@
 
 
  set_shader_mode 
 
void set_shader_mode(int mode)
 
 
Tells sfall when to use a shader. The parameter is a set of 32 flags which specify the screens on which the shader will be disabled, unless bit 32 is set, in which case the shader will only be active on those screens. Remember that screens are displayed on top of each other; if the player opens the character menu which in combat, the game still considers the player to be in combat. See sfall.h for a list of defines.
 
  set_shader_texture 
 
void set_shader_texture(int ID, string param, int texID)
 
 
  set_shader_vector 
 
void set_shader_vector(int ID, string param, float f1, float f2, float f3, float f4)
-
 
 
 
 
  
+
diff --git a/hook-functions/index.html b/hook-functions/index.html index 5cbde8011..703e95df2 100644 --- a/hook-functions/index.html +++ b/hook-functions/index.html @@ -1,16 +1,16 @@ - Hook functions - sfall Hook functions | sfall Link Search Menu Expand Document
sfall

Hook functions

Functions

get_sfall_arg 

mixed get_sfall_arg()
+             Hook functions | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Hook functions 
 
  Functions 
 
 
  get_sfall_arg 
 
mixed get_sfall_arg()
 
 
Gets the next argument from sfall. Each time it’s called it returns the next argument, or otherwise it returns 0 if there are no more arguments left. You can arbitrarily get the value of any argument using the sfall_func1("get_sfall_arg_at", argNum) function.
 
  get_sfall_arg_at 
 
sfall.h
 
mixed get_sfall_arg_at(int argNum)
 
 
Gets the value of hook argument with the specified argument number (first argument of hook starts from 0)
 
  get_sfall_args 
 
int get_sfall_args()
 
 
Returns all hook arguments as a new temp array.
 
  init_hook 
 
int init_hook()
 
 
The hook script equivalent of game_loaded; it returns 1 when the script is loaded for the first time or when the player reloads the game, and 0 otherwise.
 
  register_hook 
 
void register_hook(int hookID)
-
 
Used from a normal global script if you want to run it at the same point a full hook script would normally run. In case of this function, start proc will be executed in current global script. You can use all above functions like normal.
 
  register_hook_proc 
 
void register_hook_proc(int hookID, proc procedure)
-
 
The same as register_hook, except that you specifically define which procedure in the current script should be called as a hook (instead of “start” by default). Pass procedure the same as how you use dialog option functions. This IS the recommended way to use hook scripts, as it gives both modularity (each mod logic in a separate global script, no conflicts if you don’t use “hs_*.int” scripts) and flexibility (you can place all related hook scripts for specific mod in a single script!).
 
Use zero (0) as second argument to unregister hook script from current global script.
 
NOTE: you can hook several scripts to a single hook point, for example if it’s different mods from different authors or just some different aspects of one larger mod. In this case scripts are executed in reverse order of how they were registered. When one of the scripts in a chain returns value with set_sfall_return, the next script may override this value if calls set_sfall_return again. Sometimes you need to multiply certain value in a chain of hook scripts.
 
Example: let’s say we have a Mod A which reduces all “to hit” chances by 50%. The code might look like this:
 
original_chance = get_sfall_arg;
+
 
Used from a normal global script if you want to run it at the same point a full hook script would normally run. In case of this function, start procedure will be executed in current global script. You can use all above functions like normal.
 
  register_hook_proc 
 
void register_hook_proc(int hookID, proc procedure)
+
 
The same as register_hook, except that you specifically define which procedure in the current script should be called as a hook (instead of “start” by default). Pass procedure the same as how you use dialog option functions. This IS the recommended way to use hook scripts, as it gives both modularity (each mod logic in a separate global script with no conflicts) and flexibility. You can place all related hook scripts for a specific mod in one global script!
 
Use zero (0) as second argument to unregister hook script from current global script.
 
NOTE: you can hook several scripts to a single hook point, for example if it’s different mods from different authors or just some different aspects of one larger mod. When one of the scripts in a chain returns value with set_sfall_return, the next script may override this value if calls set_sfall_return again.
 
Example: Sometimes you need to multiply certain value in a chain of hook scripts. Let’s say we have a Mod A which reduces all “to hit” chances by 50%. The code might look like this:
 
original_chance = get_sfall_arg;
 set_sfall_return(original_chance / 2);
-
 
Mod B also want to affect hit chances globally, by increasing them by 50%. Now in order for both mods to work well together, we need to add this line to Mod A hook script:
 
set_sfall_arg(0, (original_chance / 2));
-
 
This basically changes hook argument for the next script. Mod B code:
 
original_chance = get_sfall_arg;
+
 
Mod B also want to affect hit chances globally, by increasing them by 50%. Now in order for both mods to work well together, we need to add this line to Mod A hook script:
 
set_sfall_arg(0, (original_chance / 2));
+
 
This basically changes hook argument for the next script. Mod B code:
 
original_chance = get_sfall_arg;
 set_sfall_return(original_chance * 1.5);
 set_sfall_arg(0, (original_chance * 1.5));
 
 
So if you combine both mods together, they will run in chain and the end result will be a 75% from original hit chance (hook register order doesn’t matter in this case, if you use set_sfall_arg in both hooks).
 
The defines to use for the hookID are in sfall.h.
 
  register_hook_proc_spec 
 
void register_hook_proc_spec(int hookID, procedure proc)
-
 
Works very similar to register_hook_proc, except that it registers the current script at the end of the hook script execution chain (i.e. the script will be executed after all previously registered scripts for the same hook, including the hs_*.int script). All scripts hooked to a single hook point with this function are executed in exact order of how they were registered, as opposed to the description below, which refers to using register_hook/register_hook_proc functions.
 
  set_sfall_arg 
 
void set_sfall_arg(int argNum, int value)
-
 
Changes argument value. The argument number (argNum) is 0-indexed. This is useful if you have several hook scripts attached to one hook point (see register_hook_proc).
 
  set_sfall_return 
 
void set_sfall_return(int value)
-
 
Used to return the new values from the script. Each time it’s called it sets the next value, or if you’ve already set all return values it does nothing.
 
 
 
 
  
+

Works the same as register_hook_proc, except that it registers the current script at the end of the hook script execution chain (i.e. the script will be executed after all previously registered scripts for the same hook, including the hs_<name>.int script). In addition, all scripts hooked to a single hook point with this function are executed in the exact order of how they were registered. In the case of using register_hook and register_hook_proc functions, scripts are executed in reverse order of how they were registered. The execution chain of script procedures for a hook is as follows: 1. Procedures registered with register_hook and register_hook_proc functions (executed in reverse order of registration). 2. The hs_<name>.int script. 3. Procedures registered with the register_hook_proc_spec function (executed in the exact order of registration).

set_sfall_arg 

void set_sfall_arg(int argNum, int value)
+

Changes argument value. The argument number (argNum) is 0-indexed. This is useful if you have several hook scripts attached to one hook point (see register_hook_proc).

set_sfall_return 

void set_sfall_return(int value)
+

Used to return the new values from the script. Each time it’s called it sets the next value, or if you’ve already set all return values it does nothing.

diff --git a/hook-types/index.html b/hook-types/index.html index 41f40f5af..fd1fe8b2c 100644 --- a/hook-types/index.html +++ b/hook-types/index.html @@ -1,4 +1,4 @@ - Hook types - sfall Hook types | sfall Link Search Menu Expand Document
sfall

Hook types

AdjustFID

HOOK_ADJUSTFID (hs_adjustfid.int)

Runs after calculating character figure FID on the inventory screen, whenever the game decides that character appearance might change. Also happens on other screens, like barter.

NOTE: FID has following format: 0x0ABBCDDD, where: A - object type, BB - animation code (always 0 in this case), C - weapon code, DDD - FRM index in LST file.

int     arg0 - the vanilla FID calculated by the engine according to critter base FID and armor/weapon being used
+             Hook types | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Hook types 
 
 
  AdjustFID 
 
HOOK_ADJUSTFID (hs_adjustfid.int)
 
Runs after calculating character figure FID on the inventory screen, whenever the game decides that character appearance might change. Also happens on other screens, like barter.
 
NOTE: FID has following format: 0x0ABBCDDD, where: A - object type, BB - animation code (always 0 in this case), C - weapon code, DDD - FRM index in LST file.
 
int     arg0 - the vanilla FID calculated by the engine according to critter base FID and armor/weapon being used
 int     arg1 - the modified FID calculated by the internal sfall code (like Hero Appearance Mod)
 
 int     ret0 - overrides the calculated FID with provided value
@@ -22,7 +22,7 @@
 int     ret0 - Override the hit/miss
 int     ret1 - Override the targeted bodypart
 Critter ret2 - Override the target of the attack
-
 
  AmmoCost 
 
HOOK_AMMOCOST (hs_ammocost.int)
 
Runs when calculating ammo cost for a weapon. Doesn’t affect damage, only how much ammo is spent.
 By default, weapons can make attacks when at least 1 ammo is left, regardless of ammo cost calculations.
 To add proper check for ammo before attacking and proper calculation of the number of burst rounds (hook type 1 and 2 in arg3), set CheckWeaponAmmoCost=1 in Misc section of ddraw.ini.
 
Item    arg0 - The weapon
+
 
  AmmoCost 
 
HOOK_AMMOCOST (hs_ammocost.int)
 
Runs when calculating ammo cost for a weapon. Doesn’t affect damage, only how much ammo is spent.
 By default, a weapon can perform an attack with at least one ammo, regardless of ammo cost calculation.
 To add proper checks for ammo before attacking (hook type 1 arg3), set CheckWeaponAmmoCost=1 in Misc section of ddraw.ini.
 
NOTE: The return value must be greater than or equal to 0 to be valid.
 
Item    arg0 - The weapon
 int     arg1 - Number of bullets in burst or 1 for single shots
 int     arg2 - The amount of ammo that will be consumed, calculated by the original ammo cost function (this is basically 2 for Super Cattle Prod and Mega Power Fist)
                NOTE: for hook type 2, this value is the ammo cost per round (default is always 1)
@@ -37,7 +37,7 @@
 Critter arg1 - the critter being bartered with
 int     arg2 - the default value of the goods
 Critter arg3 - table of requested goods (being bought from NPC)
-int     arg4 - the amount of actual caps in the barter stack (as opposed to goods)
+int     arg4 - the number of actual caps in the barter stack (as opposed to goods)
 int     arg5 - the value of all goods being traded before skill modifications
 Critter arg6 - table of offered goods (being sold to NPC)
 int     arg7 - the total cost of the goods offered by the player
@@ -53,7 +53,7 @@
 Critter arg4 - the target of the critter (can be 0)
 
 Item    ret0 - overrides the chosen best weapon
-
 
  CalcAPCost 
 
HOOK_CALCAPCOST (hs_calcapcost.int)
 
Runs whenever Fallout is calculating the AP cost of using the weapon (or unarmed attack). Doesn’t run for using other item types or moving.
 Note that the first time a game is loaded, this script doesn’t run before the initial interface is drawn, so if the script effects the AP cost of whatever is in the player’s hands at the time the wrong AP cost will be shown. It will be fixed the next time the interface is redrawn.
 You can get the weapon object by checking item slot based on attack type (ATKTYPE_LWEP1, ATKTYPE_LWEP2, etc) and then calling critter_inven_obj.
 
Critter arg0 - The critter performing the action
+
 
  CalcAPCost 
 
HOOK_CALCAPCOST (hs_calcapcost.int)
 
Runs whenever Fallout calculates the AP cost of using an active item in hand (or unarmed attack). Doesn’t run for moving.
 Note that the first time a game is loaded, this script doesn’t run before the initial interface is drawn, so if the script effects the AP cost of whatever is in the player’s hands at the time the wrong AP cost will be shown. It will be fixed the next time the interface is redrawn.
 You can get the weapon object by checking item slot based on attack type (ATKTYPE_LWEP1, ATKTYPE_LWEP2, etc) and then calling critter_inven_obj.
 
Critter arg0 - The critter performing the action
 int     arg1 - Attack Type (see ATKTYPE_* constants)
 int     arg2 - Is aimed attack (1 or 0)
 int     arg3 - The default AP cost
@@ -63,7 +63,7 @@
 
 
  CanUseWeapon 
 
HOOK_CANUSEWEAPON (hs_canuseweapon.int)
 
Run when the AI checks whether it can use a weapon. This mostly happens when NPCs try to find weapons in their inventory or on the map.
 
Critter arg0 - the critter doing the check
 Item    arg1 - the weapon being checked
 int     arg2 - attack type (see ATKTYPE_* constants)
-int     arg3 - original result of engine function: 1 - can use, 0 - can't use
+int     arg3 - original result of engine function: 1 - can use, 0 - cannot use
 
 int     ret0 - overrides the result of engine function. Any non-zero value allows using the weapon
 
 
  CarTravel 
 
HOOK_CARTRAVEL (hs_cartravel.int)
 
Runs continuously during worldmap travel on car.
 
int     arg0 - vanilla car speed (between 3 and 8 "steps")
@@ -77,7 +77,7 @@
 int     arg3  - The amount of damage to the attacker
 int     arg4  - The special effect flags for the target (use bwand DAM_* to check specific flags)
 int     arg5  - The special effect flags for the attacker (use bwand DAM_* to check specific flags)
-int     arg6  - The weapon used in the attack
+Item    arg6  - The weapon used in the attack
 int     arg7  - The bodypart that was struck
 int     arg8  - Damage Multiplier (this is divided by 2, so a value of 3 does 1.5x damage, and 8 does 4x damage. Usually it's 2; for critical hits, the value is taken from the critical table; with Silent Death perk and the corresponding attack conditions, the value will be doubled)
 int     arg9 - Number of bullets actually hit the target (1 for melee attacks)
@@ -119,9 +119,9 @@
 int     arg3 - 1 if the hex would normally be blocking
 
 Obj     ret0 - 0 if the hex doesn't block, or any sort of object pointer if it does
-
 
  DescriptionObj 
 
HOOK_DESCRIPTIONOBJ (hs_descriptionobj.int)
 
Runs when using the examine action icon to display the description of an object. You can override the description text. An example usage would be to add an additional description to the item based on player’s stats/skills.
 
Does not run if the script of the object overrides the description.
 
Obj     arg0 - the object
+
 
  DescriptionObj 
 
HOOK_DESCRIPTIONOBJ (hs_descriptionobj.int)
 
Runs when using the examine action icon to display the description of an object. You can override the description text. An example usage would be to add an additional description to the item based on player’s stats/skills.
 
Does not run if the script of the object overrides the description.
 
NOTE: Returning a pointer to the new text received from the get_string_pointer function is still valid, but the method is DEPRECATED and is left for backward compatibility only.
 
Obj     arg0 - the object
 
-int     ret0 - a pointer to the new text received by using "get_string_pointer" function
+String  ret0 - the new description text to use
 
 
  Encounter 
 
HOOK_ENCOUNTER (hs_encounter.int)
 
Runs whenever a random encounter occurs (except the Horrigan meeting and scripted encounters), or when the player enters a local map from the world map. You can override the map for loading or the encounter.
 
int     arg0 - event type: 0 - when a random encounter occurs, 1 - when the player enters from the world map
 int     arg1 - the map ID that the encounter will load (see MAPS.h or Maps.txt)
 int     arg2 - 1 when the encounter occurs is a special encounter, 0 otherwise
@@ -153,7 +153,7 @@
 int     arg4 - 1 when removing an equipped item from inventory, 0 otherwise
 
 int     ret0 - overrides hard-coded handler (-1 - use engine handler, any other value - override) - NOT RECOMMENDED
-
 
  InventoryMove 
 
HOOK_INVENTORYMOVE (hs_inventorymove.int)
 
Runs before moving items between inventory slots in dude interface. You can override the action. What you can NOT do with this hook:
 
     
  • force moving items to inappropriate slots (like gun in armor slot) What you can do:
    •  
  • restrict player from using specific weapons or armors
    •  
  • add AP costs for all inventory movement including reloading
    •  
  • apply or remove some special scripted effects depending on PC’s armor
    •  
 
int     arg0 - Target slot:
+
 
  InventoryMove 
 
HOOK_INVENTORYMOVE (hs_inventorymove.int)
 
Runs before moving items between inventory slots in dude interface. You can override the action.
 
What you can NOT do with this hook:
 
     
  • force moving items to inappropriate slots (like gun in armor slot) What you can do:
    •  
  • restrict player from using specific weapons or armors
    •  
  • add AP costs for all inventory movement including reloading
    •  
  • apply or remove some special scripted effects depending on PC’s armor
    •  
 
int     arg0 - Target slot:
                0 - main backpack
                1 - left hand
                2 - right hand
@@ -167,7 +167,7 @@
 Item    arg2 - Item being replaced, weapon being reloaded, or container being filled (can be 0)
 
 int     ret0 - Override setting (-1 - use engine handler, any other value - prevent relocation of item/reloading weapon/picking up item)
-
 
  ItemDamage 
 
HOOK_ITEMDAMAGE (hs_itemdamage.int)
 
Runs when retrieving the damage rating of the player’s used weapon. (Which may be their fists.)
 
int     arg0 - The default min damage
+
 
Notes for the event of dropping items on the ground:
 
     
  • the event is called for each item when dropping multiple items from the stack
    •  
  • for ammo type items, the number of dropped ammo in a pack can be found by using the get_weapon_ammo_count function
    •  
  • for the PID_BOTTLE_CAPS item, the event is called only once, and the number of dropped units can be found from the value of the OBJ_DATA_CUR_CHARGES object field (or with the get_weapon_ammo_count function)
    •  
 
  ItemDamage 
 
HOOK_ITEMDAMAGE (hs_itemdamage.int)
 
Runs when retrieving the damage rating of the player’s used weapon. (Which may be their fists.)
 
int     arg0 - The default min damage
 int     arg1 - The default max damage
 Item    arg2 - The weapon used (0 if unarmed)
 Critter arg3 - The critter doing the attacking
@@ -241,21 +241,28 @@
 
 int     ret0 - overrides the result of the Sneak check
 int     ret1 - overrides the duration time for the current result
-
 
  StdProcedure 
 
HOOK_STDPROCEDURE (hs_stdprocedure.int)
 
Runs before Fallout executes a standard procedure (handler) in any script of any object. NOTE: this hook will not be executed for start, critter_p_proc, timed_event_p_proc, and map_update_p_proc procedures.
 
int     arg0 - the number of the standard script handler (see define.h)
+
 
  StdProcedure 
 
HOOK_STDPROCEDURE (hs_stdprocedure.int)
 
Runs before Fallout executes a standard procedure (handler) in any script of any object. NOTE: this hook will not be executed for start, critter_p_proc, timed_event_p_proc, and map_update_p_proc procedures.
 
int     arg0 - the number of the standard script handler (see *_proc in define.h)
 Obj     arg1 - the object that owns this handler (self_obj)
 Obj     arg2 - the object that called this handler (source_obj, can be 0)
+int     arg3 - always 0 (1 for _END version)
+Obj     arg4 - the object that is acted upon by this handler (target_obj, can be 0)
+int     arg5 - the parameter of this call (fixed_param), useful for combat_proc
 
 int     ret0 - pass -1 to cancel the execution of the handler
-
 
  StdProcedureEnd 
 
HOOK_STDPROCEDURE_END (hs_stdprocedure.int)
 
Runs after Fallout executes a standard procedure (handler) in any script of any object. NOTE: this hook will not be executed for start, critter_p_proc, timed_event_p_proc, and map_update_p_proc procedures.
 
int     arg0 - the number of the standard script handler (see define.h)
+
 
  StdProcedureEnd 
 
HOOK_STDPROCEDURE_END (hs_stdprocedure.int)
 
Runs after Fallout executes a standard procedure (handler) in any script of any object. NOTE: this hook will not be executed for start, critter_p_proc, timed_event_p_proc, and map_update_p_proc procedures.
 
int     arg0 - the number of the standard script handler (see *_proc in define.h)
 Obj     arg1 - the object that owns this handler (self_obj)
 Obj     arg2 - the object that called this handler (source_obj, can be 0)
-int     arg3 - 1 after procedure execution
+int     arg3 - always 1 (procedure end)
+Obj     arg4 - the object that is acted upon by this handler (target_obj, can be 0)
+int     arg5 - the parameter of this call (fixed_param), useful for combat_proc
 
 
  Steal 
 
HOOK_STEAL (hs_steal.int)
 
Runs when checking an attempt to steal or plant an item in other inventory using Steal skill.
 
This is fired before the default handlers are called, which you can override. In this case you MUST provide message of the result to player (“You steal the %s”, “You are caught planting the %s”, etc.). Example message (vanilla behavior):
 display_msg(sprintf(mstr_skill(570 + (isSuccess != false) + arg3 * 2), obj_name(arg2)));
 
Critter arg0 - Thief
 Obj     arg1 - The target
-Item    arg2 - Item being stolen/planted
+Item    arg2 - The item being stolen/planted
 int     arg3 - 0 when stealing, 1 when planting
+int     arg4 - quantity of the item being stolen/planted
 
-int     ret0 - overrides hard-coded handler (1 - force success, 0 - force fail, -1 - use engine handler)
+int     ret0 - overrides hard-coded handler (2 - force fail without closing window, 1 - force success, 0 - force fail, -1 - use engine handler)
+int     ret1 - overrides experience points gained for stealing this item (must be greater than or equal to 0)
 
 
  SubCombatDamage 
 
HOOK_SUBCOMBATDAMAGE (hs_subcombatdamage.int)
 
This hook overrides the vanilla damage calculation formula. Runs when:
 
     
  1. Before the game calculates how much damage each target will get. This includes primary target as well as all extras (explosions and bursts).
    2.  
  2. AI decides whether it is safe to use area attack (burst, grenades), if he might hit friendlies.
    3.  
 
Does not run for misses, non-combat damage like dynamite explosions, or if one of the damage formulas is selected in ddraw.ini.
 
Critter arg0 - the attacker
 Critter arg1 - the target
 Item    arg2 - the weapon used in the attack
@@ -284,7 +291,7 @@
 int     arg6 - Ranged flag. 1 if the hit chance calculation takes into account the distance to the target. This does not mean the attack is a ranged attack
 int     arg7 - The raw hit chance before applying the cap
 
-int     ret0 - the new hit chance
+int     ret0 - The new hit chance. The value is limited to the range of -99 to 999
 
 
  UseAnimObj 
 
HOOK_USEANIMOBJ (hs_useanimobj.int)
 
Runs before playing the “use” (usually “magic hands”) animation when a critter uses a scenery/container object on the map, or before walking/running animation if the player is at a distance from the object.
 
Critter arg0 - the critter that uses an object (usually dude_obj)
 Obj     arg1 - the object being used
 int     arg2 - the animation code being used (see ANIM_* in Animcomd.h)
@@ -310,7 +317,7 @@
 int     arg2 - skill being used
 
 int     ret0 - a new critter to override the user critter. Pass -1 to cancel the skill use, pass 0 to skip this return value
-int     ret1 - pass 1 to allow the skill being used in combat (only for dude_obj or critter being controlled by the player)
+int     ret1 - pass 1 to allow the skill to be used in combat (only for dude_obj or critter being controlled by the player)
 
 
  WithinPerception 
 
HOOK_WITHINPRECEPTION (hs_withinperception.int)
 
Runs when checking if one critter sees another critter. This is used in different situations like combat AI. You can override the result.
 
NOTE: obj_can_see_obj calls this first when deciding if critter can possibly see another critter with regard to perception, lighting, sneak factors.
 If check fails, the end result is false. If check succeeds (e.g. critter is within perception range), another check is made if there is any blocking tile between two critters (which includes stuff like windows, large bushes, barrels, etc.) and if there is - check still fails.
 You can override “within perception” check by returning 0 or 1, OR, as a convenience, you can also override blocking check after the perception check by returning 2 instead. In this case you should add “line of sight” check inside your hook script, otherwise critters will detect you through walls.
 
This is fired after the default calculation is made.
 
Critter arg0 - Watcher object
 Obj     arg1 - Target object
 int     arg2 - Result of vanilla function: 1 - within perception range, 0 - otherwise
@@ -324,4 +331,4 @@
                0 - not in range (can't see)
                1 - in range (will see if not blocked)
                2 - forced detection (will see regardless, only used in obj_can_see_obj script function which is called by every critter in the game)
-
 
 
 
 
  
+
diff --git a/hooks/index.html b/hooks/index.html index c1715c594..77dced266 100644 --- a/hooks/index.html +++ b/hooks/index.html @@ -1,4 +1,4 @@ - Hooks - sfall Hooks | sfall Link Search Menu Expand Document
sfall

Hooks

Hook scripts are specially named scripts that are run by sfall at specific points to allow mods to override normally hardcoded behaviour in a more flexible way than sfall’s normal ini configuration.

In addition to the bit of code it overrides, the script will be run once when first loaded and again at each player reload to allow for setup. Hook scripts have access to a set of arguments supplied to sfall, but aren’t required to use them all. They also return one or more values, but again they’re optional, and you only need to return a value if you want to override the default.

See hook types and hook functions reference for details.

Hooks compatibility

To aid in mods compatibility, avoid using hs_xxx .int scripts. Instead it is recommended to use a normal global script combined with register_hook_proc or register_hook.

Example setup for a hook-script based mod:

procedure tohit_hook_handler begin
+             Hooks | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Hooks 
 
Hook scripts are specially named scripts that are run by sfall at specific points to allow mods to override normally hardcoded behaviour in a more flexible way than sfall’s normal ini configuration.
 
In addition to the bit of code it overrides, the script will be run once when first loaded and again at each player reload to allow for setup. Hook scripts have access to a set of arguments supplied to sfall, but aren’t required to use them all. They also return one or more values, but again they’re optional, and you only need to return a value if you want to override the default.
 
See hook types and hook functions reference for details.
 
  Hooks compatibility 
 
To aid in mods compatibility, avoid using the predefined hs_<name>.int scripts. Instead it is recommended to use a normal global script combined with register_hook_proc or register_hook.
 
Example setup for a hook-script based mod:
 
procedure tohit_hook_handler begin
    display_msg("Modifying hit_hook " + get_sfall_arg);
    set_hit_chance_max(100);
    set_sfall_return(100);
@@ -9,4 +9,4 @@
       register_hook_proc(HOOK_TOHIT, tohit_hook_handler);
    end
 end
-
 
 
Table of contents
  
 
 
 
  
+

Table of contents

diff --git a/index.html b/index.html index 9560fa895..7e27d0cd3 100644 --- a/index.html +++ b/index.html @@ -1 +1 @@ - Home - sfall Home | sfall Link Search Menu Expand Document
sfall

sfall

sfall is a set of engine modifications for the classic game Fallout 2 in the form of a DLL, which modifies executable in memory without changing anything in EXE file itself.

Engine modifications include:

  • Better support for modern operating systems
  • Externalizing many settings like starting map and game time, skills, perks, critical hit tables, books, etc.
  • Bug fixes
  • Many additional features for users, such as item highlight button, party member control, etc.
  • Extended scripting capabilities for modders (many new opcodes to control sfall features as well as previously unavailable vanilla engine functions)

Note that this is documentation for sfall specifically, not Fallout scripting in general. For vanilla function reference, refer to the wiki.

Getting started

To get started with sfall, first familiarize yourself with new concepts:

Pay special attention to the best practices page. Also, take a look at SSLC features and optimization guide.

Next, proceed to discover new functions. They are categorized, use the menu to find the one you need. If you can’t, check uncategorized functions list and sfall macros. Also, there’s search at the top of the page.

Questions and problems

  • Report bugs and suggest features on Github.
  • Ask questions and discuss on the forum.
+ Home | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

sfall

sfall is a set of engine modifications for the classic game Fallout 2 in the form of a DLL, which modifies executable in memory without changing anything in EXE file itself.

Engine modifications include:

  • Better support for modern operating systems
  • Externalizing many settings like starting map and game time, skills, perks, critical hit tables, books, etc.
  • Bug fixes
  • Many additional features for users, such as item highlight button, party member control, etc.
  • Extended scripting capabilities for modders (many new opcodes to control sfall features as well as previously unavailable vanilla engine functions)

Note that this is documentation for sfall specifically, not Fallout scripting in general. For vanilla function reference, refer to the wiki.

Getting started

To get started with sfall, first familiarize yourself with new concepts:

Pay special attention to the best practices page. Also, take a look at SSLC features and optimization guide.

Next, proceed to discover new functions. They are categorized, use the menu to find the one you need. If you can’t, check uncategorized functions list and sfall macros. Also, there’s search at the top of the page.

Questions and problems

  • Report bugs and suggest features on Github.
  • Ask questions and discuss on the forum.
diff --git a/ini-settings/index.html b/ini-settings/index.html index 897349337..0919f2d11 100644 --- a/ini-settings/index.html +++ b/ini-settings/index.html @@ -1,7 +1,9 @@ - INI settings - sfall INI settings | sfall Link Search Menu Expand Document
sfall

INI settings

Functions

get_ini_section

sfall.h

array get_ini_section(string file, string sect)
-

Returns an associative array of keys and values for a given INI file and section. NOTE: all keys and their values will be of String type.

get_ini_sections

sfall.h

array get_ini_sections(string file)
-

Returns an array of names of all sections in a given INI file.

get_ini_setting 

int get_ini_setting(string setting)
-
  • 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.
  • 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’s settings, by using ddraw.ini as the file name.

get_ini_string 

string get_ini_string(string setting)
-

Reads a string value from an ini file in the fallout directory.

modified_ini 

int modified_ini
+             INI settings | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  INI settings 
 
  Functions 
 
 
  get_ini_config 
 
sfall.h
 
array get_ini_config(string file)
+
 
Loads a given INI file and returns a permanent array (map) where keys are section names and values are permanent sub-arrays (maps) where keys and values are strings.
 
     
  • Searches the file in the regular file system, like with all other ini-related functions.
    •  
  • Subsequent calls for the same file will return the same array, unless it was disposed using free_array.
    •  
 
  get_ini_config_db 
 
sfall.h
 
array get_ini_config_db(string file)
+
 
Works exactly like get_ini_config, except it searches the file in database (DAT) files. If not found, then it will try the regular file system.
 
  get_ini_section 
 
sfall.h
 
array get_ini_section(string file, string sect)
+
 
Returns an associative array of keys and values for a given INI file and section.
 
     
  • If the INI file is not found, it returns an empty array.
    •  
  • NOTE: all keys and their values will be of String type.
    •  
 
  get_ini_sections 
 
sfall.h
 
array get_ini_sections(string file)
+
 
Returns an array of names of all sections in a given INI file.
 
     
  • If the INI file is not found, it returns an empty array.
    •  
 
  get_ini_setting 
 
int get_ini_setting(string setting)
+
 
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 or the setting argument is in an invalid format, it returns -1.
    •  
  • 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.
    •  
 
  get_ini_string 
 
string get_ini_string(string setting)
+
 
Reads a string value from an ini file in the Fallout directory.
 
     
  • If the file or key cannot be found, it returns an empty string.
    •  
  • If the setting argument is in an invalid format, it returns -1 (integer).
    •  
 
  modified_ini 
 
int modified_ini
 
 
Returns the value of ModifiedIni setting in [Main] section of the INI.
 
  set_ini_setting 
 
sfall.h
 
void set_ini_setting(string setting, int/string value)
-
 
Writes an integer or a string value to an ini file in the Fallout directory. If the ini file does not exist, it will be created The setting argument works in the same way as in get_ini_setting, seperate the file name, section and key with a “|” character. Note: the file name is limited to 63 chars (including the extension), the section name is limited to 32 characters.
 
 
 
 
  
+

Writes an integer or a string value to an ini file in the Fallout directory. If the ini file does not exist, it will be created The setting argument works in the same way as in get_ini_setting, seperate the file name, section and key with a “|” character. Note: the file name is limited to 63 chars (including the extension), the section name is limited to 32 characters.

diff --git a/interface/index.html b/interface/index.html index b0987a198..565b3dfb0 100644 --- a/interface/index.html +++ b/interface/index.html @@ -1 +1 @@ - Interface - sfall Interface | sfall Link Search Menu Expand Document
sfall

Interface

Subcategories

+ Interface | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Interface

Subcategories

diff --git a/inventory/index.html b/inventory/index.html index 720f968b9..4b8feb2b4 100644 --- a/inventory/index.html +++ b/inventory/index.html @@ -1,3 +1,3 @@ - Inventory - sfall Inventory | sfall Link Search Menu Expand Document
sfall

Inventory

Functions

display_stats

sfall.h

void display_stats()
+             Inventory | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Inventory 
 
  Functions 
 
 
  display_stats 
 
sfall.h
 
void display_stats()
 
 
     
  • Updates player’s stats in the inventory display window or on the character screen.
    •  
  • NOTE: works only when the interface window is opened
    •  
 
  inventory_redraw 
 
sfall.h
 
void inventory_redraw(invSide)
-
 
Redraws inventory items list in the inventory/loot/barter screens. Argument invSide specifies which side needs to be redrawn: 0 - the player, 1 - target (container/NPC in loot/barter screens), -1 - both sides (same as without argument).
 
 
 
 
  
+

Redraws inventory items list in the inventory/loot/barter screens. Argument invSide specifies which side needs to be redrawn: 0 - the player, 1 - target (container/NPC in loot/barter screens), -1 - both sides (same as without argument).

diff --git a/keyboard-and-mouse/index.html b/keyboard-and-mouse/index.html index d29a309dd..e3b406e92 100644 --- a/keyboard-and-mouse/index.html +++ b/keyboard-and-mouse/index.html @@ -1,6 +1,6 @@ - Keyboard and mouse - sfall Keyboard and mouse | sfall Link Search Menu Expand Document
sfall

Keyboard and mouse

Functions

get_mouse_buttons 

int get_mouse_buttons()
+             Keyboard and mouse | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Keyboard and mouse 
 
  Functions 
 
 
  get_mouse_buttons 
 
int get_mouse_buttons()
 
 
Returns the number of the mouse button that is currently pressed (1 - left, 2 - right, 3 - left+right, 4 - middle, 0 otherwise).
 
  get_mouse_x 
 
int get_mouse_x()
 
 
  get_mouse_y 
 
int get_mouse_y()
 
 
  key_pressed 
 
int key_pressed(int dxScancode)
 
 
  tap_key 
 
void tap_key(int dxScancode)
-
 
 
 
 
  
+
diff --git a/knockback/index.html b/knockback/index.html index 06bd2bfbe..44ff5a099 100644 --- a/knockback/index.html +++ b/knockback/index.html @@ -1,7 +1,7 @@ - Knockback - sfall Knockback | sfall Link Search Menu Expand Document
sfall

Knockback

The type value in the weapon knockback functions can be 0 or 1. If 0, the value becomes an absolute distance that targets will be knocked back. If 1, the value is multiplied by the distance they would normally have been knocked back. Weapon knockback modifiers are applied in the order weapon -> attacker -> target, so a x2 weapon wielded by an abs 6 attacker hitting a /2 target will knock the target back 3 squares. The knockback functions will not override the stonewall perk or knockdowns resulting from criticals. knockback values set on weapons or critters are not saved, and must be reset each time the player reloads.

Functions

remove_attacker_knockback 

void remove_attacker_knockback(CritterPtr)
+             Knockback | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Knockback 
 
The type value in the weapon knockback functions can be 0 or 1. If 0, the value becomes an absolute distance that targets will be knocked back. If 1, the value is multiplied by the distance they would normally have been knocked back. Weapon knockback modifiers are applied in the order weapon -> attacker -> target, so a x2 weapon wielded by an abs 6 attacker hitting a /2 target will knock the target back 3 squares. The knockback functions will not override the stonewall perk or knockdowns resulting from criticals. knockback values set on weapons or critters are not saved, and must be reset each time the player reloads.
 
  Functions 
 
 
  remove_attacker_knockback 
 
void remove_attacker_knockback(CritterPtr)
 
 
  remove_target_knockback 
 
void remove_target_knockback(CritterPtr)
 
 
  remove_weapon_knockback 
 
void remove_weapon_knockback(WeaponPtr)
 
 
  set_attacker_knockback 
 
void set_attacker_knockback(CritterPtr, int type, float value)
 
 
  set_target_knockback 
 
void set_target_knockback(CritterPtr, int type, float value)
 
 
  set_weapon_knockback 
 
void set_weapon_knockback(WeaponPtr, int type, float value)
-
 
 
 
 
  
+
diff --git a/lists/index.html b/lists/index.html index 77f9ff9bb..5c7db5d6a 100644 --- a/lists/index.html +++ b/lists/index.html @@ -1,6 +1,6 @@ - Lists - sfall Lists | sfall Link Search Menu Expand Document
sfall

Lists

The list_xxx functions can be used to loop over all items on a map. list_begin takes an argument telling sfall what you want to list. (Defined in sfall.h) It returns a list pointer, which you iterate through with list_next. Finally, when you’ve finished with the list use list_end on it. Not calling list_end will result in a memory leak. Alternatively, use list_as_array to get the whole list at once as a temp array variable, which can be looped over using len_array and which you don’t need to remember to free afterwards.

Functions

list_as_array 

array list_as_array(int type)
+             Lists | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Lists 
 
The list_xxx functions can be used to loop over all items on a map. list_begin takes an argument telling sfall what you want to list. (Defined in sfall.h) It returns a list pointer, which you iterate through with list_next. Finally, when you’ve finished with the list use list_end on it. Not calling list_end will result in a memory leak. Alternatively, use list_as_array to get the whole list at once as a temp array variable, which can be looped over using len_array and which you don’t need to remember to free afterwards.
 
  Functions 
 
 
  list_as_array 
 
array list_as_array(int type)
 
 
  list_begin 
 
int list_begin(int type)
 
 
  list_end 
 
void list_end(int listid)
 
 
  list_next 
 
int list_next(int listid)
 
 
  party_member_list 
 
array party_member_list(int includeHidden)
-
 
Returns an array of all current party members (0 - only critter-type, alive and visible will be returned, 1 - all object, including Trunk, etc.)
 
 
 
 
  
+

Returns an array of all current party members (0 - only critter-type, alive and visible will be returned, 1 - all object, including Trunk, etc.)

diff --git a/locks/index.html b/locks/index.html index d8d217777..42ea8131a 100644 --- a/locks/index.html +++ b/locks/index.html @@ -1,4 +1,4 @@ - Locks - sfall Locks | sfall Link Search Menu Expand Document
sfall

Locks

Functions

lock_is_jammed

sfall.h

bool lock_is_jammed(ObjectPtr obj)
+             Locks | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Locks 
 
  Functions 
 
 
  lock_is_jammed 
 
sfall.h
 
bool lock_is_jammed(ObjectPtr obj)
 
 
Returns 1 if the lock (container or scenery) is currently jammed, 0 otherwise.
 
  set_unjam_locks_time 
 
sfall.h
 
void set_unjam_locks_time(int time)
 
 
Sets after how many hours (up to 127 hours) jammed locks will be unjammed if the player leaves the map. Also disables the auto unjam that occurs at midnight when the player is on the map. Passing 0 will disable the auto unjam mechanism completely. The auto unjam mechanism will be reset each time the player reloads the game.
 
  unjam_lock 
 
sfall.h
 
void unjam_lock(ObjectPtr obj)
-
 
Unjams a lock immediately without having to wait until the next day, or leave the map and then return after 24 hours. Does not work in use_skill_on_p_proc procedure.
 
 
 
 
  
+

Unjams a lock immediately without having to wait until the next day, or leave the map and then return after 24 hours. Does not work in use_skill_on_p_proc procedure.

diff --git a/main-interface/index.html b/main-interface/index.html index 29ed18d29..0ce1c4aed 100644 --- a/main-interface/index.html +++ b/main-interface/index.html @@ -1,5 +1,5 @@ - Main interface - sfall Main interface | sfall Link Search Menu Expand Document
sfall

Main interface

Functions

intface_hide

sfall.h

void intface_hide()
+             Main interface | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Main interface 
 
  Functions 
 
 
  intface_hide 
 
sfall.h
 
void intface_hide()
 
 
Hides main interface.
 
  intface_is_hidden 
 
sfall.h
 
bool intface_is_hidden()
 
 
Returns 1 if interface is currently hidden, 0 otherwise.
 
  intface_redraw 
 
sfall.h
 
void intface_redraw(bool winType)
 
 
Redraws main game interface. Useful after direct changes to current player weapons or stats to reflect changes.
 
     
  • redraws main game interface, useful to reflect changes after directly changing current player weapons or stats
    •  
  • winType: the type number of the interface window (see WINTYPE_* constants in sfall.h). Pass -1 to redraw all interface windows.
    •  
 
  intface_show 
 
sfall.h
 
void intface_show()
-
 
Shows main interface.
 
 
 
 
  
+

Shows main interface.

diff --git a/maps-and-encounters/index.html b/maps-and-encounters/index.html index 70c57f820..467ae7a12 100644 --- a/maps-and-encounters/index.html +++ b/maps-and-encounters/index.html @@ -1,4 +1,4 @@ - Maps and encounters - sfall Maps and encounters | sfall Link Search Menu Expand Document
sfall

Maps and encounters

Subcategories

Functions

exec_map_update_scripts

sfall.h

void exec_map_update_scripts()
+             Maps and encounters | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Maps and encounters 
 
  Subcategories 
  
  Functions 
 
 
  exec_map_update_scripts 
 
sfall.h
 
void exec_map_update_scripts()
 
 
Executes map_update_p_proc for all objects on map and global/hook scripts as well.
 
  force_encounter 
 
void force_encounter(int map)
 
 
Can be called either from a global script while traveling on the world map, or from a normal script while on a local map. In either case the encounter occurs shortly after the next time the player moves on the world map. The player will not get an outdoorsman skill check.
 
  force_encounter_with_flags 
 
void force_encounter_with_flags(int map, int flags)
 
 
Does the same thing as force_encounter, but allows the specification of some extra options (see sfall.h for available flags). Forcing a random encounter on a map that is not normally used for random encounters may cause the player to lose the car, if they have it. In this case use force_encounter_with_flags with the ENCOUNTER_FLAG_NO_CAR flag set.
 
  get_map_enter_position 
 
array get_map_enter_position()
@@ -9,4 +9,4 @@
 
 
Adjusts how fast time passes while you’re on the world map. It takes a single float as an argument, where 1 is the normal speed. This function works in addition to the WorldMapTimeMod setting in ddraw.ini and the Pathfinder perk, rather than overriding it, so calling set_map_time_multi(0.5) when the player has 2 levels of Pathfinder would result in time passing at 25% the normal speed on the world map.
 
  set_terrain_name 
 
sfall.h
 
void sfall_func3("set_terrain_name", int x, int y, string name)
 
 
Overrides the terrain type name for the sub-tile on the world map by the specified coordinates.
 
  set_town_title 
 
void sfall_func2("set_town_title", int areaID, string title)
 
 
Sets a floating text for a town on the world map when hovering the cursor over the player’s marker.
 
- areaID: the ID number of the town from city.txt
-
 
 
 
 
  
+
diff --git a/math/index.html b/math/index.html index f82f54bef..d62d42e4d 100644 --- a/math/index.html +++ b/math/index.html @@ -1,4 +1,4 @@ - Math - sfall Math | sfall Link Search Menu Expand Document
sfall

Math

Functions

^ 

x^y
+             Math | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Math 
 
  Functions 
 
 
  ^ 
 
x^y
 
 
Exponentiation. Use as any other arithmetic operator, like 5^(1/3). If exponent is an integer, you can use a negative base, otherwise you will get “NaN” with a negative base. If both arguments are integers, the result will be an integer.
 
  abs 
 
int/float abs(int/float x)
 
 
Absolute (positive) value of x.
 
  arctan 
 
float arctan(float x, float y)
 
 
Arctangent of x. Pass 1 as y (don’t ask…).
 
  ceil 
 
int ceil(float x)
@@ -6,9 +6,9 @@
 
 
Cosine of x
 
  div 
 
div(x, y)
 
 
Unsigned integer division. Use as a division operator, like 3 + (20 div 5). If both dividend and divisor are integers, they will be treated as unsigned integers. If one of them is a float, div will perform the signed division just like vanilla division operator.
 
  exponent 
 
float exponent(float x)
 
 
E^X
 
  floor2 
 
sfall.h
 
int floor2(int/float value)
-
 
Works just like vanilla floor function, but returns correct integers for negative values (vanilla floor function works exactly the same as ceil for negative values, much like trunc in C/C++).
 
  log 
 
float log(float x)
+
 
Works just like vanilla floor function, but returns correct integers for negative floats.
 
     
  • NOTE: vanilla floor function works exactly the same as ceil for negative floats (i.e. basically trunc in C/C++).
    •  
 
  log 
 
float log(float x)
 
 
Natural logarithm of x.
 
  round 
 
int round(float x)
 
 
Round x to the nearest integer.
 
  sin 
 
float sin(float x)
 
 
Sine of x
 
  sqrt 
 
float sqrt(float x)
 
 
Square root of x.
 
  tan 
 
float tan(float x)
-
 
Tangent of x
 
 
 
 
  
+

Tangent of x

diff --git a/npc-perks/index.html b/npc-perks/index.html index 3c8157581..dc30b9e1f 100644 --- a/npc-perks/index.html +++ b/npc-perks/index.html @@ -1,6 +1,6 @@ - NPC perks - sfall NPC perks | sfall Link Search Menu Expand Document
sfall

NPC perks

These functions are similar to has_fake_*/set_fake_*/set_selectable_perk functions, but apply to the specified party member NPC (including dude_obj)

Functions

has_fake_perk_npc

sfall.h

int has_fake_perk_npc(object npc, string namePerk)
+             NPC perks | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  NPC perks 
 
These functions are similar to has_fake_*/set_fake_*/set_selectable_perk functions, but apply to the specified party member NPC (including dude_obj)
 
  Functions 
 
 
  has_fake_perk_npc 
 
sfall.h
 
int has_fake_perk_npc(object npc, string namePerk)
 
 
  has_fake_trait_npc 
 
sfall.h
 
int has_fake_trait_npc(object npc, string nameTrait)
 
 
  set_fake_perk_npc 
 
sfall.h
 
void set_fake_perk_npc(object npc, string namePerk, int level, int image, string desc)
 
 
  set_fake_trait_npc 
 
sfall.h
 
void set_fake_trait_npc(object npc, string nameTrait, int active, int image, string desc)
 
 
  set_selectable_perk_npc 
 
sfall.h
 
void set_selectable_perk_npc(object npc, string namePerk, int active, int image, string desc)
-
 
 
 
 
  
+
diff --git a/objects-and-scripts/index.html b/objects-and-scripts/index.html index 81b4cc4ef..b3eba04fa 100644 --- a/objects-and-scripts/index.html +++ b/objects-and-scripts/index.html @@ -1,18 +1,18 @@ - Objects and scripts - sfall Objects and scripts | sfall Link Search Menu Expand Document
sfall

Objects and scripts

Functions

dialog_obj

sfall.h

ObjectPtr dialog_obj()
+             Objects and scripts | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Objects and scripts 
 
  Functions 
 
 
  dialog_obj 
 
sfall.h
 
ObjectPtr dialog_obj()
 
 
Returns a pointer to the object (critter) the player is having a conversation or bartering with.
 
  get_flags 
 
sfall.h
 
int get_flags(ObjectPtr obj)
 
 
Gets the current value of object flags (see define_extra.h for available flags).
 
  get_object_data 
 
sfall.h
 
get_object_data(ObjectPtr object, int offset)
-
 
Returns the data at the specified offset of an object (see OBJ_DATA_* constants in define_extra.h for offsets).
 
  get_script 
 
int get_script(ObjectPtr)
+
 
Returns the data at the specified offset of an object (see OBJ_DATA_* constants in define_extra.h for offsets).
 
  get_script 
 
int get_script(ObjectPtr obj)
 
 
     
  • accepts a pointer to an object and returns its scriptID (line number in scripts.lst), or 0 if the object is unscripted.
    •  
  • returns -1 on argument error.
    •  
 
  loot_obj 
 
sfall.h
 
ObjectPtr loot_obj()
 
 
Returns a pointer to the target object (container or critter) of the loot screen.
 
  obj_is_carrying_obj 
 
int (ObjectPtr invenObj, ObjectPtr itemObj)
 
 
Returns number of itemObj inside invenObj’s inventory, note that both arguments are object pointers. useful when dealing with different stacks of same item (obj_is_carrying_obj_pid just returns total for all stacks of the same PID.)
 
  obj_is_openable 
 
sfall.h
 
bool obj_is_openable(object obj)
-
 
Returns True if the object is openable (i.e. has an opening/closing animation)
 
  obj_under_cursor 
 
sfall.h
 
ObjectPtr obj_under_cursor(bool onlyCritter, bool includeDude)
+
 
Returns True if the object is openable (i.e. has an opening/closing animation), False otherwise
 
  obj_under_cursor 
 
sfall.h
 
ObjectPtr obj_under_cursor(bool onlyCritter, bool includeDude)
 
 
Returns the object under the cursor on the main game screen.
 
     
  • onlyCritter: 
       
    • True - only checks critters and ignores their cover (roof tiles, walls, scenery, etc.)
      •  
    • False - checks all objects (can’t check critters under objects)
      •  
     
    •  
  • passing False to the includeDude argument will ignore dude_obj 
       
    • NOTE: to get an object located on a tile when the cursor is in movement mode (hexagon cursor), use the tile_under_cursor function
      •  
     
    •  
 
  real_dude_obj 
 
sfall.h
 
ObjectPtr real_dude_obj()
-
 
Returns the initial dude_obj after set_dude_obj was used.
 
  remove_script 
 
void remove_script(ObjectPtr)
+
 
Returns the initial dude_obj after set_dude_obj was used.
 
  remove_script 
 
void remove_script(ObjectPtr obj)
 
 
Accepts a pointer to an object and will remove the script from that object.
 
  set_dude_obj 
 
sfall.h
 
void set_dude_obj(ObjectPtr critter)
 
 
Take control of a given critter. Passing value 0 will reset control back to “real” dude.
 
  set_flags 
 
sfall.h
 
void set_flags(ObjectPtr obj, int flags)
 
 
Sets the current flags of an object. All flags are rewritten with given integer, so first get current flags with get_flags and use bwor/bwand to set/remove specific flag.
 
  set_object_data 
 
sfall.h
 
set_object_data(ObjectPtr object, int offset, int data)
 
 
Sets the data at the specified offset of an object.
 
  set_scr_name 
 
sfall.h
 
void set_scr_name(string name)
-
 
Overrides the name of the script object that was set from scrname.msg.
 
     
  • The changed name will be reset each time the player leaves the map or reloads the game
    •  
  • Passing an empty string (“”) to the name argument or omitting it will allow the game to get the name for the object from pro_*.msg files
    •  
  • NOTE: this function is intended for use in normal game scripts and overrides the name only once for the same object until reset
    •  
 
  set_script 
 
void set_script(ObjectPtr, int scriptid)
-
 
Accepts a pointer to an object and scriptID, and applies the given script to an object (scriptID accept the same values as create_object_sid from sfall 3.6). If used on an object that is already scripted, it will remove the existing script first; you cannot have multiple scripts attached to a single object. Calling set_script on self_obj will have all sorts of wacky side effects, and should be avoided. If you add 0x80000000 to the sid when calling set_script, map_enter_p_proc will be SKIPPED. The start proc will always be run.
 
  set_self 
 
void set_self(ObjectPtr)
+
 
Overrides the name of the script object that was set from scrname.msg.
 
     
  • The changed name will be reset each time the player leaves the map or reloads the game
    •  
  • Passing an empty string (“”) to the name argument or omitting it will allow the game to get the name for the object from pro_*.msg files
    •  
  • NOTE: this function is intended for use in normal game scripts and overrides the name only once for the same object until reset
    •  
 
  set_script 
 
void set_script(ObjectPtr obj, int scriptID)
+
 
Accepts a pointer to an object and scriptID, and applies the given script to an object (scriptID accept the same values as create_object_sid from sfall 3.6). If used on an object that is already scripted, it will remove the existing script first; you cannot have multiple scripts attached to a single object. Calling set_script on self_obj will have all sorts of wacky side effects, and should be avoided. If you add 0x80000000 to the sid when calling set_script, map_enter_p_proc will be SKIPPED. The start proc will always be run.
 
  set_self 
 
void set_self(ObjectPtr setObj)
 
 
Overrides the script’s self_obj for the next function call.
 
     
  • It is primarily used to allow the calling of functions which take an implicit self_obj parameter (e.g. drop_obj) from global scripts, but it can also be used from normal scripts.
    •  
  • self_obj will be reverted to its original value after the next function call.
    •  
  • Calling set_self(0) will also revert self_obj to its original value. It is recommended to call this after each use of set_self in normal scripts in order to avoid unforeseen side effects.
    •  
  • source_obj, target_obj, and similar functions will not work if preceded by set_self.
    •  
  • NOTE: for use_obj, use_obj_on_obj vanilla functions to work correctly, it is required to call set_self twice. You can also access the local variables in the script of an object after calling set_self twice.
    •  
 
  set_unique_id 
 
sfall.h
 
int set_unique_id(ObjectPtr object, int flag)
-
 
Assigns a unique ID number to the object and returns it. If a unique ID number has already been assigned to an object, then ID number is returned without reassignment. flag is optional.
 
     
  • items with unique IDs will not stack with other items of the same type in the inventory
    •  
  • to just get the current ID number of an object, use get_object_data(object, OBJ_DATA_ID)
    •  
  • unique ID numbers are saved in your savegame, and have a range from 0x10000000 to 0x7FFFFFFF
    •  
  • there is also a unique ID number range for the player and party members from 18000 to 83535
    •  
  • to assign a new ID number generated by the engine to the object (i.e. unassign a unique ID), call the function with two arguments and pass -1 for the flag argument
    •  
 
 
 
 
  
+

Assigns a unique ID number to the object and returns it. If a unique ID number has already been assigned to an object, then ID number is returned without reassignment. flag is optional.

  • items with unique IDs will not stack with other items of the same type in the inventory
  • to just get the current ID number of an object, use get_object_data(object, OBJ_DATA_ID)
  • unique ID numbers are saved in your savegame, and have a range from 0x10000000 to 0x7FFFFFFF
  • there is also a unique ID number range for the player and party members from 18000 to 83535
  • to assign a new ID number generated by the engine to the object (i.e. unassign a unique ID), call the function with two arguments and pass -1 for the flag argument
diff --git a/optimization/index.html b/optimization/index.html index b40024436..984f5f513 100644 --- a/optimization/index.html +++ b/optimization/index.html @@ -1,7 +1,7 @@ - Optimization - sfall Optimization | sfall Link Search Menu Expand Document
sfall

Optimization

The executation speed of scripts is not typically important in an unmodded game, given the difference in performance between a modern computer and what Fallout was designed for. When you start adding mods to the mix there’s the potential for problems again, since sfall’s global script system means that you can have a large amount of scripts being run every single frame.

sslc -O option

The sfall build of sslc supports a -O command line option to perform an optimization pass over the generated code. This isn’t a magic make-my-code-go-faster bullet; most of what it does is very limited in scope. It’s primary purpose was to strip out the procedures and variables which get automatically pulled into every script that includes define.h, whether you use them or not, and to do something about the additional variables that get created by foreach loops.

There are several levels of optimization available:

  • -O1 - Basic, only removes unreferenced globals variables and procedures, code itself remains untouched.
  • -O2 - Full, most code optimizations are on, but only those that were tested on complex scripts.
  • -O3 - Experimental, provides most efficiency, but tend to break some complex code due to bugs.

The following optimizations are performed:

  • constant expression folding: if an expression depends only on values which are known at compile time, then the expression is replaced by its result. 
    a := 2 + 2;  -> a := 4;
+             Optimization | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
     
     
     
      Optimization 
      
    The execution speed of scripts is not typically important in an unmodded game, given the difference in performance between a modern computer and what Fallout was designed for. When you start adding mods to the mix there’s the potential for problems again, since sfall’s global script system means that you can have a large amount of scripts being run every single frame.
     
      sslc -O option 
     
    The sfall build of sslc supports a -O command line option to perform an optimization pass over the generated code. This isn’t a magic make-my-code-go-faster bullet; most of what it does is very limited in scope. It’s primary purpose was to strip out the procedures and variables which get automatically pulled into every script that includes define.h, whether you use them or not, and to do something about the additional variables that get created by foreach loops.
     
    There are several levels of optimization available:
     
       
    • -O1 - Basic, only removes unreferenced globals variables and procedures, code itself remains untouched.
      •  
    • -O2 - Full, most code optimizations are on, but only those that were tested on complex scripts.
      •  
    • -O3 - Experimental, provides most efficiency, but tend to break some complex code due to bugs.
      •  
     
    The following optimizations are performed:
     
       
    • constant expression folding: if an expression depends only on values which are known at compile time, then the expression is replaced by its result. 
      a := 2 + 2;  -> a := 4;
 
       
       
      •  
    • constant variable initialization: All variables are initialised to some value, (‘0’, if you don’t specify anything else,) so sslc attempts to make use of that fact to remove the first assignment to a variable if the first assignment is a constant expression. 
      variable a;  -> variable a := 4;
 a := 4;      ->
-
       
       
      •  
    • constant propagation: checks for values assigned to variables which can be computed at compile time, and replaces relevent references to the symbol by the constant. The original store is not removed by this optimization. Global variables are considered for this optimization only if they are not marked import or export, and are not assigned to anywhere in the script. 
      a := 4;  -> a := 4;
+
       
       
      •  
    • constant propagation: checks for values assigned to variables which can be computed at compile time, and replaces relevant references to the symbol by the constant. The original store is not removed by this optimization. Global variables are considered for this optimization only if they are not marked import or export, and are not assigned to anywhere in the script. 
      a := 4;  -> a := 4;
 foo(a);  -> foo(4);
 
       
       
      •  
    • dead code removal: Checks for and removes code which cannot be reached, either because it is hidden behind a return or because the argument to an if statement can be computed at compile time. 
      if (True) then begin   -> display_msg("foo");
   display_msg("foo");  ->
@@ -35,4 +35,4 @@
   ...                                         -> while i < tmp do begin
 end                                           ->   ...
                                               -> end
-
       
       
      •  
    •  
      Mark functions with pure or inline where relevent.
       
         
      •  
        pure is a hint to the optimizer that a procedure has no side effects. (i.e. there’s no way to tell that it’s been called aside from its return value.) Pure procedures cannot modify global variables, or call any other procedure that isn’t itself pure. Functions marked with pure can only be used in expressions (i.e. you cannot use the call <procedure> syntax to call them.) If there are non-pure terms in an expression, it prevents that expression being considered for dead store removal. Where no such optimizations can be performed, or if optimization is disabled, marking a procedure with pure will have no effect on the compiled code.
         
        •  
      •  
        inline is an instruction to the compiler to replace calls to the marked procedure with a copy of the procedures code instead of having a seperate call. Inlined procedures cannot use the return command, cannot be predefined, and cannot be used as part of an expression. Inlining if a procedure is only going to be called once is always a win, but if there are multiple calls to a procedure you will end up bloating the size of the generated code.
         
        •  
       
      •  
     
     
     
     
      
+

  • Mark functions with pure or inline where relevant.

    • pure is a hint to the optimizer that a procedure has no side effects. (i.e. there’s no way to tell that it’s been called aside from its return value.) Pure procedures cannot modify global variables, or call any other procedure that isn’t itself pure. Functions marked with pure can only be used in expressions (i.e. you cannot use the call <procedure> syntax to call them.) If there are non-pure terms in an expression, it prevents that expression being considered for dead store removal. Where no such optimizations can be performed, or if optimization is disabled, marking a procedure with pure will have no effect on the compiled code.

    • inline is an instruction to the compiler to replace calls to the marked procedure with a copy of the procedures code instead of having a separate call. Inlined procedures cannot use the return command, cannot be predefined, and cannot be used as part of an expression. Inlining if a procedure is only going to be called once is always a win, but if there are multiple calls to a procedure you will end up bloating the size of the generated code.

diff --git a/other/index.html b/other/index.html index 82642506a..a58e3dfaa 100644 --- a/other/index.html +++ b/other/index.html @@ -1,4 +1,4 @@ - Other - sfall Other | sfall Link Search Menu Expand Document
sfall

Other

Functions

active_hand 

int active_hand
+             Other | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Other 
 
  Functions 
 
 
  active_hand 
 
int active_hand
 
 
  add_g_timer_event 
 
sfall.h
 
void add_g_timer_event(int time, int fixedParam)
 
 
Adds a timer event that calls the timed_event_p_proc procedure in the current global script time: the number of ticks after which the event timer is triggered fixedParam: the value that is passed to the timed_event_p_proc procedure for the fixed_param function
 
  add_trait 
 
sfall.h
 
void add_trait(int traitID)
 
 
adds the specified trait to the player
 
  create_message_window 
 
void create_message_window(string message)
@@ -37,7 +37,7 @@
 
 
  set_movie_path 
 
void set_movie_path(string filename, int movieid)
 
 
  set_pickpocket_max 
 
void set_pickpocket_max(int percentage)
 
 
Effects all critters rather than just the player and can set the maximum in range from 0 to 999.
 
  set_pipboy_available 
 
void set_pipboy_available(int available)
-
 
Will only accept 0 or 1 as an argument. Using any other value will cause the function to have no effect. Use 0 to disable the pipboy, and 1 to enable it.
 
  set_proto_data 
 
void set_proto_data(int pid, int offset, int value)
+
 
Sets the availability of the pipboy in the game. Use 0 to disable the pipboy, and 1 or 2 to enable it (value 2 does not mark the VSUIT_MOVIE movie as “played”).
 
  set_proto_data 
 
void set_proto_data(int pid, int offset, int value)
 
 
Used to alter the in-memory copies of the .pro files Fallout makes when they are loaded. The offset refers to the offset in memory from the start of the proto to the element you are reading. Changes are not stored on disc, and are not permanent. If you modify the protos, and then Fallout subsequently reloads the file your changes will be lost.
 
  set_unspent_ap_bonus 
 
void set_unspent_ap_bonus(int multiplier)
 
 
Alters the AC bonus you receive per unused action point at the end of your turn in combat. To allow for fractional values, the value given if divided by 4. (Hence the default value is 4 and not 1.)
 
  set_unspent_ap_perk_bonus 
 
void set_unspent_ap_perk_bonus(int multiplier)
 
 
Similar to set_unspent_ap_bonus, but effects the extra AC granted by the H2H Evade perk. (The default value of this is also 4, equivalent to doubling the original bonus.
 
  set_viewport_x 
 
void set_viewport_x(int view_x)
@@ -47,4 +47,4 @@
 
 
Returns 1 if last sneak attempt (roll against skill) was successful, 0 otherwise. This calls an internal engine function which is used to determine the perception range of critters (which you can override using HOOK_WITHINPERCEPTION).
 
  stop_game 
 
void stop_game()
 
 
  toggle_active_hand 
 
void toggle_active_hand
 
 
  unwield_slot 
 
void sfall_func2("unwield_slot", object critter, int slot)
-
 
unequips an item from the specified slot for a critter or the player can take off player’s equipped item when the inventory is opened, or the player is in the barter screen slot: 0 - armor slot, 1 - right slot, 2 - left slot (see INVEN_TYPE_* in define.h)
 
 
 
 
  
+

unequips an item from the specified slot for a critter or the player can take off player’s equipped item when the inventory is opened, or the player is in the barter screen slot: 0 - armor slot, 1 - right slot, 2 - left slot (see INVEN_TYPE_* in define.h)

diff --git a/outline/index.html b/outline/index.html index f86a91581..661cf3f2f 100644 --- a/outline/index.html +++ b/outline/index.html @@ -1,4 +1,4 @@ - Outline - sfall Outline | sfall Link Search Menu Expand Document
sfall

Outline

Functions

get_outline

sfall.h

int get_outline(ObjectPtr obj)
+             Outline | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Outline 
 
  Functions 
 
 
  get_outline 
 
sfall.h
 
int get_outline(ObjectPtr obj)
 
 
Gets the current outline color for an object.
 
  outlined_object 
 
sfall.h
 
ObjectPtr outlined_object()
 
 
Returns an object that is currently highlighted by hovering the mouse above it.
 
  set_outline 
 
sfall.h
 
void set_outline(ObjectPtr obj, int color)
-
 
     
  • sets the outline color of an object (see OUTLINE_* constants in sfall.h)
    •  
  • can also set a custom color from the game palette by shifting the color index value left by 8 bits: 0xCC00 where CC is the palette index (available since sfall 4.2.7/3.8.27)
    •  
  • passing 0 will disable the outline
    •  
 
 
 
 
  
+
  • sets the outline color of an object (see OUTLINE_* constants in sfall.h)
  • can also set a custom color from the game palette by shifting the color index value left by 8 bits: 0xCC00 where CC is the palette index (available since sfall 4.2.7/3.8.27)
  • passing 0 will disable the outline
diff --git a/perks-and-traits/index.html b/perks-and-traits/index.html index 990c3d6f8..925093f6e 100644 --- a/perks-and-traits/index.html +++ b/perks-and-traits/index.html @@ -1,4 +1,4 @@ - Perks and traits - sfall Perks and traits | sfall Link Search Menu Expand Document
sfall

Perks and traits

Subcategories

Functions

apply_heaveho_fix 

void apply_heaveho_fix
+             Perks and traits | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Perks and traits 
 
  Subcategories 
  
  Functions 
 
 
  apply_heaveho_fix 
 
void apply_heaveho_fix
 
 
  clear_selectable_perks 
 
void clear_selectable_perks()
 
 
Restores the “select a perk” box to its default state.
 
  get_perk_available 
 
int get_perk_available(int perk)
 
 
  get_perk_owed 
 
int get_perk_owed
@@ -37,4 +37,4 @@
 
 
  set_selectable_perk 
 
void set_selectable_perk(string name, int active, int image, string desc)
 
 
Used to add additional items to “select a perk” box by setting the ‘active’ parameter to 1, and to remove them again by setting it to 0.
 
  set_swiftlearner_mod 
 
void set_swiftlearner_mod(int bonus)
 
 
  show_real_perks 
 
void show_real_perks()
-
 
Reverts the effect os hide_real_perks.
 
 
 
 
  
+

Reverts the effect os hide_real_perks.

diff --git a/pip-boy/index.html b/pip-boy/index.html index c85a16c9c..112a3d0c8 100644 --- a/pip-boy/index.html +++ b/pip-boy/index.html @@ -1,2 +1,2 @@ - Pip-Boy - sfall Pip-Boy | sfall Link Search Menu Expand Document
sfall

Pip-Boy

Functions

set_quest_failure_value 

void sfall_func2("set_quest_failure_value", int gvarNumber, int thresholdValue)
-
  • sets the threshold value (failure_threshold) for the quest at which the quest will be considered failed (its description in the pipboy will be crossed out and colored red)
  • gvarNumber: the number of the global variable controlling the quest
  • thresholdValue: the value of the global variable at which the quest is counted as a failure
+ Pip-Boy | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Pip-Boy

Functions

set_quest_failure_value 

void sfall_func2("set_quest_failure_value", int gvarNumber, int thresholdValue)
+
  • sets the threshold value (failure_threshold) for the quest at which the quest will be considered failed (its description in the pipboy will be crossed out and colored red)
  • gvarNumber: the number of the global variable controlling the quest
  • thresholdValue: the value of the global variable at which the quest is counted as a failure
diff --git a/read_xxx/index.html b/read_xxx/index.html index 3be2289c7..dc4d640c2 100644 --- a/read_xxx/index.html +++ b/read_xxx/index.html @@ -1,5 +1,5 @@ - read_xxx - sfall read_xxx | sfall Link Search Menu Expand Document
sfall

read_xxx

These functions take a memory address as the parameter and can read arbitrary pieces of Fallout’s address space.

Functions

read_byte 

int read_byte(int address)
+             read_xxx | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  read_xxx 
 
These functions take a memory address as the parameter and can read arbitrary pieces of Fallout’s address space.
 
  Functions 
 
 
  read_byte 
 
int read_byte(int address)
 
 
  read_int 
 
int read_int(int address)
 
 
  read_short 
 
int read_short(int address)
 
 
  read_string 
 
int read_string(int address)
-
 
 
 
 
  
+
diff --git a/rest/index.html b/rest/index.html index 7e1d7f1c5..9cf48693f 100644 --- a/rest/index.html +++ b/rest/index.html @@ -1,3 +1,3 @@ - Rest - sfall Rest | sfall Link Search Menu Expand Document
sfall

Rest

Functions

get_can_rest_on_map

sfall.h

get_can_rest_on_map(int mapNum, int elev)
+             Rest | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
  
 
 
  Rest 
 
  Functions 
 
 
  get_can_rest_on_map 
 
sfall.h
 
get_can_rest_on_map(int mapNum, int elev)
 
 
     
  • returns the set rest value of the map after using the set_can_rest_on_map function
    •  
  • Returns -1 if the rest value of the map was not previously set (i.e. no data for the map in sfalldb.sav)
    •  
  • the can_rest_here values from maps.txt are ignored.
    •  
 
  set_can_rest_on_map 
 
sfall.h
 
void set_can_rest_on_map(int mapNum, int elev, bool value)
-
 
Allows/disallows to rest on the map for the specified level, overrides the can_rest_here values in maps.txt.
 
     
  • mapNum is the map index from maps.txt
    •  
  • passing -1 to the elev argument will set the rest value for all map elevations
    •  
  • the set rest value will be stored in sfalldb.sav file (in savegame)
    •  
 
 
 
 
  
+

Allows/disallows to rest on the map for the specified level, overrides the can_rest_here values in maps.txt.

  • mapNum is the map index from maps.txt
  • passing -1 to the elev argument will set the rest value for all map elevations
  • the set rest value will be stored in sfalldb.sav file (in savegame)
diff --git a/sfall-funcx-macros/index.html b/sfall-funcx-macros/index.html index 4f8188c39..06162d9d2 100644 --- a/sfall-funcx-macros/index.html +++ b/sfall-funcx-macros/index.html @@ -1,4 +1,4 @@ - Sfall funcX macros - sfall Sfall funcX macros | sfall Link Search Menu Expand Document
sfall

Sfall funcX macros

Functions

add_extra_msg_file

sfall.h

int add_extra_msg_file(string fileName)
+             Sfall funcX macros | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Sfall funcX macros 
 
  Functions 
 
 
  add_extra_msg_file 
 
sfall.h
 
int add_extra_msg_file(string fileName)
 
 
Loads the custom message file, and returns the file ID number assigned to it in range from 0x3000 to 0x3FFF for the message_str_game function to get messages from the file.
 
     
  • fileName: the name of the custom message file (including the .msg extension) in text\<language>\game\ directory.
    •  
 
Alternative form: int add_extra_msg_file(string fileName, int fileNumber)
 
     
  • fileNumber: the file ID number for the message_str_game function. The available range is from 0x2000 to 0x2FFF (see ExtraGameMsgFileList setting in ddraw.ini) Use fileNumber only if you want to add a message file without editing ddraw.ini or existing scripts to support the old way.
    •  
 
  critter_inven_obj2 
 
sfall.h
 
ObjectPtr critter_inven_obj2(ObjectPtr obj, int type)
 
 
Works just like vanilla critter_inven_obj, but correctly reports item in player’s inactive hand slot.
 
  dialog_message 
 
sfall.h
 
void dialog_message(string text)
 
 
Displays a message in the NPC response window in dialog or barter screen.
 
  get_current_inven_size 
 
sfall.h
 
get_current_inven_size(ObjectPtr object)
@@ -21,4 +21,4 @@
 
 
Compares two strings case-insensitive, and returns True if the two strings are matched.
 
  sfall_func3(“string_compare”, string str1, string str2, int codePage) 
 
sfall.h
 
bool sfall_func3("string_compare", string str1, string str2, int codePage)
 
 
Compares two strings case-insensitive, and returns True if the two strings are matched
 
     
  • codePage: code page number to properly compare national characters in the range 128-255 of the ASCII code table available encodings: 1250-1252, 866
    •  
 
  spatial_radius 
 
sfall.h
 
int spatial_radius(ObjectPtr obj)
 
 
Returns radius of spatial script, associated with given dummy-object (returned by create_spatial).
 
  void sfall_func0(“remove_timer_event”) 
 
sfall.h
 
void sfall_func0("remove_timer_event")
-
 
Clears all set timer events for the current global script.
 
 
 
 
  
+

Clears all set timer events for the current global script.

diff --git a/sfall/index.html b/sfall/index.html index 909d6a3fa..1ca2a6c4d 100644 --- a/sfall/index.html +++ b/sfall/index.html @@ -1 +1 @@ - Sfall - sfall Sfall | sfall Link Search Menu Expand Document
sfall

Sfall

Subcategories

+ Sfall | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Sfall

Subcategories

diff --git a/skills/index.html b/skills/index.html index 03c263a51..f19f29ca8 100644 --- a/skills/index.html +++ b/skills/index.html @@ -1,4 +1,4 @@ - Skills - sfall Skills | sfall Link Search Menu Expand Document
sfall

Skills

Functions

get_available_skill_points 

int get_available_skill_points()
+             Skills | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  Skills 
 
  Functions 
 
 
  get_available_skill_points 
 
int get_available_skill_points()
 
 
  get_critter_skill_points 
 
int get_critter_skill_points(int critter, int skill)
 
 
Will get the number of additional points a critter has in a skill, on top of whatever they have from their stats and other bonuses
 
  mod_skill_points_per_level 
 
void mod_skill_points_per_level(int value)
 
 
Accepts a value of between -100 and 100, and modifies the number of skill points the player recieves when they level up. This is a modification of what would otherwise happen, rather than a replacement. The value is not saved into the save game, so should be reset in the game_loaded section of a script.
 
  set_available_skill_points 
 
void set_available_skill_points(int value)
@@ -6,4 +6,4 @@
 
 
  set_critter_skill_mod 
 
void set_critter_skill_mod(CritterPtr, int max)
 
 
  set_critter_skill_points 
 
void set_critter_skill_points(int critter, int skill, int value)
 
 
Will set the number of additional points a critter has in a skill, on top of whatever they have from their stats and other bonuses. Note that skill points are part of the proto, so calling it on a critter will affect all critters that share the same proto.
 
  set_skill_max 
 
void set_skill_max(int value)
-
 
Can’t be used to increase the skill cap above 300.
 
 
 
 
  
+

Can’t be used to increase the skill cap above 300.

diff --git a/sslc/index.html b/sslc/index.html index 225c98092..6bfc06b10 100644 --- a/sslc/index.html +++ b/sslc/index.html @@ -1,4 +1,4 @@ - SSLC - sfall SSLC | sfall Link Search Menu Expand Document
sfall

SSLC

This is a modified copy of sslc, that has a few bugfixes from the original, that will recognise and compile the additional script functions provided by sfall, that can also understand some additional syntax, and that has an integrated preprocessor and optimizer.

Unlike the original script compiler, this has not been compiled as a dos program. When using this in place of the original compile.exe but still using p.bat, you need to either get rid of the dos4gw.exe reference from p.bat or replace the original dos4gw.exe with the one in this archive.

If you use Fallout Script Editor, you can extract compile.exe and dos4gw.exe to its \binary folder, or extract them somewhere else and change your preferences in FSE to point there. FSE doesn’t seem to be able to tell when errors occur when using this compiler though, so I’d recommend either using sfall’s script editor instead or compiling by hand if possible.

When compiling global or hook scripts for sfall 3.4 or below, you must include the line procedure start; before any #include files that define procedures to avoid a few weird problems. (this is no longer required starting from 3.5)

This version of compiler was designed primarily for new sfall functions, but it can safely (and is recommended) to be used with non-sfall scripts as well, as long as you don’t use any of the arrays syntax and any sfall script functions.

The original unmodified sslc source is over here: https://teamx.ru/site_arc/utils/index.html

Command line options 

-q  don't wait for input on error
+             SSLC | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
   
 This site uses Just the Docs, a documentation theme for Jekyll. 
 
 
  
 
 
 
  SSLC 
  
This is a modified copy of sslc, that has a few bugfixes from the original, that will recognise and compile the additional script functions provided by sfall, that can also understand some additional syntax, and that has an integrated preprocessor and optimizer.
 
Unlike the original script compiler, this has not been compiled as a dos program. When using this in place of the original compile.exe but still using p.bat, you need to either get rid of the dos4gw.exe reference from p.bat or replace the original dos4gw.exe with the one in this archive.
 
If you use Fallout Script Editor, you can extract compile.exe and dos4gw.exe to its \binary folder, or extract them somewhere else and change your preferences in FSE to point there. FSE doesn’t seem to be able to tell when errors occur when using this compiler though, so I’d recommend either using sfall’s script editor instead or compiling by hand if possible.
 
When compiling global or hook scripts for sfall 3.4 or below, you must include the line procedure start; before any #include files that define procedures to avoid a few weird problems. (this is no longer required starting from 3.5)
 
This version of compiler was designed primarily for new sfall functions, but it can safely (and is recommended) to be used with non-sfall scripts as well, as long as you don’t use any of the arrays syntax and any sfall script functions.
 
The original unmodified sslc source is over here: https://teamx.ru/site_arc/utils/index.html
 
  Command line options 
 
-q  don't wait for input on error
 -n  no warnings
 -b  backward compatibility mode
 -l  no logo
@@ -25,21 +25,21 @@
 call test("value", 0, -1);
 
 
    
  •  
    New logical operators AndAlso, OrElse for short-circuit evaluation of logical expressions. Using these operators allow the right part of logical expressions not to be evaluated (executed, computed) if the result is already known. This can improve the performance of running scripts.
     
    Example: if (obj andAlso obj_pid(obj) == PID_STIMPAK) then ...
     
    If obj is null, the second condition will not be checked and your script won’t fail with “obj is null” error in debug.log
     
    This also has an effect that a value of last computed argument is returned as a result of whole expressions, instead of always false (0) or true (1):
     
    obj := false;
 display_msg(obj orElse "something");  // will print "something"
-
     
     
    You can also use the -s option to enable short-circuit evaluation for all the AND, OR operators in the script.
     
    NOTE: Be aware that it may break some old scripts because operators behavior is changed slightly.
     
    •  
  • Conditional expressions (Python-inspired), also known as ternary operator: 
       
    • new: 
      X := value1 if condition else value2
+
       
       
      You can also use the -s option to enable short-circuit evaluation for all the AND, OR operators in the script.
       
      NOTE: Be aware that it may break some old scripts because operators behavior is changed slightly.
       
      •  
    • Conditional expressions (Python-inspired), also known as ternary operator: 
         
      • new: 
        X := value1 if (condition) else value2
 
         
         
        •  
      • old: 
        if (condition) then
   X := value1;
 else
   X := value2;
 
         
         
        •  
       
      •  
    • To assign values, you can use the alternative assignment operator from C/Java instead of Pascal syntax. 
         
      • new: 
        x = 5;
 
         
         
        •  
      • old: 
        x := 5;
-
         
         
        •  
       
      •  
    • Multiple variable declaration: Multiple variables can be declared on one line, seperated by commas. This is an alterative to the ugly begin/end block, or the bulky single variable per line style. 
         
      • new: 
        variable a, b, c;
+
         
         
        •  
       
      •  
    • Multiple variable declaration: Multiple variables can be declared on one line, separated by commas. This is an alternative to the ugly begin/end block, or the bulky single variable per line style. 
         
      • new: 
        variable a, b, c;
 
         
         
        •  
      • old: 
        variable begin a; b; c; end
 
         
         
        •  
       
      •  
    • Variable initialization with expressions: You can now initialize local variables with complex expressions instead of constants. 
         
      • new: 
        variable tile := tile_num(dude_obj);
 
         
         
        •  
      • old: 
        variable tile;
 tile := tile_num(dude_obj);
 
         
         
        NOTE: If your expression starts with a constant (eg. 2 + 2), enclose it in parentheses, otherwise compiler will be confused and give you errors.
         
        •  
       
      •  
    • Hexadecimal numerical constants: Simply prefix a number with 0x to create a hexadecimal. The numbers 0 to 9 and letters A to F are allowed in the number. The number may not have a decimal point. 
         
      • new: 
        a := 0x1000;
 
         
         
        •  
      • old: 
        a := 4096;
-
         
         
        •  
       
      •  
    • Increment/decrement operators: ++ and -- can be used as shorthand for += 1 and -= 1 respectively. They are mearly a syntactic shorthand to improve readability, and so their use is only allowed where += 1 would normally be allowed. 
         
      • new: 
        a++;
+
         
         
        •  
       
      •  
    • Increment/decrement operators: ++ and -- can be used as shorthand for += 1 and -= 1 respectively. They are merely a syntactic shorthand to improve readability, and so their use is only allowed where += 1 would normally be allowed. 
         
      • new: 
        a++;
 
         
         
        •  
      • old: 
        a += 1;
 
         
         
        •  
       
      •  
    • break & continue statements: They work just like in most high-level languages. break jumps out of the loop. continue jumps right to the beginning of the next iteration (see for and foreach sections for additional details). 
         
      • new: 
        while (i < N) begin
   // ...
@@ -89,15 +89,10 @@
 end else begin
   display_msg("something else");
 end
-
         
         
        •  
       
      •  
    • Empty statements in blocks are allowed: This is just a convenience to save scripters a bit of memory. Some of the macros in the Fallout headers include their own semicolons while others do not. With the original compiler you had to remember which was which, and if you got it wrong the script would not compile. Now it’s always safe to include your own semicolon, even if the macro already had its own. For example, this would not compile with the original sslc, but will with the sfall edition: 
      #define my_macro diplay_msg("foo");
-
-procedure start begin
-  my_macro;
-end
-
       
       
      NOTE: Does not work currently.
       
      •  
    • Procedure stringify operator @: Designed to make callback-procedures a better option and allow for basic functional programming. Basically it replaces procedure names preceeded by @ by a string constant. 
         
      • old: 
        callbackVar := "Node000";
-callbackVar();
+
         
         
        •  
       
      •  
    • Procedure stringify operator @: Designed to make callback-procedures a better option and allow for basic functional programming. Basically it replaces procedure names preceded by @ by a string constant. 
         
      • old: 
        callbackVar := "Node000";
+call callbackVar;
 
         
         
        •  
      • new: 
        callbackVar := @Node000;
-callbackVar();
+call callbackVar;
 
         
         
        Not many people know that since vanilla Fallout you can call procedures by “calling a variable” containing it’s name as a string value. There was a couple of problems using this:
         
        •  
      • optimizer wasn’t aware that you are referencing a procedure, and could remove it, if you don’t call it explicitly (can be solved by adding making procedure critical)
        •  
      • you couldn’t see all references of a procedure from a Script Editor
        •  
      • it was completely not obvious that you could do such a thing, it was a confusing syntax
        •  
       
      •  
    • (*) Arrays: In vanilla Fallout, arrays had to be constructed by reserving a block of global/map variables. Since sfall 2.7, specific array targeted functions have been available, but they are fairly messy and long winded to use. The compiler provides additional syntactic shorthand for accessing and setting array variables, as well as for array creation. When declaring an array variable, put a constant integer in []` to give the number of elements in the array. (before sfall 3.4 you had to specify size in bytes for array elements, now it’s not required, see “Arrays” page for more information) 
         
      • new: 
        procedure bingle begin
   variable a[2];
   a[0] := 5;
@@ -141,4 +136,4 @@
   if (itemPid == pid) then
     itemPrice := price;
 end
-
         
         
        If you want to add additional condition for continuing the loop, use syntax: foreach (<symbol> in <expression> while <expression>). In this case loop will iterate over elements of an array until last element or until “while” expression is true (whatever comes first).
         
        NOTE: Just like for loop, continue statement will respect increments of a hidden counter variable, so you can safely use it inside foreach.
         
        •  
       
        Fixes 
       
         
      • playmoviealpharect was using the token for playmoviealpha, breaking both functions in the process.
        •  
      • addbuttonflag had an entry in the token table, and could be parsed, but was missing an entry in the emit list. This resulted in the compiler accepting it as a valid function, but not outputting any code for it into the compiled script.
        •  
      • The function tokenize was missing an entry in the token table, and so would not be recognised by the compiler.
        •  
      • Fixed the check for the call "foo" syntax so that non-string constants will no longer be accepted.
        •  
       
        Backward compatibility 
       
      There are several changes in this version of sslc which may result in problems for previously working scripts. A new command line option -b is available, which will turn off all new fixes and features which have the possibility of causing a previously compiling script to change its behaviour. (And only those features; anything which would not compile under the old sslc is not affected.) This includes the following:
       
         
      • Since for, foreach, break, continue, in and tokenize are now hardcoded names, existing scripts that use any of them as a variable or procedure name will no longer compile.
        •  
      • Missing a semicolon after a variable declaration is now a hard error. (Originally sslc would check for the semicolon, but would not complain if it was missing.)
        •  
      • The function addbuttonflag used to be recognised by the compiler, but would not emit any code into the int file.
        •  
      • The function playmoviealpharect compiled as playmoviealpha.
        •  
       
        int2ssl note 
       
      int2ssl by Anchorite (TeamX) is included in sfall modderspack package. It was updated to support all additional opcodes of sfall, along with some syntax features. You can use it to decompile any sfall or non-sfall script.
       
    •  
     
     
      
+

    If you want to add additional condition for continuing the loop, use syntax: foreach (<symbol> in <expression> while <expression>). In this case loop will iterate over elements of an array until last element or until “while” expression is true (whatever comes first).

    NOTE: Just like for loop, continue statement will respect increments of a hidden counter variable, so you can safely use it inside foreach.

    Fixes

    • playmoviealpharect was using the token for playmoviealpha, breaking both functions in the process.
    • addbuttonflag had an entry in the token table, and could be parsed, but was missing an entry in the emit list. This resulted in the compiler accepting it as a valid function, but not outputting any code for it into the compiled script.
    • The function tokenize was missing an entry in the token table, and so would not be recognised by the compiler.
    • Fixed the check for the call "foo" syntax so that non-string constants will no longer be accepted.

    Backward compatibility

    There are several changes in this version of sslc which may result in problems for previously working scripts. A new command line option -b is available, which will turn off all new fixes and features which have the possibility of causing a previously compiling script to change its behaviour. (And only those features; anything which would not compile under the old sslc is not affected.) This includes the following:

    • Since for, foreach, break, continue, in and tokenize are now hardcoded names, existing scripts that use any of them as a variable or procedure name will no longer compile.
    • Missing a semicolon after a variable declaration is now a hard error. (Originally sslc would check for the semicolon, but would not complain if it was missing.)
    • The function addbuttonflag used to be recognised by the compiler, but would not emit any code into the int file.
    • The function playmoviealpharect compiled as playmoviealpha.

    int2ssl note

    int2ssl by Anchorite (TeamX) is included in sfall modderspack package. It was updated to support all additional opcodes of sfall, along with some syntax features. You can use it to decompile any sfall or non-sfall script.

    diff --git a/stats/index.html b/stats/index.html index f641931f9..cd6c68c7b 100644 --- a/stats/index.html +++ b/stats/index.html @@ -1,11 +1,11 @@ - Stats - sfall Stats | sfall Link Search Menu Expand Document
    sfall

    Stats

    The get/set_pc_base/extra_stat functions are equivalent to calling get/set_critter_base/extra_stat with dude_obj as the critter pointer. None of these stat functions take perks into account, and neither do they do range clamping to make sure the stats are valid. Use the normal get_critter_stat function to get a correctly perk adjusted and range clamped value for a stat.

    Subcategories

    Functions

    get_critter_base_stat 

    int get_critter_base_stat(CritterPtr, int StatID)
+             Stats | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
     
     
     
      Stats 
     
    The get/set_pc_base/extra_stat functions are equivalent to calling get/set_critter_base/extra_stat with dude_obj as the critter pointer. None of these stat functions take perks into account, and neither do they do range clamping to make sure the stats are valid. Use the normal get_critter_stat function to get a correctly perk adjusted and range clamped value for a stat.
     
      Subcategories 
      
      Functions 
     
     
      get_critter_base_stat 
     
    int get_critter_base_stat(CritterPtr, int StatID)
 
     
      get_critter_extra_stat 
     
    int get_critter_extra_stat(CritterPtr, int StatID)
 
     
      get_pc_base_stat 
     
    int get_pc_base_stat(int StatID)
 
     
      get_pc_extra_stat 
     
    int get_pc_extra_stat(int StatID)
 
     
      get_stat_max 
     
    get_stat_max(int stat, bool who = False)
-
     
       
    • Returns the maximum set value of the specified stat (see set_stat_max functions)
      •  
    • who: 0 (false) or omitting the argument - returns the value of the player, 1 (true) - returns the value set for other critters
      •  
     
      get_stat_min 
     
    get_stat_min(int stat, bool who = False)
-
     
       
    • Returns the minimum set value of the specified stat (see set_stat_min functions)
      •  
    • who: 0 (false) or omitting the argument - returns the value of the player, 1 (true) - returns the value set for other critters
      •  
     
      set_critter_base_stat 
     
    void set_critter_base_stat(CritterPtr, int StatID, int value)
+
     
       
    • Returns the maximum set value of the specified stat (see set_stat_max functions)
      •  
    • who: 0 (False) or omitting the argument - returns the value of the player, 1 (True) - returns the value set for other critters
      •  
     
      get_stat_min 
     
    get_stat_min(int stat, bool who = False)
+
     
       
    • Returns the minimum set value of the specified stat (see set_stat_min functions)
      •  
    • who: 0 (False) or omitting the argument - returns the value of the player, 1 (True) - returns the value set for other critters
      •  
     
      set_critter_base_stat 
     
    void set_critter_base_stat(CritterPtr, int StatID, int value)
 
     
      set_critter_extra_stat 
     
    void set_critter_extra_stat(CritterPtr, int StatID, int value)
 
     
      set_pc_base_stat 
     
    void set_pc_base_stat(int StatID, int value)
 
     
      set_pc_extra_stat 
     
    void set_pc_extra_stat(int StatID, int value)
-
     
     
     
     
      
+
    diff --git a/strings/index.html b/strings/index.html index 470a49ea8..bf6448f95 100644 --- a/strings/index.html +++ b/strings/index.html @@ -1,9 +1,13 @@ - Strings - sfall Strings | sfall Link Search Menu Expand Document
    sfall

    Strings

    Functions

    charcode 

    int charcode(string text)
+             Strings | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Strings 
     
      Functions 
     
     
      charcode 
     
    int charcode(string text)
 
     
    Returns ASCII code for the first character in given string.
     
      get_string_pointer 
     
    sfall.h
     
    int get_string_pointer(string text)
-
     
    Returns a pointer to a string variable or to a text.
     
      string_format 
     
    sfall.h
     
    string string_format(string format, any val1, any val2, ...)
-
     
    Formats given value using standard syntax of C printf function (google “printf” for format details). However it is limited to formatting up to 4 values.
     
       
    • formatting is only supported for %s and %d, and the format string is limited to 1024 characters
      •  
     
      string_split 
     
    array string_split(string, split)
+
     
    (DEPRECATED) Returns a pointer to a string variable or to a text
     
       
    • NOTE: this function is intended for use only in HOOK_DESCRIPTIONOBJ. Starting from sfall 4.4/3.8.40, you can return normal strings directly in the hook without calling the function
      •  
     
      string_find 
     
    sfall.h
     
    int string_find(string haystack, string needle)
+
     
    Returns the position of the first occurrence of a needle string in a haystack string, or -1 if not found. The first character position is 0 (zero).
     
      string_find_from 
     
    sfall.h
     
    int string_find_from(string haystack, string needle, int pos)
+
     
    Works the same as string_find, except you can specify the position to start the search.
     
       
    • If pos is negative - it indicates a position starting from the end of the string, similar to substr().
      •  
     
      string_format 
     
    sfall.h
     
    string string_format(string format, any val1, any val2, ...)
+
     
    Formats given values using standard syntax of C printf function (google “printf” for format details). However, it is limited to formatting up to 7 values.
     
       
    • The format string is limited to 1024 characters
      •  
     
      string_format_array 
     
    lib.strings.h
     
    string string_format_array(string format, int array)
+
     
    The same as string_format, but accepts an array of parameters.
     
      string_replace 
     
    lib.strings.h
     
    string string_replace(string str, string search, string replace)
+
     
    Replaces all occurances of a given search string in a string with a given replacement string.
     
      string_split 
     
    array string_split(string text, split)
 
     
    Takes a string and a seperator, searches the string for all instances of the seperator, and returns a temp array filled with the pieces of the string split at each instance. If you give an empty string as the seperator, the string is split into individual characters. You can use this to search for a substring in a string like this: strlen(get_array(string_split(haystack, needle), 0))
     
      string_to_case 
     
    string sfall_func2("string_to_case", string text, int toCase)
 
     
    Converts all letters in the given string to the specified case.
     
    toCase: 0 - lowercase, 1 - uppercase
 
     
    NOTE: this function works only for English letters of A-Z/a-z.
     
      strlen 
     
    int strlen(string text)
-
     
    Returns string length.
     
      substr 
     
    string substr(string, start, length)
-
     
    Cuts a substring from a string starting at “start” up to “length” characters. The first character position is 0 (zero).
     
       
    • If start is negative - it indicates starting position from the end of the string (for example substr("test", -2, 2) will return last 2 charactes: “st”).
      •  
    • If length is negative - it means so many characters will be omitted from the end of string (example: substr("test", 0, -2) will return string without last 2 characters: “te”).
      •  
    • If length is zero - it will return a string from the starting position to the end of the string New behavior for sfall 4.2.2/3.8.22
      •  
     
     
     
     
      
+

    Returns string length.

    substr 

    string substr(string text, int start, int length)
+

    Cuts a substring from a string starting at “start” up to “length” characters. The first character position is 0 (zero).

    • If start is negative - it indicates a position starting from the end of the string (for example substr("test", -2, 2) will return last 2 charactes: “st”).
    • If length is negative - it means so many characters will be omitted from the end of string (example: substr("test", 0, -2) will return string without last 2 characters: “te”).
    • If length is zero - it will return a string from the starting position to the end of the string. New behavior for sfall 4.2.2/3.8.22
    diff --git a/tags/index.html b/tags/index.html index 1ce45dfa1..3339fcfa2 100644 --- a/tags/index.html +++ b/tags/index.html @@ -1,6 +1,6 @@ - Tags - sfall Tags | sfall Link Search Menu Expand Document
    sfall

    Tags

    show_iface_tag, hide_iface_tag and is_iface_tag_active relate to the boxes that appear above the interface such as SNEAK and LEVEL. You can use 3 for LEVEL and 4 for ADDICT, or the range from 5 to (4 + the value of BoxBarCount in ddraw.ini) for custom boxes. Remember to add your messages to intrface.msg and set up the font colours in ddraw.ini if you’re going to use custom boxes. Starting from sfall 4.1/3.8.12, is_iface_tag_active can also be used to check 0 for SNEAK, 1 for POISONED, and 2 for RADIATED.

    Functions

    add_iface_tag

    sfall.h

    void add_iface_tag()
+             Tags | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Tags 
     
    show_iface_tag, hide_iface_tag and is_iface_tag_active relate to the boxes that appear above the interface such as SNEAK and LEVEL. You can use 3 for LEVEL and 4 for ADDICT, or the range from 5 to (4 + the value of BoxBarCount in ddraw.ini) for custom boxes. Remember to add your messages to intrface.msg and set up the font colours in ddraw.ini if you’re going to use custom boxes. Starting from sfall 4.1/3.8.12, is_iface_tag_active can also be used to check 0 for SNEAK, 1 for POISONED, and 2 for RADIATED.
     
      Functions 
     
     
      add_iface_tag 
     
    sfall.h
     
    void add_iface_tag()
 
     
    Adds one custom box to the current boxes, and returns the number of the added tag (-1 if the tags limit is exceeded. The maximum number of boxes is limited to 126 tags.
     
      hide_iface_tag 
     
    void hide_iface_tag(int tag)
 
     
      is_iface_tag_active 
     
    int is_iface_tag_active(int tag)
 
     
    Starting from sfall 4.1, can also be used to check 0 for SNEAK, 1 for POISONED, and 2 for RADIATED.
     
      set_iface_tag_text 
     
    sfall.h
     
    void set_iface_tag_text(int tag, string text, int color)
 
     
    Sets the text messages and colors for custom notification boxes to the interface without the need to add messages to intrface.msg and set up the font colors in ddraw.ini. Tag value is the same as used in show_iface_tag, hide_iface_tag, and is_iface_tag_active. The valid range is from 5 to (4 + the value of BoxBarCount in ddraw.ini) or the number of the last custom box added using the add_iface_tag function. The text is limited to 19 characters.
     
      show_iface_tag 
     
    void show_iface_tag(int tag)
-
     
     
     
     
      
+
    diff --git a/tiles-and-paths/index.html b/tiles-and-paths/index.html index a7a2f3248..58eba8b18 100644 --- a/tiles-and-paths/index.html +++ b/tiles-and-paths/index.html @@ -1,5 +1,7 @@ - Tiles and paths - sfall Tiles and paths | sfall Link Search Menu Expand Document
    sfall

    Tiles and paths

    Functions

    get_tile_fid 

    int get_tile_fid(int tile)
-

    obj_blocking_line 

    ObjectPtr obj_blocking_line(ObjectPtr objFrom, int tileTo, int blockingType)
+             Tiles and paths | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
     
     
     
      Tiles and paths 
     
      Functions 
     
     
      get_tile_fid 
     
    int get_tile_fid(int tileData)
+
     
       
    • Returns FID information about the square under the given tile at elevation 0
      •  
    • Pass elevation as 4-bit number in bits 25-28 to access other elevations
      •  
    • Pass result mode in bits 29-32: 0 - ground FID, 1 - roof FID, 2 - raw data.
      •  
     
      get_tile_ground_fid 
     
    sfall.h
     
    int get_tile_ground_fid(int tileNum, int elevation)
+
     
    Returns FID of a ground tile at given tile number and elevation.
     
      get_tile_roof_fid 
     
    sfall.h
     
    int get_tile_roof_fid(int tileNum, int elevation)
+
     
    Returns FID of a roof tile at given tile number and elevation. Note that FID of 1 is used when there is no actual roof.
     
      obj_blocking_line 
     
    ObjectPtr obj_blocking_line(ObjectPtr objFrom, int tileTo, int blockingType)
 
     
    Returns first object which blocks direct linear path from objFrom to tileTo using selected blocking function (see BLOCKING_TYPE_* constants in sfall.h). If path is clear (no blocker was encountered by selected function) - returns 0. objFrom is always excluded from calculations, but is required to be a valid object.
     
      obj_blocking_tile 
     
    ObjectPtr obj_blocking_tile(int tileNum, int elevation, int blockingType)
 
     
    Returns first object blocking given tile using given blocking function or 0 if tile is clear.
     
      path_find_to 
     
    array path_find_to(ObjectPtr objFrom, int tileTo, int blockingType)
 
     
    Returns the shortest path to a given tile using given blocking function as an array of tile directions (0..5) to move on each step. Array length equals to a number of steps. Empty array means that specified target cannot be reached.
     
      tile_by_position 
     
    sfall.h
     
    int tile_by_position(int x, int y)
@@ -7,4 +9,4 @@
 
     
    Returns an array of all objects at given tile. It will include any hidden, dead or system objects (like cursor), so make sure to check properly when iterating.
     
      tile_light 
     
    int tile_light(int elevation, int tileNum)
 
     
    Returns light intensity at the given tile in range from 0 to 65535.
     
      tile_refresh_display 
     
    void tile_refresh_display()
 
     
    Redraws the game scene (tiles, walls, objects, etc.).
     
      tile_under_cursor 
     
    int tile_under_cursor
-
     
     
     
     
      
+
    diff --git a/utility/index.html b/utility/index.html new file mode 100644 index 000000000..b924c0a4f --- /dev/null +++ b/utility/index.html @@ -0,0 +1,5 @@ + Utility | sfall Skip to main content Link Menu Expand (external link) Document Search Copy Copied

    Utility

    Subcategories

    Functions

    atof 

    float atof(string text)
+

    atoi 

    int atoi(string text)
+

    sprintf 

    string sprintf(string format, any value)
+

    Formats given value using standart syntax of C printf function (google “printf” for format details). However, it is limited to formatting only 1 value.

    • Can be used to get character by ASCII code (“%c”).

    typeof 

    int typeof(any value)
+

    Returns type of the given value: VALTYPE_INT, VALTYPE_FLOAT or VALTYPE_STR.

    diff --git a/variables/index.html b/variables/index.html deleted file mode 100644 index e6d128dc9..000000000 --- a/variables/index.html +++ /dev/null @@ -1,5 +0,0 @@ - Variables - sfall Variables | sfall Link Search Menu Expand Document
    sfall

    Variables

    Subcategories

    Functions

    atof 

    float atof(string text)
-

    atoi 

    int atoi(string text)
-

    sprintf 

    string sprintf(string format, any value)
-

    Formats given value using standart syntax of C printf function (google “printf” for format details). However it is limited to formatting only 1 value. Can be used to get character by ASCII code (“%c”).

    typeof 

    int typeof(any value)
-

    Returns type of the given value: VALTYPE_INT, VALTYPE_FLOAT or VALTYPE_STR.

    diff --git a/version/index.html b/version/index.html index e6b029dc9..9f98a83e7 100644 --- a/version/index.html +++ b/version/index.html @@ -1,4 +1,4 @@ - Version - sfall Version | sfall Link Search Menu Expand Document
    sfall

    Version

    Functions

    sfall_ver_build 

    int sfall_ver_build()
+             Version | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Version 
     
      Functions 
     
     
      sfall_ver_build 
     
    int sfall_ver_build()
 
     
      sfall_ver_major 
     
    int sfall_ver_major()
 
     
      sfall_ver_minor 
     
    int sfall_ver_minor()
-
     
     
     
     
      
+
    diff --git a/virtual-file-system/index.html b/virtual-file-system/index.html index 6bba76909..89a04608a 100644 --- a/virtual-file-system/index.html +++ b/virtual-file-system/index.html @@ -1,4 +1,4 @@ - Virtual file system - sfall Virtual file system | sfall Link Search Menu Expand Document
    sfall

    Virtual file system

    The fs_* functions are used to manipulate a virtual file system. Files saved here should have paths relative to the data folder, and use backslashes as the directory separator. They will take precedence over files stored in the normal data folder. They will also be saved into save games if you set a flag for them using fs_resize(fileId, -1), so be avoid creating large files. Using fs_copy followed by fs_read_xxx, you can read the contents of existing files.

    Functions

    fs_copy 

    int fs_copy(string path, string source)
+             Virtual file system | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
     
     
     
      Virtual file system 
     
    The fs_* functions are used to manipulate a virtual file system. Files saved here should have paths relative to the data folder, and use backslashes as the directory separator. They will take precedence over files stored in the normal data folder. They will also be saved into save games if you set a flag for them using fs_resize(fileId, -1), so be avoid creating large files. Using fs_copy followed by fs_read_xxx, you can read the contents of existing files.
     
      Functions 
     
     
      fs_copy 
     
    int fs_copy(string path, string source)
 
     
      fs_create 
     
    int fs_create(string path, int size)
 
     
      fs_delete 
     
    void fs_delete(int id)
 
     
      fs_find 
     
    int fs_find(string path)
@@ -16,4 +16,4 @@
 
     
      fs_write_int 
     
    void fs_write_int(int id, int data)
 
     
      fs_write_short 
     
    void fs_write_short(int id, int data)
 
     
      fs_write_string 
     
    void fs_write_string(int id, string data)
-
     
     
     
     
      
+
    diff --git a/weapons-and-ammo/index.html b/weapons-and-ammo/index.html index c75171d17..ea99cc735 100644 --- a/weapons-and-ammo/index.html +++ b/weapons-and-ammo/index.html @@ -1,5 +1,5 @@ - Weapons and ammo - sfall Weapons and ammo | sfall Link Search Menu Expand Document
    sfall

    Weapons and ammo

    Functions

    get_weapon_ammo_count 

    int get_weapon_ammo_count(ObjectPtr weapon)
+             Weapons and ammo | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Weapons and ammo 
     
      Functions 
     
     
      get_weapon_ammo_count 
     
    int get_weapon_ammo_count(ObjectPtr weapon)
 
     
    This also allows to get current charges of a misc item (Geiger counter, etc).
     
      get_weapon_ammo_pid 
     
    int get_weapon_ammo_pid(ObjectPtr weapon)
 
     
      set_weapon_ammo_count 
     
    void set_weapon_ammo_count(ObjectPtr weapon, int count)
 
     
    This also allows to set current charges of a misc item (Geiger counter, etc).
     
      set_weapon_ammo_pid 
     
    void set_weapon_ammo_pid(ObjectPtr weapon, int pid)
-
     
     
     
     
      
+
    diff --git a/windows-and-images/index.html b/windows-and-images/index.html index 7c8ff416c..197fa5c52 100644 --- a/windows-and-images/index.html +++ b/windows-and-images/index.html @@ -1,4 +1,4 @@ - Windows and images - sfall Windows and images | sfall Link Search Menu Expand Document
    sfall

    Windows and images

    Functions

    create_win

    sfall.h

    void create_win(string winName, int x, int y, int width, int height, int flags)
+             Windows and images | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Windows and images 
     
      Functions 
     
     
      create_win 
     
    sfall.h
     
    void create_win(string winName, int x, int y, int width, int height, int flags)
 
     
    flags argument is optional. Works just like vanilla CreateWin function, but creates a window with MoveOnTop flag if the flags argument is not specified, and allows to set additional flags for the created window. MoveOnTop flag allows the created window to be placed on top of the game interface.
     
      draw_image 
     
    sfall.h
     
    void draw_image(string/int artFile/artId, int frame, int x, int y, bool noTransparent)
 
     
       
    • displays the specified PCX or FRM image in the active window created by vanilla CreateWin or sfall’s create_win script function
      •  
    • artFile/artId: path to the PCX/FRM file (e.g. art\\inven\\5mmap.frm), or its FRM ID number (e.g. 0x7000026, see specification of the FID format) optional arguments:
      •  
    • frame: frame number, the first frame starts from zero
      •  
    • x/y: offset relative to the top-left corner of the window
      •  
    • noTransparent: pass True to display an image without transparent background
      •  
    • NOTE: to omit optional arguments starting from the right, call the functions with different sfall_funcX (e.g. sfall_func4("draw_image", pathFile, frame, x, y))
      •  
     
      draw_image_scaled 
     
    sfall.h
     
    void draw_image_scaled(string/int artFile/artId, int frame, int x, int y, int width, int height)
 
     
       
    • displays the specified PCX or FRM image in the active window created by vanilla CreateWin or sfall’s create_win script function
      •  
    • artFile/artId: path to the PCX/FRM file (e.g. art\\inven\\5mmap.frm), or its FRM ID number (e.g. 0x7000026, see specification of the FID format) optional arguments:
      •  
    • frame: frame number, the first frame starts from zero
      •  
    • x/y: offset relative to the top-left corner of the window
      •  
    • width/height: the new width/height to scale the image to. Pass -1 to either width or height to keep the aspect ratio when scaling
      •  
    • NOTE: to omit optional arguments starting from the right, call the functions with different sfall_funcX (e.g. sfall_func4("draw_image", pathFile, frame, x, y))
      •  
    • if called without x/y/width/height arguments, the image will be scaled to fit the window without transparent background
      •  
     
      get_window_attribute 
     
    int sfall_func1("get_window_attribute", int winType)
@@ -17,5 +17,5 @@
 - color1/color2: the color index in the game palette. `color1` sets the text color for the first line, and `color2` for all subsequent lines of text (default color is 145)
 
     
      nterface_overlay 
     
    sfall_func2("interface_overlay", int winType, int mode)
 
     
    Alternative form: int sfall_func6("interface_overlay", int winType, 2, int x, int y, int width, int height).
     
    Creates an additional drawing surface above the graphic layer of the specified interface window. All subsequent calls of interface_art_draw and interface_print functions will draw on it.
     
       
    • winType: the type number of the interface window (see WINTYPE_* constants in sfall.h)
      •  
    • mode: 1 - creates a new overlay surface 2 - clears the overlay area or the specified rectangle defined by the x, y, width, height arguments 0 - destroys the created overlay surface (frees up the memory allocated to the surface)
      •  
     
      set_window_flag 
     
    sfall.h
     
    void set_window_flag(string winName/int winID, int flag, bool value)
-
     
    Changes the specified flag for the created script or game interface window.
     
       
    • winName: the window name, assigned to the window by the CreateWin/create_win function
      •  
    • winID: the ID number of the interface or script window obtained with the get_window_under_mouse function, or 0 for the current game interface
      •  
    • flag: the flag to change (see WIN_FLAG_* constants in define_extra.h)
      •  
    • value: true - set the flag, false - unset the flag
      •  
     
      win_fill_color 
     
    int win_fill_color(int x, int y, int width, int height, int color)
-
     
    Fills the rectangle area of the currently selected script window with the specified color, or clears the window with transparent (index 0) color (call the function without arguments).
     
       
    • color: the color index in the game palette (from 0 to 255)
      •  
     
     
     
     
      
+

    Changes the specified flag for the created script or game interface window.

    • winName: the window name, assigned to the window by the CreateWin/create_win function
    • winID: the ID number of the interface or script window obtained with the get_window_under_mouse function, or 0 for the current game interface
    • flag: the flag to change (see WIN_FLAG_* constants in define_extra.h)
    • value: True - set the flag, False - unset the flag

    win_fill_color 

    int win_fill_color(int x, int y, int width, int height, int color)
+

    Fills the rectangle area of the currently selected script window with the specified color, or clears the window with transparent (index 0) color (call the function without arguments).

    • color: the color index in the game palette (from 0 to 255)
    diff --git a/worldmap/index.html b/worldmap/index.html index 2ffe5e2bd..e4929c106 100644 --- a/worldmap/index.html +++ b/worldmap/index.html @@ -1,4 +1,4 @@ - Worldmap - sfall Worldmap | sfall Link Search Menu Expand Document
    sfall

    Worldmap

    The mapper manual lists the functions world_map_x_pos and world_map_y_pos, which supposedly return the player’s x and y positions on the world map. get_world_map_x/y_pos are included here anyway, because I was unable to get those original functions to work, or even to find any evidence that they existed in game.

    Functions

    get_world_map_x_pos 

    int get_world_map_x_pos()
+             Worldmap | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      Worldmap 
     
    The mapper manual lists the functions world_map_x_pos and world_map_y_pos, which supposedly return the player’s x and y positions on the world map. get_world_map_x/y_pos are included here anyway, because I was unable to get those original functions to work, or even to find any evidence that they existed in game.
     
      Functions 
     
     
      get_world_map_x_pos 
     
    int get_world_map_x_pos()
 
     
      get_world_map_y_pos 
     
    int get_world_map_y_pos()
 
     
      set_world_map_pos 
     
    void set_world_map_pos(int x, int y)
-
     
     
     
     
      
+
    diff --git a/write_xxx/index.html b/write_xxx/index.html index 46d518aab..bc415947f 100644 --- a/write_xxx/index.html +++ b/write_xxx/index.html @@ -1,5 +1,5 @@ - write_xxx - sfall write_xxx | sfall Link Search Menu Expand Document
    sfall

    write_xxx

    These functions take a memory address as the parameter and can write to arbitrary pieces of Fallout’s address None of these functions will work unless AllowUnsafeScripting is enabled in ddraw.ini.

    Functions

    write_byte

    UNSAFE

    void write_byte(int address, int value)
+             write_xxx | sfall                        Skip to main content   Link      Menu      Expand       (external link)    Document      Search       Copy       Copied       
       
     This site uses Just the Docs, a documentation theme for Jekyll. 
     
     
      
      
     
     
      write_xxx 
     
    These functions take a memory address as the parameter and can write to arbitrary pieces of Fallout’s address None of these functions will work unless AllowUnsafeScripting is enabled in ddraw.ini.
     
      Functions 
     
     
      write_byte 
     
    UNSAFE
     
    void write_byte(int address, int value)
 
     
      write_int 
     
    UNSAFE
     
    void write_int(int address, int value)
 
     
      write_short 
     
    UNSAFE
     
    void write_short(int address, int value)
 
     
      write_string 
     
    UNSAFE
     
    void write_string(int address, string value)
-
     
     
     
     
      
+