daily pastebin goal
25%
SHARE
TWEET

bsetroot Properties

a guest Aug 11th, 2014 191 Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
  1. 1. Introduction
  2.  
  3. bsetroot lets you set your desktop background to either a solid colour, a gradient, a square pattern, an image, or a combination of these. bsetroot usually is called from the 'rootCommand' line in a blackbox style.
  4.  
  5. The included bsetbg.exe works just as an alias to bsetroot.
  6.  
  7. Note on v2.1
  8. The format of bsetroot.rc has been changed to a more intuitive format. No more cryptic wildcards, just simple search paths. See -> Configuration.
  9.  
  10. 2. Switches
  11.  
  12. -solid <colour> :
  13. Change the desktop background to the colour you specify.
  14. -gradient <type> -from <colour> -to <colour> :
  15. Apply a gradient of specified type to the background.
  16. -mod <x> <y> -fg <colour> [-bg <colour>] :
  17. Apply a square pattern to the background. <x> and <y> set the size of the squares.
  18. -full <image> :
  19. Display an image stretched to cover the desktop.
  20. -tile <image> :
  21. Display an image tiled over the desktop.
  22. -center <image> :
  23. Display an image in the center of the desktop.
  24. -bitmap [stretch|tile|center] <image> :
  25. Similar to above.
  26. -sat <0..255> :
  27. Set image color saturation
  28. -hue <0..255> :
  29. Set image/background merge factor.
  30. -scale <factor> :
  31. Resize the image by a percent factor.
  32. -path <searchpath> :
  33. Specify searchpath for images. This is useful when set in bsetroot.rc.
  34. -quiet :
  35. Igore any errors silently.
  36. -vdesk :
  37. Use virtual desktop size to span the wallpaper over monitors.
  38. -save <file.bmp> :
  39. Save the generated background to the specified file rather than setting the wallpaper.
  40. -help :
  41. Show short summary.
  42. 3. Configuration
  43.  
  44. Configuration is not needed in most cases. Just put the bsetroot executable where blackbox.exe is.
  45.  
  46. When bsetroot finds bsetroot.rc in the same directory, it starts reading options from it like commandline switches. This is supposed to be useful especially with the -path switch.
  47.  
  48. For example these lines would make bsetroot look for images in two additional locations and also let it silently ignore any errors.
  49.  
  50. -path "c:/blackbox/images"
  51. -path "c:/my pictures"
  52. -quiet
  53. 4. Searchpaths
  54.  
  55. This is how bsetroot looks for images:
  56.  
  57. First it tries the image-path as given in the commandline.
  58. Then it looks for the image in the searchpaths from any -path ... options (as listed in bsetroot.rc).
  59. Finally it looks for the image in a folder 'backgrounds' relative to the location of bsetroot.exe.
  60. You can use relative or absolute paths with both images and image searchpaths. Relative paths refer to the location where bsetroot.exe is.
  61.  
  62. Please note that paths with spaces need to have quotes. That is for both paths on the command line and paths in bsetroot.rc.
  63.  
  64. 5. Gradients
  65.  
  66. A gradient texture is defined by the gradient type and two colours.
  67.  
  68. Type can be one of "vertical", "horizontal", "diagonal", "crossdiagonal", "pipecross", "elliptic", "rectangle", or "pyramid".
  69.  
  70. For compatibility with bsetroot on linux, you also can/should include the word "gradient" in the gradient type.
  71.  
  72. You can combine the gradient type with "interlaced" to get some effect or add a bevel with "raised/sunken bevel1/2".
  73.  
  74. Example:
  75.  
  76. bsetroot -gradient verticalinterlacedgradient -from steelblue -to orange
  77. 6. Colours
  78.  
  79. Colours can be in any format that blackbox accepts.
  80.  
  81. rgb format: rgb:77/88/CC or rgb:7/8/C
  82. html format: "#7788CC" or the short form "#78C"
  83. one from the literal colors below
  84. Note that bsetroot on linux wants quotes around html format colors.
  85.  
  86. Literal Colors:
  87. These literal color names are known to bsetroot:
  88. http://blackbox4windows.com/index.php?/topic/22-literal-colors-for-styles/
RAW Paste Data
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy. OK, I Understand
 
Top