home *** CD-ROM | disk | FTP | other *** search
/ napalm.napnet.hu / 2015-02-12.napalm.napnet.hu.tar / napalm.napnet.hu / programok / kommunikacio / mpp700.exe / Kte-Readme.txt < prev    next >
Text File  |  2002-08-02  |  13KB  |  295 lines
  1. Kte v1.5
  2. --------------------------------------------------- - -  -    -
  3.  
  4. MTS Home page: http://www.mircscripts.org/mts.php
  5.  
  6. Features:
  7. - Compatible with MTS 1.0 and 1.1 themes
  8. - Works on mIRC 6.01 and 6.02
  9. - Supports most MTS features, like events, schemes, images,
  10.   nicklist coloring and fonts
  11. - Precompiles themes (slow loading, fast theming)
  12. - Theme preview
  13. - vPak, gzip and .zip support
  14. - Your settings are restored if you stop using themes
  15. - You define what you want to be applied
  16.  
  17. To be available in next releases:
  18. - Sound support
  19.  
  20.  
  21. Loading Kte
  22. --------------------------------------------------- - -  -    -
  23.   The first step is loading Kte. It's something simple, but
  24. remember you must use the right mIRC version.
  25.  
  26.   If Kte is on the same directory as mIRC, you can use this:
  27.     /load -rs kte.mrc
  28.  
  29.   If it's on a subdirectory on mIRC's directory, you can use a
  30. relative path, like (supposing it's in 'Kte'):
  31.     /load -rs kte\kte.mrc
  32.  
  33.   If it's on another directory, you'll need to specify a full
  34. path. If it has spaces, surround it with quotes:
  35.     /load -rs c:\mystuff\kte.mrc
  36.  
  37. *** To update, replace the files in the Kte directory with
  38.     the new ones. If you are updating from Kte 1.0, you should
  39.     do it while mIRC is NOT running. If you are updating from
  40.     another version, you can just /load the script file again if
  41.     mIRC is running. After that, you should reload the current
  42.     theme (if any) in order to update your compiled script file.
  43.  
  44.  
  45. Loading a theme
  46. --------------------------------------------------- - -  -    -
  47.   To load a theme in Kte, you may use /theme.load or /kte_load
  48. (both do the same). For example, to load the theme called
  49. "Sample" (which should be in your themes directory if the path
  50. isn't specified), use the syntax '/theme.load Sample'.
  51.   Kte supports simple MTS themes and vPak archives. If you
  52. specify a path for nGZIPn.dll, it will also support gzipped
  53. versions of the mentioned formats. As result, the supported
  54. extensions will be .mts, .mts.gz, .vpk and .vpk.gz. For zipped
  55. files support, you must have mUnzip, and specify its path on the
  56. Settings dialog.
  57.   If you prefer, you may open a theme loading dialog by typing
  58. just '/theme.load'.
  59.   Some themes include schemes, which are small variations to
  60. their appearance. To use, for example, the 5th scheme from the
  61. Sample theme, use '/theme.load -s5 Sample'.
  62.   You can define what you want and what you don't want to be
  63. loaded on the load dialog. You can't, however, use this to mix
  64. settings from different themes.
  65.   Theme loading in Kte may take a little long, since it compiles
  66. the theme into a scripting file for best performance.
  67.  
  68.  
  69. Changing schemes
  70. --------------------------------------------------- - -  -    -
  71.   If you want to use a different scheme from the current theme,
  72. you may use /theme.scheme or /kte_scheme. It's a bit faster than
  73. using /theme.load again, as /theme.scheme skips some steps of
  74. loading a whole new theme.
  75.   To list all the schemes from the current theme, type just
  76. '/theme.scheme'.
  77.   To load a new scheme, you may specify its number (for example,
  78. to load the 3rd scheme, use '/theme.scheme 3') or its name (to
  79. load the scheme named 'Blue', type '/theme.scheme blue').
  80.   If you want to load the default scheme, you may use
  81. '/theme.scheme -d'.
  82.  
  83.  
  84. Unloading a theme
  85. --------------------------------------------------- - -  -    -
  86.   When you load a theme, the previous one is automatically
  87. unloaded; however, if you don't want to use any theme, type
  88. '/theme.unload' or '/kte_unload'.
  89.   Kte restores your colors, RGB values, nicklist colors, fonts
  90. and timestamp settings when you use /theme.unload. However, due
  91. to a limitation in mIRC, some cases of nicklist coloring can't be
  92. restored correctly: if you have one or more color settings which
  93. refer to the same nickname (does not apply to "Any nick"), only
  94. one of them will be restored. Also, font recovery is not
  95. complete: misc windows, like Notify and URL List, use the same
  96. font as the status window when restored (which is enough for most
  97. users).
  98.   Anyway, I hope the current restoring helps you with most (if
  99. not all) of the problems of quitting using any themes. If you
  100. would like to see some improvements, please contact me.
  101.  
  102.  
  103. Settings
  104. --------------------------------------------------- - -  -    -
  105.   To change engine settings, type '/theme.load', and click the
  106. File\Settings menu.
  107.   You can, for example, set up the default path for your themes
  108. folder, clear your cache directory, or even hide the /names list
  109. you get when joining a channel.
  110.  
  111.  
  112. Misc notes
  113. --------------------------------------------------- - -  -    -
  114.   You can get nGZIPn and mUnzip on http://www.mircscripts.org/
  115. (DLLs section), and several themes on the Themes section.
  116.  
  117.   If you want to quit using Kte, just type '/unload -rs kte.mrc'.
  118. If you are using a theme, you'll be asked if you want to unload
  119. it first.
  120.  
  121.   Kte reads where some events should be displayed from mirc.ini
  122. and caches the information. In case you have changed something
  123. and wants to force Kte to read mirc.ini again, you may use
  124. '/kte_refresh'.
  125.  
  126.   If you want to use Kte in your script, feel free to change
  127. Kte-Dyn.dat (the source of the dynamic script file) or Kte.mrc to
  128. fit your needs, as long as you give me credits. You can also use
  129. two small functions which may ease information output: /kte_echo
  130. and /kte_error.
  131.   The syntax is simple: '/kte_echo <window> <text>', where
  132. <window> is the window where you want to echo (can be -a for
  133. active window or -s for status window), and <text> is the text
  134. you want to output. It's a shortcut for using the Echo MTS event.
  135. /kte_error works the same way, but for the Error event.
  136.   If you're writing an add-on, I wouldn't recommend using these
  137. aliases, though, or your add-on will only work if the user has
  138. Kte.
  139.  
  140.  
  141. Theme problems
  142. --------------------------------------------------- - -  -    -
  143.   These are common theme problems:
  144.   - When you preview a theme, it echoes something to the status
  145.     window. This is because the theme is using /echo directly
  146.     instead of %:echo, defined by the standard, and needs fixing.
  147.   - Kte simply says "invalid theme file". Possible causes are
  148.     that the theme doesn't have a Name line, doesn't define the
  149.     version of the MTS standard it's made for (MTSVersion line)
  150.     or defines it as something different than 1.0 or 1.1 (there
  151.     are a few themes still based on early 0.9x standards).
  152.   - On some events that you call, like when you send a CTCP or
  153.     a notice, some themes show your nickname instead of the
  154.     target's nickname. This is because the theme is using <nick>
  155.     where it should use <target>. If you have knowledge of the
  156.     themes format, you can easily fix that on the .mts file.
  157.     Anyway, authors should be contacted to fix their themes.
  158.  
  159.   In any cases, you should check if there isn't a newer version
  160. of the theme available.
  161.  
  162.  
  163. Version history
  164. --------------------------------------------------- - -  -    -
  165. 1.0 - First public release.
  166. 1.1 - Added more information to Readme.
  167.     - Fixed bugs related to:
  168.       - Events: kick, /names, part, /whois
  169.       - General: scheme loading, theme unloading, loading
  170.         packed/gzipped themes, loading themes with background
  171.         pictures.
  172.       - Kte on directories containing spaces.
  173.     - Caching improvement:
  174.       - Compiled themes are now cached.
  175.       - Each different scheme in a theme will have its own
  176.         cached bitmap now.
  177.     - New options:
  178.       - It's now possible to hide some messages and events that
  179.         appear when you're connecting to a server or joining a
  180.         channel.
  181.       - You can set what you want to be cached now.
  182.       - Now you can skip some stuff from being applied while
  183.         loading themes.
  184.     - Changed the way the preview works. There won't be any
  185.       problems related to previewing themes with background
  186.       pictures anymore.
  187.     - Kte will perform some cleanup now when unloaded.
  188.     - CTCP replies are now echoed to the Status window, like
  189.       mIRC does by default.
  190.     - Settings restoration now takes your timestamp back.
  191.     - Added an Edit command to the File menu in the loading
  192.       dialog. If you have KThm (K Theme Editor) loaded, it will
  193.       be used for editing. If not, Notepad will be called.
  194.     - Some minor changes.
  195. 1.2 - JoinSelf is now supported.
  196.     - Fixed problem with themes which don't use a Prefix line.
  197.     - Fixed problems related to:
  198.       - Events: Join
  199.       - Timestamp: %::timestamp, base colors on timestamps.
  200.     - Added /kte.* commands, which do just the same as their
  201.       /theme.* counterparts.
  202.     - Kte now reads mirc.ini to determine the target of the
  203.       events. This includes the "Show in active" group in mIRC
  204.       Options and the Events settings for channels. To force a
  205.       refresh, use '/kte_refresh' (this is the first Kte-
  206.       specific command, by the way).
  207.     - Improved how the Load event is displayed.
  208.     - Added a Font Replacement section to the options dialog.
  209.       If you don't have IBMPC or GwdTE_437 installed, Kte will
  210.       automatically set up replacements for them with Terminal.
  211.       If you have Microsoft Sans Serif installed, it will be
  212.       set as a replacement for MS Sans Serif.
  213.     - Kte.dll now has a few more built-in functions.
  214.       Previeweing themes became much faster.
  215.     - Numerous minor fixes.
  216. 1.3 - DCC Chat connections are themed now.
  217.       Kte won't theme DCC Chats if you have more than one chat
  218.       with the same person, to avoid conflicts and problems.
  219.     - Kte now fully works on mIRC 6.0 and 6.01 (but it's still
  220.       compatible with mIRC 5.91).
  221.     - Fixed %::cmode in events.
  222.     - Improved how numeric replies (raws) are handled.
  223.     - In mIRC 6.01, Kte will detect the "Show Away in active"
  224.       option.
  225.     - Fixed (hopefully) preview not working for some people.
  226.     - Kte should work properly now with fserves.
  227.     - Several, really numerous other bugfixes.
  228. 1.31 (Minor, mostly bugfix release)
  229.     - This may be the last release of Kte that will be
  230.       compatible with mIRC 5.91.
  231.     - Hopefully, the bug that showed wrong channel names and
  232.       nicknames has been fixed.
  233.     - Improved Kte.dll: much smaller, and the preview bug
  234.       should be gone forever.
  235.     - Got rid of the /me bug on DCCs.
  236.     - A few other issues fixed here or there.
  237. 1.4 - mIRC 6.01 is required now.
  238.     - Renamed all /kte.* commands to /kte_*. Please change any
  239.       references to them, as /kte.* won't be supported in future
  240.       releases.
  241.     - Added zipped themes support (mUnzip is required)
  242.     - Added %::parentext to CTCP-related events
  243.     - Channel and query backgrounds should now always be
  244.       applied.
  245.     - Fixed a few display bugs on the main dialog
  246.     - Kte now uses %:comments instead of %:comment, as the
  247.       standard says.
  248.     - The bug that showed wrong channel names and nicknames is
  249.       gone for good this time (I hope).
  250.     - Several other reported bugs fixed.
  251. 1.5 - Compatible with mIRC 6.01 and 6.02.
  252.     - Added more information to this file: made some aspects
  253.       clearer, added how to load Kte.
  254.     - Several internal changes, again:
  255.       - New kte-dyn system (faster, but more complicated
  256.         to change).
  257.       - More corrections in problems with background pictures.
  258.       - Once more, numerous minor bugs were fixed.
  259.     - Preview files are now saved in .png format if you are
  260.       using True Color (24-bit) or Full Color (32-bit) color
  261.       settings. As the .png saver still has issues with other
  262.       color depths, .bmp is used on them instead.
  263.     - There are now two previews: the standard one and a
  264.       bigger one, that pops up on a separate window.
  265.     - Added a "Change scheme" menu item. Can also be used as
  266.       a good example of how to read information from the
  267.       current theme from any other script.
  268.  
  269.  
  270. Author
  271. --------------------------------------------------- - -  -    -
  272. Nickname: Kamek
  273. Channels: #IRCzone on BRASnet (irc.brasnet.org)
  274.           #mircscripts.org on undernet (eu.undernet.org)
  275. Contact:  talk to me on IRC or send me a private message
  276.           on mircscripts.org.
  277.  
  278.  
  279. Thanks
  280. --------------------------------------------------- - -  -    -
  281. Without these people, Kte wouldn't be the same...
  282.  
  283. mIRC creator: Khaled Mardam-Bey
  284. They're cool: crazy2k, Dark_Greg, Eric^^, Tig0ti, outbreak
  285. Bug trackers: blue-elf, Ymar
  286. Oh, and also: all the other people who reported bugs
  287. Annoying ppl: fubar, nacitar, oracel (kidding)
  288. vPak support: Variant (vPak addon)
  289. gzip support: Necroman (nGZIPn.dll)
  290. .zip support: Info-ZIP (base for mUnzip.dll)
  291. Numeric info: pai (Numerics reference: http://www.pairc.com/)
  292. Compiler boy: tabo
  293. Hosting this: mircscripts.org
  294. Of course...: you, for using it :)
  295.