--- trunk/doc/en/html/setup/teraterm-win.html 2009/03/24 12:52:36 3226 +++ trunk/doc/en/html/setup/teraterm-win.html 2009/03/24 15:10:33 3227 @@ -1,550 +1,550 @@ - - - - -Window (Tera Term setup file) - - - - - -

Disabling auto text copying

- -

-If you select text by mouse, it is copied to the clipboard at the same time. To disable the auto text copying, edit the AutoTextCopy line in the [Tera Term] section of the setup file like the following: -

- -
-AutoTextCopy=off
-
- -
-Default:
-AutoTextCopy=on
-
- - -

Delimiters of a word selected by double clicking

- -

-You can select a word by double clicking it with the left mouse button. You can specify delimiter characters for the word selection by editing the DelimList line in the [Tera Term] section of the setup file like the following: -

- -
-DelimList=<delimiter characters>
-
- -

-For example: -

- -
-DelimList=<>()[]
-
- -

-specifies 6 delimiter characters "<", ">", "(", ")", "[" and "]". -Note that the space and "$" characters should be specified as "$20" and "$24": -

- -
-DelimList=$20    ; space character
-
- -
-Default:
-DelimList=$20!"#$24%&'()*+,-./:;<=>?@[\]^`{|}~
-
- -

-In the DelimList line, only singe-byte code characters can be specified. Double-byte code characters (Japanese kanji) are regarded as delimiters. You can make them be non-delimiters by editing the DelimDBCS line like the following: -

- -
-DelimDBCS=off
-
- -
-Default:
-DelimDBCS=on
-
- -

-If you prefer the word selection behavior of earlier Tera Term versions, specify like the following: -

- -
-DelimList=$20
-DelimDBCS=off
-
- - -

Disabling the pop-up menu

- -

-When the menu bar is hidden, clicking the left mouse button while pressing the Ctrl key causes the pop-up menu to appear. To disable the pop-up menu, edit the EnablePopupMenu line in the [Tera Term] section of the setup file like the following: -

- -
-EnablePopupMenu=off
-
- -
-Default:
-EnablePopupMenu=on
-
- - -

Hiding the "Show menu bar" command

- -

-When the menu bar is hidden, the "Show menu bar" command appears in the system menu. To hide the "Show menu bar" command, edit the EnableShowMenu line in the [Tera Term] section of the setup file like the following: -

- -
-EnableShowMenu=off
-
- -
-Default:
-EnableShowMenu=on
-
- - -

Disabling the language mode selection

- -

-To disable the language mode selection in the [Setup] General dialog box, edit the LanguageSelection line in the [Tera Term] section of the setup file like the following: -

- -
-LanguageSelection=off
-
- -
-Default:
-LanguageSelection=on
-
- - -

Maximum scroll buffer size

- -

-You can change the maximum scroll buffer size, which can be specified in the [Setup] Window dialog box, by editing the MaxBuffSize line in the [Tera Term] section of the setup file like the following: -

- -
-MaxBuffSize=<number of lines>
-    (should be less than or equal to 500000)
-
- -

-Note: Tera Term consumes <scroll buffer size> * <terminal width> * 5 bytes of memory for the scroll buffer. -

- -
-Default:
-MaxBuffSize=10000
-
- - -

Nonblinking cursor

- -

-You can make the cursor nonblinking by editing the NonblinkingCursor line in the [Tera Term] section of the setup file like the following: -

- -
-NonblinkingCursor=on
-
- -
-Default:
-NonblinkingCursor=off
-
- - -

Maximum number of lines to move in a jump scrolling

- -

-To change the maximum number of lines to move in a jump scrolling, edit the ScrollThreshold line in the [Tera Term] section of the setup file like the following: -

- -
-ScrollThreshold=<number of lines>
-
- -
-Default:
-ScrollThreshold=12
-
- - -

Disabling text selection when the window is activated by mouse

- -

-When the window is inactive, you can activate the window by clicking the text area of window. In the default setup, the text selection is started by this mouse clicking at the same time. To disable the text selection when the window is activated by mouse, edit the SelectOnActive line in the [Tera Term] section of the setup file like the following: -

- -
-SelectOnActivate=off
-
- -
-Default:
-SelectOnActivate=on
-
- - -

Title format

- -

-To change the title format, edit the TitleFormat line in the [Tera Term] section of the setup file like the following: -

- -

-You can change the key code for the left mouse button by editing the TEKGINMouseCode line in the [Tera Term] section of the setup file like the following: -

- -
-TitleFormat=<format ID>
-
- -

-<format ID> is a integer value. It is treated as bit string. -

- - - - - - - - - - - - - - - - - - - - - - - - - - -
1st bit (1)Displays tcp hostname or serial port number
2nd bit (2)Displays session No.
3rd bit (4)Displays VT/TEK
4th bit (8)Displays <host/port> first
5th bit (16)Displays TCP port number
6th bit (32)Displays the baud rate of serial port
- -

-Examples of <format ID> are shown as follows. -

- -
-Format ID   Title format
-0           <title>
-1           <title> - <host/port>
-2           <title> (session no.)
-3           <title> - <host/port> (session no.)
-4           <title> VT/TEK
-5           <title> - <host/port> VT/TEK
-6           <title> (session no.) VT/TEK
-7           <title> - <host/port> (session no.) VT/TEK
-13          <host/port> - <title> VT/TEK
-29          <host:tcpport/port> - <title> VT/TEK
-45          <host/port:baud> - <title> VT/TEK
-61          <host:tcpport/port:baud> - <title> VT/TEK
-
- -
-Default:
-TitleFormat=5
-
- - -

Actual colors of "white" and "black" colored text

- -

-The escape sequences "<ESC>[37m" and "<ESC>[30m" make the text color white and black, respectively. Similarly, the escape sequences "<ESC>[47m" and "<ESC>[40m" make the background color white and black, respectively. -

- -

-Some applications assume that the screen background is black (like real VT100 terminal), and expect that white colored text is visible. However, the default background color of Tera Term is white, and therefore white colored text is invisible. -

- -

-If you edit the UseTextColor line in the [Tera Term] section of the setup file like the following: -

- -
-UseTextColor=on
-
- -

-the actual color of "white" colored text (background) becomes a color for "Text" specified in the [Setup] Window dialog box. Similarly, the actual colors for "black" text (background) becomes a color for "Background". -

- -
-Default:
-UseTextColor=off
-
- - -

Space between characters (lines)

- -

-To change space between characters (lines), edit the VTFontSpace line in the [Tera Term] section of the setup file like the following: -

- -
-VTFontSpace=<dx1>,<dx2>,<dy1>,<dy2>
-
- -
-Where:
-  <dx1>  Left side space for each character in pixels.
-  <dx2>  Right side space for each character in pixels.
-  <dy1>  Space above each line in pixels.
-  <dy2>  Space below each line in pixels.
-
- -
-Example:
-VTFontSpace=0,1,0,0    1 pixel of right side space for each character.
-VTFontSpace=0,0,1,0    1 pixel of space above each line.
-
- -
-Default:
-VTFontSpace=0,0,0,0
-
- - -

Hiding the [Window] menu

- -

-To hide the [Window] menu, edit the WindowMenu line in the [Tera Term] section of the setup file like the following: -

- -
-WindowMenu=off
-
- -
-Default:
-WindowMenu=on
-
- - -

Eterm lookfeel window

- -

-To specify the detailed settings for Eterm lookfeel window, edit the [Tera Term] section of the setup file like the following: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
BGSPIPathOn / OffThis option can specify Susie plugin path to load the image. Susie is Japanese free software.
BGFastSizeMovefolder nameThis option enables Tera Term window moving and resizing to more faster. This feature is valid in Windows dragging mode.
BGFlickerlessMoveOn / OffThis option can reduce the flicker of window moving.
BGUseAlphaBlendAPIOn / OffFor debug. Tera Term does not use AlphaBlend API when this option is off.
BGNoFrameOn / OffTera Term window is without frame when this option is on and HideTitle option is on. - If so, you can resize window with Alt + Shift + LeftDrag.
BGThemeFilefile nameYou can specify the theme file.
- Tera Term will randomly select one of files when the theme file is specify with wildcard.
- -
-Default:
-BGUseAlphaBlendAPI = On
-BGSPIPath = plugin
-BGFastSizeMove = On
-BGFlickerlessMove = On
-BGNoFrame = Off
-BGThemeFile = theme\*.ini
-
- -

Config of theme file

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
BGReverseTextTone0 - 255The transparency value of the reverse text.
BGPictureFilefile nameYou can specify the image file name merging with the wall paper.
- Tera Term will randomly select one of files when the wild card is specified.
- Please specify the relative path from the thema file when you want to use the relative path.
- The kind of file that Tera Term can load is depend the plugin stored in BGSPIPath.
- Tera Term can load the bitmap file when there is not plugin.
-
BGPicturePatternStretch
- Tile
- Center
- FitWidth
- FitHeight
- AutoFit
You can specify the painting method of the image file.
- Both FitWidth and FitHeight can expand or recude the image while the aspect ratio of the image preserves.
- AutoFit can exchange FitWidth for FitHeight not to generate the space between the window and the image. -
BGPictureBaseColorR, G, BThis color can paint between the image file and the window.
BGPictureTone0 - 255The transparency value of the image file.
BGFadeTone0 - 255This option can enable the whole background to fade.
BGFadeColorR, G, BThis option can configure the fade color.
VTFore, Red ...R, G, BThis option can configure the text color.
- - -

How to scroll the screen when the window size is maximized

-

-You can specify how to scroll the screen when the window size is maximized.
-If the screen is scrolled with the maximized window size, the screen image may be disrupted in some case. Therefore, the screen of maximized window size will be scrolled by using a different method than a usual way by default. However, there may be a minor side effect such as flickering or being slowed down.
-If a line of MaximizedBugTweak in [Tera Term] section of a setup file is modified as follows, a usual method will be used even the window size is maximized to avoid such side effects. However, as described above, the screen image may be disrupted. -

- -
-MaximizedBugTweak=off
-
- -
-Default:
-MaximizedBugTweak=on
-
- - -

Display the cursor even if the window comes out of focus

-

-Tera Term will display the cursor even if the window comes out of focus.
-If you want to disable this option, modify a line of KillFocusCursor in [Tera Term] section of setup file as follows. -

- -
-KillFocusCursor=off
-
- -
-Default:
-KillFocusCursor=on
-
- - -

Save the window position

-

-Tera Term does not save the window position when "Save setup" was called.
-If you enable this position, current window position is saved to a specified setup file. -

- -

-Also if this option is enabled, current window position and terminal size are saved to the current setup file when VT window was closed. -

- -
-SaveVTWinPos=on
-
- -
-Default:
-SaveVTWinPos=off
-
- - -

Change the window icon

-

-Tera Term executable program includes "VT window" icon, "TEK window" icon, and some other icons. -If you change the value of VTIcon or TEKIcon, the displaying icon of VT window or TEK window is changed. -

- -

-For example, to use old icon for VT window, specify like the following: -

- -
-VTIcon=VT_CLASSIC
-
- -

-Following icon names are available: -

- - - - - - - - - - - - - - - -
Icon name Icon
TTERM
VT
TEK
TTERM_CLASSIC
VT_CLASSIC
CYGTERM
Default Default("VT" at VT window, "TEK" at TEK window)
- -
-Default:
-VTIcon=Default
-TEKIcon=Default
-
- - - - + + + + +Window (Tera Term setup file) + + + + + +

Disabling auto text copying

+ +

+If you select text by mouse, it is copied to the clipboard at the same time. To disable the auto text copying, edit the AutoTextCopy line in the [Tera Term] section of the setup file like the following: +

+ +
+AutoTextCopy=off
+
+ +
+Default:
+AutoTextCopy=on
+
+ + +

Delimiters of a word selected by double clicking

+ +

+You can select a word by double clicking it with the left mouse button. You can specify delimiter characters for the word selection by editing the DelimList line in the [Tera Term] section of the setup file like the following: +

+ +
+DelimList=<delimiter characters>
+
+ +

+For example: +

+ +
+DelimList=<>()[]
+
+ +

+specifies 6 delimiter characters "<", ">", "(", ")", "[" and "]". +Note that the space and "$" characters should be specified as "$20" and "$24": +

+ +
+DelimList=$20    ; space character
+
+ +
+Default:
+DelimList=$20!"#$24%&'()*+,-./:;<=>?@[\]^`{|}~
+
+ +

+In the DelimList line, only singe-byte code characters can be specified. Double-byte code characters (Japanese kanji) are regarded as delimiters. You can make them be non-delimiters by editing the DelimDBCS line like the following: +

+ +
+DelimDBCS=off
+
+ +
+Default:
+DelimDBCS=on
+
+ +

+If you prefer the word selection behavior of earlier Tera Term versions, specify like the following: +

+ +
+DelimList=$20
+DelimDBCS=off
+
+ + +

Disabling the pop-up menu

+ +

+When the menu bar is hidden, clicking the left mouse button while pressing the Ctrl key causes the pop-up menu to appear. To disable the pop-up menu, edit the EnablePopupMenu line in the [Tera Term] section of the setup file like the following: +

+ +
+EnablePopupMenu=off
+
+ +
+Default:
+EnablePopupMenu=on
+
+ + +

Hiding the "Show menu bar" command

+ +

+When the menu bar is hidden, the "Show menu bar" command appears in the system menu. To hide the "Show menu bar" command, edit the EnableShowMenu line in the [Tera Term] section of the setup file like the following: +

+ +
+EnableShowMenu=off
+
+ +
+Default:
+EnableShowMenu=on
+
+ + +

Disabling the language mode selection

+ +

+To disable the language mode selection in the [Setup] General dialog box, edit the LanguageSelection line in the [Tera Term] section of the setup file like the following: +

+ +
+LanguageSelection=off
+
+ +
+Default:
+LanguageSelection=on
+
+ + +

Maximum scroll buffer size

+ +

+You can change the maximum scroll buffer size, which can be specified in the [Setup] Window dialog box, by editing the MaxBuffSize line in the [Tera Term] section of the setup file like the following: +

+ +
+MaxBuffSize=<number of lines>
+    (should be less than or equal to 500000)
+
+ +

+Note: Tera Term consumes <scroll buffer size> * <terminal width> * 5 bytes of memory for the scroll buffer. +

+ +
+Default:
+MaxBuffSize=10000
+
+ + +

Nonblinking cursor

+ +

+You can make the cursor nonblinking by editing the NonblinkingCursor line in the [Tera Term] section of the setup file like the following: +

+ +
+NonblinkingCursor=on
+
+ +
+Default:
+NonblinkingCursor=off
+
+ + +

Maximum number of lines to move in a jump scrolling

+ +

+To change the maximum number of lines to move in a jump scrolling, edit the ScrollThreshold line in the [Tera Term] section of the setup file like the following: +

+ +
+ScrollThreshold=<number of lines>
+
+ +
+Default:
+ScrollThreshold=12
+
+ + +

Disabling text selection when the window is activated by mouse

+ +

+When the window is inactive, you can activate the window by clicking the text area of window. In the default setup, the text selection is started by this mouse clicking at the same time. To disable the text selection when the window is activated by mouse, edit the SelectOnActive line in the [Tera Term] section of the setup file like the following: +

+ +
+SelectOnActivate=off
+
+ +
+Default:
+SelectOnActivate=on
+
+ + +

Title format

+ +

+To change the title format, edit the TitleFormat line in the [Tera Term] section of the setup file like the following: +

+ +

+You can change the key code for the left mouse button by editing the TEKGINMouseCode line in the [Tera Term] section of the setup file like the following: +

+ +
+TitleFormat=<format ID>
+
+ +

+<format ID> is a integer value. It is treated as bit string. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
1st bit (1)Displays tcp hostname or serial port number
2nd bit (2)Displays session No.
3rd bit (4)Displays VT/TEK
4th bit (8)Displays <host/port> first
5th bit (16)Displays TCP port number
6th bit (32)Displays the baud rate of serial port
+ +

+Examples of <format ID> are shown as follows. +

+ +
+Format ID   Title format
+0           <title>
+1           <title> - <host/port>
+2           <title> (session no.)
+3           <title> - <host/port> (session no.)
+4           <title> VT/TEK
+5           <title> - <host/port> VT/TEK
+6           <title> (session no.) VT/TEK
+7           <title> - <host/port> (session no.) VT/TEK
+13          <host/port> - <title> VT/TEK
+29          <host:tcpport/port> - <title> VT/TEK
+45          <host/port:baud> - <title> VT/TEK
+61          <host:tcpport/port:baud> - <title> VT/TEK
+
+ +
+Default:
+TitleFormat=5
+
+ + +

Actual colors of "white" and "black" colored text

+ +

+The escape sequences "<ESC>[37m" and "<ESC>[30m" make the text color white and black, respectively. Similarly, the escape sequences "<ESC>[47m" and "<ESC>[40m" make the background color white and black, respectively. +

+ +

+Some applications assume that the screen background is black (like real VT100 terminal), and expect that white colored text is visible. However, the default background color of Tera Term is white, and therefore white colored text is invisible. +

+ +

+If you edit the UseTextColor line in the [Tera Term] section of the setup file like the following: +

+ +
+UseTextColor=on
+
+ +

+the actual color of "white" colored text (background) becomes a color for "Text" specified in the [Setup] Window dialog box. Similarly, the actual colors for "black" text (background) becomes a color for "Background". +

+ +
+Default:
+UseTextColor=off
+
+ + +

Space between characters (lines)

+ +

+To change space between characters (lines), edit the VTFontSpace line in the [Tera Term] section of the setup file like the following: +

+ +
+VTFontSpace=<dx1>,<dx2>,<dy1>,<dy2>
+
+ +
+Where:
+  <dx1>  Left side space for each character in pixels.
+  <dx2>  Right side space for each character in pixels.
+  <dy1>  Space above each line in pixels.
+  <dy2>  Space below each line in pixels.
+
+ +
+Example:
+VTFontSpace=0,1,0,0    1 pixel of right side space for each character.
+VTFontSpace=0,0,1,0    1 pixel of space above each line.
+
+ +
+Default:
+VTFontSpace=0,0,0,0
+
+ + +

Hiding the [Window] menu

+ +

+To hide the [Window] menu, edit the WindowMenu line in the [Tera Term] section of the setup file like the following: +

+ +
+WindowMenu=off
+
+ +
+Default:
+WindowMenu=on
+
+ + +

Eterm lookfeel window

+ +

+To specify the detailed settings for Eterm lookfeel window, edit the [Tera Term] section of the setup file like the following: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
BGSPIPathOn / OffThis option can specify Susie plugin path to load the image. Susie is Japanese free software.
BGFastSizeMovefolder nameThis option enables Tera Term window moving and resizing to more faster. This feature is valid in Windows dragging mode.
BGFlickerlessMoveOn / OffThis option can reduce the flicker of window moving.
BGUseAlphaBlendAPIOn / OffFor debug. Tera Term does not use AlphaBlend API when this option is off.
BGNoFrameOn / OffTera Term window is without frame when this option is on and HideTitle option is on. + If so, you can resize window with Alt + Shift + LeftDrag.
BGThemeFilefile nameYou can specify the theme file.
+ Tera Term will randomly select one of files when the theme file is specify with wildcard.
+ +
+Default:
+BGUseAlphaBlendAPI = On
+BGSPIPath = plugin
+BGFastSizeMove = On
+BGFlickerlessMove = On
+BGNoFrame = Off
+BGThemeFile = theme\*.ini
+
+ +

Config of theme file

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
BGReverseTextTone0 - 255The transparency value of the reverse text.
BGPictureFilefile nameYou can specify the image file name merging with the wall paper.
+ Tera Term will randomly select one of files when the wild card is specified.
+ Please specify the relative path from the thema file when you want to use the relative path.
+ The kind of file that Tera Term can load is depend the plugin stored in BGSPIPath.
+ Tera Term can load the bitmap file when there is not plugin.
+
BGPicturePatternStretch
+ Tile
+ Center
+ FitWidth
+ FitHeight
+ AutoFit
You can specify the painting method of the image file.
+ Both FitWidth and FitHeight can expand or recude the image while the aspect ratio of the image preserves.
+ AutoFit can exchange FitWidth for FitHeight not to generate the space between the window and the image. +
BGPictureBaseColorR, G, BThis color can paint between the image file and the window.
BGPictureTone0 - 255The transparency value of the image file.
BGFadeTone0 - 255This option can enable the whole background to fade.
BGFadeColorR, G, BThis option can configure the fade color.
VTFore, Red ...R, G, BThis option can configure the text color.
+ + +

How to scroll the screen when the window size is maximized

+

+You can specify how to scroll the screen when the window size is maximized.
+If the screen is scrolled with the maximized window size, the screen image may be disrupted in some case. Therefore, the screen of maximized window size will be scrolled by using a different method than a usual way by default. However, there may be a minor side effect such as flickering or being slowed down.
+If a line of MaximizedBugTweak in [Tera Term] section of a setup file is modified as follows, a usual method will be used even the window size is maximized to avoid such side effects. However, as described above, the screen image may be disrupted. +

+ +
+MaximizedBugTweak=off
+
+ +
+Default:
+MaximizedBugTweak=on
+
+ + +

Display the cursor even if the window comes out of focus

+

+Tera Term will display the cursor even if the window comes out of focus.
+If you want to disable this option, modify a line of KillFocusCursor in [Tera Term] section of setup file as follows. +

+ +
+KillFocusCursor=off
+
+ +
+Default:
+KillFocusCursor=on
+
+ + +

Save the window position

+

+Tera Term does not save the window position when "Save setup" was called.
+If you enable this position, current window position is saved to a specified setup file. +

+ +

+Also if this option is enabled, current window position and terminal size are saved to the current setup file when VT window was closed. +

+ +
+SaveVTWinPos=on
+
+ +
+Default:
+SaveVTWinPos=off
+
+ + +

Change the window icon

+

+Tera Term executable program includes "VT window" icon, "TEK window" icon, and some other icons. +If you change the value of VTIcon or TEKIcon, the displaying icon of VT window or TEK window is changed. +

+ +

+For example, to use old icon for VT window, specify like the following: +

+ +
+VTIcon=VT_CLASSIC
+
+ +

+Following icon names are available: +

+ + + + + + + + + + + + + + + +
Icon name Icon
TTERM
VT
TEK
TTERM_CLASSIC
VT_CLASSIC
CYGTERM
Default Default("VT" at VT window, "TEK" at TEK window)
+ +
+Default:
+VTIcon=Default
+TEKIcon=Default
+
+ + + +