SBrowserQ User's Guide-V3.7


Table of contents

1 Explanation of initial screen

2. Importing GRs

3. Basic game operation

4. Saving GRs and format of GR

5. Database storage and retrieval

6. Watching games

7. Diagram image output

8. Use of computer shogi engine

9. Other operations

Appendix GRE-style move expression

Explanation of terms used in this guide

1. Explanation of initial screen

When you start SBrowseQ, the following screen is displayed.

Initial screen
The above screen image is when Look&Feel is Metal, and other Look&Feel screen images are slightly different.
Especially on Mac OS X, if Look&Feel is Aqua, the menu bar will move to the screen menu.
In this guide, the display style when Metal is set to Look&Feel will be explained.

2 Importing GRs

2.1 Screen description immediately after importing
2.2 Importing method
   (1) Import from a GR file
   (2) Import from clipboard
   (3) Capture by dragging and dropping a GR file
   (4) Import GR of Watching game from the internet
   (5) Import from database
2.3 Imported GR
   (1) GR format
   (2) GR code
   (3) Title default settings

2.1 Screen description immediately after importing

In order to display the GR on the shogi board, it is first necessary to import the GR from the outside.
If you import the GR

The following shows the screen immediately after importing.

(Screen 1 immediately after import)
  Screen 1 immediately after loading

The above screen is an example immediately after importing in the normal case.
When you import the GR, 【Shogi Board Window】, 【Shogi Board Right Window】, and 【Shogi Board Lower Window】 are newly assigned displayed respectively. 【Comment Board】 is displayed in the 【Shogi Board Lower Window】.
If there are GRs that were displayed before importing, they will not be deleted.
It is possible to switch and display by clicking the 【GR Selection Tab】 with the mouse.

(Screen 2 immediately after import) Case where the 【Engine Monitor】 is displayed
Screen 2 immediately after loading

The above capture screen is when the score and the thinking process are set in the GR.

This is the case that read in the GR generated by the game with the computer shogi engine the local game or the net game. The thinking process and 【Score Graph】are displayed in the 【Shogi Board Lower Window】. (Refer to 8.2 (1) (f) Saving Engine Monitor data)

In the 【Shogi Board Lower Window】, in addition to 【Comment Board】, 【Search Result List】 of the database or 【Engine Monitor】 (displayed when playing a game with Shogi engine) or 【Network Game Operation Board】(used when playing a net game) is displayed. If they overlap, they can be switched and displayed by tabs.

This software adopts a method (multi-tab window) to switch and display multiple imported GRs using the 【GR Selection Tab】.

2.2 How to import

(1) Import from a GR file

When importing a GR file, select 【File (F)】/【Open】 from the menu. The 【File Selection Dialog】 is displayed.

【File Selection Dialog】


Select the file name of the game to be imported and click the 【Open Button】. Importing the GR is completed, and the screen immediately after importing is displayed.

(2) Import from clipboard

Imports the contents of copied in the clipboard by other shogi software or the contents read in the clipboard by copy the GR file of the watching game in into this system.
Click the right mouse button on the 【Shogi Board Window】 to display the 【Shogi Board Popup Menu】.

【Shogi Board Popup Menu】


From the 【Shogi Board Popup Menu】, select 【Paste GR or Position】.
When the GR is captured, the screen immediately after importing is displayed.

(3) Drag and Drop the GR file to import

Drag a GR file at any location of the 【Shogi Board Window】 with the mouse and drop it to complete the GR capture and display the screen immediately after importing.

(4) Import the GR from the internet

Import the GR for watching games directly from the internet.
For details, refer to 6 Watching games.

(5) Import from database

If you have set a GR (or Tsume Shogi) database , you can import GRs from that database.
For details, refer to (3) Operations on Search Result List.

2.3 Imported GR

(1) GR format

The GR is written in a certain format, and there are several types.
The GR format supported by this program is as follows.

KIF format: A format widely used in professional game, shogi club 24, etc.
		You can also specify the consumption time for each "move".
KI2 format: The notation of the "move"s is based on the Japan Shogi Federation.
		The consumption time for each "move" cannot be specified.	
		However, in SBrowserQ, the consumption time is recorded as comment information 
		and displayed as the consumption time in the 【Move List】.
CSA format: The format used in the GR of computer shogi.
		You can also specify the consumption time for each "move".
GRE format: A GR format created to support the English version.
		It is a specification unique to SBrowserQ and is not compatible with other software.

You don't need to be aware of these formats when you import the GR.
This program automatically recognizes and retrieves information.

The GR is roughly classified into a part that describes a series of "move" and a part that describes game (or Tsume Shogi) information.
There is not much incompatibility of information in each GR format for the "move", but for the game (or Tsume Shogi) information part, setting and format of items are not always the same.
In addition, even in the same GR format, there are items added by the game, omitted items, etc.
It becomes complicated and rather makes the system difficult to understand.
Therefore, this program defines the information to be taken from the game, and omits other information as information.
See 3.3 (4) Editing game information and Tsume Shogi information for information to be imported.

(2) GR code

Normally, if you use only this shogi software to handle the GR file in the same platform (OS), you don't need to be very aware of the code system.
However, when reading a GR file created with a text editor or a GR file created with other shogi software, due to differences in the code system,it may not be readable.
To avoid such a situation, when importing from a GR file, the code system is automatically determined and the GR can be imported.
Not all code systems can be judged, but I think that most of the code systems used in Windows, MAC and Linux can be read.

If the code system is clearly known and fixed, it is slightly more efficient to directly specify the code system.
Therefore, the code system of the input GR file can be set so that it can be directly specified.

Select 【Preferences】 from the 【Preferences (P) Menu】.
【Preferences Dialog】 is displayed.
Specify the code system of the GR to be imported in 【GR Code Combo】 of 【GR Input】.

【Preferences Dialog】


The code systems that can be selected are as follows.
The code system that can be judged by "Automatic Detection" is also in this range.
Automatic Detection: The code system is automatically judged. This is the default.
【Selectable code system below】
Shift_JIS: Code system used in old Windows (Shift JIS)
UTF_8: Unicode encoding method is UTF-8
UTF_16LE: Unicode encoding method is UTF-16 and byte order is little endian
UTF_16BE: Unicode encoding method is UTF-16 and byte order is big endian
EUC_JP: Code system used in Uunix system
ISO2022JP: Code system used in e-mails (JIS)

I have been at loss jugement about what code system is good when saving a GR in a file (also for outputting to a ZIP file).
From the reason why UTF_8 can be handled as standard on all platforms and it can be read by other shogi software , it will be set by default at installing this program , To change this specification, use the 【Preferences Dialog】 as in the case of importing a GR.
Specify the code system of the GR to be output in 【GR Code Combo】 of 【GR Output】.
The code system that can be selected in this combo box is the same as when inputting.
However, there is no selection item called "Automatic Determination".


(3) Title default settings

When importing a GR, the "Title" item of Game Information may not be set.
When performing a database search with this system since the title becomes a key item, I want to avoid the unset state as much as possible.
Therefore, when a GR is imported, a "Title" is generated from the "Event" item of the GR for which a "Title" has not been set, and it is set as the default.

If there is a specified keyword (multiple specifications are possible) in the character string in the "Event" item, the "Title" specified for it is taken as the default Title of the GR

In 【Preferences Dialog】, specify the keyword and title in 【Game Title Default】/【GR Input】.
If you click the right mouse button in the 【Game Title Default】 field, 【Title Setting Popup Menu】 will be displayed.

【Title Setting popup Menu】

Add

When adding a new definition, select 【Add】 from the 【Title Setting Popup Menu】.
【Add or Update Title Dialog】 is displayed.
【Add or Update Title Dialog】


Specify the default character string as "Title" in 【Title】.
Specify the keyword string in 【Charater String in <Event>】.
When specifying more than one, separate them with',' (comma).
When you click the 【Add Button】, the added setting will be newly displayed in the 【Game Title Default】field

Update

If you want to update the added settings, click the line you want to update in the 【Game Title Default】 column to select it.
After that, the 【Title Setting Popup Menu】 is displayed and select 【Update】.
【Add or Update Title Dialog】 is displayed.
The 【Title】 and 【Charater String in <Event>】before update are displayed.
Update the contents and click the 【Update Button】.
The updated content is displayed in the 【Game Title Default】 field.

Delete

If you no longer need the definition, you can delete the setting.
Select the row to delete by clicking it with the mouse.
After that, display the 【Title Setting Popup Menu】 and select 【Delete】.
The selected row is deleted from 【Game Title Default】 field.

Click the 【OK Button】 in the 【Preferences Dialog】 to reflect these settings in the system after 【Add】, 【Update】, or 【Delete】.

When adding or updateing, it is not possible to specify duplicate values for the default "Title".
Also, if you specify the same value as that specified in another line for the 【Charater String in <Event>】, the setting in the first line will be given priority.

3. Basic game operation

The GR is a history of the game in which the "move"s from the start potision are described in order, and the "position" can be displayed on the shogi board by advancing the "move".
The following three operations can be performed to a GR displayed on a shogi board.

If you import a GR, you will be able to view and examine the GR.
 

From now on, the "position" currently displayed on the shogi board will be described as the "current position" of that GR.
In addition, the immediately "move" before the present "position" is exposed is described as "current move".
The "current move" has its background color so that it can be identified on the shogi board.
It is displayed in a different color from the shogi board. (See 9.2 (4) "Current move" Background Color)

 3.1 Display of GRs
   (1) Operation for moving the "position" of a GR
    ① Operation using the 【Operation Panel】
    ② Operation by mouse
    ③ Operation by Keyboard
   (2) Auto Playback
    ① Auto Playback operation with 【Operation Panel】
    ② Auto Playback operation with mouse
    ③ Switching the Auto Playback direction with the mouse
    ④ Auto Playback operation with keyboard
   (3) Display of Game information and Tsume Shogi information
    ① Display game information
    ② Display of Tsume Shogi information
 3.2 Research and generation of Branch GR
   (1) "Move" operation during "Reserach mode"
   (2) Branch GR generation by moving and dropping
   (3) Generation of Branch GR by "move"s in 【Comment Board】
   (4) Branch GR generation from 【GR Edit Board】
   (5) Generation of Branch GR from 【Position Dictionary Board】
   (6) Error when generating Branch GR
   (7) Multiple Branch GRs at the same branch point
   (8) Delete Branch GR
   (9) Cancel "move"
   (10) Changing the Branch GR to Root GR
   (11) Remove duplicate "move"s at multipule Branch GRs
 3.3 Editing the GR
   (1) Editing GRs by moving and dropping pieces
   (2) Game Over Reason setting
   (3) Editing operation in the 【Move List】
   (4) Editing game information and Tsume Shogi information
   (5) Creating a new GR
   (6) Edit comment
 3.4 Editing a "position"
   (1) How to move pieces
   (2) Generation of "position"s to be edited
   (3) Setting "position" start information
   (4) End of "position" editing
   (5) Other information settings for the "position"

3.1 Display of GR

(1) Operation for moving the "position" of a GR

Any "position" of the imported GR can be displayed.
There is also a method of sequentially tracing the "move" from the start "position", and a method of directly specifying the "move". Such an operation can be performed when the "Operation Mode" is the "Reserach Mode", and at that time, there is a 【Reserach Mode Icon】 displayed in the 【GR Selection Tab】.
Immediately after importing the GR, it is in this mode.

【Reserach Mode Icon】

Below, I will explain the operation to display the "position" of the GR in this Reserach mode.

① Operation with the 【Operation Panel】

Select 【Display Operation Panel】 from the 【Operation (O) Menu】 to display the 【Operation Panel】.

【Operation Panel】

Move "position" by clicking each button with the mouse.

button Advance one next "position"

button Back one preivious "position"

button Return to the start "position" of Root GR or Branch GR

button Move to the end "position" or of Root GR or Branch GR

button Move to the next lower branch GR at the branch point of the Root GR or the Branch GR

Button Return to the previous upper the branch point at the Root GR or the Branch GR

Button reverse Automatic Playback start

Button forward automatic Playback start

Button Automatic Playback stop

 Automatic Playback speed adjustment slider

【Ooperation Panel】 remains displayed until it is closed by clicking the × button.

② Operation by mouse

You can move "position" with the mouse.

Advance "move"

 Move the mouse cursor over the 【Shogi Board Window】 or 【Move List】 field and rotate the mouse wheel button to the front to advance the "move" according to the amount of rotation.

Back "move"

 Move the mouse cursor over the 【Shogi Board Window】 or 【Move List】 field and rotate the wheel button of the mouse forward to return the "move" according to the amount of rotation.

Direct "move" to any "position"

Click the "move" in the 【Move list】 with the mouse. Then the "position" moves directly to the "position" of the clicked "move".

【Move List】

Return to the upper Branch GR

Move the mouse cursor to the 【Shogi Board Window】 and double-click the mouse to return to the Root GR or the Branch GR.
Also, move the mouse cursor to the 【Move List】 field and click the right mouse button to display the 【Move List Popup Menu】.
Select 【Return】 to return to the previous Root GR or Branch GR.

【Move List Popup Menu】

Move to lower Branch GR

Click the branch point (⇒ displayed in column B) in the 【Move List】 of the Root GR or the Branch GR to move to the lower Branch GR.

【Move List】


Direct move to Branch GR

If you click on a Branch GR (【Node】 ​​or 【Leaf】) that is formed a tree structure in the 【GR Tree】, you can move directly to the Root GR or Branch GR.

【GR Tree】


③ Operation by keyboard

When the focus is in the 【Shogi Borad Window】(【Focus Lamp】 is lit) or in the 【Move List】 field , you can move a "position" by key input.

  【↓】Advance one next "position"
  【↑】Back one preivious "position"
  【Home】Return to start "position" of Root GR or Branch GR
  【End】Move to the end "position" or of Root GR or Branch GR
  【←】Return to the previous upper the branch point at the Root GR or the Branch GR
  【→】Move to the next lower branch GR at the branch point of the Root GR or the Branch GR

(2) Auto Playback

Auto Palyback is a function to replay and display GRs at regular intervals.
Play and display the GR in the forward direction or in the reverse direction or you can stop the auto playback at any place.
It is effective only when the Operation Mode is "Reserch Mode" or "Watching Mode", and does not work while playing a game or editing a GR.

① Auto Playback operation with 【Operation Panel】

If you click the button while the 【Operation Panel】 is open, Auto Playback will start in the forward direction.
Click the button to start Auto Playback in the reverse direction.
To stop Auto Playback, click the button.

The speed (interval) of Auto Playback can be adjusted from 0.1 seconds (left edge) to a maximum of 10 seconds (right edge) by moving the 【Auto Playback Speed Adjustment Slider】 on the 【Operation Panel】.

② Auto Playback operation with mouse

If you check 【Enable Auto Playback Operation with mouse】 in the operation settings of 【Preferences Dialog】, you will be able to perform Auto Playback Operation with mouse.
If you are unfamiliar with the operation, it is difficult to research GR because that the Auto Playback will work unexpectedly and the "position" will change.
So normally you can not use the Auto Playback Operation with the mouse.

When the Auto Playback operation using the mouse is enabled, display the GR on 【Shogi Board Window】 and then click the left mouse button anywhere on the 【Shogi Board Window】 except for the pieces.
Then Auto Playback will start.
If the same operation as the start is performed during the Auto Playback, the Auto Playback is paused.
If you do the same operation again in the paused state, the Auto Playback will resume.

③ Switching the Auto playback direction with the mouse

When Auto Playback is paused, drag the mouse upwards while holding down the left mouse button at any place other than the piece on the 【Shogi Board Window】, The display changes to the reverse direction.
After that, even when the Auto Playback is temporarily stopped and then restarted, the Auto Playback direction does not change and remains in the reverse direction.

Also, when the Auto Playback is paused, if you press the left mouse button and drag downward in any place other than the piece on the 【Shogi Board Window】, change to forward Auto Playback direction.
After that, even when the Auto Playback is temporarily stopped and then restarted, the reproduction direction does not change and remains in the forward direction.

④ Auto Playback operation with keyboard

After displaying the GR in the 【Shogi Board Window】, press the S character key to start Auto Playback in the forward direction.
Pressing the S or P character key during Auto Playback pauses it.
Pressing the S character key in the paused state restarts the Auto Playback in the forward direction, and pressing the P character key restarts the Auto Playback in the reverse direction.

(3) Display of Game information and Tsume Shogi information

In addition to "move"s information, the GR has information such as the player name and game date and time related to the GR,you can display their contents.

① Display game information

If the displayed GR is a game GR(Note), the 【Game Information Panel】 can be displayed.
Select 【Display Information Board】 in the 【Operation (O) Menu】.
The【Game Information Board】 is displayed.

【Game Information Board】


For an explanation of each display item, see that item in 3.3 (4) Editing game information and Tsume Shogi information.
However, 【Start Datetime】 is 【Start Date】 + 【Start Time】, and 【End Datetime】 is 【End Date】 + 【End Time】.
If there is Rating Information, 【Black】 is displayed as 【Black】 + (【Black Rating】), and 【White】 is displayed as 【White】+ (【White Rating】).
For 【Game Over Reason】, see 3.3 Editing the GR (2) Game Over Reason setting.
【Move Count】shows the number of "last move" of the GR.
Please refer to Edit consumption time for 【▲ consumption time】 and 【△ consumption time】.

② Tsume Shogi information

If the displayed the GR is Tsume Shogi (Note), the Tsume Shogi information can be displayed.
Select 【Display Information Board】 in the 【Operation (O) Menu】.
【Tsume Shogi Information Board】 is displayed.

【Tsume Shogi Information Board】


For an explanation of each display item, see that item in 3.3 (4) Editing Game information and Tsume Shogi information.

Note) The operation is the same for both Game Information display and Tsume Shogi Information display.
Depending on the type of displayed GR (play game record or Tsume Shogi record) the display borad is selected.
If it was read from the Tsume Shogi style database, the GR is determined Tsume Shogi GR. 
If it was read from the game style database,it is determined to be a game GR. 
(Refer to 【Tsume Shogi Style】 in 5.1 Database Creation.)
In the case it is not a GR imported from the database, 
if the initial "position" is different from the game start "position"
and the number of starting "move" is not set or is set to 1 
and no player is set, it is judged as Tsume Shogi.

3.2 Research and generation of Branch GR

The research here means to study the changing "move"s from the original "move"s while moving the pieces to the imported GR .
When a piece is moved and examined, a GR is generated correspondingly. It is called a Branch GR.
The generated Branch GR is displayed in a tree so as to branch from the Root.
The operation here is an explanation when the "Operation Mode" is the "Reseach Mode".


Although it is in "Research Mode" immediately after importing, in other modes, selecting 【Research】 in 【Edit (E) Menu】 changes the "Operation Mode" to "Resarch Mode".

(1) "Move" operation during Reserach Mode

There are 【Drag】 method and 【Select】 method for moving pieces.
Which operation is to be performed depends on the to specify the【Piece Movement Method】of 【Preferences Dialog】
The default is 【Drag】 method.

【Drag】 method

Select the piece you want to move on the 【Shogi Board】 with the mouse, drag it as it is, and release the mouse at the move destination to complete the move.
If the destination is not originally movable or if it is a foul, the piece will return to its original position without moving.
In addition, it is not possible to move while ignoring the "black turn" and the "white turn".

In the case of dropping from a piece stand, select the piece on the 【Piece Stand】 which you want to drop,then as well as the operation on the 【Shogi Board】, drag it and release it at the destination.
Similarly, when the dropping destination is a place where the dropping is originally impossible, or when there is an foul (as an example two pawn ),the piece is returned to the original 【Piece Stand】.

If the final "move" in GR is 【Game Over Reason】 (such as when the game is finished or time out), you cannot operate the piece at that position.

【Selection】 method

Click and select the piece you want to move on the 【Shogi Board】 with the mouse.
The background color of the selected piece changes.
Then, the mouse is clicked on the destination to complete the movement.
If the destination is not originally movable or if it is a foul, the piece of the movement source does not move and remains in the selected state.
In addition, it is not possible to move while ignoring the "black turn" and the "white turn". (You cannot select pieces)

To drop from a 【Piece Stand】, click on the piece on the 【Piece Stand】 which you want to drop.
Then click on the destination.
Similarly, when the dropping destination is a place where the dropping is originally impossible, or when there is an foul (as an example two pawn ), the dropping is not completed and the pieces of the 【Piece Stand】 remain selected.

If the final "move" in GR is 【Game Over Reason】 (such as when the game is finished or time out), you cannot operate the piece at that position.

Click the selected piece again to cancel the selection.

  

(2) Branch GR generation by moving and dropping

The Branch GR is generated by moving a piece on a 【Shogi Board】 or dropping a piece from a 【Piece Stand】 at an intermediate position.
The generated Branch GR is displayed in the 【Move List】.
A leaf is displayed in the 【GR Tree】 with the title such as the number of "move"s and the "move".
In addition, ⇒ indicating a branch point is displayed in the 【B】 column of the 【Move List】 which is before moving or dropping the piece.
Below, show the situation on the screen

【Before branch screen】
Before branch screen

At this point, dropping Pawn to 34 from the 【White Piece Stand】 (P*34).

【Screen after branch】
Screen after branch

A Branch GR is generated.
Further, if the player continuously drops or moves the piece after that, the "move" are sequentially added to the Branch GR.
That is, even if a piece is droped or moved at the last step of the Branch GR, a new Branch GR is not generated.
However, in the last step of this Root GR, the Branch GR is always generated, so be careful of the difference.

Here, if return to the Root GR from the Branch GR (see Operation for moving the "position" of a game for how to return), and the following screen will appear.

【The Screen returned to the Root】
Return to Root

  【GR Tree】 shows that the currently displayed game is the Root.
【Move List】 displays "move"s of Root GR, and indicates the branch point with ⇒.

(3) Generation of Branch GR by "move"s in 【Comment Board】

If there is a description of the "move"s of the change procedure in the 【Comment Board】, if the "Operation Mode" is "Research Mode" or "Watching Mode", the "move"s is displayed in blue and underlined.
If you click that part with the mouse, a Branch GR for that part will be generated and displayed on the board.
However, if the situation at the time of clicking and the content of the "move"s procedure do not match, an error will occur and the Branch GR will not be generated.
Below, show the situation on the screen

【Before click the "move"s at 【Comment Board】】
Click comment

△3四歩▲4五玉△3五金▲5五玉△4六馬 in the 【Comment Board】 on the screen before branching If you click

【After click the "move"s at 【Comment Board】】
Comment generation Branch GR

Display the beginning "position" of the generated Branch GR.

Multi-moves selection

The description of the "move"s in the 【Comment Board】 is not limited to the case where the description is connected in a series, and there is usually a description other than the "move"s.
In that case, those "move"s can be selected collectively to form a continuous "move"s.

【Before selection at 【Comment Board】
Before multiple selection

In the above figure,The 5 "move"s such as △同角成▲同香△4四角▲3一角△3三王▲5一龍△4三金 are a series.
Select part or all of those "move"s to be included in the selection range.
Even if the "move"s are not all included in the selection range, as long as the "move"s are within the selection range,it becomes the same as the selection including all the "move"s.

Selection range specification at 【Comment Board】
Multiple selection

Specify the selection area with the mouse as shown above, and release the mouse.
The Branch GR is created in the same as selecting △同角成▲同香△4四角▲3一角△3三王▲5一龍△4三金.

Pinning at 【Comment Board】

【Comment Board】 changes for each "position", so when you create a Branch GR, the comment you are currently referring to will disappear, and if you want to refer to that comment again You have to go back to each branch point.
The pinning is that the 【Comment Board】 does not change even if the "position" changes.

Clicking the 【C】 column of the 【Move List】 with the mouse will pin the comment for that "position".


"Pin" is displayed in the 【C】 column of the 【Move List】 to notify that it has been pinned.
No matter how you move the "position" in this state, the 【Comment Board】 does not change.
Clicking the pinning display "position" again with the mouse releases the pinning.
Only the Root GR can be pinned, and not the Branch GR.

(4) Branch GR generation from 【GR Edit Board】

If you want to generate a GR by copying the "move"s and pasting, display the 【GR Edit Board】 by selecting 【Display Edit Board】 from the 【Operation (O)】 menu.
On the 【GR Edit Board】, click the right mouse button to display the operation menu.
Select 【Paste】 from the operation menu.
The "move"s is pasted and displayed on the 【GR Edit Board】.

【GR Edit Board】


Next, click the 【Add GR】 button to generate the Branch GR from the displayed "move"s.
On the 【GR Edit Board】, you can edit your "move"s by key operation.
You can paste your "move"s on the 【GR Edit Board】, edit it, and then generate the content as a Branch GR.
The 【GR Edit Board】 remains displayed until you click the 【x】 with the mouse to close the window.

While the 【GR Edit Board】 is displayed, if you click your "move"s in the 【Comment Board】, the Branch GR will not be generated, and the "move"s will be captured and displayed in this 【GR Edit Board】.
Therefore, you can edit it if necessary, and then click the 【Add GR Button】 to generate the Branch GR.
Moreover, after moving the "position" to the "position" where the "move"s fits, it is possible to generate the Branch GR by the "move"s.

(5) Generation of Branch GR from 【Position Dictionary Board】

The 【Position dictionary】 is created when the GR is registered in the game database.
About all "position" of the GR registered in the database,it holds a list of the next "move"s and the win rate for each "move"s.
Select 【Display Position Dictionary Board】from 【Operation (O) Menu】.
The 【Position Dictionary Board】 window will be displayed and show the contents of the 【Position Dictionary】 for the "current position".
Clicking each line of the next "move" that is displayed with the mouse will generate a Branch GR for that "move".

Refer to 5.7 Display Position Dictionary Board for the 【Position Dictionary】.

(6) Error when generating Branch GR

When selecting "move"s in the 【Comment Board】 or adding "move"s in the 【GR Edit Board】, the "move"s may not match the "current position".
And the "black move" and "white move" does not line up in order alternately ,and so on ,in that case, an error occurs and the Branch GR is not generated.
In case of an error, the "position" where the error of the "move" is recognized is displayed in red on the 【GR Edit Board】, and the error content is displayed in an error message.

【Error display of 【GR Edit Board】


(7) Multiple Branch GRs at the same branch point

If multiple changing procedures occur in one "position", multiple Branch GRs will hang at the same branch point.
When the branch point is clicked with the mouse in the 【Move List】 to be moved the "position" to a lower-level Branch GR, a selection process will be required for how to move to the which Branch GR's "position" .

【Branch GR Selection Popup Menu】


When you select a Branch GR from the 【Branch GR Selection Popup Menu】, the "position" moves to the beginning of the Branch GR.
The menu title in the above is displayed the "move" and the number which is the beginning of the Branch GR. However, even in such a case, if the player directly selects a Branch GR in the 【GR Tree】, it is possible to directly move the "position" to the Branch GR.

(8) Delete Branch GR

Explain the operation when you want to delete the Branch GR that seems unnecessary.
Select the Branch GR to be deleted in 【GR Tree】, and click the right mouse button to display 【GR Tree Popup Menu】.
A confirmation message is displayed when 【Delete】 is selected.
If you select 【Yes】 for the message, the Branch GR is deleted.

【GR Tree Popup Menu】


If there is a branch point in the middle of the Branch GR to be deleted and the Branch GR hanging below it, that Branch GR is also deleted.

(9) Cancel "move"

You can cancel the most recent operation on a piece while in "Research Mode".
It is the last operation that can be canceled, that is, the final "move" (the last "move" in the GR), and it cannot be canceled after returning to any "position".
In addition, the "move" of the Branch GR can be canceled, but the "move" of the Root GR cannot be canceled.
Operations on the Root GR are performed by "Edit Mode". Click the right mouse button on 【Shogi Board Window】 to display 【Shogi Board Popup Menu】.
Select 【Cancel】 on the popup menu. The most recent "move" is deleted.

(10) Changing the Branch GR to Root GR

From the root of tree to the designated Branch GR can be used as the Root GR.
From the middle (branch point) of the original Root GR,it becomes a form in which it hangs from the new Root GR as a Branch GR.
Select the Branch GR to be made into the Root GR in 【GR Tree】, and then click the right mouse button to display 【GR Tree Popup Menu】.
If you select 【Make GR Root】, the selected Branch GR becomes the Root GR.
It cannot be canceled.
However, if the original Root GR that has become the Branch GR is selected and the changeing to Root GR operation is performed, the original is restored again.

(11) Remove duplicate "move"s at multipule Branch GRs

Multiple GRs from the same branch point may exsist and thare is a case that those GRs includes the same "move"s until halfway.
This function is to reconstruct a new tree structure by removing duplicated parts.

	Ex.) Two Branch GRs from the Root GR are branched at the 95th "move". 
	    When there are two Branch GRs and each is a "move" as follows.

            96        97         98       99     100
        Branch GR 1▲S57 △N×57+ ▲K97 △P65 ▲N56
        Branch GR 2▲S57 △N×57+ ▲R84            
        --------------------
        (Overlapping part)
        Execute 【Remove Duplicate Moves】
            96        97         98       99     100
        Branch GR 1▲S57 △N×57+ ▲K97 △P65 ▲N56  
        Branch GR 2        ▲R84                    	

	     The Branch GR 1 has a structure in which it branches from the Root GR at the 95th "move", 
	     and the Branch GR 2 branches in from the Root GR at the 97th "move".
	

To organize the GRs, click the 【GR Tree】 right mouse button to display the 【GR Tree Popup Menu】.
In this case, it is not necessary to select the Branch GR.
The operation is executed when 【Remove Duplicate Moves】 is selected.
After this operation you can't undo the GRs.

3.3 Editing the GR

Can be create new GRs, add, delete, or change existing GRs by manipulating pieces.
Also can be create or change 【GR Information】 (or 【Tsume Shogi Information】).
You can to edit the GR, switch the "Operation Mode" to the "Edit Mode".
When "Edit" of 【Edit (E) Menu】 is selected, "Operation Mode" is switched to "Edit Mode".

At that time, an icon indicating "Edit Mode" is displayed on the 【GR Selection Tab】.

【GR Selection Tab Icon】


(1) Editing GRs by moving and dropping pieces

The method of moving the piece in "Operation Mode" is "Edit Mode" is the same as when "Operation Mode" is "Research Mode" or "Watching Mode".
In "Research Mode" or "Watching Mode", when a piece is moved, a Branch GR is generated according to it, but "Edit Mode" does not create a Branch GR.

Addition of "move"s

If you move the piece in the final "position" of the GR, the move will be added to the GR.
After that, when the piece is moved, if the "move" are in the Root GR, it is added as the Root GR, and if it is in the Branch GR, it is sequentially added to the Branch GR.
If you move or drop a piece in a "position" in the middle of GR, all "move"s after that postion will be deleted from the GR (a confirmation message will be displayed before the deletion) and the "move" generated by moving or dropping a piece will be added as the final "move".

Change of GR

It is not possible to directly change the "move" of the GR.
This is because if you change your "move" in the middle, you will not be able to maintain consistency as a GR.

(2) Game Over Reason setting

【Game Over Reason】 is information indicating the reason that the game has ended and includes the following.
"Resign"/"Suspend"/"Repetition_of_Moves"/"Drawn_game"/"Time_over"/"Foul_lose"/"Foul_win"/"Win"/"Checkmate"/"Draw"/"Sealed move"
In GR editing, this final information is set at the end of the GR.

Setting is done in the 【Set Game Over Reason Dialog】.
Select 【Set Game Over Reason】 from the 【Edit (E) Menu】.
【Set Game Over Reason Dialog】 is displayed.

【Set Game Over Reason】


Click the 【▼ Button】 of 【Set Game Over Reason Combo】 with the mouse to display a list of 【Game Over Reason】.
Select the 【Game Over Reason】 from the list and click the 【OK Button】 to add the 【Game Over Reason】 character string to the end of the GR.

(3) Editing operation in the 【Move List】

The GR editing instructions in the 【Move List】 are partial copy of the GR, deletion of the "move", and setting and changing the consumption time.

Delete the "move"

Select the "move" to be deleted in 【Move List】.
The "move"s after this "move" is deleted.
Click the right mouse button in 【Move List】 to display the 【Move List Popup Menu】.
Select 【Delete】.
If you select 【Yes】 to the confirmation message, the deletion will be executed.

【Move List】


Partial copy of GR

Copy the selected "move"s to the clipboard.
However, the "position" of selection start position is also copied to clipboard.
The GR with "move"s which are from the selection start position until the selection end position is generated and copied to the clipboard.
The generated GR can be pasted to a 【Shogi Board】 and it can be referenced.

Select the range of the "move"s to be copied in 【Move List】.
Next, click the right mouse button in 【Move List】 to display 【Move List Popup Menu】.
Select 【Copy】.

Edit consumption time

You can edit and set the consumption time for each "move" for the Root GR.
It is not possible to edit the consumption time in the Branch GR.
The 【T】 column of the 【Move List】 shows the consumption time for each "move".

          The display format is as follows.

            <minutes>:<seconds>
                    <minutes> are hourly minutes (0-)
                    <second> is the time unit second (00-59)
	

Double-click the 【T】 column of the "move", then it is possible to to enter <minutes> and <seconds>.

【Move List ― Consumption time editing】


The input format of the consumption time is the same as the display format.
If the input format is incorrect, the input is simply ignored.

In the case of the GR such as the consumption time of all "move"s is 0, it can be hidden the 【T】 column.
Right-click the 【Title】 field of the 【Move List】.
【Display Column Selection Menu】 is displayed.
【Display Column Selection Menu】


Therefore, if you select 【Hide Consumption Time】, the 【T】 column will not be displayed.

To display the 【T】 column again, right-click the 【Title】 field of the 【Move List】 and display the 【Display Column Selection Menu】.
You select 【Display Consumption Time】, the 【T】 column will be displayed.

【Display Column Selection Menu】


If you want to edit the consumption time, display the 【T】 column if it is not displayed and then edit it.

When the 【Game Information Dialog】 is displayed, the total consumption time is displayed black and white.
The total consumption time is sum up consumption time of each "move".
(In the case of a GR format is KIF , the each "move" keeps the total time to it's "move" , so that if you edit the consumption time of a "move", The total consumption time is changed in all "move"s from that "move" to the end. )
T The 【Game Information Dialog】is displayed by selecting 【Display Information Board】 from the 【Operation (O) Menu】.

【Game Information Dialog】


(4) Editing game information and Tsume Shogi information

Game information is information other than the "move" related to the game.
This information can be set and changed in the 【Set Game Information Dialog】.
This dialog is displayed when you select 【Set Game Information Dialog】 in 【Edit (E) Menu】.

【Set Game Information Dialog】


Change the settings of each item above and click the 【Exec Button】 to change the game information.
The input method of each item will be described below.

Title Mainly specify the game title name.
Enter directly in the title input field from the keyboard.
If you have created a database, 【List Button】 is displayed.
If you click this button, a list of titles which will be registered in the database so far is displayed, you can select that and enter.
The number of characters that can be entered is not particularly limited, but when registering in the database Maximum 120 characters.
If it exceeds that, an error will occur and registration will not be possible.
Event Mainly specify the event name.
The input method is the same as the Title.
As for the event name displayed by clicking the 【List Button】 , when a title is selected, a list of event names belonging to the title where the title is selected is displayed.
If the event is not set, all event names registered in the database are displayed.
Start Date Specify the start date of the game.
Enter it as <Month 1-2 digits>/<Day 1-2 digits></<Year 4 digit year>.
Click the start date input field with the left mouse button.
The date input spinner is displayed.
The method of inputting using it will be described.
Date Spinner
The date spinner is displayed the start date of an existing GR or the current date inteh case of a new GR.
To change the year of the displayed date, click the 4 digit of the year with the mouse and move the input cursor to the 4 digit of the year (any position is acceptable).
Next, if you want to move backward the year, click the 【▽ Button】 of the spinner with the mouse. If you want to move forward,click the 【△ Button】 on the spinner.
The month and day settings can be operated in exactly the same way as in the year.
To cancel the input, click the left mouse button on the spinner.
The spinner disappears and the original settings are displayed in the normal input field.
When registering a GR in the database, the start date must be specified.
Start Time Specify the start time of the game.
Enter as <hour 1 to 2 digits>/<minute 1 to 2 digits>/<second 1 to 2 digits>.
The input method using the spinner is the same operation as the start date.
When registering a GR in the database, the start time must be specified.
End Date Specify the end date of the game.
The input method is the same as the start date.
End Time Specify the end time of the game.
The input method is the same operation as the start time.
Black Specify the player name of the "black turn".
If the database is set, you can enter the name by the autocomplete function.
When one or several characters are input, the corresponding name in the database is searched and the list is displayed.
You can select and enter from the list.
player designation
Note that this designation is indispensable when registering in the database.
There is no particular limit to the number of characters that can be entered, but when registering in the database, the maximum is 80 characters.
If it exceeds that,an error will occur and registration will not be possible.
White Specify the player name of the "white turn".
The input method is the same as the black.
Note that this designation is indispensable when registering in the database.
Place Specify the place of the game.
There is no particular limit to the number of characters that can be entered, but when registering in the database, the maximum is 80 characters.
If it exceeds that,an error will occur and registration will not be possible.
Handicap Select from the combo box of the handicap list and enter.
If there is no corresponding discount in the handicap list, enter it directly in the field of the combo box.
In that case, there is no particular limit to the number of characters that can be entered, but when registering in the database, maximum 20 characters.
If it exceeds that,an error will occur and registration will not be possible.
Opening Specify the battle type.
If you have created a database, 【List Button】 is displayed.
If you click this button, a list of the opening titles which will be registered in the database so far is displayed, you can select that and enter.
The number of characters that can be entered is not particularly limited, but registered in the database If you want to use up to 80 characters.
If it exceeds that, an error will occur and registration will not be possible.
Black Rating Specify the rating of the "black turn".
Specify a numerical value.
White Rating Specify the rating of the "white turn".
Specify a numerical value.
Time Condition Specify the playing time condition of the game.
The format of the specified character string is arbitrary.
There is no particular limit to the number of characters that can be entered, but when registering in the database, maximum 80 characters.
If it exceeds that, an error will occur and registration will not be possible.


In this program, you can edit not only GR but also Tsume Shogi GR.
The editing operation of the "move" is basically the same as the GR, and the information other than the "move" (Tsume Shogi GR Information) is different from the GR.
Therefore,in the case of you try to change the setting of Tsume Shogi Information, edit operation is performed in the 【Set Tsume Shogi Information Dialog】 which is different from the 【Set Game Information Dialog】.
Please refer to 3.4 Editing "position"s for an explanation of how to set the initial arrangement of Tsume Shogi.

To edit Tsume Shogi Information, select 【Set Tsume Shogi Information】 in the 【Edit (E) Menu】. 【Set Tsume Shogi Information Dialog】 is displayed.

【Set Tsume Shogi Information Dialog】


If you change the settings of each item above and click the 【Exec Button】, the Tsume Shogi Information will be changed.
The input method of each item will be described below.

Title Specify the title of Tsume Shogi.
Enter directly in the title input field from the keyboard.
There is no particular limit to the number of characters that can be entered, but when registering in the database, the maximum is 120 characters.
If it exceeds that, an error will occur and registration will not be possible.
In addition, in the case of Tsume Shogi, the title specified here is displayed as the title of the 【GR Selection Tab】.
Work Name Specify the Work name of Shogi Tsume.
Enter directly from the keyboard in the work name input field.
There is no particular limit to the number of characters that can be entered, but when registering in the database, the maximum is 120 characters.
If it exceeds that, an error will occur and registration will not be possible.
Announcement Date Specify the date of announcement of this Tsume Shogi.
The specification method and input method are the same as the input of the Start date in the GR Information setting.
Author Specifies the Author of this Tsume Shogi.
If the database is set, you can enter the name using the auto-complete function (see the black item when changing the GR information settings).
There is no particular limit to the number of characters that can be entered, but when registering in the database, the maximum is 80 characters (full-width).
If it exceeds that ,an error occurs and registration will not be possible.
Post Specify the name of the announcement medium for this Tsume Shogi.
If you have created a database, 【List Button】 is displayed.
Click this button to register in the database so far A list of publications is displayed, and you can select and enter it.
The number of characters that can be entered is not particularly limited, but when registering in the database Up to 80 characters when registering in the database.
If it exceeds that, an error will occur and registration will not be possible.
Category There is no particular decision as to what to specify, but the classification of this Tsume Shogi is mainly specified.
There is no particular limit to the number of characters that can be entered, but when registering in the database, maximum 80 characters.
If it exceeds that, an error will occur and registration will not be possible.

(5) Creating a new GR

To create a new GR, select 【New】 from the 【Edit (E) Menu】.
The dialog for selecting the initial piece arrangemnt is displayed first.

【Initial Piece Arrangement Setting Dialog】


Here, select the initial piece arrangement of the newly GR.
In the case of the piece arrangement of Non Handicap, click the 【OK Button】 as it is.
In the case of handicap, select the handicap type from the 【Initial Piece Arrangemnt Combo】 and then click the 【OK Button】.
To cancel the new creation, click the 【Cancel button】.
The initial piece arrangement that can be specified are "Non Handicap"/"Lance drops"/"Right Lance drops"/"Bishop drops"/"Rook drops"/"Rook & Lance drops"/"Two pieces drops"/"Four pieces drops"/"Six pieces drops"/"Eight pieces drops"/"Ten pieces drops".
When you select the initial piece arrangement and click the 【OK Button】, the pieces are displayed on the【Shogi Board】 with the selected initial layout, and the "Operation Mode" is set to "Edit Mode".

【New】


【Shogi Board Window】, 【Shogi Board Right Window】,【Comment Board】in the【Shogi Board Lower Window】 is newly created for new creation, "New" string is displayed in the 【GR Selection Tab】.
This is changed to "<Black player name>-<White player name>" by entering values ​​for the black and white in the 【Set GR Information Dialog】.
After that, the editing operation is performed according to the contents.

(6) Edit comment

The comment for the starting "position" and each "move"s of the GR can be set in the 【Comment Board】.
The editing operation of the 【Comment Board】 is the same as the operation in a normal text editor, and the following basic operations can be performed.

Copy:Copy the character string in the specified range to the clipboard
Cut:Cut a character string in the specified range and copy it to the clip board
Paste:Insert the contents of the clipboard at the cursor position or
replace with the character string in the selected range.
Undo:Cancel the previous operation and undo.
Redo:Re-execute the operation canceled by the undo operation.

Click the right mouse button in 【Comment Board】 to display 【Comment Board Popup Menu】 and select and execute these operations.

【Comment Board Popup Menu】


When the "Operation Mode" is "Research Mode" or "Watching Mode", the "move"s and html links (url) inserted by editing are extracted in blue and underlined (selection display).
If click the extracted "move"s ,create a Branch GR, and if click the html link ,start the browser and display the contents.
When the "Operation Mode" is "Edit Mode", no extraction is performed and the display is as it is.
If you switch to "Research Mode", the selection display (in blue and underlined)will be restored again.

When a comment is set,'*' is displayed in the 【C】 column of 【Move List】.

About displaying at the 【Comment Board】

If you select 【Font】 in the 【Comment Board Popup Menu】, the 【Font Dialog】 will be displayed and you can set fonts.

The 【Font Dialog】 allows you to specify the typeface, style, and size (points).

【Font Dialog】


When 【Window display】 is selected in 【Comment Board Popup Menu】, 【Comment Board】 can be displayed as an external window instead of 【Shogi Board Lower Window】.
If you close this external window, you will be returned to the original 【Comment Board】 of 【Shogi Board Lower Window】.

3.4 Editing a "position"

"position" editing is for setting the arrangement of pieces.
Place the pieces by operating the pieces with the mouse.
This allows one "position" to be freely edited or generated.
Mainly used for creating and editing Tsume Shogi.
Select 【Edit Position】 from the 【Edit (E) Menu】.
The "Operation Mode" becomes the "Position Edit Mode".
When the "Operation Mode" is switched to the "Position Edit Mode", a new 【Shogi Board Window】 is created and the "position" can be edited.

An icon indicating that the "Operation Mode" is the "Position Edit Mode" is displayed on the 【GR Selection Tab】.

【Position Edit Mode Icon】


(1) How to move pieces

There are no restrictions on how you can move the pieces, and you are free.
You can also move from Komadai to Komadai.
However, when placing another piece at the postion of the already placed piece, You cannot place a piece there unless you move the piece you have already placed and create an empty space.
The Black and white of the piece and the back (promoted) can be specified by cyclically changing the piece placed on the {Shogi Board】 by clicking the right button of the mouse.

->(click) ->->(click) ->->(click) ->->(click)->first state

Since "Gold" and "King" are not true, clicking the right mouse button will repeat the reverse sequence.

You can use both <Drag method> and <Selection method> for moving pieces in the same way as in the Research mode. ((1) Refer to Moving operation during Reserach Mode)


Move to piece box

A move to the piece box (the area surrounded by the white frame on the lower left of the 【Shogi Board】) that was not in the Research Mode or the Edit mode is newly added as the move destination of the piece.
When creating an arbitrary "position" of dropped pieces, it is necessary to move the dropped pieces to the piece box.
On the contrary, you can freely move from the piece box to the piece stand or the board.


(2) Generation of "position"s to be edited

A method of generating a "position" to be edited will be described.

Edit any "position" of existing GR

If you want to edit any "position" of the existing GR, switch to the "position" editing at that the "position".
The arrangement of pieces for that "position" is displayed as is in the newly assigned 【Shogi Board Window】.

【"Position" of existing GR】
Screen for editing existing game

Switch the "Operation Mode" to "Position Edit Mode" to edit the above "position".

【"Position" editing screen】
Aspect edit screen

【Shogi Board Window】 is newly added and the existing "position" is copied and displayed as it is.
In the 【GR Selection Tab】, "Position" is displayed at the same time as the 【Position Edit Mode Icon】.
The 【Shogi Board Right Window】 and 【Shogi Board Lower Window】 remain as they are, but their contents are erased and disappeared.
Hereinafter, edited with respect to this arrangement by operation the pieces.

Edit existing "position"

When editing an existing postion, display that "position" in the 【Shogi Board Window】 and switch to "position" editing there.
In this case, the 【Shogi Board Window】 is not newly allocated, and the editing operation can be started as it is on the 【Shogi Board Window】 of the "position".

【Existing "position"】
Screen of existing position

Switch the "Operation Mode" to "Position Edit Mode" to edit the above "position".



"Operation Mode" is switched to "Position Edit Mode", and the icon indicating the "Position Edit Mode" is displayed on the game selection tab.
Others remain unchanged.
Hereinafter, edited with respect to this arrangement by operation the pieces.

Initial piece arrangement specification

At editing the "position", you can set the piece arrangement to the starting "position" of the game or Initial piece arrangement of the Tsume Shogi.
In "Position Edit Mode", move the mouse cursor to 【Shogi Board Window】 and click the right button.
The 【Position Operation Popup Menu】 is displayed.
【Position Operation Popup menu】


If you select 【Initial Piece Arrangement Setting】 here, the 【Initial Piece Arrangement Placement Selection Popup Menu】 will be displayed, and you can select the start "position" of Non-handicap or drop of pieces.

【Initial Piece Arrangement Placement Selection Popup Menu】


The initial piece arrangement selected here is displayed on the board.

If you select 【Tsume Shogi Initial Piece Arrangement】, it will be the initial piece arrangement of Tsume Shogi.

The initial piece arrangement of Tsume Shogi is the arrangement in which the white King is located at 11, the black King is located at the 【Piece Box】, and the other pieces are located at the 【Black Piece Stand】 or 【White Piece Stand】.

【Tsume Shogi Initial Piece Arrangement】
Initial arrangement of Tsume Shogi pieces

Hereafter, edit by operating pieces for this arrangement.
In addition, setting the piece arrangement of Tsume Shogi may be more efficient after moving all the pieces of the 【Black Piece Stand】 to the 【White Piece Stand】.
In this case, Click 【Go To White Piece Stand】 of the 【Initial Piece Arrangement Placement Selection Popup Menu】.
All of the pieces on the 【Black Piece Stand】 move to the 【White Piece Stand】.

(3) Setting "position" start information

The 【Start Move Number】 refers to the "turn" and the number of "move" at the "position" of next to this "position" currently being edited.
After finishing the "position" editing, the "Operation Mode" is in the "Research Mode" or the "Position Edit Mode" When a "move" is added from this "position", it becomes the number of "move" of the first "move".
The default number of "move" is 1.
A method of designating the phase start procedure and the procedure will be described.
Select 【Set Position Start Information】 from 【Position Operation Pop-up Menu】.
The 【Position Start Information Setting Dialog】 is displayed.

【Position Start Information Setting Dialog】


Here, specify the numerical value for the start "move" number in the 【Start Move Number Input Field】.
Select either the "black move" or the "white move" and click the 【OK Button】 to set the "position" start information.

(4) End of "position" editing

To end the "position" edit, select 【Quit Editting Position】 from the 【Position Operation Popup Menu】 or select 【Quit Editting Position】 from the 【Edit (E) Menu】.
The "Position" editing is completed and the "Operation mode" is switched to the "Research Mode".
In the 【GR Tree】, the title of the root that was displayed as "Root" in the case of game is displayed as "Position".
Also, in the 【Move List】, "Position" is displayed at the starting "position".

【Screen immediately after quit editting "position"】


(5) Other information settings for the "position"

In "position" editing, you can set the piece arrangement and the start "move" number, but set other information after the "position" editing is completed.
If this "position" is the "position" of the GR, display 【Set Game Information Dialog】 and each item is set.
If it is Tsume Shogi, set each item in 【Set Tsume Shogi Information Dialog】.
To set the start comment for a "position", enter the comment directly in the 【Comment Board】.

4. Saving GRs and format of GR


This program allows you to save the imported GR as a text file.
It can also be registered in a database and saved.
Here, saving in a file will be described.
For registration in the database, refer to 5.2 Registration in database.

 4.1 Save operation to file
 4.2 GR format and file extension when saved
 4.3 Options when saving
 4.4 Import to clipboard

4.1 Save operation to file

To save the GR that is currently displayed in a file, select 【Save As】 from the 【File (F) Menu】.
【Save File Dialog】 is displayed.

【Save File Dialog】


Select the save destination folder in the 【Save Window】.
Next, enter the file name and click the 【Save Button】 with the mouse to save the GR.
It is not necessary to specify the file name extension.
It is automatically added according to the setting of the output format of the GR.

To read the GR file, edit it, and reflect the changes in the GR file, select 【Save】 from the 【File (F) Menu】.
The changes are reflected in the original GR file.

4.2 GR format and file extension when saved

Which GR format to save the GR fromat can be specified by setting.
Select 【Preferences】 from 【Preferences (P) Menu】, 【Preferences Dialog】 will be displayed.

Select the format in 【GR Format】 of 【GR Output】 (KIF/KI2/CSA/GRE), and click 【OK button】.
It is saved in the GR file in the format set here, and the extension of the GR file at that time is automatically added as follows for each format.

GR format file extension

KIF format"kif"
KI2 format"ki2"
CSA format"csa"
GRE format"gre"

	

When saving, if an extension is also specified for the file name, if the extension is the same as the setting value, the extension will not be added automatically.

From V3.0, when the GR is saved, the score and the thinking process outputed by the shogi engine, if any, are output as a comment.
In SBrowserQ, when this GR is read, the comment is displayed in the comment field, and the score and the thinking process are displayed on the 【Engine Monitor】.
Since the format is peculiar to SBrowserQ, when this GR is read by another program, the score and the thinking process are displayed as comments.

4.3 Options when saving

Specify whether or not to save Branch GRs

If there is an Branch GR along with the Root GR, it will be saved in the GR file together.
Other game software can't read in the GR file that contains both the Root GR and the Branch GR,becouse it's format is not compatible with other game software.
Therefore, when saving the GR, it is possible to specify that only the Root GR is saved and the Branch GR is not saved.

In 【Prefereces Dialog】, if you clear the check box for 【with Branch GR】 of 【GR Output】, only the Root GR will be saved.
If you want to process with this program only, you should always check 【with Branch GR】 and save the Branch GR.
If you import the GR file, the Root GR and the Branch GR will be displayed on the 【Shogi Board】 as before saving.

Specify whether to save comments

Comments can be set in the GR.
In many cases comments are useful and should not be ruled out too much, but for some reason you want to save disk space, etc.
You may want to remove the comment.
In that case, if you uncheck 【with Comment】 of 【GR Output】 in 【Prefereces Dialog】, comments are removed from the GR and are not saved.

Specify whether or not to save the score and the thinking process

The score and the thinking process that are output when playing a game with the shogi engine are output as comments in the GR.
If you do not want to output to the GR, uncheck the check box of 【with Thinking Porcess】 of 【GR Output】 in 【Preferces Dialog】, the score and the thinking process that are output as comments when saving a GR are removed from the GR and are not saved.

Specify whether to save GR analysis information

The result of the GR analysis is output as a comment in the GR.
In 【Prefreces Dialog】, clear the check box for 【with Analysis GR】 in 【GR Output】.
When saving a GR, the GR analysis information is removed from the GR and is not saved.

4.4 Import to clipboard

The operation of copying the GR to the clipboard can be considered as a kind of saving operation.
In that case, all the options that can be specified by saving the file, that is, the specification of the GR format, the setting of the existence of the Branch GR, the setting of the existence of the comment is also all effective.
(【Shogi Board Popup Menu】's 【Copy GR】 or 【Copy Position】 operation)
The difference between 【Copy GR】 and 【Copy Position】 is that 【Copy GR】 copies all the GRs to the clipboard, whereas 【Copy Position】 the "position" is copied to the clipboard.
Therefore, there is no information on "move"s.
The piece arrangement of the "position" and the GR information or Tsume Shogi information are copied.

5. Database storage and retrieval


In this program, the imported GRs can be saved in a database and retrieved by various searches.
The method of operating the database will be described.

 5.1 Create database
 5.2 Registering in database
   (1) Registration operation
   (2) Duplicate check
   (3) Required items
   (4) Batch registration of GR files
   (5) Batch registration of database from ZIP file
   (6) Batch download of ShogiClub 24 GRs and registering in database
 5.3 Database search
   (1) GR search
   (2) Search Result List
   (3) Operations on the Search Result List
   (4) Search Result List and page
   (5) Sort Search Result List
   (6) Customize database items
   (7) Win rate display
   (8) Search Result List display operation
 5.4 Text search for comments
 5.5 "Position" search
   (1) "Position" search
   (2) Partial search
   (3) Similar search
   (4) Combination of each search
 5.6 Excel output processing
   (1) Setting
   (2) Execution
   (3) Customization of aggregation file
 5.7 "Position" Dictionary display
 5.8 Update of GR
   (1) Update operation
   (2) Update target database
 5.9 Batch processing of database
   (1) Batch GR analysis
   (2) Batch Auto Playback
 5.10 Database maintenance
   (1) Database update
   (2) Database release
   (3) Import database
   (4) Database backup

5.1 Creating database

In order to use the database, it is necessary to create a new database.
The operation will be described.
First, select 【DataBase】 from the 【Extensions (X) Menu】 to display the 【DataBase List Dialog】.

【Database List Dialog】


Next, click the 【New Button】 on this screen.
The 【Create New DataBase Dialog】 is displayed.

【Create New DataBase Dialog】


Will be explained each item how to specify below.

DataBase Title Title name that identifies the database.
The title specified here is displayed in 【Database Selection Combo】. There is no limit to the length of the character string to be specified, but it is desirable that all can be included in 【Database Selection Combo】. (8 characters)
File Creation folder When a database is created, one file is created.
Specify the folder to store the file.
Click the 【Folder Button】 to display the 【Folder Selection Dialog】.
If you select a folder there, the path name is set in this input field.
DataBase NameSpecify the name of the database.
One file with the name specified here will be created in the specified folder.
The file extension is "h2".
Tsume Shogi Style Specify the database type.
Specify the database is for storing game GRs or is for storing Tsume Shogi GRs.
Check this check box if the database stores Tsume Shogi.
In the case of a database that saves game GRs, do not check.
This specification is necessary because the game database and Tsume Shogi database differ in the items to be saved and the method of checking duplicates during registration.
Number of lines per page Specify the number of lines per page of the 【Search Result List】.
This is a variable for limiting the number of records that are retrieved at one time.
The range that can be specified is 50-2000.
The default is 100. (5.3(4) Search Result List and page) Reference

Duplicate Registration Impossible Specifies whether the same GR cannot be registered in the database.
If you check it, you cannot register the same GR.
If you do not check it, you can register the same GR.
Refer to 5.2 (2) Duplicate check.


If you specify the above items and click the 【Create Button】, one file with the character string specified in 【DataBase Name】 will be created in 【File Creation folder】, and the creation of the database will be completed.
The 【DataBase List Dialog】 displays the contents of the created database (DataBase Title, File Creation Folder, DataBase Name, Tsume Shogi Style, Number of lines per page).
After that, all functions related to the database will be available.

Multiple databases

You can create as many databases as you like.
When creating multiple databases, specify the database titles so that they do not overlap.

The advantage of creating multiple databases is that you can customize the display items of search results for each database.
You can set display/non-display or display order of items for each database. (See 5.3 (6) Customizing database items)
Search is done on an individual database basis. You cannot search across databases.
When multiple databases were created, before searching or registering, it's necessary to select the target database with 【DataBase Selection Combo】

The selected database is called the "current database".

About the display order of 【DataBase Selection Combo】

The display order of 【DataBase List Dialog】 is the same as that of 【DataBase Selection Combo】.
The display order can be changed in the 【DataBase List Dialog】.
Select the database whose display order you want to change with the left mouse button and drag it to the position you want to display When you move or release the left mouse button, the display position is replaced.

5.2 Registering in database

(1) Registration operation

To save the imported GR in the database, select 【Add DB】 from the 【File (F) Menu】.
The GR on the Current Shogi Board (the GR selected in the 【GR Selection Tab】) is registered to the "current database".

(2) Duplicate check

Perform a check during registration so that the same GR is not duplicated in the database.
In the case of game GR, if the Start Date, the Start Time, the Black Player, the White Player, and the Move Count are the same, the GR is judged to be the same GR and a duplicate error occurs.
In the case of Tsume Shogi GR a duplicate error will occur if the same start "position" (including holding pieces) is already registered.
However, if duplicate registration is permitted due to database settings, no error will occur and registration will be performed as is.
The setting method will be described below.

Select 【DataBase】 from 【Extensions(X) Menu】 to display 【Database List Dialog】.
On this screen, select the database to be changed and click the 【Update Button】.
【Update DataBase Settings Dialog】 is displayed

【Update DataBase Settings Dialog】


If you uncheck 【Duplicate Registration Impossible】 on this screen and click the 【Update Button】, duplicate checking will not be performed for that database at registration.
If checked in reverse, duplicate check is performed.
If a new database is created ,duplicate check is set at right after that .

(3) Required items

When registering a game GR, as described in 3.3 (4) Editing game information and Tsume Shogi information, the Start Date, Start Time, The black and the white are mandatory.
If this information is not set, you cannot register.
If you perform the registration operation while there are unset items, Set Game Information Dialog will be displayed and you will be prompted to enter the unset items.
Specify all unset items and click the 【Register Button】 (changed from 【Exec Button】 to 【Register Button】) to register in the database.

(4) Batch registration of GR files

It is possible to register all the GR files existing under the specified folder in the database at once.
There are more folders under the folder, if a GR file exists there, all the GR files are also registered.
In this process, files with extensions other than kif/ki2/csa/gre/txt are not considered as GR files and are not registered.

Select 【File TO DB (Batch Registration)】 in 【File (F) Menu】.
The 【Batch Import of GR files Dialog】 is displayed.

【Batch Import of GR files Dialog】


Specify the folder (path name) where the GR to be imported is stored in the 【GR Folder】 input field.
Click the 【Folder Button】 to display the folder selection dialog.
Select a folder there.
The pathname of the selected folder is set in the 【GR Folder】 input field.

If you want to shorten the processing time during registration, select 【High-Speed Processing Mode】 in 【Database registration Processing Option】.
If there are about 1000 cases, use 【Normal Processing Mode】 sufficient, but if there are more than 10000 cases, it is faster to execute in 【High-speed processing mode】.
However, if any abnormality occurs in the 【High-Speed Processing Mode】 and it is interrupted, the entire database may not be accessible.
If you have a small number of records, it is better to select 【Normal Processing Mode】 and execute registration because the GRs that have already been registered before batch registration may become unreadable.

Click the 【Exec Button】 at the end to start batch registration in the "current database".
If an error occurs during processing, the following error message will be displayed.

【Batch Registration Error Message】


The sample screen is an error message when a duplicate error occurs.
If you click the 【Continue Button】, the registration of the GR that caused the error will be canceled and the next GR registration process will continue.
If you click the 【Continue (Continue(no further confirmation) Button】, the meaning is the same as the 【Continue Button】, but if the same error (duplicate error in the case of the sample) occurs after that, The confirmation message is not displayed and the process continues to the end.
When you click the 【Cancel Button】, the batch registration process is canceled and the process ends.
When in addition to duplication error, a GR error occurs (format error when there is an error in the GR format, or when required items are not set), the same error message is displayed.
When an error occurs, the operation of selecting 【Continue (no further confirmation) Button】does not mean skipping confirmation about the other error too, it is an operation to skip the confirmation only to that error.

(5) Batch registration of database from ZIP file

You can extract the GRs archived in the ZIP file and register them in the "current database" at once.
Select 【ZIP file TO DB (Batch Registration)】 of 【File (F) Menu】.
【Import from ZIP file Dialog】 is displayed.

【Import from ZIP file Dialog】


Specify the path name of the ZIP file to be imported in the 【ZIP File】 input field.
Click the 【File Button】 to display the file selection dialog.
If you select a ZIP file, its path name will be set in the 【ZIP File】 input field.
【DataBase Registration Processing Option】 is the same as the case of batch importing GR files.
Also, when an error specific to a GR occurs in the middle, the handling is the same as in the case of batch importing GR files.

(6) Batch download of ShogiClub 24 GRs and registering in database

You can collectively download your GR (Tokyo Dojo) at ShogiClub 24 and register it in the "current database".
In ShogiClub 24, you can download it by incorporating DownThemAll! in the FireFox browser only.
It is a little troublesome because it is limited to FireFox browser and the operation to register the downloaded GR file in the database after that occurs.
With this program, you can execute download to database registration with just one touch.

Select 【Download Shogi24 GRs】 in 【File (F) Menu】.
【Download Shogi24 GRs Dialog】 is displayed.

【Download Shogi24 GRs Dialog】


User ID User name of the ShogiClub 24.
Specify your user name.
PasswordPassword for ShogiClub 24.
Specify the password for your user name.
Date from Specify the start range of the GR to be downloaded by date.
If this window is displayed, the date of the current day is set.
Date to Specify the end of the range of the GR to download by date.
If this window is displayed, the date of the current day is set.
Display the download list of the GR Specify whether to display the list of GRs in the specified range before downloading the GRs.
Display when checked.
Not displayed unless checked.

Set these contents and click the 【Exec Button】.
The download process starts.
The settings of 【User ID】, 【Password】, and 【Display the download list of the GR】 are saved even after the program ends, so it is not necessary to specify each time thereafter.
Especially, 【Password】 is encrypted and saved.
If 【Display the download list of the GR】 is checked, 【Shogi 24 Download GR List Dialog】 is displayed before downloading.

【Shogi 24 Download GR List Dialog】


You can check the GR to be downloaded from this list, and at the same time, you can choose whether to download it.
【Number of downloads】 indicates the number of GRs displayed in the download list.
All the checks in the 【Select】 column are initially displayed as checked (downloadable).
Uncheck any GRs you don't want to download here.
The “GR Title” is a title displayed on the browser when the Tokyo GR is downloaded in the ShogiClub 24.
If you click the 【Deselect All Button】, all the check boxes in the 【Select】 column will be unchecked.
At that time, the 【Deselect All Button】 changes to the 【Select All Button】.
If you click the 【Select All Button】, all 【Select】 columns will be checked.
At that time, the 【Select All Button】 changes to the 【Deselect All Button】.
Click the 【Exec Button】 to start downloading the checked game and register it in the "current database".
Click the 【Cancel Button】 to cancel the download process.

In the database registration process, handling of errors in individual GRs is the same as the previous batch registration process.

Since the download GR of ShogiClub 24 has a rating set as GR information, it will be reflected in the database as it is.
(When registering a GR by cutting and pasting individual GRs, there is no rating information, so registering in the database is a manual input operation.)

5.3 Database search

Search the "current database" and extract the target GR from the database.
There are two types of searches: a case of searching (GR search) from information on various items of a GR and a case of specifying a "position" (searching for a "position").
Search results are displayed as a list of GRs in 【Search Result List】.

(1) GR search

To search for a GR, select 【Search DB】 from the 【File (F) Menu】.
The 【Search Condition Input Dialog】 is displayed.

【Search Condition Input Dialog】


If you click the 【Search Button】 with the mouse without entering anything, all GRs in the "current database" will be searched.
【Search Result List】 displays a list of all the GRs in the "current database".
In order to narrow down the GRs displayed in the 【Search Result List】, specify the search condition for each item in the 【Search Condition Input Dialog】.
In the 【Search Result List】, the GRs that meet all the conditions specified in each item are displayed in a list.
If no condition is entered for an item, searching is not done to narrow down by that item .
The method of specifying each item will be described below.

Start Date fromSpecify the start date of the game.
Specify when searching for GRs played after this date.
The input operation is the same as the method of specifying the start date in the 【Set Game Information Dialog】.
Start Date toSpecify the start date of the game.
Specify when searching for GRs played before this date.
The input operation is the same as the method of specifying the start date in the 【Set Game Information Dailog】.
TitleSpecify the title.
Search for a GR that matches the title specified here.
Enter directly in the title input field from the keyboard.
Click the 【List Button】 to display a list of the titles registered so far in the database, and you can select and enter it.
You can specify'*' (Note 1) as the input character.
EventSpecify the event.
Search for a GR that matches the GR specified here.
Input directly from the keyboard in the game input field.
Click the 【List Button】 to display a list of the event matches that have been registered in the database so that you can select and enter them.
You can specify'*' (Note 1) as the input character.
PlayerSpecify the player name.
Search for a GR that matches the player name specified here.
The input operation is the same as the black in the 【Set Game Information Dialog】.
You can specify'*' (Note 1) as the input character.
TurnWhen the player name is specified, the player's "turn" (black/white) can be to specified.
A GR that matches the specified "turn" is searched.
If the player is not specified, only the "turn" cannot be specified.
Select "Unspecified" if you do not want to specify the narrowing down by "turn" item.
Win/LoseIf the player name is specified, the player's win/lose (Win/Lose/Draw) can be specified.
The GR that matches the win/lose specified here is searched.
If the player is not specified, only the win/loser cannot be specified.
If you do not want to specify the narrowing down by win/lose item, select "Unspecification".
OpponentIf the player name is specified, the opponent can be specified.
A GR that matches the opponent specified here is searched.
The input operation is the same as the white in the 【Set Game Information Dialog】.
if The player is not specified, only the opponent cannot be specified.
You can specify'*' (Note 1) as the input character.
Rating fromSpecify the rating.
Matches with either the black rating or the white rating higher than the rating specified here are searched.
Input is a numerical value.
Rating toSpecify the rating.
Matches with either the black rating or the white rating less than or equal to the rating specified here are searched.
Input is a numerical value.
OpenningSpecify the Openning.
A GR that matches the opening specified here is searched.
Click the 【List Button】 to display a list of openning that have been registered in the database so that you can select and enter them.
You can specify'*' (Note 1) as the input character.
Place Specify the the Place.
A GR that matches the place specified here are searched.
Click the 【List Button】 to display a list of Places that have been registered in the database so that you can select and enter them.
You can specify'*' (Note 1) as the input character.
GR CommentSpecify keyword string.
A GR that matches the keyword character string in the comment of GR is searched.

When you set the search conditions for each item and click the 【Search Button】 with the mouse, the search process starts and the results are displayed in the 【Search Result List】.
Clicking the 【Cancel Button】 cancels the search process and does not execute it.
Button】 deletes all the set search conditions 【Search Condition Input Dialog】 Each input field of is returned to the initial state.

Search Tsume Shogi GRs

If the "current database" is Tsume Shogi, the search items will change to those for Tsume Shogi.

【Search Condition Input Dialog】 for Tsume Shogi


If you click the 【Search Button】 with the mouse without entering anything, all items in the "current database" will be searched.
【Search Result List】 displays a list of all Tsume Shogi GRs in the "current database".

In order to narrow down the Tsume Shogi GRs displayed in the 【Search Result List】, specify the search conditions for each item in the 【Search Condition Input Dialog】 for Tsume Shogi】.
A list of Tsume Shogi GRs that meet the conditions specified in each item is displayed in the 【Search Result List】.
If no condition is entered for an item, the item is not narrowed down.
The method of specifying each item will be described below.

Announcement Date from Specify the date of announcement of Shogi Tsume.
Specify when searching for Tsume Shogi GRs published after this date.
The input operation is the same as the specification method from the start date of the search condition input of the GR.
Announcement Date to Specify the date of announcement of Tsume Shogi.
Specify when searching for Tsume Shogi GRs published before this date.
The input operation is the same as the specification method up to the start date of the search condition input of the GR.
TitleSpecify the title.
Search for Tsume Shogi GRs that match the title specified here.
Enter directly in the title input field from the keyboard.
You can specify'*' (Note 1) as the input character.
Work NameSpecify the work name.
Search for Tsume Shogi GRs that match the work name specified here.
Enter directly from the keyboard in the work name input field.
You can specify'*' (Note 1) as the input character.
AuthorSpecify the author.
Search for Tsume Shogi GRs that match the author specified here.
The input operation is the same as the method of specifying the player who inputs the search condition of the GRs.
You can specify'*' (Note 1) as the input character.
Category Specify the category.
The Tsume Shogi GRs that match the category specified here are searched.
Click the 【List Button】 to display a list of the categories registered so far in the database, and you can select and enter it.
You can specify'*' (Note 1) as the input character.
PostSpecify post.
The Tsume Shogi GRs that match the post specified here are searched.
Click the 【List Button】 to display a list of the publications registered so far in the database, and you can select and enter it.
You can specify'*' (Note 1) as the input character.
GR commentSpecify keyword string.
Tsume Shogi GRs that have a character string that matches the keyword character string in the comment are searched.

When you set the search conditions for each item and click the 【Search Button】 with the mouse, the search process starts and the results are displayed in the 【Search Result List】.
Clicking the 【Cancel Button】 cancels the search process and does not execute it.
Button】 deletes all the set search conditions 【Search Condition Input Dialog】 for Tsume Shogi Return the input field of to the initial state.

 (Note 1) A single'*' character is used as a special character that matches any character string.
   An example is shown below.

  As an example, we will show you how to search for the GRs of all A-class ranked games 
  by specifying the event name.

                【Specifed event name value】                   【Search Result】
   "71st Ranked Games A Class 1st Round"Only the GRs of the 1st round are extracted.
   "71st Ranked Games A Class *" All GRs of A class are extracted.(Use '*')
   "71st Ranked Games A class"There is no such event name, so there is no match GR.

  Furthermore, the case of a player is shown as an example.

   【Specified Player name value】                   【Player search results】
   "Yasumitsu*Sato*""YasumitsuSato", "Yasumitsu Sato", and "Yasumitsu Sato 9th Dan"
    are also extracted.
   "Yasumitsu Sato"Only "Yasumitsu Sato" is extracted.
   "Yasumitsu*Sato""YasumitsuSato" and "Yasumitsu Sato" are extracted.

  '*' When designating one character as a general character, describe it as two consecutive'**'.

(2) Search Result List

The search result of the "current database" is displayed in 【Search Result List】.
【Search Result List】 is displayed as a tab window in 【Shogi Board Lower Window】.

【Search Result List】


Explain each item on the Search Result List screen.



(3) Operations on the Search Result List

Selecting GRs

By selecting a GR from the 【Search Result List】 obtained by searching the "Current DataBbase", the GR can be displayed on the 【Shogi Board】.
When you double-click a line in the 【GR List】, the GR of that line is expanded on the 【Shogi Board】.
It will be displayed as like Screen 1 immediately after importing.
However, the 【Shogi Board Lower Window】 still displays the 【Search Results List】 tab window.

Delete GR from database

You can delete the GRs displayed in 【Search Result List】 from the database.
Select the game to be deleted in the 【GR List】 by clicking it with the mouse.
Multiple GRs can be selected by holding down the 【Shift】 key and clicking the mouse.
However, you cannot make selections that span pages.
Next, click the right mouse button on the 【GR List】 to display the 【GR List Operation Popup Menu】.

【GR List Operation Popup Menu】


When you select 【Delete】, a confirmation message is displayed, and when you select 【Exec】, the deletion process is executed.
The deleted GR disappears from 【GR List】.
Be careful when deleting because the GR once deleted cannot be restored.

If you delete the GR which is extracted from the database and is displayed on the【Shogi Board】from the database ,it's deleted from the database, but the GR display on 【Shogi Board】remains the same.
In this case, it is possible to newly register in the database again.

【Deselect】 in 【GR List Operation Popup Menu】 is to simply deselect.

(4) Search Result List and page

If the number of searches exceeds the 【Number of lines per page】, the 【Search Result List】 will be displayed on separate pages.
Use the 【Next Page Button】 and 【Previous Page Button】 to switch pages.
【Number of lines per page】 is the maximum number of lines per page and is set for each database.
The default value is 100.
If the number of searches is large, the system resources are required to read all of the result of search from the database and the load is increased to the system.
【Number of lines per page】 is for limiting the number of records to be read at one time by searching.

If you want to change 【Number of lines per page】, display 【Update DataBase Setting Dialog】.
Next, specify the number of lines in the 【Number of lines per page】input field on this screen.
The range that can be specified is 50-2000.
Click the 【Update Button】 to change the number of lines.
At that time, the 【Search Result List】 is deleted, and the【Number of lines of per page】 specified by the change is reflected when the next search is performed.
Generally, when a large value is specified for the 【Number of lines pere page】, the display of 【Search Result List】 becomes slow.

(5) Sort Search Result List

The display order of the GRs extracted by the search depends on the display position (customizable) of the items in 【GR List Item Name】.
The items are sorted in descending order step by step from the left side item (excluding 【No.】) .
If the values ​​of the items are the same, the item in the next display position is sorted and the order is determined.
In the same manner, sorting is sequentially performed on the displayed items and the final result sequence is determined.
If the title of line would assumed to be a string of characters concatenated from left to right with each item having a fixed length, it is the same as that sorts them in descending order.

It is possible to instruct to perform re-sorting for each item.
In that case, specify either descending order or ascending order as the sorting option.
Click the right mouse button in 【GR List Item Name】 of the item to be re-sorted.
【Item Operation Popup Menu】 is displayed.

【Item Operation Popup Menu】


Here, if you select 【Descending order】, the items will be sorted in descending order and the GRs will be sorted.
If you select 【Ascending order】, the ascending order will be sorted in the same way.
The display order of the GRs is the same as when the sorting is performed assuming that the selected item is the leftmost display item (excluding the 【No.】).

(6) Customize database items

Show/hide items

Items to be displayed or not to be displayed in 【Search Result List】 can be selected.
To hide the item, click the right mouse button in the 【GR List Item Name】 of the item.
【Item Operation Popup Menu】 is displayed, and select 【Hide item】.
The specified item will not be displayed in the 【GR List】.
To add the item to be displayed, select 【Add Item】 from the 【Item Operation Popup Menu】.
【Additional Item List Menu】 is displayed.

【Additional Item List Menu】


When you select the item you want to add in 【Additional Item List Menu】, the additional item will be displayed at the position next to the item selected in 【GR List Item Name】.
Items displayed in the 【Additional Item List Menu】 are a list of all hidden items that are currently hidden.
The items that can be displayed are as follows.

【DataBase Item】

<In case of GR database>

【ID】Numbers assigned in sequence when GRs are registered in the database
【TimeStamp】Date and time when the GR was registered or updated in the database
【Black】Black player name (Note 1)
【White】White player name (Note 1)
【Title】Title of GR
【Event】Event of GR
【Start Datetime】Date and time of the game start
【End Datetime】Date and time when the game ends
【Week】The week when the game starts
【BR】Rating of the black (Note 2)
【WR】Rating of the white (Note 2)
【Time Condition】Time condition for playing game 
【Openning】Openning of game
【Winner】Winner's "turn"
【Game over reason】End information of the game
【Move Count】Final "move" number of GR
【Handicap】Handicap for games
【Start Move Number】 Start "move" numer (value set in "position" editing)

<In case of Tsume shogi database>

【ID】Numbers assigned in sequence when Tume Shogi GRs are registered in the database
【TimeStamp】Date and time when the Tsume shogi GR was registered or updated in the database
【Author】Name of Tsume Shogi author
【Title】Title of Tsume Shogi
【Work Name】Name of Tume Shogi
【Announcement Date】Announcement date of Tsume Shogi
【Category】Category of Tsume shogi
【Move Count】The Number of "move"s of checkmate procedure
【Post】Tsume Shogi's announcement medium

(Note 1)The black and the white cannot be set as hidden items.
(Note 2)If one of the BR and the WR is hidden, both are hidden.
If you add one of the items, both will be displayed.

If all items are set to be displayed in 【Search Result List】, the display space for each item will be too small to display them sufficiently.
If possible, it is better to limit the display items to only those that are necessary.

Collaboration with 【Search Condition Input Dialog】

If you hide the items in 【Search Result List】, the search items in 【Search Condition Input Dialog】 will also be hidden.
When you add an item, the search item in the 【Search Condition Input Dialog】 is also added.
However, not all items can be displayed in the 【Search Condition Input Dialog】.
In the range of items described in search item description in the GR database, the search items in the 【Search Condition Input Dialog】 are shown/hidden in conjunction with the show/hide of the items in the 【Search Result List】.
【Black】 and 【White】 In the 【Search Result List】 is correspond to 【Player】 and 【Opponent】 in 【Search Condition Input Dialog】 , 【BR】, 【WR】 is correspond to 【Rating】 in 【Search Condition Input Dialog】 .
The GR comment in the 【Search Condition Input Dialog】 is always displayed not related to which the search items are hide or display.

Although the items in the 【Search Condition Input Dialog】 for Tume Shogi are different, they are linked to the show or hide of the items in the 【Search Result List】.

Change item display position

The display position of items can be changed except for the 【No.】.
Click the left button of the mouse on 【GR List Item Name】 of the item to change the display position.
Drag it and move it to the position you want to display.
When you release the left mouse button, the display position of the item moves to the release position.

These settings in the 【Search Result List】 of the "current database" are saved as they are even after this program is closed.
You can customize the show/hide of items and the display position of items for each database.

(7) Win Rate display

The information obtained as a result of the search has a Win Rate. (Not in the Tsume Shogi GR database)
The winning percentage is displayed below the 【Search Result List】.
When a player name is specified in 【Search Condition Input Dialog】, the win rate of the player is displayed as the search result.
If you don't specify a player name, it simply displays the overall winning ratio of the "black turn".
The display format is shown below.

① When you search by specifying the player in the 【Search Condition Input Dialog】.
   No designation black or white

 Display format:Player <win rate info> ◆ Black Win Rate <win rate info> ◆ White Win Rate <win rate info>

② When you search by specifying the player in the 【Search Condition Input Dailog】.
   Specify the black with 【Turn】

 Display format:Player Black Win Rate <win rate info>

③ When you search by specifying the player n the 【Search Condition Dialog】. Specify the white in 【Turn】.

 Display format:Player White Win Rate <win rate info>

④ If you do not specify the player

 Display format:Black Win Rate <win rate info>

<win rate info>=:<win rate>【<number of win>/<number of game> (<number of draw>)】
<win rate>=:<win number>/<number of game> calculated value (up to 3 digits after the decimal point)
<number of win> =:Number of game win
<number of game> =:Number of game. Excluding the number of game drawed
<number of draw> =:Number of game that have been draw

The winning percentage is calculated based on the GR on the first page of the 【Search Results List】.
If you want to obtain the overall Win Rate of the search results, click the 【Overall Calculation Button】 with the mouse.
The overall win rate is displayed.
If the search result is within one page, it is not necessary and the 【Overall Calculation Button】 is not displayed.
The reason for doing this is that it is necessary to read the entire GR of the search results when calculating and displaying the overall winning percentage from the beginning, which requires time.
It is a pity that the priority is to display the [Search Result List] window quickly.

(8) Search Result List display operation

Close 【Search Result List】

To close the 【Search Result List】, select 【Close】 in 【GR List Operation Popup Menu】.
【Serach Result List】 will be deleted and 【Shogi Board Lower Window】 will return to the display of 【Comment Board】 only.

In addition, the case where delete the display of [Search result list] is summarized as follows.


Open 【Search Result List】 in a new window

To display the 【Search Result List】 in a new window, select 【Window display】 in 【GR List Operation Popup Menu】.
The 【Search Result List Window】 is displayed.

【Search Result List Window】


The operation in the 【Search Result List Window】 is the same as 【Search Result List】.
To close this window, click the 【x】 button in the window, or click the right mouse button in 【Game List】 in this window.
Display 【GR List Operation Popup Menu】.
Then select 【Close】.

【GR List Operation Popup Menu】


To return to the original 【Search Result List】 display of the 【Shogi Board Lower Window】, select 【Undo】 from the 【GR List Operation Popup Menu】.
【Search Result List Window】 is deleted, and 【Shogi Board Lower Window】 is returned to the display of 【Search Result List】 and 【Comment Board】.

Switching between 【Search Result List】 and 【Comment Board】 in 【Shogi Board Lower Window】

The 【Shogi Board Lower Window】 is a tab window.
After the search, the 【Search Result List】 is newly displayed.
【Comment Board】 and 【Search Result List】 can be switched by tabs.

5.4 Text search for comments

Comments are written in the GR for each starting "position" and each "move".
The GR can be searched by that comment.
Enter the keyword for search in the 【GR Comment】 of【Search Condition Input Dialog】.
The GR that holds the character string that matches the keyword in the comment is searched from the "current database" and displayed in the 【Search Result List】.
When you select a GR in the 【Search Result List】 and display it on the 【Shogi Board】, A mark'◆' indicating that the keyword matches is displayed in the【C】 column of the 【Move List】.
When the comment at the matched position is displayed in the 【Comment Board】, the background color of the character string that matches the specified keyword is shown in yellow.

【Sample string search results】


Until you close the 【Search Result List】 or display a new 【Search Result List】 by re-searching, when you select and display a GR from the 【Search Result List】, the display is as shown above.
That is, during that time, the state of the search result is held.

The same is true for the comment search in the 【Search Condition Input Dialog】 of Tsume Shogi.

5.5 "Position" search

(1) "Position" search

You can search a GR that has the same "position" as the "current position" of the GR displayed on the 【Shogi Board】 from the "current database" and display it in the 【Search Result List】.
A procedure for performing a "position" search will be described.
Display the "position" to be searched on the 【Shogi Board Window】.
Next, select 【Position Search】 from the 【File (F) Menu】.
The 【Position Search Condition Setting Dialog】 is displayed.

【Position Search Condition Setting Dialog】


The Shogi Board to be searched is displayed in the 【Position Search Condition Setting Dialog】.
Click the 【Search exec Button】 with the mouse to execute the "position" search.
Search results are displayed in 【Search Result List】.



The 【Hit Position】 item is displayed next to 【No.】.
【Hit Position】 indicates the "move" count of the "position" that matches the search target "position".
If there are multiple identical "position" in a GR, it matches the first "position".
If there is a matching "position" in both the Root GR and the Branch GR, the matching of the Root GR is given priority.
If you select a GR in the 【GR List】 and display it on the 【Shogi Board】, the matching "position" of that GR is displayed instead of the starting "position".
It is not possible to search for the starting "position" of a game.
It is possible to search for situations where the "number of move" is one or more.
However, in the case of Shogi Tsume, it is possible to search at the starting "position" (initial placement).
In the "position" search of this program, even when the boards match and the holding pieces do not match, it is treated as a match.
The pieces held on the piece stand are not the conditions for matching the "position"s.

The display position of the 【Hit Position】 item is always displayed at the position next to the 【No.】.
The display position cannot be changed.
All other operations in the 【Search Result List】 are the same as in the case search.

(2) Partial search

Partial search does not search the entire "position", but a part of the "position".
A method of specifying the partial "position" will be described.
It is the same as the "position" search until the 【Position Search Condition Setting Dialog】 is displayed.
Next, the part to be searched on the 【Shogi Board】 is specified.
When you click a square on the 【Shogi Board】 with the mouse, the background of the square changes to gray.
The grayed squares in the "position" are the search target.
The specified parts do not have to be adjacent to each other, and any "position" can be specified.

【【Position Search Condition Setting Dialog】 Partial selection example】


When you click the 【Search exec Button】, the matching part of the specified part is searched and the result is displayed in the 【Search Result List】.
Partial search takes more time than the "position" search.

Partial selection operation
 

In addition to the operation of clicking each square and specifying the part, the specified range can be specified with a rectangle.
If you click the end point on the diagonal of the rectangle with the mouse and drag it, and release the mouse on the other end of the diagonal, The background of the squares will change to gray and you can search.

Partial selection cancel operation

If you click the already selected square with the left mouse button, the square returns to its original state and the selection is canceled.
If a rectangular range is specified with the mouse while pressing the 【Shift】 key, the selection of that range is canceled.
Clicking the right mouse button cancels all selections.

(3) Similar search

Similarity search is a "position" search, and this is a search for a GR that holds the specified "position" as a similar "position" even if there is a mismatch in some of the specified "position"s instead of an exact match.
The number of unmatched points within a similar "position" is specified in 【Similarity Search Setting Combo】 of the 【Position Search Condition Setting Dialog】.

【Similarity Search Setting Combo】


0means a normal "position" search or partial search in the sense of an exact match
2If there is a discrepancy within 2 places, consider it as a similar positiom
4If there is a discrepancy within 4 places, it will be a similar "position"
6If there is a discrepancy within 6 places, it is regarded as a similar "position"
8If there is a discrepancy within 8 places, consider it as a similar "position"
10If there is a discrepancy within 10 places, consider it as a similar "position"

The number of "move"s in the "position" determined as a similar "position" is displayed in 【Hit Position】 of 【Search Result List】.
In this case, the determination method determines that the "position" in the GR with the fewest mismatches is the similar match scene.
In other words, even if you find a "position" where there are two disagreements, if there is a "position" that is a perfect agreement beyond, as a similar match, set its "move" count to 【Hit Position】.

Similarity search is a very time-consuming search method because it basically checks all the GRs in the "current database".
Therefore, it is not a practical search and is not highly recommended.
If it's less than a few thousand, it's not a big deal, but if it exceeds tens of thousands, it takes a lot of time.

(4) Combination of each search

In "position" search, 【Search Condition Input Dialog】 (In the case of a database for Tsume shogi, 【Search Condition Input Dialog】 for Tsume Shogi) is displayed and further refinement can be specified.
When you click the 【Search Condition Setting Button】 in the 【Position Search Condition Setting Dialog】, the 【Search Condition Input Dialog】 is displayed, and you can set the narrowing conditions.

In the 【Position Search Condition Setting Dialog】, specify the placement range (entire "position" or part of the "position") on the 【Shogi Board】, and specify the search range in the 【Search Condition Input Dialog】.
A similar search condition can be specified as a condition for "position" matching to perform a search.
It is not always necessary to specify the search range in the 【Search Condition Input Dialog】 It is not necessary to specify and it is optional.

5.6 Excel output processing

Database items can be extracted in Excel (Note 1) book format.
The extracted results can be displayed on the screen by starting Excel or Calc (Note 2), or you can use the macro function of Excel or Calc with the result as the input to perform the aggregation process.
To use this function, Excel or Calc must be installed.

The type and arrangement (column position) of the items to be extracted in the Excel book format, sort conditions for each item, and the editing method can set for some items.
According to the setting, it is possible to extract items of the GR or Tsume shogi GR which narrowed down by the search condition from the "current database".

If the setting conditions are different, you can register multiple processes as separate processes.
The registered process can be selected and executed from the menu.
When you install this program, "GR List" and "Win rate list by opponent" are installed as samples and can be used.

Excel (Note 1): Microsoft Office Excel. Requires 2007 or later version of Microsoft Office.
Calc (Note 2): Libre Office Calc. Libre Office is open source and can be downloaded 
               and used from https://ja.libreoffice.org.
	

(1) Setting

Explain the setting method of Excel output process.
Select 【Excel Output Processing】 in 【Extensions (X) Menu】.
【Excel Output Prosessing Dialog】 is displayed.

【Excel Output Prosessing Dialog】


Registering Excel output processing

Click the 【Add Button】 to add a new Excel output process.
【Excel Output Prosessing Add Dialog】 is displayed.

【Excel Output Prosessing Add Dialog】


In this dialog, define the contents of Excel output processing.
In 【Title】, set the title when the menu is selected for the process defined here.
In 【Excel File Output】, set how to create an Excel file from the data extracted from the database.
In 【Post Processing】, set how to process the created Excel file.
How to set each item in this dialog is explained.

【Title】:
Set the title of Excel output process.
Make sure that it does not duplicate the already registered title.
The title set here will be the title for selecting the Excel output process from the menu.

【Excel linked file output settings】:
DB Item Pattern Select a database item set.
Select the item set that can be selected from 【GR】/【GR For Each Player】/【Tsume Shogi】 according to the processing.
The item name is set in 【DataBase Item】 according to the DB items selected here.
  • 【GR】:
  • Extract DataBase Items of GR
  • 【GR For Each Playe】:
  • 【Black】/【White】 in the database item of the GR will be the extraction method converted to 【Player】/【Opponent】/【Player Turn】.
    【Winner】 is the same item name, but the value is set the Player's Win/Lose ("Win" / Lose "/ Draw").

    Other items are the same as in the case of 【GR】.
    In this item set, will be extracted two lines of information for each GR and will be output to Excel file.
        One line information for 【GR】】
    Item name: 【Black】 【White】 【Winner】
    One line: "Sato" "Tanaka" "Black"
    
    
        2 lines of information in the case of 【GR For Each Player】
    Item name: 【Player】 【Opponent】 【Player Turn】 【Winner】
    1st line: "Sato"   "Tanaka"        "Black"          "Win"
    2nd line: "Tanaka"   "Sato"        "White"          "Loss"
    
    
     By selecting this items, the aggregation process for each player becomes very easy to handle.
  • 【Tsume Shogi】:
  • Extract DataBase Iitems of GR for Tsume shogi.
DataBase ItemDisplay that item (all items) according to the DB Item Pattern selection.
The vertical order of items here corresponds to the order of columns in the Excel sheet.

Delete Item

To delete an item that does not need to be extracted, select the item by clicking the left mouse button.
Then, by clicking the right mouse button, the 【Operation Popup Menu】 is displayed.
If you select 【Delete Item】, the item will be deleted.

Or, select the item to delete and press the 【Delete Key】 to delete the item.

Add Item

If you want to add the deleted item again, Then, by clicking the right mouse button, the 【Operation Popup menu】 is displayed.
Select 【Add Item】 to display a list of deleted items.
Select the item to add from the list.
The selected item is added.
The position of the added item is above the item with the current selection display.

Change order of items

When changing the order of items, you can move the target item by dragging it with the mouse.

SortSet sort condition (【Asc】/【Des】) for each item when extracting from database.
Click the left mouse button on the 【Sort】 column of the target item to display the combo box.
【Dsc】/【Asc】 can be selected.
NormalizationSpecify whether to unify the names of the players (【Yes】/【No】).
Players means to 【Black】/【White】 in items of 【GR】, and 【Player】/【Opponent】 in items of 【GR For Each Player】 Click the left mouse button on the 【Normalize】 column of the target item to display the combo box.
【Yes】/【No】 can be selected.
When performing the aggregation process, unless the names of the players are unified, it is not possible to correctly aggredate the win rate and the number of wins.
Especially in professional game, the name in the game is often different for each game, so it is necessary to compile them all together.
It is necessary to unify the knight names.
When 【Yes】 is selected, edit operation is performed to group the items into the same value according to the following rules.

Normalization rule

  • Remove all whitespace between first and last name.
  • Example) "Akira Tanaka" -> "AkiraTanaka"
  • Remove N段 or N級 or N冠 at the end.
  • Example) "Akira Tanaka 9段" -> "Akira Tanaka"
    N refers to Chinese numerals or full-width/half-width arithmetic numerals. (1 digit)
  • Removing the title name at the end.
  • Example) "Akira Tanaka名人" -> "Akira Tanaka"
    The title name at the end can be customizable.
    The following values has already been set as title names to be removed at installing this program.
    "名人"/"竜王"/"棋聖i"/"棋王"/王将"/"王位"/"王座"/"十段"
  • If "名誉" is added before the name, removing it as well.
  • Example) "Akira Tanaka名誉十段" -> "Akira Tanaka"
Note that the value used when sorting items is, of course, the value after normalization editing.
As a result, the extracted data will have the same names arranged neatly according to the sort condition.
Edit date and time Specify how to edit date and time items.
Specify the display method of date and time when it is extracted to an Excel sheet using edit characters that represent date and time.
In the case the DB Item Patern is 【GR】/【GR For Each Player】,The target items are 【TimeStamp】/【Start Datetime】/【End Datetime】, In the case the DB Item Patern is 【Tsume Shogi】,it is 【Announce date】.
【Edit character】
y: Yearyyyy4th digit yearyylast 2 digits of the year
M: MonthMM2 digits monthM1-2 digits month
d: daydd2 digits dayd1-2 digits day
H: HourHH2 digits hourH1-2 digits hour
m: minutemm2 digit minutem1-2 digits minute
s: Secondss2 digits seconds1-2 digits second
 
【Example of use】
【Edit Date Settings】 【Display Date and Time in Excel】
yyyy/M/d H:m -> 2014/1/2 2:30

Double-click the 【Edit Date and Time】 column of the target item to change it to the text edit field.
Therefore, the date and time display is set while using the edited character.
In Excel, dates before 1900/1/1 cannot be displayed, so set the display format of the cell as "character string" instead of "date".
Item Title outputSpecify whether to set the item name of each column in the top row of the Excel sheet.
If you check this check button, the top row of the Excel sheet will be the row of item names.
If unchecked, the row of item names will not be set in the top row of the Excel sheet.

The created Excel file name is "Book.xlsx" and the location is the "tmp" folder under the program installation folder.
The created Excel file is temporary for later processing.
If you want to save the extraction result, display it in Excel (or Calc) and execute 【Save As】 in Excel (or Calc).
Excel versions before 2003 cannot handle files with extension "xlsx".
Excel version 2007 or later is required.

【Post processing】:
Post processing selection
Radio button
  • 【Display Only】
  • Specify that the created Excel workbook is displayed by starting Excel (or Calc).
  • 【Aggregate】
  • Launch a separately created Excel (or Calc) aggregation file.
    Notify the file for aggregatation the path name etc of the created Excel file ((3) Customization of aggregation file).
AggregationSpecify the path name of Excel (or Calc) aggregation file when 【Aggregate】 is selected in 【Post Processing Radio Button】.
Only the file name may be used as long as it is directly under the installation directory of this program.
【Win rate list by opponent】 is pre-installed (Note) as a file for aggregation.
  • AmountForExcel.xlsm (for Excel)
  • AmountForCalc.ods (for Calc)
(Note) If the platform is Windows, pre-installation settings are for Excel.
      int the case Mac or Linux,it is for Calc.
If you are using Microsoft Office on your Mac, change the settings here for Excel.
If you are using Libre Office on Windows, change the settings here for Calc.
As for the spreadsheet software to be started, Calc will be started if it is "ods" according to the extension of the file for aggregation.
Excel is started with the extension for Excel files ("xls"/"xlsx"/"xlsm" etc.).

Click the 【Add Button】 after performing the above settings to add one Excel output process.
Click the【Cancel Button】the additional processing will be canceled and you will be returned to the 【Excel Output Processing Dialog】.

Change of Excel output process

If you want to change the already registered one, select the Excel output process to be changed from the 【Excel Output Processing Title】 list by clicking the left mouse button, Then click the 【Update Button】.
Excel Output Processing Update Dialog】 is displayed.
The display screen has the same contents as the dialog at the time of addition, except that it is not possible to change the selection of 【DB Item Pattern】.
The setting method is the same as the content at the time of addition, except that the selection of【DB Item Pattern】 cannot be changed.

Delete Excel Output process

If you want to delete the already registered one, select the Excel output process to be deleted from the 【Excel Output Processing Title】 list by clicking the left mouse button, Then click the 【Delete Button】.
A confirmation dialog will be displayed, and will be deleted by clicking the 【Yes Button】.

Change display order of Excel linkage process

The display order of the 【Excel Output Processing Title】 list is the same as the display order of the submenu of 【File Menu】/【DB Term to Excel File Menu】.
You can change the display order by dragging and moving the 【Excel Output Processing Title】 of the target process with the left mouse button.

Configure Normalization

Register the last character string to be removed in Normalization rule of item edit.
Click 【Configure Normalization Button】 to display 【Configure Normalization Dialog】.

【Normalization Normalization Dialog】


Click the right mouse button to add a new 【End Character String】.
The operation popup menu will be displayed and select 【Add】.
A blank line is added to the end of this list.
Double-click on the blank line with the left mouse button.
You can enter a character string at that position.
Input the character string and press the 【Enter Key】 to complete the additional processing.

When deleting the added 【End Character String】, click the left mouse button and select the 【End Character String】 to be deleted.
Then click the right mouse button.
Select 【Delete】 from the operation popup menu that is displayed.
The selected 【End Character String】 is deleted.
Alternatively, press the 【Delete key】 after selecting the end character string to be deleted, and the selected end character string is deleted.

To change the 【End Character String】, double-click the end character string to be changed with the left mouse button.
The 【End Character String】 at that position can be changed.
Change the 【End Character String】 and press the 【Enter Key】 to complete the change process.

Click the 【OK Button】 to finish editing the 【End Character String】.
If you click the 【Cancel Button】,
The editing operation up to that point is canceled.

(2) Execution

When you select 【File (F) Menu】/【DB Term to Excel File】, the selection menu of the process registered by the Excel output process is displayed.

【Excel Output Process Selection Menu】


Select the process to be executed here.
【Search Condition Input Dialog】 is displayed. (If the "current database" is Tsume Shogi, 【Search Condition Input Dialog】 for Tsume shogi is displayed).
Then enter the conditions to be extracted and click the 【Exec Button】.

Extract from the "current database", create an Excel book, execute an Excel file output, and perform sequential processing, and finally start Excel (or Libre Office) to display the Excel file or perform its aggregation processing.

Below are the sample of aggregation results of the pre-installed【Win rate list by opponent】.

【Win rate list by opponent】 Total result sample


This sample is displayed in Excel.
This is a search result obtained by setting "羽生*" as a player in the search condition input dialog from a database called "Pro Shogi game" and performing a search.
Note that "羽生*" is specified for the player's condition.
In this sample professional GR database, "羽生 善治", "羽生善治", "羽生 善治三冠", etc. These are all GRs of the same person, and we want to include them in the extraction target. (Refer to (Note 1) of database search for how to specify'*')
According to the normalization rules of the players, all the results are counted by "羽生 善治".

Macro security settings

Macro ("VBA"/"Libre Office Basic") is used for totaling in both Excel and Calc.
Therefore, depending on the security settings, the macro may be ignored or a warning message may be displayed when the macro is executed.
Therefore, it is necessary to change the security setting to enable the macro in Excel or Calc.
Since it is dangerous to set the macro to be always valid, there is a method to set the folder in which the totaling file exists to be a trusted location and to enable only the macro of the totaling file.
The operation to add a new trusted location to enable the pre-installed 【Win rate list y opponent】 is shown below.

【Trusted location】 setting operation
For Excel:
    Start Excel and select 【Option】->【Security Center】 from the 【File Menu】.
    Go to -> 【Security Center Settings】 -> 【Trusted Locations】 and click 【Add New Location】.
    So add a new .
For Calc:
   【For Windows/Linux】
      Start Calc and select 【Option】->【Security】 from the 【Tools Menu】.
      Go to -> 【Macro Security (Y)】 -> 【Trusted Sources】 -> 【Trusted File Locations】 and click 【Add】.
      Add a new < 【Security】 -> from the 【Settings Menu】.
      Go to 【Macro Security】->【Trusted Sources】->【Trusted File Locations】 and click 【Add】.
      Add a new <trusted folder> of this program.

      <Trusted folder> 
            For Windows/Linux => <Destination folder>/SbrowserQ_V3.7/
            For Mac => SbrowserQ_V3.7.app folder

(3) Customization of aggregation file

Aggregation file can be created and registered according to the aggregation contents.
How to create is explained.

The 【Win rate list by opponent】 created as a sample has 【DB Item Pattern】 as "GR For Each Player" and read the extracted items ("Player"/"Opponent/"Player Turn"/"Winner") and and a new book (a document in LibeOffice) is created and the results aggregated in this book are displayed.
When making a table, sort so that the opponents are arranged in order of the number of games played or the win rate.
New books are not displayed until the aggregation process is completed.
Three books are used here.
① Aggregation file (macro definition. Book to be started first)
② Extracted data (book opened and generated by macro of aggregation file)
③ For new display
After the aggregation process is completed, the aggregate file and the extracted data book are closed and only the new display book is displayed.

Aggregating file is started by this program (SBrowserQ).
The interface at that time will be described.
What is required in the file for aggregation is the file path name when reading the extracted data (Excel file).
This path name is set on the top sheet of the book of aggregating files to notify.
Since other information is set together, The contents are shown below.

   Set each value in the following cells on the first sheet.
 A1 cell: Excel file path name of the extracted data 
 A2 cell: Summary processing title (title set in the 【Excel Output Processing Add Dialog】)
 A3 cell: Database name to be extracted
 A4 cell: Search parameter string when extracting
 A5 cell: Language information selected in SbrowserQ. Set 2 characters "JA" for Japanese 
          and 2 characters "EN" for English.

The extracted data (Excel workbook format) is always set to the first sheet of the workbook (sheet name is "Sheet1").

In the sample aggregation process, after read this information, the interface cell value is erased so that it will be not displayed during the process.
The created aggregating file can be stored in any folder, but as described in Macro security settings it is necessary to change the security settings.

5.7 "Position" Dictionary display

A "Position" Dictionary is a dictionary that has information on all "position"s of all GRs registered in the database.
There is one for each database.
As information

Information about the "current position" of the GR that is currently displayed can be obtained from the "position" dictionary and its contents can be displayed.
Select 【Display Position Dictionary Board】 from the 【Operation (O) Menu】 to display the 【Position Dictionary Board】.

【Position Dictionary Board】


【Position Dictionary Database Selection Combo】 shows which database the currently displayed "position" dictionary belongs to and the title of that database.
You can switch the database displayed in this combo box.
That is, a dictionary of a database different from the "current database" can be displayed.
The top line of the detail column of the 【Position Dictionary Board】 always displays the total information of the "position".
From the next line, information for each "move" is displayed.

The display order of the information for each 【Next Move】 can be sorted and rearranged according to the 【Number of Moves】 and the 【Win Rate】.
If you click the 【Number of Moves】 in the title with the mouse, it will be sorted by the 【Number of moves】in the direction opposite to the current display (ascending order if the current order is descending, and descending order if it is ascending order), the result is displayed.
If you click the 【Win Rate】 of the title with the mouse, it will be sorted by the 【Win Rate】 and the result will be displayed.

Clicking on the line for each 【Next Move】 with the mouse will create an Branch GR that next "move".

5.8 Update of GR

(1) Update operation

Retrieve the GR from the database, import it into the 【Shogi Board】, and then change the GR by reviewing and editing operations, and reflect it in the database.
For that doing ,select 【Update DB】 from 【File (F) Menu】.
The changes are reflected in the database.

If you register 【Add DB】 for a GR imported from the database, it will be a new registration for that database, so if duplicate registration is not allowed, the registration will result in a duplicate error (registered).
However, if there is a change in Duplicate check item, such as when 【Black】,【White】 name is changed by editing, or the 【Move count】 has changed, another GR As a new registration is possible by 【Add DB】.

When the GR the database is updated, the 【TimeStamp】 of the database item is rewritten to the changed date and time.

(2) Update target database

Usually, the "current database" is the target database for importing a GR from the "current database", editing it, and then updating it.
However, after importing the GR from the "current database", if the "current database" is switched with the 【DataBase Selection Combo】 (when multiple databases are created), because the "current database" is different from the database from which the GR was imported, in that case the GR is updated to the database from which the GR was imported.

From which database the GR displayed on the 【Shogi Board】 was imported can be obtained from the 【GR Source Information】.
Click the right mouse button on 【GR Selection Tab】. A popup window will appear and the 【GR Source Iformation】 for the GR will be displayed.

【GR Source Information】


The format of the 【GR Source Information】 is shown below.

【GR Source Information】:=【<type>】 <source>
Or
(without source)

   <Type>:=DBIndicates a GR imported from the DB database.
   FileIndicates a GR taken from a file.
   UrlA GR (watching game) imported from the Internet

   <Source>:=If the type is DB :=<Database name>(<ID>)
   <Database name>:=Database title
   <ID>:=Value of database ID item(A unique number given to the GR in the database)
   If the type is file:= file path name of GR file
   If the type is Url:=URL of the GR

        When "(without source)" is displayed in the format of the source information, 
       it means the GR taken in by the operation of pasting the GR.


5.9 Batch processing of database

(1) Batch GR analysis

Perform GR analysis in a batch to GRs obtained by searching the database.
The result of the GR analysis can be saved in the database as it is.
It is a prerequisite that a shogi engine is registered in order to perform a GR analysis.
In addition, the database for Tsume Shogi is not subject to GR analysis.

Starting procedure for Batch GR Analysis

First, select the target GR database in the 【Database Selection Combo】.
Next, select 【Batch GR Analysis】 from 【File (F) Menu】.
Then 【Analysis GR Dialog】 is displayed.
The contents specified here are the same as those for normal GR analysis.
Then click the 【Start Button】,【Search Condition Input 【Batch processing】 Dialog】 is displayed.

【Search Condition Input 【Batch processing】 Dialog】


Here, search conditions are set in order to narrow down the GRs for Batch GR Analysis.
The setting method is the same as the normal 【Search Condition Input Dialog】.
If you do not enter any search conditions, all GRs in the database will be targeted.
Furthermore, the following two are specified as options specific to batch processing.

Automatically save updated GR Specify whether to save the analysis result after executing the GR analysis in the database automatically.
When this option is checked, the analysis result is automatically saved in the database and the confirmation dialog asking whether to save the analysis result after the GR analysis is completed is not displayed.
If you do not check this option, after one GR analysis is completed, a confirmation dialog is displayed asking whether to save the analysis results in the database.
In this case, if you do not respond to the dialog, the GR analysis of the next game will not start.
Display the 【Search Result List[Batch processing Dialog】 Specify whether to display the 【Search Result List[Batch processing Dialog】 displayed in the next step.
If you check this option, the 【Search Result List [Batch Process] Dialog】 is displayed, and you can specify the order of the GR analysis by sorting.
If you do not check this option, the 【Search Result List [Batch processing Dialog】will not be displayed and immediate GR analysis will start.

If you check the 【Display Search Result List [Batch processing] Dialog】 in 【Search Condition Input [Batch Processing] Dialog】, 【Search Result List [Batch Processing] dialog】Is displayed.

【Search Result List [Batch Processing] Dialog】


Batch GR analysis is executed sequentially from the beginning of this [Search Result List].
You can change the order of the GR analysis by sorting for each item of 【GR List title】.
For sorting operation, refer to (5) Sort Search Result List.

Click the 【Exec Button】 to start the GR analysis of the first GR.

Operations during Batch GR analysis

During the GR analysis, the 【GR Analysis Monitor】 is displayed in the 【Shogi Board Lower Window】 as in the normal GR analysis, and you can monitor the progress of the GR analysis.
In addition, in Batch analysis, 【Search Result List [Batch Processing]】will be added as a tab window to【Shogi Board Lower Window】.
T the contents are the same as those displayed in the 【Search Result List [Batch processing] Dialog】, and here the position of the GR being analyzed is shown by the selection bar.
【Search Result List [Batch Processing]】


The displayed contents are almost the same as the 【Search Result List】 displayed in a normal database search, except the database name is displayed in the upper right corner instead of the re-search button.

① Interruption of Batch GR Analysis

If you want to suspend the Batch GR Analysis, click the right mouse button on the tab window of this 【Search Result List [Batch processing]】 and diplay 【Batch Processing Popup Menu】.

【Batch Processing Popup Mnu】


If you select 【Suspend】 here, Batch GR Analysis will be stopped and ended.
In that case, the board at the time of interruption remains displayed in the 【Shogi Board Window】.

You can also stopped Batch Game Analysis by clicking on the 【GR Selection Tab】 of the 【Shogi Board Window】 that is performing Batch GR Analysis.
In that case, the 【Shogi Board Window】 is also deleted.

If you select 【End Analysis】 in the 【Analysis (A) Menu】, the GR Analysis of the GR currently being executed is interrupted, but the Batch GR Analysis itself is not interrupted.
The GR Analysis of the next GR newly begins.

② Skip GR Analysis

You can interrupt the GR Analysis of the GR currently being executed, and execute the GR Analysis of other GRs on the 【Search Result List 【Batch Processing】】.
Move the 【GR Selection Bar】 in 【Search Result List 【Batch Processing】】 to the position of the GR you want to execute GR Analysis and double-click it.
The game analysis of the currently executed GR is interrupted, and the GR Aalysis of the newly selected GR is started.
Thereafter, the GR Analysis after the newly selected GR is executed as a target of the Batch GR Analysis.

End of Batch GR Analysis

When the GR Analysis of the last GR in 【Search Result List [Batch Processing]】 is completed, the Batch GR Analysis is completed.
The board at the end of the GR Analysis of the last GR is left in the 【Shogi Board Window】.
Also, although the mark is displayed on the 【GR Selection Tab】 of the 【Shogi Board Window】 during Batch GR Analysis, This display disappears as soon as the Batch Analysis ends.

(2) Batch Auto Playback

You can watch or examine the GRs by searching the GR database and sequentially playing automatically.
It is also possible to perform the examination operation and the editing operation as usual during the playback of the Batch GR.
The changed GR can also be automatically saved in the database by specified.

Procedure for starting Batch GR Auto Playback

First, select the target GR database in the 【Database Selection Combo】.
Next, select 【Playback in Batch】 from 【File (F) Menu】.
【Search Condition Input [Batch Processing] Dialog】 is displayed.
The subsequent flow is the same as that for Batch GR Analysis.
The first GR is displayed and Auto Playback starts.

Operations during Batch Auto Playback

A 【Search Result List [Batch Processing]】 is added as a tab window to the 【Shogi Board Lower Window】.
The content is the same as that displayed in the 【Search Result List [Batch Processing] Dialog】, and here, the position of the GR been displyed in the 【Shogi Board Window】 is indicated by the selection bar.
The operations that can be performed here are the same as those for Batch GR Analysis, so refer to that.

End of Batch GR Auto Playback

Refer to this because it is the same as the case of Batch GR Analysis.

5.10 Database maintenance

(1) Database update

You can change the database settings after creating a new database.
Display 【Update Database Settings Dialog】 and change the settings.
The setting contents that can be changed here are the 【Tsume Shogi Style】, the 【Duplicate Registration Impossible】, the 【Number of lines per page】, and the 【DataBase Title】.
For 【Tsume Shogi Style】,refer to 5.1 Create database.
For 【Duplicate Registration Impossible】,refer to (2) Duplicate check.
For the 【Number of lines per page】refer to (4) Search Result List and Page.
Here, the change of the title of the database will be described.

Change the name displayed in 【Database Title】 to the desired name.
Click the 【Update Button】 to change the title of the database.
The title that can be entered cannot be the same as that already used in this system.

(2) Database release

Release is to separate the database so that this program cannot refer to it.
Therefore,the released database will not be displayed in the 【Database Selection Combo】.

Select the database to be separated with 【DataBase List Dialog】, and click the 【Release Button】.
Database released.
In order to refer to the released database again with this program, import the database.

(3) Database import

The already created database can be imported into this program.
Of course, the database must have been created by this program.

Click the 【Import Button】at the 【DataBase List Dialog】 .
File Selection Dialog】 is displayed.
Then, select the database file (extension is'h2.db') that should be imported there.
Then click the 【Import Button】.
If the file is a database file created by this program, the import is complete and the 【Database List Dialog】 is displayed as a list.
All the operations can be performed on the imported database.

When importing a database created with a version earlier than V3.0

When importing a database created with a version earlier than V3.0 into this program version V3.0 or later, select the database file in the 【File selection dialog】 and click the 【Import Button】 Then, 【Database Setting Dialog】 is displayed.
Therefore, it is necessary to set the 【DataBase Title】, the 【Tsume Shogi Style】, the 【Number of lines per page】.

【Database Setting dialog】


The method of specifying the 【DataBase Title】, 【Tsume Shogi Style】, and 【Duplicate Registration Impossible】 each parameter is as described in 5.1 Database creation.
The 【Number of lines per page】 is described in (4) Search Result List and Page.

Once specified here, this operation becomes unnecessary when the database is imported again after the release.

Import operation by drag & drop

New from V3.0, you can import the database by dragging and dropping.
Display the 【DataBase List Dialog】 and drag the database file to import to this screen.
The import operation is completed simply by dropping it there.
When importing a database created with a version earlier than V3.0 by this operation, the 【Database Setting Dialog】 will be displayed as well as when you perform the import operation with the 【Import Button】 and each parameter will be abe to specified there.

(4) Database backup

The GRs and Tsume Shogi GRs accumulated in the database for many years become unreadable for some reason, and the database file itself If it disappears, the impact will be great, and it is very important to back up the database as a countermeasure.

As a method of backing up the database, there is a method of backing up the database file itself.
As described in 5.1 Create database, one database basically consists of one file.
Therefore, leaving a backup of that file is relatively easy.
In addition, for recovery, the backup file can be incorporated into this system as described in (3) Import database.

Another method is to save all the GRs and Tsume Shogi GRs in the database in a ZIP file.
The advantage of this method is that it requires less disk space than the method of backing up database files and the GR that is output to ZIP file can be read by other software as well as this program.

Explain the save operation to the ZIP file.
This process is performed on the "current database".
Select 【DB To Zip File】 from the 【File (F) Menu】.
The 【ZIP File Save Dialog】 of the ZIP file is displayed.

【ZIP File Save Dialog】


Select the folder to save and enter the file name of the ZIP file.
It is not necessary to specify the extension in the file name, and "zip" is automatically added as the extension.

By click the 【Save Button】, 【Search Condition Input Dialog】 (For the Tsume Shogi database, 【Search Condition input dialog】 for Tsume Shogi) is displayed.
You can narrow down the GRs saveing to the ZIP file by specifying the search conditions.
If no condition is specified, all GRs will be saved.
Click the 【Execute button】 (which is different from the 【Search Button】) to start saving to a ZIP file.

The method of importing the GRs saved in the ZIP file to the database is as described in 5.2 (5) Batch registration of database from ZIP file.

6 Watching games

You can watch the game online.
Kifu for Flash allows you to watch online broadcasts, but this program has the merit that you can examine while watching and you can watch it by enlarging the screen.

 6.1 Watching operation
   (1) Update process
   (2) Automatic update process
   (3) Examination operation during automatic update
   (4) Examination operation by engine
   (5) Simultaneous watching of multiple relays
 6.2 History
 6.3 Watching games on the Meijinsen site
   (1) Login process
   (2) Change account

6.1 Watching operation

(1) Update process

If you want to watch the game, you need to get the URL of the GR (addres on the net).
At Kifu for Flash, click 【Save】 or 【Text version game record report】(【テキスト版棋譜速報】), the GR of the game is displayed on the browser, and the URL is displayed in the URL input field of the browser.
Use that URL.

Enter the URL of the game to be imported in 【GR URL Input Field】.
You can easily enter by cutting and pasting, or if it can be dragged, by dragging the URL and dropping it in the 【GR URL Input Field】 or 【Shogi Board Window】 rather than enter the URL directly on the keyboard in the 【GR URL Input Field】.
Next, click the 【Update Button】 to complete the import of the GR, and the immediately after import will be displayed.
However, in this case, not the game start "position",display the "current position" of the game (the last "move").

(2) Automatic update process

You can update the GR for watching the net at regular time intervals.
Click 【Auto Update Button】 to display the menu for selecting the time interval.
【Automatic Update Menu】


The selectable time intervals are as in the menu.
Clicking the 【Refresh Button】 during automatic update to display the GR at that time does not affect the time interval during automatic update.
When the automatic update is started, 【Auto Update Time Display Field】 indicates that the automatic update is in progress.

【Auto Update Time Display Field】 Display format:
  Auto updating (<update time>)
      <Update time> =: 30 s
      1 min
      3 min

An icon indicating that the "Operation Mode" is "Watching Mode" is displayed on the 【GR Selection Tab】.

【Watching Mode Icon】


Click the 【Stop Auto Update】 button to stop the automatic update process.
The automatic update process automatically stops when the game ends.

(3) Examination operation during automatic update

The "Operation Mode" during automatic update is the "Watching Mode".
The Operation in 【Watching Mode】 is no different from the operation in 【Research Mode】, but during 【Watching Mode】 You can no longer edit the GR.
Even during the Automatic updating, it is possible to create a Branch GR and study the changing procedure by moving the pieces or by selecting the "move"s in the comment field.
See 3.2 Research and generation of Branch GR . Even if the "position" is being displayed to trace back in the Root or the "position" of the Branch GR is being displayed ,when if a new "move" or comment is added by the automatic update, the 【Current Position】has been remained and displayed as is and the "position" never changes suddenly.

If the sound is set to "on" in the 【Set Sound】, you can see that a new "move" has been started by the sound.

(4) Examination operation by engine

During automatic update, you can select 【Analysis GR】/【Spot Analysis】 or 【Search Moves at Curretn Position】 from 【Analysis (A) Menu】, and the engine can be used for simultaneous parallel processing.
Please refer to 8.4 (1) (g) Analysis GR during watching games for 【Analysis GR】.
Also, for 【Search Moves at Curretn Position】, see 8.4 (2) Search "Move"s at "Current Position".

In the case Analysis GR while watching a game, an icon indicating that Analysis GR is in progress is displayed in the 【GR Selction Tab】.

【Analysis GR during watching games】


In the case【Spot Analysis】 while watching a game, character string of "Spot Analysis" is displayed on the status bar, indicating that 【Spot Analysis】 is in progress.
【Spot Analysis】


(5) Simultaneous watching of multiple broadcasts

If multiple internet relays overlap, you can watch each one at the same time.
【Shogi Board Window】 is assigned to each of them when performing watching operation.
You can watch while switching with 【GR Selection tab】.
If a new "move" is occurred to while watching the other, the background color of the 【GR Selection Tab】 changes to green to notify that the "move" has been updated.

6.2 History

Once the URL of the imported GR is saved as a URL reference history.
The URL can be selected and entered from the history.
Move the mouse cursor to 【GR URL Input Field】 and right-click to display the following 【GR URL Input Field Popup Menu】.

【GR URL Input Field Popup Menu】

When 【History】 is selected in 【Game URL Input Field Popup Menu】, 【URL Reference History Dialog】 is displayed.

【URL Reference History Dialog】


In the 【URL Reference History Dialog】, the URL of the GR that has been referenced so far is displayed in the 【URL Column】, and the game name of that game is displayed in the 【Title】.
The most recently referenced items are listed at the top, and are listed below in the order of reference.

Select the target URL from the 【URL Reference History Dialog】 by double-clicking with the mouse.
The selected URL is entered in the 【GR URL Input Field】.
Up to 100 URLs are stored in the URL Reference History.
When the number of saved items reaches 100, the oldest ones are deleted and new URLs are added to the history.
If you want to delete the history, click the URL you want to delete in the 【URL Reference History Dialog】 and select it.
Next, when the 【Delete Key】 is pressed, the selected URL is deleted from the URL Reference History.

6.3 Watching games on the Meijinsen site

With V3.6, you can now watch GRs on the Meijinsen site.
However, the Meijinsen site is a paid site, so it is necessary to register and acquire an account in advance.
The watching procedure is the same as the normal case, but the login process comes first.
The login process is only once when you import the first GR from the Meijinsen site after starting SBrowserQ.
After that, if the login is successful, this process does not occur.
When SBrowserQ is terminated and restarted, similarly, the login process always occurs at the time of the first GR import.
You can save the account of the Meijisen site, so if you save it, the login process will be automatically performed after that, so you can watch the game with the same procedure as the normal watching process.

(1) Login process

Drag and drop the URL of the GR you want to obtain from the site for the Meijinsen to the 【Shogi Board Window】 to display the following 【Meijinsen Login Dialog】.
【Meijinsen Login Dialog】

User IDEnter the user ID of the Meijinsen account.
PasswordEnter the password for the Meijinsen account.
Member siteSelect which site is used by the Meijinsen account (@Nifty/Yahoo (Note 1)/Rakuten).
Member typeSelect whether the account is 【monthly member】/【60 day member】/【7 day member】/【1 day member】.
Save User ID and Password If checked, the specified User ID and Password will be saved in SBrowserQ.
If it is saved, you will be automatically logged in and this dialog will not be displayed.
 (Note 1) V3.6 does not support login with a Yahoo account. You can use either @Nifty or Rakuten. 

Click the 【Exec】 button to execute the login process and import the specified GR.

(2) Change account

If you save the User ID and Password in SBrowserQ, you will no longer be able to see the 【Meijinsen Login Dialog】.
If you need to change your account, you won't be able to change it if you don't see this dialog.
If you drop the URL of the Meijinsen Home Page to the 【GR URL Input Field】 or 【Shogi Board Window】, the 【Meijinsen Login Dialog】 is always displayed.
If it is displayed, you can specify the changes there.
In this case, clicking the 【Exec】 button does not import the GR, but only logs in according to the changes.

7 Diagram Image Output

 7.1 Image display settings
 7.2 Image output

7.1 Image display settings

The diagram image of the 【Current position】 being displayed on the 【Shogi Board Window】 can be output or printed to a file or clipboard.
Select 【Diagram Image Output】 from the 【File (F) Menu】 to display the 【Diagram Image Output Dialog】.

【Diagram Image Output Dialog】


In this window, the output image of the 【Current position】 is displayed on the right side.
It is convenient because you can operate while checking the output image.
The setting method will be described below.

Set image size

Specify the size of the output image in pixel (dot) units.
The value specified here determines the size of the output image.
Specify the image size horizontal(【Image Size H】) and image size vertical(【Image Size V】) (It doesn't have to be square).

Set grid size

The grid size is the square size for one piece on 【Shogi Board】.
The size of the 【Shogi Board】 is determined by specifying the 【Grid Size】 (pixels).
The skeleton of the output image is almost determined by the 【Image Size】 and the 【Grid Size】.

Display items and font settings

The items displayed in the 【Diagram Image】 is explained.
In the font settings, the typeface, style, and points (size) can be set.

  With the default font setting, it may be displayed outside the grid, so in that case, select a different font.
  Especially occurs in Windows version.
Top Title Description of "position".
The contents that are set by default when this window is displayed are as follows.
   Top Title :=【the <fig> shows the starting position】...In the case of the starting "position"
   【The <fig> shows <move> at <number> moves】...In the middle of the game
   【The <fig> shows <move> at <number> moves <:end info>】...When the game ends
	<fig>:="figure"in case of Root GR	
	"change figure"in case of Branch GR
	<move>:="Current move" displayed by english notation	
	<nember>:=the number of "current move"	
        <end info>:= 【Game Over Reason】

If you want to change the expression other than the above, you can set the content in the 【Top Title Input Field】.
If the character string in the 【Top Title Input Field】 is deleted, the 【Top Title】 will not be displayed.
When you click the 【Font Button】, 【Font Dialog】 is displayed, and you can set the font of the character string of the 【Top Title】.
Bottom TitleDisplay 【Event Information】.
If you want to change it, set the contents in the 【Bottom Title Input Field】.
If the character string in the 【Bottom Title Input Field】 is deleted, the 【Bottom Title】 will not be displayed.
When you click the 【Font Button】, 【Font Dialog】 is displayed, and you can set the font of the character string of the 【Bottom Title】.
Player Name Black Display player name of black.
If you want to change it, you can set the content in the 【Black Input Field】.
If the character string in the 【Black Input Field】 is deleted, the black is not displayed.
If you click the 【Font Button】 of the Player Name, 【Font Dialog】 will be displayed, and you can set the font of the black/white.
Player Name White Display player name of white.
If you want to change it, you can set the content in the 【White Input Field】.
Also, if the character string in the 【White Input Field】 is deleted, the white will not be displayed.
If you click the 【Font Button】 of the Player Name, 【Font Dialog】 will be displayed, and you can set the font of the black/white.
Piece On BoardPieces on board.
Click 【Font Button】 to display 【Font Dialog】. You can set the font.
Piece In Hand BlackDisplay black's pieace in hand.
If there are too many pieces to display on the screen image, they can be displayed in two lines.
If you press the line feed key at an appropriate position to make it 2 lines, the screen image will change to 2 lines vertically. 3 lines and above are ignored.
If you click the 【Font Button】 of the holding pieces, 【Font Dialog】 will be displayed, and you can set the font of the Piece In hand(Black/White).
Piece In Hand WhiteDisplay white's pieces in hand.
If there are too many pieces to display on the screen image, they can be displayed in two lines.
If you press the line feed key at an appropriate position to make it 2 lines, the screen image will change to 2 lines vertically. 3 lines and above are ignored.
If you click the 【Font Button】 of the holding piece, 【Font Dialog】 will be displayed, and you can set the font of the Piece In Hand(Black/White).
Shogi Board ScaleClick the 【Font Button】 on the 【Shogi Board Scale】 to display 【Font Dialog】 You can set the scale font.
"Current Move" Click the 【Font Button】 of the 【Current Move】 to 【Font Dialog】 is displayed, and you can set the font of the 【Current Move】.

Other optional settings

There are options that can be further specified on the image display of the 【Shogi Board】.
The options will be described below.

Tsume Shogi Style Display Check to display the image of the arrangement of pieces for Tsume Shogi.
The Tsume Shogi Style Display is a format in which the player's name of black/white and the pieces in hand of white are not displayed.
Please refer to the display sample of Tsume Shogi Style below.
Display Star On Shogi Board Check to display a star (black circle) on the 【Shogi Board】.
Promoted Piece Red Display/td> Check to display the promoted piece by red color.

【Tsume Shogi Style Display sample】
Tsume Shogi Style

Each font setting and 【Image Size H】, 【Image Size V】, 【Grid Size】, 【Tsume Shogi Style Display】, 【Shogi Board Star Display】,and 【Promoted Piece Red Display】 setting will be saved.
There will be valid the next time you open the 【Diagram Image Output Dialog】 too.

7.2 Image output

File output

The Diagram Image can be output to a file according to the image format specification.
The image formats that can be specified are as follows.

	GIFSave as gif format.
	PNGSave as png format.
	JPEGSave in jpeg format.
	BMPSave in bitmap format.
	

Select the image save format in the 【Image Format Combo】.
Next, click the 【File Button】 to display the save file folder.
After selecting the save destination folder, specify the file name, and click the 【Save Button】 to save the Diagram Image in the file.
It is not necessary to specify the file extension because it is automatically added according to the image format specification.

Clipboard output

Click the 【Clipboard Button】 to output the Diagram Image to the clipboard.

Print

Click the 【Print Button】 to print the Diagram Image.
【Print Preview Window】 is displayed.

【Print preview Window】


Click 【Print Menu】 and select 【Print】. When the 【Print Dialog】 is displayed, select the printer and set the number of copies and click the 【Print Button】 to start printing.

Click 【Print Menu】 and select 【Page Setup】.
The 【Page Setup Dialog】 is displayed, and you can specify the paper size, paper feed method, margin settings, etc.

Click 【Print Menu】 and select 【Margin Display】.
A rectangular frame indicating the print range is displayed as a dashed line in the 【Print Preview Window】.
If you select 【Display Margin Frame】 again, this frame will disappear.

Print can be enlarged or reduced with respect to the current size.
From the 【Scaling Menu】, select the ratio to the current size from the menu.
The selectable ratios are as follows.

50%/70%/80%/90%/100%/110%/120%/130%/150%

8 Use of computer shogi engine


This program does not have its own computer shogi engine.
Freely provided Bonanza or USI protocol compatible shogi engines, by installing, it is possible to play a game between a computer and a human or between computers.
SBrowserQ supports two forms: a local game that plays in a closed form in this program, and a net game that plays against other shogi software and humans via the network.

In addition to the game, you can also use the engine for research.

 8.1 Installing Shogi engine
   (1) Engine registration
   (2) Change engine registration details
   (3) Delete engine registration
   (4) Other setting options
 8.2 Local game
   (1) New game
     (a) Game operation
     (b) Game time and "turn" display
     (c) On/Off operation of "countdown" alarm sound
     (d) Engine Monitor and display
     (e) Engine Monitor operation
     (f) Saving Engine Monitor data
   (2) Resume suspended game
   (3) Continuation game from the "current position"
 8.3 Net game
   (1) Preparation for connection
   (2) Login
   (3) Play with standard protocol
   (4) Play with extended protocol
     (a) Game waiting registration
     (b) Canceling game waiting registration
     (c) Challenge
     (d) Operations during "Repeated game"
     (e) Watching games
     (f) Game operation and end
     (g) Others
 8.4 Research by engine
   (1) GR analysis
     (a) Start GR analysis
     (b) "Position" update during GR analysis
     (c) End of GR analysis
     (d) Target GR of GR analysis and marking it
     (e) GR analysis from the "current position"
     (f) Save GR analysis results
     (g) GR analysis during watching games
     (h) Operation of the GR Analysis Monitor
     (i) About engine in GR analysis
   (2) Spot Analysis
     (a) Start "Spot Analysis"
     (b) End of "Spot Analysis"
     (c) Analysis time on "Spot Analysis"
     (d) Reanalysis of already analyzed "position"
   (3) Search "move"s at "current position"
 8.5 Note when running a shogi engine

8.1 Installing Shogi engine

Explain how to install shogi engine.
First, it is necessary to download and install the engine to be embedded from each site. (See the engine's documentation for how to install it).
Next, start SbrowserQ and select 【Shogi Engine】 from the 【Extensions (X) Menu】.
【Shogi Engine Dialog】 is displayed.

【Shogi Engine Dialog】


(1) Engine registration

The engine is installed by the additional processing of this dialog.
The method will be described.
Click 【Add Button】 in the 【Shogi Engine Dialog】.
The 【Add Shogi Engine Dialog】 is displayed.

【Add Shogi Engine Dialog】


Engine File PathSpecify the engine execution file path name. (Required)
Startup ParametersSome engines require start-up parameters and specify them in that case.
If the engine is Bonanza, specify "csa_shogi".
Environment VariableSome engines refer to environment variable and specify them in that case.
If the engine is GPS shogi, refer to the value of the environment variable "OSL_HOME".
When installing using the installer on Windows, environment variables are set automatically, no need to specify.
When manually installing on Linux or MacOsx, set the environment variable here.
ProtocolSpecify the engine protocol.
Select either "USI"/"Bonanza"/GPSfish.(Required)
If the engine is Bonanza, specify "Bonanza", and if the engine supports the USI protocol, specify "USI".
When incorporating the GPSfish engine in GPS shogi, specify "GPSfish".

Engine Shutdown ConditionSpecify the condition when the engine process ends.
Select either "Game Over" or "System Shutdown". (Required)
If you specify "Game Over", the process will end when the engine finishes playing.
If "System Shutdown" is specified, the engine process will not be terminated until this program (SBrowserQ) is terminated.
When playing a game repeatedly, it may take time and stress if the process is started and ended for each game.
In that case, it is recommended to set to "System Shutdown".
Save OptionsSpecify where to save engine options. (Required)
If you select "Save by GUI", it is saved on the GUI side, that is, this program.
If you select "Save by engine", it will be saved on the engine side.
In case of Bonanza or GPSfish engine, there is basically no function to save on the engine side, so select "GUI by save".
If the engine supports USI protocol, select "Save by engine" because the engine has a save function.
However, selecting GUI save does not affect the operation.

After making these settings, click the 【Add Button】 to complete the engine installation.

Engine registration by drag & drop

Drag the executable file of the engine whose installation has been completed with the mouse and drop it on the 【Shogi Engine Dialog】 to automatically The engine can be incorporated into the SBrowserQ without deciding the protocol and performing the troublesome setting work.

Most engines have confirmed that this method can be used for embedding, but if you cannot embed it properly, such as when you need to set environment variables, you can reembed by returning to the original method.

When the engine is installed by drag & drop, the engine termination condition is set to "System Shutdown" and the option is set to "Save by GUI".

(2) Change engine registration details

Change registration details

If you want to change the registered engine settings, select the engine you want to change from the list in the 【Shogi Engine Dialog】.
Click with the mouse to select.
Next, click the 【Update Button】 to display the 【Update Shogi Engine Dialog】.
Therefore, the value of the already set item can be changed.
Most of the time the items to be changed are about engine termination conditions.

Change Engine Title

The Engine Title can be changed in the 【Shogi Engine Dialog】.
The title of the engine have been displayed that was automatically obtained from the engine when the engine was registered (Note).
The engine title is identification information for selecting an engine when playing a game.
Double-click the 【Engine title】 part to be changed with the mouse.
The title can be edited.



(Note) Depending on the engine, the automatically acquired name may be very long, so if you use it as is, 
when the GR of that engine will be registerd in the database, the player name 
(the engine title becomes the player name) exceeds the length of the field, resulting in an error will be.
Therefore, it is advisable to change the engine title short (80 characters or less) here. 

Change engine display order

The display order of the engine list can be changed in the 【Shogi Engine Dialog】.
Select the engine you want to change with the mouse, drag it to a new display position, and release the mouse to complete the change of the display position.
The engine display order in the 【Shogi Engine Dialog】 list is the same as the list display order in the 【Engine Selection Combo】 in the 【Game Dialog】.

(3) Delete engine registration

To delete a registered engine, select the engine to be deleted from the list in the 【Shogi Engine Dialog】
Click the 【Delete Button】.
The engine registration will be canceled.

(4) Other setting options

Set Timeout Value

Set the Timeout Value in the 【Shogi Engine Dialog】.
Specify the number of seconds for the timeout value.
If there is no response from the engine even after the specified number of seconds has elapsed, the processing is interrupted at that point.
Initial default value is 30 seconds

Display Shogi Engine Monitor

In the 【Shogi Engine Dialog】, specify whether or not to display the 【Shogi Engine Monitor】 in the lower window of the 【Shogi Board】 when playing an engine.
The engine monitor displays the "thinking process" informatione from the engine, other information, and a graph of the evaluation value.

8.2 Local game

(1) New game

Engine-to-engine, human-to-engine and human-to-human games can be played.
To play a game,select 【New Game】 from 【Game (B) Menu】.
The 【Game Dialog】 is displayed.

【Game Dialog】


TitleEnter the title of this game.
Specification is optional.
EventEnter the event of this game.
Specification is optional.
HandicapSpecify the Handicap.
The Handicap that can be specified is
"Non-Handicap"/"Lance drops/"Right Lance drops"/"Bishop drops"/"Rook drops"/"Rook &Lance drops/" "Two pieces drops"/"Four pieces drops"/"Six pieces drops"/"Eight pieces drops"/"Ten pieces drops".
The player who is "uwate" (the one who drops the piece) is allways the "black turn".
BlackSelection of the "black turn"(or "shitate") player of this game.
If you select a person, enter the name of the player.
If you select an engine, select an engine from the 【Engine Selection Combo】.
Black - Time ConditionSpecify "Black" (or "Shitate") holding time in minutes.
Black - Countdown/Additional Time When the display of this button is "Countdown", it is possible to specify the number of seconds for the countdown after the "black" (or "shitate") has run out of time.
Also, if you click this button in it's state ("Countdown" displayed), The button display changes to "Additional Time".
In this case, it is possible to play by the "Fisher rule", and you can specify the Addtional Time in seconds that will be added to Time Condition on the "black" (or "shitate") every each "move" .
This button can change its display with each click.
Black - Options (Note)When an engine is selected as a "black" (or a "shitate") player, set options for that engine.
Click 【Option Button】, the option setting dialog is displayed.
There is no need to set it if the default is acceptable.
Options vary from engine to engine, For the contents, refer to the description (if any) of the installed engine.
WhiteSelection of the "white turn" (or "uwate") player of this game.
If you select a person, enter the name of the player.
If you select an engine, select an engine from the 【Engine Selection Combo】.
White - Time ConditionSpecify "white" (or "uwate move") holding time in minutes.
White - Countdown/Additional Time When the display of this button is "Countdown", it is possible to specify the number of seconds for the countdown after the "White" (or "Uwate") player has run out of time.
Also, if you click this button in it's state ("Countdown" displayed), The button display changes to "Additional Time".
In this case, it is possible to play by the "Fisher rule", and you can specify the Addtional Time in seconds that will be added to Time Condition on the "white" (or "uwate") every each "move" .
This button can change its display with each click.
White - Options (Note)When an engine is selected as a "white" (or a "uwate") player, set options for that engine.
Click 【Option Button】, the option setting dialog is displayed.
There is no need to set it if the default is acceptable.
Options vary from engine to engine, For the contents, refer to the description (if any) of the installed engine.

      

(Note)About engine option settings

The options for shogi engines differ from engine to engine, so the setting dialogs also differ. Here, as an example, the option setting dialogs for Bonanza and GPS are shown. 【For Bonanza】 For each item, see readme.txt file in sikou_dll folder of Bonanza and refer to it. Select the reference item in the opening database from "book off"/"book_on_narrow"/"book_on_wide". Here "book_on_narrow" means "book on" and "book narrow". "book_on_wide" is "book on" and "book wide". 【For USI (sample Yaneuraou)】 In the case of USI engine, there are options common to USI in addition to engine-specific options. USI common options This program currently supports only two options: USI_Ponder option (*1) for predictive reading and USI_Hash option for hash area size. If you check predictive reading, predicts opponent's "move" at opponent's "turn" and continues thinking. The hash area size sets the size of the hash table used by the engine, and the unit is MB. Engine specific options vary from engine to engine, so please refer to the documentation for each engine for the explanation.
(*1) Depending on the shogi engine, the USI_Ponder option may be invalid, and predictive reading is always performed. There is a case where you do not want to make CPU load too large by predictive reading when you enjoy playing games locally between engines. Considering that point, if you uncheck 【USI_Ponder】, the GUI side does not send an instruction ("go ponder") to start predictive reading to the engine,resulting in no predictive reading.

After making these settings and clicking the 【Game Start Button】, the game starts.
When the game starts, the "Operation Mode" changes to the "Game Mode", and the icon indicating the "Game Mode" is displayed on the 【GR Selection Tab】.
【Shogi Board Window】 is newly created and the starting "position" of the game is displayed.

If you click the 【Swap Black and White Button】 before the game starts, you can completely replace the black and white.

【Start screen of new game】


Below the 【Player Name】, the game time information such as the black and white, Consumption Time/Remaining Time/Countdown, etc. is displayed.
When the Shogi Engine Monitor is checked in the 【Shogi Engine Dialog】, the Shogi Engine Monitor is displayed in the 【Shogi Board Lower Window】

(a) Game operation

The movement method of the piece when the "turn" is human is the same as in the "Research Mode" and the "Edit Mode".
Also, while playing, you cannot go back or forward to your previous "move".
In the 【Move List】 column, the "move"s of the game are displayed in order.
Again, you can't go back to that "position" by selecting your "move".
If the player is an engine, the piece cannot be moved by operating the mouse.

Resign

If the player is a human and want to resign the game , select 【Resign】 from the 【Game (B) Menu】.
The game ends, and the operation mode switches to the "Research Mode".

Suspend

To suspend the game, select 【Suspend】 from the 【Game (B) Menu】.
The game is interrupted and the operation mode switches to "Research mode".
When you select 【Resume Interrupted Game】 in 【Game (B) menu】, you can resume from the suspended "position".

Retract

If the player is human and wants to retract th "move", select 【Retract】 from the 【Game (B) Menu】.
"Retract" can be instructed by a human at it is his "turn".
If you retract, it will return to the "position" two steps before and it will be human's "turn".
The consumption time also returns.

Hurry Up

If you can't wait for the engine's response ("move"), select 【Hurry up】 in 【Game (B) Menu】, you can let the computer stop thinking and notify you of the "move" at that point.

Pause

To pause the game, select 【Pause】 from the 【Game (B) Menu】.
If you select 【Resume】 in 【Game (B) Menu】, the game continues and restarts.
While paused, an icon indicating that the game is paused is displayed on the 【GR Selection Tab】.

【Pause icon】


In this state, the reseach operation can be performed as in the case of the "Research Mode".
If you click the engine 【Thinking Process】 displayed on the engine monitor, it can be displayed as the Branch GR.

(b) Game time and "turn" display

Display the playing time information for each of the black and white players under the 【Player Name】 display field. There are three types of display methods for the elapsed time during a game: "Consumptiontime", "Remaining time", and "Countdown". The display of "Consumption time" and "Remaining time" can be switched by an operation during a game as appropriate.
When the Consumption time is exhausted and the countdown process is started, the "Countdown" is automatically displayed. In the case of "Countdown", the time displays the remaining seconds.

In order to indicate which is the "current turn", the "turn" display icon (when display time type is "Consumption time"and when it's "Remaining time" or "Countdown" )will be displayed.

Game time information display format: = <turn><display time type><time>
<turn>:=the "turn" display icon that indicating holding "current turn". Empty if there is no "turn".
<display time type>:= Either "Consumption time"/"Remaining time"/"Countdown".
<time>:=Display the time in hours, minutes and seconds according to . 
In case of "Countdown", <time> is only "second".

Display time switching operation

To switch the display time, click the right mouse button in the 【Game Time Display Field】 of either the black or the white.
Display the popup menu for switching the display time.

If the current display is "Consumption time"


Click 【Display Remaining Time】 with the mouse to display the remaining time.
If the current display is "remaining time"


If you click 【Display Consumption Time】 with the mouse, the time will be displayed as consumption time.

When the switching operation is performed, both the black and the white are switched.
However, it does not switch when the "Countdown" is displayed.

(c) On/Off operation of countdown alarm sound

You can switch whether or not to generate an alarm sound during countdown.
If the alarm sound is currently generated and you want to stop it, select the 【Turn off alarm】 menu from the display time switching Popup menu.
The alarm sound will no longer occur.
Conversely, if you want to generate an alarm sound, select the 【Turn on alarm】 menu from the display time switching Popup menu.
After that, an alarm sound will be generated during the countdown.

(d) Engine monitor and display

If you specify to display the engine monitor in the 【Shogi Engine Dialog】, the 【Engine Monitor】 will be additionally displayed as a tab window in 【Shogi Board Lower Window】 when playing games.

There are two types of engine monitors: 【Thinking Process Information】 that displays Thinking Process from the engine and the like, and 【Score Graph】 that displays changes in evaluation values ​​in a graph.
In the case of engine-to-engine game, each 【Thinking Process information】 is divided into left and right in the tab window and displayed.
Below that, a score graph that combines the "white move" and the "black move" is displayed.

【Engine Monitor】

 

【Thinking Process Information】 displays information such as Thinking Process from the engine during a game.
The information from the engine is different for Bonanza and USI engines, but will be displayed in almost the same format.
GPSFish has the same display format as USI.
Hereinafter, when it is describing as the "USI" case, it is included as the "Gpsfish" case too.
【Score graph】 is a graph showing the evaluation of the "move" notified from the engine.
The display contents will be described below.

In the case of the engine is Bonanza, the 【Thinking Process Information】 is explained.

【"Thinking Process" Information for Bonanza】


① 【Shogi Engine Option Display Button】

Click this button if you want to change engine options while playing.
Same as when you click the option button on the 【Game Dialog】 【Shogi Engine Option Dialog】 is displayed.

② 【Engine Information Panel】

 Show engine "turn" and distinguished names at the beginning.
The consumption time, CPU usage rate, NPS and hash usage rate notified by the engine are displayed.
When click this panel with the mouse, the display of this information become small.
Click it again to return.

③ 【Engine Thinking Process Display Column】

  Here, the Thinking Process notified from the engine and other character string information are displayed.
   【MC】:"Move Count" of thinking process information
   【Score】: Evaluation value. Displayed is 100 times (*) the evaluation value notified from Bonanza.
   【P】:If the character "P" is displayed, it means that it is a predictive thinking process.
   Display "-" when the thinking process in my "turn".
   【M】:If "◎" is displayed, it indicates that the information is representative of the thinking process
   and evaluation value of the "move".
   The evaluation value notified here is displayed as the value of the evaluation value graph.
   【Thinking Process and other character information】:
  Displays the thinking process and other character information notified by the engine.

  (Note) In order to adjust the evaluation values ​​of Bonanza and USI to almost the same scale, 
         it is displayed 100 times.

If the engine is USI, the 【Thinking Process Information】 is explained.

【Thinking Process Information for USI】


① 【Shogi Engine Option Display Button】

Click this button if you want to change engine options while playing.
Same as when you click the option button on the 【Game Dialog】 【Shogi Engine Option Dialog】 is displayed.
However, with the USI engine, there are almost no items that can be set during a game.
It is only to check the setting contents of the option.

② 【Engine Information Ppanel】

 Show engine "turn" and distinguished names at the beginning.
Infomations (the predictive move, the current research move, the depth, the number of nodes, NPS and hash usage rate) notified from the engine is displayed.
Click this panel with the mouse.
The display of this information become small.
Click it again to return.
The predictive move is displayed when the 【USI_ponder】 is set in the 【Shogi Engine Option Dialog】.
However whether it is displayed depends on the engine.

③ 【Engine Thinking Process Display Column】

  Here, the Thinking Process notified from the engine and other character string information are displayed.
   【MC】:"Move Count" of thinking process information
   【Score】:Evaluation value. Displays the evaluation value (Note) notified from the USI engine.
   【Time】:Time spent thinking process on the engine side. The unit is millisecond.
   【Depth】:Displays the thinking process depth level.
   【P】:If the character "P" is displayed, it means that it is a predictive thinking process.
   Display "-" when the thinking process in my "turn".
   【M】:If "◎" is displayed,it indicates that the information is representative of the thinking process.
   and evaluation value of the "move".
   The evaluation value notified here is displayed as the value of the evaluation value graph.
   【Thinking Process and other character information】:
  Displays the thinking process and other character information notified by the engine.

  (Note)  As for the evaluation value of USI, if the own engine is superior, a positive value is notified,
  and if it is inferior, a negative value is notified.
  To unify the display, change the display to a positive value if the black is dominant, 
 and change it to a negative value if the white is dominant.

The display contents of the score graph will be explained.

【Score Graph】



The 【Score Graph】 is a bar graph showing the evaluation value of the "move" from the engine.
The horizontal axis is the number of "move", and the vertical axis is the evaluation value.
As for the evaluation value, a positive value represents the black superiority, and a negative value represents the white superiority.
The evaluation value of the Black engine is shown by a black bar, and the evaluation value of the white engine is shown by a white bar.

If'*' is displayed on the center line (line where the evaluation value is 0), it means that the engine has not notified the evaluation value.
If the player is a human, all are displayed as'*'.

When you move the mouse into the score graph, a 【Cursor】 (blue vertical line) is displayed on the bar graph at the mouse position.
The evaluation value is displayed numerically above the 【Cursor】.
【Current Position Cursor】 (red vertical line) is not displayed during a game, but indicates the "current position" displayed on the shogi board when the game ends (operation mode is in "Research Mode") or when the game is paused.

The maximum vertical axis evaluation value is 1500 by default.
When the evaluation value exceeding that is notified, it cannot be displayed in the graph.
When it is desired to display more evaluation values ​​in the graph, change the maximum displayable evaluation value.
To change, click the right mouse button on the 【Score Graph】 and display 【Score Graph Popup Menu】.
Select 【Score Graph Settings】 to display the 【Score Graph Settings Dialog】.

【Score Graph Setting Dialog】


Change the maximum evaluation value that can be displayed here and press the 【Exec Button】 to complete the change.
The minimum range is 100 and the maximum range is 33000.

【Scale Adjustment Slider】 is for adjusting the maximum scale on the vertical axis (evaluation value).
Moving the slider up increases the maximum scale, and moving it down decreases it.
The maximum scale is within the maximum evaluation value set in the 【Score Graph Setting Dialog】.

(e) Engine Monitor operation

① Display switching operation

【Thinking Process Information】 and 【Score Graph】 are initially divided and displayed in one tab.
You can switch to the display of only 【Thinking Process Information】 or only 【Score Graph】.

Click the right mouse button on 【Thinking Process Information】 or 【Score Graph】.
A popup menu is displayed.

【Thinking Process Information Popup Menu】


【Score Graph Popup Menu】


The popup menu is different for each, but select the display method here.

【Display Vertically】: Display the 【Thinking Process Information】 on the black and white 
in the vertical direction.
If you arrange them in the up-down direction, you cannot display all of them
in the 【Shogi Board Lower Window】,
it is better to increase the window size vertically (manually).
【Display only Thinking Process】:
Delete 【Score Graph】 and display only 【Thinking Process Information】 in the tab.
【Display only Score Graph】:
Delete 【Thinking Process Information】 and display only 【Score Graph】 in the tab.

② Generation of Branch GR from the thinking process

When the operation mode is "Research Mode" or be paused in "Game Mode", double-click the 【Thinking Process and other character infomation】 item in 【Thinking Process Information】 to generate an Branch GR.
Please refer to 3.2 Research and generation of Branch GR for generation of Branch GR.
When the operation mode is "Research Mode" or be paused in "Game Mode", the 【Thinking Process and other character information】 item is displayed in blue to indicate that it is selectable.
After Double-click it to generate a Branch GR, it will be displayed in red.
It's line in red indicates that the Branch GR has already been generated.
Double-clicking does not generate the Branch GR.
By generating the Branch GR, you can check "Thinking Process" of the engine at the shogi board.
As an example, the state of the screen when double-clicking the thinking process at the time of pause is shown.

【Pause state】

If you double-click on 【Thinking Process and other character infomation】 line here, its contents will be displayed as a Branch GR.


Double-click the mouse to return to the Root.


The 【Thinking Process and other character infomation】 line that generated the Branch GR is displayed in red.

If you want to generate a Branch GR at once after selecting multiple thinking proces, click the right mouse button on 【Thinking Process Information】, Thinking Process Information Popup Menu is displayed.
If you select 【Branch GR Generation】, all selected thinking process lines will be added as Branch GRs.
Same as when it is selected alone,those already added as Branch GRs (displayed in red) are not added To cancel multiple selections, select this menu 【Deselect】.
All previous selections will be cancelled.

③ "Position" movement operation with score graph

When the "Operation Mode" is in "Research Mode" or be paused in "Game Mode", double-click the mouse at the 【Cursor】 position on the 【Score Graph】 to move the position to that cursor position.
You can also move the front and the back position by rotating the 【Wheel Button】 of the mouse.
These operations cannot be performed during a game.

④ 【Engine Monitor】 window display

The 【Engine Monitor】 can be displayed as a single window.
Select 【Window Display】 at 【Thinking Process Information Popup Menu or 【Score Graph Popup Menu】 The 【Engine Monitor】 tab is deleted from the 【Shogi Board Lower Window】 and the 【Engine Monitor Window】 is displayed.
【Engine Monitor Window】


The above example is an engine-to-engine game where each 【Thinking Process Information】 is displayed above and below.
Like in the tab window, it can be displayed left and right.
Click the right mouse button on 【Thinking Process Information】 in this 【Engine Monitor Window】 to display the popup menu.

【Engine Monitor Window Popup Menu】


If you select 【Display Horizontally】 here, 【Thinking Process Information】 will be displayed on the left and right in the window.
To close this window and display it as a tab under the original 【Shogi Board Window】, select 【Close Window】.

(f) Saving Engine Monitor data

Engine Monitor data is saved as a comment in the GR file.
What is saved is the main thinking process (the 【M】 part of the 【Thinking Process Information】 of 【Engin Monitor】 is ◎) and the evaluation value of the thinking process.
Therefore, when this GR file is read by another shogi software, the evaluation value and the main thinking processe are displayed in the comment information.
When it is read by SBrowserQ, it is expanded and displayed in the form of 【Thinking Process Information】 and 【Score Graph】 on the 【Enginee Monitor】 instead of 【Comment Board】.

【Display 【Engine Monitor】 when importing GR】

The 【Thinking Process Information】 shows the 【MC】 ,【Score】 and the 【Thinking Process and other character information】 of the main thinking process, but other information is not stored in the GR, so it is not displayed on the 【Engine Monitor】 when the GR is imported.
The 【Score Graph】 is displayed as it is when playing the game.

(2) Resume suspended game

The game can be restarted from the suspended "position" for the GR that was suspended.
The suspended GR means that there is no 【Game Over Resaon】 at the end of the Root GR or 【Game Over Resaon】 is set "Suspend".
The game cannot be restarted for other GRs.

When you select 【Resume Suspended Game】 in 【Game (B) Menu】, the 【Game Dialog】 is displayed.

【Game Dialog】 for resume suspended game

For the player, the player of the Root GR is displayed as it is.
Here, the 【Time Condition】 and 【Countdown】 (【Additional Time】) information of the black and the white are set.
Also, if necessary, you can switch the black and the white with the 【Swap Black & White Button】, The player itself can be changed, but in that case the player of the Root GR will change, so be careful.
The setting of each item is the same as the specification method in the 【Game Dialog】 when a new game is played.

Click the 【Game Start Button】 to resume playing the suspended game.

(3) Continuation game from the "current position"

You can continue playing games from any "position".
Resume Suspended Game】 is only restarted from the point at which the root GR was suspended, and 【Start Game from Current Position】 is starting game from any "position" of the Root GR or the Branch GR.
In this case, the generated GR is added as a Branch GR to the Root GR or the Branch GR.
The main purpose of this function is to use the engine to research the GR that have already been played.

If you select 【Start Game from Current Position】 of 【Game (B) Menu】 after displaying the 【Current Position】 to start continuous game, the 【Game Dialog】 similar to resuming suspended game is displayed
Unlike the restart of the suspended game, the player in the 【Game Dialog】 does not display the player name of the Root GR as it is, and Moreover, even if the player is changed to an engine or the like, the player of the Root GR does not change.

Here, if you change the 【Black - Player】 or 【White - Player】 to an engine and start the game, the continuous game is executed by the engine.
If the player is a human being and continues the game, there is no big difference from the usual research operation.
To end this continuation game halfway, select the 【Suspend】 in 【Game (B) Menu】.
Continuation game ends.

If continuation game is playing with the engine, the 【Engine Monitor】 will be displayed in the 【Shogi Board Lower Window】 same as at the 【New Game】.
In that case, the 【Thinking Process Information】 and the 【Score Graph】 after the number of steps for starting the continuous game are displayed.


8.3 Net game

Net game is a game mode where you play games with other computer shogi or humans connected to the server on the net via the network.

SBrowserQ can connect to a server that supports Computer Shogi Association CSA server communication protocol (Note 1) Shogi-server (Note 2) is an example.
The shogi-server supports Computer Shogi Association CSA server communication protocol as a standard protocol, It is also possible to connect with an extended protocol that extends it.
SBrowserQ supports both standard and extended protocols.

About the difference between standard protocol and extended protocol

The standard protocol is a protocol that immediately waits for a game after logging in to the server, or starts a game immediately if a game partner exists.
In addition, the game will be played with the time condition defined in advance by the server.
You cannot specify the time condition. Depending on the server, you will be disconnected immediately after the game ends.
On the other hand, in the extended protocol, after logging in, there is no immediate waiting for a game, various operations (display of login user list, challenge to play, instruction to wait for game, watching game, etc.) are enabled.
You can specify the time condition.
After the game is over, the state has been after logging in again, various operations are possible.

   (Note 1) CSA server communication protocol: See http://www2.computer-shogi.org/protocol/
   (Note 2) shogi-server: See https://shogi-server.osdn.jp/

(1) Preparation for connection

To connect to the server, preparation for connection is required.
In SBrowserQ, it is troublesome to set the necessary parameters each time you connect to the server, so we are taking a method to set it for each serverin advance.
The method of setting the necessary connection parameters will be described.

Select 【Network Game】 from the 【Extensions (X) Menu】.
【Network Game Dialog】 is displayed.

【Network Game Dialog】


Server registration

First, register a new server to connect to.
Click the 【Add Button】 in the 【Network Game Dialog】.
The 【Add Network Game Server Dialog】 is displayed.



Here, set the necessary connection parameters for each server.

Server TitleName given to the connecting server.
It must have a unique name so that it will not be duplicated.
(Required)
HostAddress of the server to connect to. (IP address or host name)
(Required)
Port NumberPort number of the server for TCP/IP connection. 4081 is the default.
(Required)
User NameUser ID on Connection Server.
With shogi-server, there is no user management on the server, so you may decide appropriately.
You can specify up to 32 alphanumeric characters and symbols ('@'.'_,'-').
(Required)
PasswordPassword on Connection Server.
With shogi-server, there is no user management on the server, so you may decide appropriately.
Up to 32 characters.
(Required)
ProtocolSelect 【Standard Protocol】 to connect to the server using the standard protocol.
Select 【Extended Protocol】 to connect to the server using the extended protocol.

When you set each parameter and click the 【Add Button】, a new server connection setting is added and displayed as a list in the 【Network Game Dialog】.

Change connection parameters

If you want to change the connection parameters once set, select the server you want to change from the list in the 【Network Game Dialog】 (click the line with the mouse), and then click the 【Update Button】.
The 【Update Network Game Server Dialog】 (same as 【Add Network Game Server Dialog】) is displayed.
Change the connection parameters here and click the 【UPdate Button】.
The changes have been completed, and the changes have been made in the list in the 【Network Game Dialog】 is displayed.(User Name and Password are not displayed)

Delete added server

To delete the setting of the newly added server, select the server to delete from the list in the 【Network Game Dialog】 (click the line with the mouse), and click the 【Delete Button】.
Select 【Yes】 in the deletion confirmation dialog to execute the deletion.
It is also deleted from the list in the 【Network Game Dialog】.

Server display order

You can change the display order of the list in the 【Network Game Dialog】.
Press the right mouse button at the position (row) of the server you want to change.
Just drag it and stop dragging at the position you want to move.
After the move is completed, the list is displayed in this order. The display order here is the display order of the server list in the 【Server Selection Combo】 used when selecting the connection server in the 【Login Dialog】.

Select player name

The player name displayed on the GR or screen will be the engine name in the case of a local game or the name set for a human, but in the case of a net game, you can specify as the player name for the user name of the connection server.
Since the player name of the GR generated by the server is the User Name, this is specified when you want that the same.
For the specification method, check 【The login User Name is used as the Player Name】 in the 【Network Game Dialog】.
If unchecked, the player name will be the same as the local player name.
This specification applies to all servers.

Show/hide 【Engine Monitor】 when watching games

If you connect to the server with the extended protocol, you can watch other arbitrary games.
At that time, it is possible to specify whether to display the 【Engine Monitor】.
If you check 【Do not show Shogi Engine Monitor when watching games】 in 【Network Game Dialog】, the 【Engine Monitor】 will not be displayed when watching games.
If unchecked, the engine monitor will be displayed.
This specification applies to all servers.

(2) Login

To start the game, first log in to the server.
Different when connecting to the server using the standard protocol and when using the extended protocol.
If you connect using the standard protocol, you will immediately wait for the game once you have logged in.
Alternatively, if there is already a partner who matches the game condition in the server, the game starts immediately.
Therefore, it is necessary to assign (Note) and set the local players at the time of login.

(Note)   Note that when assigning a player to the local side, it cannot be assigned if another player is playing
(local game or "move" search).In SbrowserQ, only one game is allowed at a time.

If you connect using the extended protocol, you will not be the state of wait for a game even after you have logged in, and you will be able to perform various operations (game challenge, game waiting instruction, game watching, etc.).
Therefore, it is not necessary to assign a player when logging in.

Explain the login operation according to each case.

If you add a new server setting in the 【Network Game Dialog】, 【Login】 will be displayed as a selection item in the 【Game (B) Menu】.

When you select 【Login】, the 【Login Dialog】 is displayed.
The 【Login Dialog】 differs depending on whether the standard protocol is used or the extended protocol is used, as specified by the server setting parameters.

【Login Dialog when connecting standard protocol】


This dialog is for when a server with standard protocol connection is selected in 【Server Selection Combo】 and a human is selected as the player.
Enter 【Local Player Name】 and click the 【Login Button】 to start login

【Login Dialog when connecting standard protocol】


This dialog is for when a server with standard protocol connection is selected in 【Server Selection Combo】 and an engine is selected as the player.
Select an engine in the 【Local Player】 field, and set options if necessary.
The operation around here is the same as when playing locally.

【Scramble】 is a parameter that was not used when playing game locally.
This is a mechanism to force let notify the engine the "move" immediately before the time out in order to prevent to lose to game caused by time.
Prompt the engine to perform "move" notification before the specified time (milliseconds) before the time expires (send "stop" command for USI (GPSFish) protocol, send "s" command for Bonanza).
You can specify the time in milliseconds.
If you specify 0, this reminder is not performed.

scramble

Since there is an error in the time measurement between the server side and the local PC side (processing time on GUI side or time to notify server of difference via line) in the game with the countdown setting, there are many cases that the time out. As a means to prevent it,if you do not notify the "move" response to the server at the just before time of time out but notify it with a little give time, you can prevent the time out to some extent. However, since the GUI forcibly sends a stop command to the engine and interrupts, the engine may not necessarily notify the optimal "move" at that time. If you still think it's better than running out of time, It is better to make this setting. In the internal test, it was possible to avoid the time out by setting 400ms to 500ms. Since the setting value of the scramble time is affected by the line condition and the processing capacity of the PC, there is no choice but to empirically find the setting value according to each. With CSA server communication protocol 1.2 or later, Delay (delay time) can be specified as a time parameter. In game conditions,if this is specified (it depends on the server),this is a good way to prevent time-outs, and it is not necessary to set the scramble time here.
Set these and click the 【Login Button】 to start login.

【Login Dialog for extended protocol connection】


This dialog is for selecting a server for extended protocol connection in 【Server Selection Combo】.
Since it is not necessary to assign a player at the time of login for extended protocol connection, clicking the 【Login Button】 on this screen will start login.

(3) Play with standard protocol

Waiting for game

After logging in to the server using the standard protocol, if there are no opponents or if there are no opponents that match the conditions, the game will wait.
The status is displayed on the 【Network Game Status Button】 on the status bar.

【Network Satus Button】


When you click the 【Network Game Status Button】, the 【Game Waiting Information】 is displayed.

【Game Waiting Information】


In this state, you can perform general operations within SbrowserQ, except for "local game" or "move exploration".
This state continues until the server finds a game partner.
To cancel the network game while waiting for the game, select 【Logout】 from the 【Game (B) Menu】.
The connection with the server is cut off, and the waiting state for the network game is canceled.

Playing game

When an opponent is found and the start of the game is notified from the server, one tab is added and the board is displayed.
The "Operation Mode" changes to "Game Mode".

【After the game starts】


The board after playing the game is the same as when playing locally.
However, the display of the 【Network Game Status Button】 on the status bar will be changed from "Waiting Game" to "Playing".
Click this button to display various information about network games.

【Network Game Information】


Unlike a local game, you cannot perform operations such as "Suspend"/"Retract"/"Hurry Up"/"Pause" while playing network game.
If the local player is a human being, he can only perform the "Resign" operation in addition to "move" operations.
If you forcibly close the playing tab with , the connection with the server will be disconnected and the playing will be interrupted.
In this case, the person who forcibly suspends will lose. (The server considers that the side that forced the suspension has resigned)

(4) Play with extended protocol

In the extended protocol, after the login is completed, the game is not immediately waiting for a game, but enters the "Login" state.
【Login Status】 is displayed on the 【Network Game Status Button】.
The 【Network Game Operation Board】 is displayed in the 【Shogi Board Lower Window】, and various operations can be performed here.

The following screen shows the situation.

【Screen immediately after login with extended protocol】


When playing with the extended protocol, you are in the "Login" state.

The operation of can be performed on the 【Network Game Operation Board】.

【Network Game Operation Board】


Explain each part of 【Network Game Operation Board】

①Server

Displays the name of the server currently connected.

②List Selection Combo

Select the list to display with this combo box.
When you select a list, its contents are displayed in the 【List Display Area】.

③ Update Button

Click the refresh button to update the list currently displayed

④ Number of list lines

Display the maximum number of lines in the list currently displayed.

⑤ Game Registration Button

Click this button to register for game waiting. 【Game Registration Dialog】 is displayed.

⑥List Display Area

The list selected by the list selection combo is displayed in this area.

⑦ Chat

When chatting, enter the character string to be notified here.

⑧ Send Button

Click this button to send the chat string to the server.
The chat string is also sent with the line feed key.

⑨Chat Display Area

The content of the chat is displayed here.

(a) Game waiting registration

When connecting with the extended protocol, in order to enter the "Waiting Game" state, it is necessary to register for waiting for the game in the "Logged in" state after login is complete.
When registering for a game, unlike the standard protocol connection, you can specify game conditions such as the time condition and "turn".
On the 【Network Game Operation Board】, click 【Game Registration button】.
【Game Registration Dialog】 is displayed.

【Game Registration Dialog】


In this dialog, specify game conditions and assign local players.
The assignment of local players is the same as described in 【Login dialog when connecting standard protocol】, so please refer to that.
Here, game condition setting and repeated game designation will be described.

Game condition setting

In the extended protocol connection, the server selects the players who has the same "Game Name" and match the "turn" condition and decides the player among them.
Therefore, the "Game Name" and the "turn" condition are necesary to be designated as the game conditions when the game waiting registration is performed with respect to the server.
The "Game Name" is a character string composed of <name>, <time condition>, <countdown> or <additional time>.
In SBrowserQ, the "Game Name" is generated from the value specified in the 【Game Registration Dialog】 and the server is notified.
The <name> is like an identifier of one group, and if this value does not match, the opponent will not be found.
What you specify may be bound by the rules of server operation.
For example, in the case of floodgate (Note), you should always specify "floodgate".
If you want to enjoy the game by starting the server locally, it is better to decide in advance so that the <name> matches.

(Note)  Computer Shogi continuous playing place "http://wdoor.cu-tokyo.ac.jp/ See shogi/floodgate.html".

The contents of the game conditions specified in the 【Game Registration Dialog】 are explained below.

Game Room NameName part of the "Game Name" specified during game waiting registration.
Characters that can be specified are alphanumeric characters and '@''_''.'.
(Required)
Time Condition (Note)Specify the time conditon.
Specify in minutes.
To specify in seconds, click the 【min Button】. 【sec Button】 is displayed and can be specified in seconds.
(Required)
Countdown (Note) When playing a game with countdown, specify the countdown time in seconds.
If you specify 0, there is no countdown.
(Required)
Additional TimeClick 【Countdown Button】 to change the button display to 【Additional Time】.
Specify the addition in seconds. You cannot specify 0.
(Required)
The added time is the time added to the holding time for each "move". (Fisher mode)
TurnIf you want to specify your turn, select it with 【Turn Selection Combo.
If 【Black】 is selected, the game is played in the "black turn", and if 【White】 is selected, it becomes a game condition in the "white turn".
【Unspecified】 does not perform the "turn" condition but leaves it to the server to decide.
(Required)

(Note)  Specifying 0 for both time condition and countdown is time limit none according to the rule on the server side. 
SBrowserQ does not support time limit none, so this cannot be specified.

Repeated Game designation

Repeated Game is a processing mode in which when a game is finished, it is automatically registered for immediate game waiting under the same game conditions.
Specify when playing games repeatedly with the engine.

In this processing mode, the game is repeatedly executed within the same 【Shogi Board Window】.
The 【Shogi Board Window】 does not increase with each game.
Therefore, when the game is over and the game is started after that, the previous GR will be erased.
So, it supports the function to automatically save the GR in the database.

When 【Repeated Game specify】 is checked, repeated game setting items are displayed in the 【Game Registration Dialog】.

【Game Registration Dialog】-Repeated Game specification


The following is a description of the specified contents of repeated game in the 【Game Registration Dialog】.

Scheduled Game End Time If you check here, you can specify the time to end the repeated game. (Hour and minute input items are displayed)

Set the end time in hours (0-23) and minutes (0-59).
It means that the game registration is not newly performed after the time specified here.
At the time when you specify the repeated game and the register for game waiting, if that time has already passed this time, the time of next day becomes the scheduled end time.
(optional)
End CountIf the number of games reaches the number specified here after starting repeated game, it means that new game waiting registration will not be performed.
When 0 is specified, it is considered as no specification.
(optional)
LOGOUT at end If you check here, if the repeated game ends due to the conditions for ending the repeated game (Scheduled Game End Time and End Count), the connection with the server is disconnected at the end of the repeated game.
(optional)
GR Auto Save Database specificationSpecify the database to automatically save the GR when the game ends.
If you check here,【Database Selection Combo】 is displayed and you can select the database to save the GR in.

(optional)

If you specify the 【Scheduled Game End Time】 and the 【End Count】 to end the game as a condition for ending the repeated game, the repeated game will end if either condition is reached.
If no ending condition is specified here, repeated playing does not end automatically, but it can be ended manually. (Refer to (d) Operations during Repeated Game)

Game Registration

If you set each of the above parameters and click the 【Game Registration Button】 in the 【Game Registration Dialog】, it will be in the "Waiting Game" state.
If you specify reapeated games,it becomes "Waiting Repeated Game".
If a player who matches the game conditions is found, the game is started same as in the standard protocol.

(b) Canceling Game Registration

In versions prior to V3.5, you could unregister by clicking the button, but this function had been deleted because t the extended protocol may not work completeness.
Therefore, if you want to cancel the registration for waiting for a game, There is no choice but disconnecting the server with LOGOUT.

(c) Game challenge

You can directly challenge a user who is already in a game waiting state.
In the "Logged in" state, first display the waiting for a game in the 【Waiting Game List】.
Select 【Waiting Game List】 in 【List Selection Combo】.
【Waiting Game List】 is displayed in the 【List display Area】.

【Waiting Game List】


Only users who are waiting for a game are displayed in the 【Waiting Game List】.
A "Game Condition String" (Note) is displayed in the 【Game Name】 column in it.
To select an opponent, select the match condition string.
You cannot directly select the user. (Shogi-server extension protocol rules)
Users with the same playing conditions are displayed as one group in the list.
(Only the first user displays the game condition character string, and after that, it is displayed as "(Same as above)".

   (Note)
   Game Condition String :=   <game name> <turn condition>
      <game name>:= <name>-<time condition>-<countdown>
   <name>:=something like a group name
   <time condition>:=Display time in seconds
   <countdown>:=display countdown time in seconds
      <turn conditions>:=
      -: Means "white turn" specified
      +: Means "black turn" specified
      *: means no "turn" specified
Double-click on the "Game Condition String" to display the 【Game Challenge Dialog】.

【Game Challenge Dialog】

The selected "Game Condition String is displayed in the 【Challenge Game Name】 field.
Here, the assignment of the Local Player is performed, and the content thereof is the same as the assignment of the player in the login dialog described in the standard protocol.

【Turn】 shows your "turn" when playing.
In the above example, the "turn" of the selected "Game Condition String" (the opponent's "turn") is the "white turn", so when making a challenge, it is always the "black turn".
If the opponent's "turn" condition is'*', that is, no designation, you can specify your own "turn".
In this case, the 【Turn Selection Combo】 is displayed in 【Turn】, and you can select and specify your own "turn".
If you do not specify your own "turn", the server will decide your "turn".

If you make these specifications and click the 【Game Challenge Button】, the game will start.
If you do not update the list for a while after displaying 【Waiting Game List】, the status of the users displayed in the list may not be waiting for games.
In that case, even if you click the 【Game Challenge Button】, the game will not start and an error will occur, and the following message dialog will be displayed.

【Game Challenge Error Dialog】

If such a situation occurs, you need to click the 【Update Button】 on the 【Network Game Operation Board】 to update the 【Waiting Game List】 to the latest state, and then try the game challenge operation again.

(d) Operation during "Repeated Game"

When a "repeated game" is specified, when the game starts, the 【Network game status button】 on the status bar changes to "In Reapeated Game".
The button of 【End of Reapeated Game Button】 is displayed on the upper part of the network game operation board.
The number of games played since the start of repeated games is displayed in 【Reapeated Game Count】.


Click the 【End of Reapeated Game Button】 to end the repeated game.
That is, after the game at the time of clicking is finished, it is instructed not to newly register for game waiting. (It is not an instruction to end the game at the moment)

Click the 【Network game status button】 of "Repeated game" to display the setting conditions etc. of the repeated game as 【Net game information】.

【Net game information-when playing repeated game】


 

(e) Watching games

You can watch the game being played via the connected server.
You can watch the game by displaying the 【Game List】 and selecting the game from the list.
Select 【Game List】 in 【List Selection Combo】.
【Game List】 is displayed in the 【List Display Area】.

【Game List】

【Game List】 displays a list of all the games currently being played on the server.
The game is represented by a character string "Game ID" that uniquely identifies the game.
The 【Game ID Colum】 of the 【Game List】 is displayed "Game ID".
Double-click the "Game ID" of the game you want to watch.
A new tab window 【Shogi Board Window】 is added, and the "current position" of the selected game is displayed in the 【Shogi Board Window】.

【Screen immediately after watching the game】


The "Operation Mode" is "Watching Mode" as in the normal Watching games.
However, unlike the normal watching game, the board here is updated in real time.
The 【Engine Monitor】 (Note*1) displays the "Thinking process" and the "Evaluation value" (Note *2) notified by both players.

(Note1)    If you check 【Do not show Shogi Engine Monitor when watching games】 in the 【Network Game Dialog】,
(Refer to Show/hide 【Engine Monitor】 when watching games) The 【Engine Monitor】 is not displayed.
In this case, it is displayed because it is checked.
(Note2)    A user who has logged in using the extended protocol can notify to the server 
the "Thinking process" and the "Evaluation value" of the "Move".
When watching a game, the contents notified from the server can be displayed on the Engine Monitor】.
The user who logs in using the standard protocol does not be notified the "Thinking process" 
and the "Evaluation value",so nothing is displayed.
However, shogi-server (2014-10-13 version) notifies the "Thinking process" and the "Evaluation value"
at the start of the game, but not after that.
(I do not know whether it is a specification or an obstacle)

You can watch a game by selecting a game from the 【Game List】 not only in the "Logged in" state but also in "Waiting Game" or "Playing".

You can watch any number of games at the same time, just as you can in the normal Watching games.
In that case, the "current position" is displayed in a 【Shogi Board Window】 which is separate tab window.
When a new "Move" is occur in the middle of watching the other game, the background color of the 【Game Selection Tab】 changes to green to notify that the "Move" has been updated.
This is also the same as in the case of normal watching.

When the game is over, the "Operation Mode" is automatically changed to "Research Mode".
If you want to stop watching the game on the way, click in the tab window.
The tab window 【Shogi Board Window】 is closed and the watching game is over.

Double-clicking the "Game ID" of the game you want to watch in the 【Game List】 will cause an error if the game has already ended.
In that case, the following message dialog is displayed.

【Watching Game Error】

In such a case, click the 【Update Button】 to display the latest 【Game List】 and try watching again.

(f) Game operation and end

The game operation is the same as the game operation using the standard protocol, and unlike the local game, you cannot perform operations such as "Suspend"/"Retract"/"Hurry Up"/"Pause" during the game.
If the local player is a human being, he can only perform the "End" operation in addition to "Move" operations.
If you forcibly close the 【Shogi Board Window】 tab while playing , the connection with the server will be disconnected and the game will be interrupted.
In this case, the person who forcibly suspends will lose. (The server considers that the side that forced the suspension has resigned.)

When the game is over, the "Operation Mode" changes to "Research Mode".
Unlike the standard protocol, the connection status with the server is maintained and the status becomes "Logged in".

(g) Others

You can chat if you are logged in.
Enter a character string in the 【Chat】 field and click the 【Send Button】 (or press the line feed key) to send the entered character string.
The character string sent by chat is displayed in the 【Chat Display Area】.
The chat string will be sent to all logged-in users.

When 【Rating List】 is selected in 【List Selection Combo】, the current and latest rating value is displayed for each user.

 (g) その他

8.4 Research by engine

(1) GR analysis

The GR analysis is to evaluate a series of "moves" of an existing GR using the shogi engine.
The evaluation value and its "thinking process" notified from the shogi engine are displayed on the 【Game Analysis Monitor】for each "move" and the transition of the evaluation value is displayed as a graph on the score graph.
As a result, it is possible to confirm the transition of trends.


Regarding acquisition of evaluation value in game analysis

The engine (Bonanza, USI, and GPSfish protocol compatible engine) that can be installed as a target for SBrowserQ will notify the GUI side of the thought result ("move" and its evaluation value) for the "current position". On the other hand, what is required for the GR analysis is a function of notifying the evaluation value when this "move" is performed at this "position". However (I think) , currently these engines do not support such a feature.
However, it is useful to use existing functions and follow changes in trends even though it is somewhat incomplete, so I incorporated it into SBrowserQ. Therefore, it becomes a problem how to obtain the evaluation of the "move" by the GR analysis, As far as other free shogi GUI software is concerned, it seems that the evaluation value of the "move" notified from the engine at that "position" use to the evaluation value of the actual "move" performed at that "position". This determines the evaluation value (evaluation value of the "recommended move" selected by the engine) without reflecting the actual "move" performed at that time, so even if a bad "move" is performed, the evaluation value of the "move" will be not appeared immediately large as a change. The evaluation value will change significantly with the next opponent "move". It can be said that the graph of the evaluation value generated as a result of the GR analysis shows the trend of the trend as a whole, but it seems to be one step behind. In SBrowserQ, this point has been improved so that an evaluation value can be obtained from the engine for the "position" generated by that actual "move". In this way, the obtained evaluation value reflects the "move". However, it should be noted that this evaluation value is originally an evaluation value of the responder and not a realistic value for the "move". In conclusion, after all, the difference between the existing method and this method is that the trend graph is shifted by one "move", and the shape of the trend graph is exactly the same. The above contents are explained below in a diagram.

◇ Existing [Position] -> 【Move】 ┗---> ([Engine Recommend Move], [Engine Recommend Move Evaluation Value]) Than this [【Move】 Evaluation Value] = [Engine Recommend Move Evaluation Value] ◇Move Response Evaluation 【Move】-> [Position] -> ([Engine Recommend Move], [Engine Recommend Move Evaluation Value]) Than this [【Move】 Evaluation Value] = [Engine Recommend Move Evaluation Value]   ※The explanation of the Corretcion Move Response Evaluation method is omitted because it has little meaning.


(a) Start GR analysis

When performing a GR analysis, first display the GR to be analyzed in the 【Shogi Board Window】.
In this case, the "Operation Mode" must be "Research Mode" or "Watching Mode".
Next, select 【Analysis GR Menu】 from 【Analysis (A) Menu】.
【Analysis GR Dialog】 is displayed.


Set the GR Analysis conditions here and click the 【Start Bbutton】 to start the GR analysis.

Explain the GR analysis conditions.

EngineSelect the shogi engine to be used in the GR analysis.
Options ButtonSet options for shogi engine.
The option specification is the same as when playing a game.
However, since the predictive reading option is always executed without specifying it, it is ignored even if specified.
Thinking End Condition-Time LimitOne "move" thinking ends when the specified time is reached.
Specify minutes and seconds.
Thinking End Condition-Depth Limit One "move" thinking is ended when the specified exploration depth is reached.
Thinking End Condition-Node Number Limit One "move" thinking ends when the specified number of nodes is reached.
Analysis Method SelectionMove Response Evaluation : The evaluation value of the "move" and the "recommended move" is determined by the "move" response evaluation.
Corretcion Move Response Evaluation: The evaluation values ​​of the "move" and "recommended move" are determined by correcting the evaluation of the response.
*For details on each evaluation method, please refer to the above 【Regarding acquisition of evaluation value in game analysis】.
Clear existing GR Analysis DataWhen performing game analysis again after GR analysis has been completed If you check here, the previous GR analysis data will be deleted and GR analysis will start.
If you do not check it, the previous game analysis data will be overwritten.
This non-checking specification is useful when partially analyzing the GR here and there in【Analysis GR from Current position】.

When the GR analysis is started, the "Operation Mode" remains the same and the GR selection icon is displayed on the【GR Selection Tab】.
In addition, the GR analysis can be executed not only for the Root GR but also for each Branch GR, so in order to show where the GR analysis is currently performed, display the icon that indicates being analyze to the node or the leaf in the【GR tree】
The following shows the screen during the GR analysis in the Root GR.

【Screen during GR analysis】


When the GR analysis starts, 【GR Analysis Monitor】is displayed in the【Shogi Board Lower Window】.
The 【GR Analysis Monitor】displays the each "move"'s evaluation and the "thinking process", and evaluation value of the "recommended move" selected by the shogi engine, and displays the "recommended move"'s "thinking process".
In addition, a 【Score Graph 】(trend graph) showing the evaluation value of "move" as a graph is displayed.
In addition, the 【[C] column】 (display of comment existence) of the [Move List] is switched to 【[S] column】 (display of evaluation value).
The evaluation value of each "move" obtained by the analysis is displayed here.

Will be explained the contents of the 【GR Analysis Monitor】.

【GR Analysis Monitor】



Explanation of each part of the 【GR Analysis Monitor】
  Display the name of the engine that is executing the GR Analysis.
  Display the GR Analysis Information.
  【MC】:Shows the "Move Count".
  【Move Score】:Displays the evaluation value of the "move" in this "position". (note)
  【R.Move Score】:Displays the evaluation value of the "recommended move" 
  (the "move" selected by the engine at that "position"). (note)
  【Score diff.】:Difference between "move score" and "recommended move" score.
  If this value is positive, the evaluation value of the "move" is  
  superior to that of the "recommended move", and if it is negative, 
  it is inferior.
  【Move】: Displays the "move" in this "position".
  【Thinking process of move】: Display the "thinking process" after the "move".
  【R.Move】:Displays the "recommended move"in this "position" 
  (the "move" selected by the engine in that "position").
  【Thinking Process of Recommended Move】: Display the thinking process 
  after the "recommeded move".
  Display 【Score Graph】 (trend graph). A graph of the evaluation value of the "move"s.
   Regarding 【Score Graph】, refer to that because it is the same as the description of 
   【Score Graph】 on the 【Engine Monitor】.
 The "★" mark indicates the "position" during the GR analysis. (Flashes during analysis)
 
 (Note)  Displayed is 100 times the evaluation value notified by Bonanza.
 The evaluation value of USI or GPSFish will notify a positive value if your engine is dominant,
 and a negative value if it is inferior.
 To unify the display with Bonanza and others,if the "black move" is dominant a positive value will be given.
 If "white move" is dominant,change it to a negative value and display it.
Display of evaluation values ​​in the 【Move list】

When the GR analysis starts, the 【[C] column】 changes to the 【[S] column】.
【[S] column】is a column that displays the same value as 【Move Score】in【GR Analysis Monitor】.
As well, The "★" mark flashes at the position of the "move" during analysis.
When the analysis of the "move"is completed, the evaluation value is displayed.

Interlocking with【Shogi Board Lower Window】

You can also switch 【[S] column】of【Move List】to【[C] column】during analysis.
If you click the comment tab of 【Shogi Board Lower Window】,comments are displayed in the 【Shogi Board Lower Window】.
In conjunction with that, the 【[S] column】of the 【Move List】switches to the【[C] column】display.
Also, in this state, if you click the 【GR Analysis Monitor】tab of the 【Shogi Board Lower Window】to switch, the 【[C] column]】of the 【Move List】 will switch to【[S] column】in conjunction with it.

You can also switch the display column of【Move List】 by displaying 【Display Column Selection Menu】at the title position of the 【Move List】and selecting that menu.

【Display Column Selection Menu】


If you select【Display Score】here,【[C] column】will switch to【[S] column】.
When【Display Column Selection Menu] is displayed while 【[S] column】is displayed, the【Display Comments】menu is displayed.
When the【Display Comments】is selected,【[S] column】is switched to【[C] column】display.

(b) "Position" update during GR analysis

In the GR analysis in the "Research Mode", the next "position" is automatically displayed on the board when the analysis of that "position" is completed.
In the GR analysis in the "Watching Mode", there is no movement of the "position" due to the analysis of the GR, and when the "position" is advanced by the "move", the "posision" displayed on the board moves.
If the GR analysis up to that time during the watching game is completed, when a new "move" is confirmed, the GR analysis of the "position" generated by the "move" is started.

"Position" movement by operation during GR analysis

It is possible to move the "position" by mouse operation or keyboard operation even during GR analysis.
In the "Research Mode", if you move to a different "position" from this "position" by mouse operation during GR analysis, the GR analysis will continue, but the automatic update of the "position" will stop and the 【Shogi Board】will not be updated from it was displayed by mouse operation.
However, if the player moves to the "position" being performed the GR analysis , the "position" automatic update by the GR analysis is restarted.

(c) End of GR analysis

GR analysis ends at the end of the GR.
If you want to interrupt the GR analysis on the way, select【End Analysis】from the 【Analysis (A) Menu】.
The GR analysis ends at that point.
The icon in the GR analysis of【GR Selection Tab】and【GR Tree】disappears when the GR analysis is completed.

(d) Target GR of GR analysis and marking it

Not only the Root GR but also the Branch GR will be the target of the GR analysis.
You can see which Branch (or Root) GR is being analyzed by display the GR analysis icon on each node or leaf of the 【GR Tree】.

(e) GR analysis from the "current position"

You can start GR analysis from any "position".
Move to the "position" where you want to start the GR analysis, and select【Analysis GR from Current Position】in the 【Analysis (A) Menu】.
Then, from the analysis result of the "move" next to that "position", the subsequent ones are displayed on the【GR Analysis Monitor】.

(f) Save GR analysis results

When a GR is saved a output file, the "evaluation value" and the "thinking process" of "move" and the "evaluation value" and "thinking process" of the "recommended move" obtained as a result of the GR analysis are saved as they are
Since all of these are handled as comment information in the GR file, they are displayed as comments when read by other shogi software.
Of course, when the GR is read by SBrowserQ, that information is displayed on the 【GR Analysis Monitor】as GR analysis information.
Also, when saved in the database, the GR analysis information is saved as is.
Save operation cannot be performed while the "Operation Mode" is "GR Analysis".
Save operation can be performed after the GR analysis is completed.

If you do not want to save the GR analysis data when saving, you can set not to save it in【Preferences Dialog】.
Refer to 4.3 Options when saving.

(g) GR analysis during watching games

While watching the game,You can execute GR analysis for the GR of watching game at the same time .
First, perform a game watching operation (see 6.1 Watching operation), and then start the GR analysis.
From the beginning (from that "position" in【GR Analysis from Current position】), the GR analysis is started up to the "current move".
When the analysis is completed up to the "current move", the GR analysis processing is in a waiting state.
If a new "move" has been added in watching the game, the waiting state is released and the GR analysis is automatically started for the newly added "move".
Such processing is repeated until the watching game is completed.
At the end of the watching game,the GR Analysis may not be completed yet,in that case, the GR analysis is continued in the "Research Mode" even if the watching game is finished.

In the GR analysis during watching a game, the movement of the "position" is the same as in the case of a normal watching, and can be moved arbitrarily.
Further, it is possible to generate the Branch GR from the 【Thinking Process of Move】 or the 【Thinking Process of Recommended Move】without interrupting the GR analysis during this period.

This is exactly the same for watching games network (8.3 (4) (e) watching games).

(h) Operation of the GR Analysis Monitor

① Display switching operation

【GR Analysis Information】and【Score graph】are initially divided and displayed in one tab.
You can switch it to display only【Game Analysis Information】or only【score graph】.

Click the right mouse button on【GR Analysis Information】or【Score graph】.
A popup menu is displayed.

【Popup menu for GR Analysis Information】


【Popup menu for score graph】


The popup menu is different for each, but select the display method here.

② Generation of Branch GRs from "thinking process"s

When the "Operation Mode" is "Research Mode"/"Watching Mode", if click the item as【Move】(or【Thinking Process of Move】) and 【R.Move】(or【Thinking Process of Recommended Move】), then the Branch GR is generated.
Please refer to 3.2 Research and generation of Branch GR for generation of Branch GR.
When the "Operation Mode" is "Research Mode"/"Watching Mode" 【Move】(or【Thinking Process of Move】) and R.Move】(or【Thinking Process of Recommended Move】) items are displayed in blue and selectable Indicates that there is.
After clicking on it and generating a Branch GR, it will be displayed in red. The red "thinking process" indicates that the Branch GR has already been generated, and clicking will not generate the Branch GR.
By generating the Branch GR, each "thinking process" can be displayed and confirmed on the board.

If you want to generate Branch GRs all at once after selecting multiple "thinking process"s, select【Branch GR Generation】from【GR Analysis Popup Menu】.
All the selected plural "thinking process"s are added as Branch GRs.
Those already added as Branch GRs (displayed in red) are not added as in the case of selecting them independently.
To cancel multiple selections, select this menu【Deselect】. All previous selections will be cancelled.

③ "Position" movement operation with score graph

If the "Ooperation mode" is "Research Mode"/"Watching Mode", double-click the mouse at the 【Cursor】position on the score graph to move the "position" to the cursor position.
You can also move the front and back "position" by rotating the [wheel button] of the mouse.

④ Window display of GR Analysis Monitor

The 【GR Analysis Monitor】 can be displayed as a separate window.
Select 【Window Display】 from the popup menu.
The engine monitor tab is deleted from the【Shogi Board Lower Window】 and the 【GR Analysis Monitor Window】 is displayed.

【GR Analysis Monitor Window】

To close this window and return to the original state, click the right mouse button on the【GR Analysis Monitor Window】 to display the popup menu.

【Popup menu for GR Analysis Monitor Window】

If you select【Close Window】, the window will be erased and the original state will be restored.

(i) About engine in GR analysis

In GR Analysis, the same two engines are used for the processing.
The reason for starting two engines is to execute the GR Analysis as early as possible, one is used for "move" analysis and the other is used for "recommended move" analysis.

The predictive reading option is disabled when setting the engine option.
Even if specified, it is ignored.

(2) Spot Analysis/p>

"Spot Analysis" is a function that executes analysis only for the "position" currently displayed on the board when the "Operation Mode" is "Research Mode" or "Watching Mode".
Therefore, there is no automatic movement of the "position".
Further, if the "position" is moved during the analysis, the analysis is canceled midway even if it is currently being analyzed, and the newly displayed "position" is analyzed.
if "Spot Analysis" has been started, the analysis of that "position" starts the moment the tab window is switched and that "position" is displayed.
 The output of the analysis "position" is the same as the GR analysis, so the explanation is omitted.
Once a "position" has been analyzed, it is not analyzed even if that "position" is displayed again on the board again.

(a) Start "Spot Analysis"

If you are not using Shogi engine elsewhere, you can start "Spot Analysis" at any time (except when playing a game).
There is no need to display a GR on the board to start.
Select 【Spot Analysis】 from 【Analysis (A) Menu】.
The 【Spot Analysis Dialog】 is displayed.
【Spot Analysis Dialog】

(a) Start "Spot Analysis"

Since the contents specified in this dialog are the same as in the【GR Analysis Dialog】, please refer to that.
The only difference is that there is no option for【Clear existing GR Analysis Data】.
Next, click the【Start Button】on this dialog to enable spot analysis.
That is, when an unanalyzed "position" is displayed, the GR analysis of that "position" starts.

When the spot analysis is started, "Spot Analysis" is displayed on the status bar.

When a "position" of GR is displayed in the【Shogi Board Window】in this state, "Spot Analysis" is executed.
Similar to the GR analysis, the【GR Analysis Monitor】is displayed in the【Shogi Board Lower Window】, and the score of the analysis result is displayed in the 【Move list】.

(b) End of "Spot Analysis"

To end the "Spot Analysis", select【End Spot Analysis Menu】from 【Analysis (A) Menu】.
The "Spot Analysis" ends, and the "Spot Analysis" display on the status bar disappears.

(c) Analysis time on "Spot Analysis"

The time required for analysis of one "position" is different from that for GR analysis, and is approximately twice the time specified for the engine time limit in the 【GR Analysis Dialog】.

(d) Reanalysis of already analyzed "position"

 The "Spot Analysis" does not analyze the already analyzed "position"s.
If you want to analyze the already-analyzed "position" again, double-click the line of the target "position" in the【Move List】.
"Spot Analysis" of that "position" is started.

(3) Search "move"s at "current position"

When the "Operation mode" is "Research Mode" or "Watching Mode", the shogi engine can search for the "move" in that "position" and display the result as a Branch GR.
Please refer to 3.2 Research and generation of Branch GR for generation of Branch GR.

If you select【Search Moves at Current Position】from【Analysis (A) Menu】at any "position",【Search Moves at Current Position Dialog】will be displayed, and search will be started by setting the search conditions and clicking【Start Button】.

【Search Moves at Current Position Dialog】


Explain the search conditions.

EngineSelect the shogi engine to be used for search.
OptionsSet options for shogi engine.
The option specification is the same as when playing a game.
Thinking End condition-Time Limit Thinking ends when the specified time is reached.
Specify minutes and seconds.
Thinking End condition-Depth Limit Thinking ends when the specified search depth is reached.
Thinking End condition-Node limit Thinking ends when the specified number of nodes is reached.
Checkmate ExplorationCheck if there will be a "checkmate" at the "current position".
If there will be a "checkmate", the procedure is added as a Branch GR.
This function may not be supported by the some engine.
Bonanza is not supported and GPS Shogi supports it.
If there is only one king on the board, it is necessary to check the【Checkmate Exploration】.
Do not show this dialog again If you check here, this dialog will not be displayed even if you select【Search Moves at Current Position】 from the toolbar.
When searching under the same conditions, it is not necessary to display a dialog and set the conditions one by one, and in such a case check.
If you select 【Search Moves at Current Position】from the menu instead of the toolbar, this dialog will be displayed regardless of the check here.

When the search is started, the【Search Moves in progress Dialog】is displayed.



When the search is completed, this dialog will be deleted and the search results will be added as a Branch GR.
Even if you do not reach the【Thinking End condition】specified in the 【Search Moves at Current Position】, if you want to stop thinking and obtain results at that point, click the【Hurry Up button】.
This dialog disappears, and the current search results are added as a Branch GR.

Below is an example of the results of search by Bonanza.
Display the content of the best-practice Branch GR in the【Shogi Board Window】.

【Search results】


The above figure is the result of performing "Search moves" on the 20rd "move" and acquiring the 21th "move" ("white move") .
The "current move" of the【Shogi Board】shows Bonanza's best "move" at that "position".
In the【Move List】, the best-practice GR is displayed.
In【GR Tree】, all the "moves" notified by Bonanza by searching are displayed in tree form as a Branch GR.
The title of each Branch GR in the【GR Tree】 will be described.

  Branch GR title :=
     <MC><Move><Score> [Thinking Process]◎<--- Best "move" format
     <MC><Move><Score> [Thinking Process]<--- Next-best "move" format
     <MC><Move><Score> <--- "Changing diagram" format

        <MC>:="Start move count" of the Branch GR   
        <Move:="Start move" of the Branch GR
        <Score>:=Evaluation value (Note) 100 points correspond to one step
           A value of + indicates the black advantage
           A value of - indicates a white advantage

  (Note)  Evaluation value
  If the engine is Bonanza, display 100 times the evaluation value actually notified.
  When the engine is USI (or GPSfish), the evaluation value to be notified is converted to
  as + indicated the black advantage, and - indicated a white advantage.

It is necessary to return the king outside the board(in Piece Box) to the board as a precaution when searching the checkmate procedure for Tsume shogi with Bonanza.
The correct result cannot be obtained even if the search is performed while it is placed outside the board.
At the【Edit Position】,return the "king" outside the shogi board to the board (a position that does not affect "mate"), set the "Operation Mode" to the "Research Mode", and then perform "search moves".

8.5 Note when running a shogi engine

This program is a program that displays and processes multiple【Shogi Board Window】as tab windows.
Therefore, even during a game, it is possible to switch to another【Shogi Board Window】and research or edit another GR.
You can also watch live games.
However, it does not allow multiple game or "move"s searches to be performed simultaneously.
This is because the load on the system is heavy, so this program limits it.
Operations such as "playing game", searching for "move"s, and "game analysis" cannot be performed simultaneously.

If you use the Shogi engine, the history of cominication between this program and the engine will be created and recorded in the "battlelog.txt" file (Note) directly under the installation folder of this program.
When new engine is installed and it doesn't work well, you can refer to this file to find the cause.
This file is overwritten each time it plays, so it will not grow.

(Note) For MacOS X, select the application file, click the right mouse button, and select [Package] 
     from the popup menu.Select [Display the contents of].
     You can find the file by following the path below in the displayed Finder.
         Contents/Java/battlelog.txt of the SbrowserQ.app file

9.Other operations


 9.1 Screen operation
   (1) Display Shogi Board Only
   (2) GR Explorer display
   (3) Display the GR in a separate window
   (4) Clear tab window
   (5) Toolbar
   (6) Show/hide GR URL Input Field
   (7) Rotate Shogi Board
   (8) Scale Up/down
 9.2 Setting for displaying Shogi Board
   (1) Shogi Board/Piece Stand Background setting
   (2) Shogi Board Window Background setting
   (3) Shogi Piece selection
   (4) "Current move" Background Color setting
   (5) Selected Piece Background Color setting
   (6) Font and Background settings for Player Name Field
 9.3 Window style settings
   (1) Look&Feel settings
   (2) Menu & Dialogs Font setting
   (3) Screen menu
   (4) Display of piece box
   (5) "Current move" Position Bar Color setting
 9.4 Language and Date format
   (1) Language setting
   (2) Date and Time format settings
 9.5 Other operations
   (1) Pinning the dialog box
   (2) Sound setting

9.1 Screen operation

(1) Display Shogi Board Only

If you do not need to display the【Shogi Board Right Window】and Shogi Board Lower Window】, such as playing a game with a computer, you can hide them and only display the 【Shogi Board Window】.
Select 【Display Shogi Board Only】from【Operation (O) Menu】.
Only the【Shogi Board Window】is displayed.

【Display Shogi Board Only】


To return to the original display, select【Display ALL】in【Operation (O) Menu】.
The display of 【Shogi Board Right Window】 and 【Shogi Board Lower Window】 is restored.

The【▲】and【▼】buttons for closing the window are attached to the boundaries of each window.
You can also close the 【Shogi Board Lower Window】.
However, since the borders are thin and the buttons are small, the operability is poor, and we decided to set up such a display operation separately.

(2) GR Explorer display

【Shogi Board Right Window】 can be displayed as an independent window.
This is a combination of the 【GR Tree】 and the 【Move List】 in a single window display, which is called the 【GR Explorer Window】.

Click the right mouse button on 【Game tree】 or 【Move list】 to display the popup menu.
If you select 【Window Display】 in that menu, 【Shogi Board Right Window】 will be deleted and 【GR Explorer Window】 will be displayed.

【GR Explorer Window】


Click the 【x】 button to close the 【GR Explorer Window】.
This window is closed and the original 【Shogi Board Right Window】 display is restored.

(3) Display the GR in a separate window

If you have imported multiple GRs, you can display any GR in a separate window.
When you import multiple GRs, you can usually display one GR by switching with the 【GR Selection Tab】.
However, there are cases where it is desired to display multiple boards on the screen at the same time.
With this program, you can display the GRs you want to display simultaneously in separate windows .

Drag the 【GR Selection Tab】 of the GR you want to display in a separate window with the left mouse button to the outside of the 【GR Selection Tab】 and release the mouse button to display the GR in a separate window To be done.
The display of the GR in the original 【Shogi Board window】 is deleted.
Basically, the original and new windows have the same appearance. However, if the 【Search Result List】 is displayed in the original window, it cannot be inherited in the new window.

However, the tab while playing a game cannot be displayed in another window. (Limitation from V3.0)

Furthermore, the new window is basically only the basic operation of the GR, and it is not possible to process extended functions or batch processing,also,you cannot play games.

Even if you set various settings such as font and background in a new window, the settings are valid only in that window and the settings are not saved when you exit the program.

(4) Clear tab window

Click on the 【GR Selection Tab】 to delete the GR displayed in the 【Shogi Board Window】.
The tab of 【Shogi Board Window】 is closed.

If the GR you are about to delete is not saved as a newly imported GR, or if you have changed it and have not saved it, a confirmation message prompting you to save is displayed.

【Save confirmation message】


Click 【Yes】 to register the GR to the "current database".
If you have not created a database, the GR is saved the file.
If you click 【No】, the save process is not performed and the tab window is closed.
Clicking 【Cancel】 cancels the closing process of the tab window.

If you have multiple tab windows open, you can close them all at once.
Select 【Close All Tab】 from the 【Operation (O) Menu】. All tab windows are closed.
If there is a newly imported GR or a changed GR, a save confirmation message is displayed for each.

(5) Toolbar

The toolbar is a collection of operations that are likely to be used frequently, allowing direct selection by button.
Each button is displayed as an icon, but if you move the mouse cursor to that position, the meaning of the button will be displayed, so it is better to use it while checking until you get used to it.

Normally, the toolbar is placed in vertical direction at the left side of the 【Shogi Board Window】, but you can also place it in the horizontal direction below the main menu (Note) or in the vertical direction at the right side of 【Shogi Board Window】.
If you drag the moving handle of the toolbar with the mouse and release it near the position you want to place it, it will be docked and placed in the window at that position.
Also, if it is released near the center of the screen, it can be set as a separate window.

Note) When Look & Feel is "Aqua", it cannot be placed below the main menu.
Also, if 【URL Input Field】 is selected to be displayed at the bottom of the menu, it cannot be placed below the main menu as well.

【Moveing handle】


When not using the toolbar, select 【Hide Toolbar】 in 【Operation (O) Menu】.
The toolbar will be hidden.
To display it again, select 【Display Toolbar】 from the 【Operation (O) Menu】.
The toolbar is displayed again.
This specification is saved and is valid for the next boot.

(7) Rotate Shogi Board

You can switch the display position of the black and white of the【Shogi Board】.
If you select 【Rotate Board】 in 【Operation (O) Menu】, the display position of the black and white of the 【Shogi Board】 will be switched.

(8) Scale Up/Down

The Shogi board window can be enlarged or reduced to be displayed.
If you select 【Scale Up】 from the 【Operation (O) Menu】, the 【Shogi Board Window】 is displayed slightly larger.
If you select 【Scale Up】 more time, it will be displayed even larger.
If you select 【Scale Down】 in the 【Operation (O) Menu】, the 【Shogi Board Window】 is slightly smaller.
If you select 【Scale Down】 more time, it will be displayed even smaller.
【Shogi Board Window】 (【Shogi Board】 【Piece Stand】, 【Player Name】,etc),is enlarged and reduced display,but 【Shogi Board Right Window】 and 【Shogi Board Lower Window】 will be not scaled.
Every time the 【Shogi Board Window】 is enlarged or reduced, the overall window size is enlarged or reduced accordingly.

Enlargement and reduction settings are saved even after the program ends, and the 【Shogi Board Window】 will be displayed with that value at the next startup.

9.2 Setting for displaying Shogi Board

In the 【Shogi Board Window】, you can select the display image of the 【Shogi Board】 or 【Piece Stand】 (wood grain keynote), or the display of 【Pieces】.
Click the right mouse button on the 【Shogi Board Window】 to display 【Shogi Board Ppopup Menu】 and select 【Shogi Board Setting】, or 【Prefernces dialog】 to display the 【Shogi Board Setting Dialog】.

【Shogi Board Setting Dialog】


Display settings are made in this dialog.

(1) Shogi Board/Piece Stand Background setting

You can set the background image of the 【Shogi Board】 with 【Set Shogi Board Background】 in the 【Shogi Board Setting Dialog】.
When you click the panel on which the background image of the 【Shogi Board】 that is currently set is displayed with the mouse, the 【Background Image Setting Dialog】 is displayed.

【Background Image Setting Dialog】


Select a background from three types of image material.
After selecting, you can fine-tune the brightness with the 【Board Brightness Adjustment Slider】.
Clicking the 【OK Button】 here completes the selection of the background material.

The materials that can be selected in this dialog can be customized.

   *Customization of background material
   You can also create and set the background material (image). The method will be described.
   ① Image file format is "png"
       If you create a large image size, it will affect the startup time and display time, 
       so create it as small as possible.

   ② Create with the specified file name.

       Select ButtonFile name
       Image1img1.png
       Image2img2.png
       Image3img3.png

   ③ Place the created image file in the folder.
      Under the installation directory (SBrowserQ_VXX) of this program (Note)
   
           image
  
      Copy to folder

   That is all.

   (Note) For Mac OS X, under Contents/Java of SbrowserQ.app file

(2) Shogi Board Window Background setting

The background of the 【Shogi Board Window】 can be set by selecting either a background image or a single background color.

Background image setting

When you select 【Image】 in the background selection of 【Shogi Board Setting Dialog】, a file selection dialog is displayed.
Therefore, you can specify the image file to be set as the background.
Any image file format may be used, but a smaller format is preferable due to startup and display time.
Since "back.png" is prepared as a sample in the image folder under the installation directory (SBrowserQ_VXX) of this program (Note), it can be selected and confirmed.

(Note) In the case of Mac OS X, it is under Contents/Java of the SbrowserQ.app file.

Background color setting

When you select 【Color】 in the background selection of 【Shogi Board Setting Dialog】, 【Background Color Dialog】 is displayed.

【Background Color Dialog】


You can select an appropriate color here and use it as the background color of the 【Shogi Board Window】.

(3) Shogi Piece selection

Selection of pieces

Select a piece with 【Piece Selection】 in the 【Shogi Board Setting Dialog】.
The image of the currently set is displayed in the frame of below the selection button , refer to it and select the piece you want to set.
The selection button without the image of the piece is invalid even if it is selected because the piece is not set.

Piece color tone setting

You can adjust the color of the selected piece.
This makes it possible to adjust the balance between the 【Shogi Board】 background and the pieces.
Click the 【Piece Color Tone Setting Button】.
【Piece Color Tone Setting Dialog】 is displayed.

【Piece Color Tone Setting Dialog】


In this dialog, set the parts other than the characters (black) of the pieces to generate colors by combining the three colors of red-green-blue and display them on top of the image of the original pieces.
The values ​​of 【Red】, 【Green】, and 【Blue】 are specified by moving each slider in the range of 0-255.
【Transparency】 specifies the transparency of the generated color.
When this value is 0, it is completely transparent and is the same as setting no color.
Also, if you specify 255, it will be completely opaque, so the generated color will be the color of the piece itself.

To return the color of the piece to the color of the image itself, click the 【Restore to Original Color BUtton】.

Fine adjustment of Piece size

You can adjust the display size of the selected piece.
You can adjust the size of one piece by using the 【Fine Adjustment of Piece Size Slider】.

Customizing the pieces

SBrowserQ In addition to the default pieces, pieces that are open to the public on the net or created by you can be displayed on the board by incorporating them into this system.
However, the following conditions must be met.

① The image file format is "png"

The background of the piece should be made transparent with an alpha channel.
The image size to be created does not matter, but it is better to create it with about 130 x 130 pixels.

② Create one piece with one image and the following types of pieces with a given file name.

piece typeBlack piece file nameWhite piece file name
sfu.pnggfu.png
skyo.pnggkyo.png
skei.pnggkei.png
sgin.pngggin.png
skin.pnggkin.png
skaku.pnggkaku.png
shi.pngghi.png
sou.pnggou.png
sgyoku.pngggyoku.png
sto.pnggto.png
成香snkyo.pnggnkyo.png
成桂skei.pnggkei.png
成銀sngin.pnggngin.png
suma.pngguma.png
sryu.pnggryu.png

The pieces of the black and white are upside down. The white piece will be able to create by creating the black piece and rotating the image 180 degrees.

③ Incorporate the prepared pieces into this system

In order to incorporate the prepared piece file into this system, open 【Shogi Board Setting Dialog】 and copy (or move) the piece file to the rectangular area for piece display in the 【Piece Selection】 column of 【the Shogi Board Setting Dialog】 by dragging and dropping.



After copying (or moving) all the piece files by dragging and dropping, the Rook piece is displayed in the piece display rectangular field and the setting is completed.
If even one piece is missing, nothing is displayed.
Setting is easy by selecting all the piece files and copying (or moving) them all at once by dragging and dropping.

A new piece file can be copied to the already set pieces by dragging and dropping.
In that case, all the pieces are overwritten, and the previous piece file is lost.
If you want to keep it, make a backup beforehand.
The setting location of the piece file of this system is as follows.

   【Location of piece files】
    Under the installation directory (SBrowserQ_VXX) of this program (Note)
     image/koma1 <--- Folder that stores the piece file corresponding to selection button piece 1
     image/koma2 <--- Folder that stores the piece file corresponding to selection button piece 2
     image/koma3 <--- Folder that stores the piece file corresponding to selection button piece 3
   
   (Note) For Mac OS X, under Contents/Java of the SbrowserQ.app file

(4) "Current move" Background Color setting

In order to make it easier to identify "current move", it is displayed with a predetermined background color on the 【Shogi Board】.
To change the background color, click the display panel (rectangular area) of 【Current Move Background Color】 in the 【Shogi Board Setting Dialog】.
【Current Move Background Color dialog】 is displayed.
Therefore, when the background color is selected, the selected background color is set on the display panel of 【Current Move Background Color】.
When you click the 【OK Button】 of the 【Shogi Board Setting Dialog】, the background color is displayed as the background of the "current move".

(5) Selected Piece Background Color setting

If 【Selection】 is specified in 【Piece Movement Method】 of 【Operation】 of the 【Preferences Dialog】 , You can set the background color of the selected piece here.
Click the display panel (rectangular area) of 【Selection Piece Background Color】 of 【Shogi Board Setting Dialog】.
The 【Selection Piece Background Color Dialog】 is displayed.
Therefore, when the background color is selected, the selected background color is set on the display panel of 【Selection Piece Background Color】.
When you click the 【OK Button】 of the 【Shogi Board Setting Dialog】, the background color is displayed as the background color of the selected piece.

(6) Font and Background settings for Player Name Field

Font settings

Click the right mouse button in 【Black Player Name Display Field】 or 【White Player Name Display Field】.
【Player Popup Menu】 is displayed and 【Font】 can be selected.

【Player Popup Menu】


【Font setting dialog】 is displayed and you can set the font.
The font settings specified in either the 【Black Player Name Display Field】 or 【White Player Name Display Field】 are applied to both.

Set Text Color

Select 【Set Text Color】 from the 【Player Popup Menu】.
【Text Color Dialog】 is displayed, and you can select the character color.

Background color setting

Select 【Set Background Color】 from the 【Player Popup Menu】.
The player's 【Background Color Dialog】 is displayed, and the background color can be selected.

The font setting, character color setting, and background color setting specified in either the 【Black Player Name Display Field】 or 【White Player Name Display Field】 are applied to both.
The character color setting and background color setting specified here are also applied to the time display during the game. (Font settings are not applied)

Copy

If you select 【Copy】 in 【Player Popup Menu】, you can copy the player name displayed in this column to the clipboard.
It is convenient to how to enter the player name as keywaord when search the database.

9.3 Window style settings

(1) Look&Feel settings

Look & Feel is the display style of the window and can be set according to your preference.
Immediately after this program is installed, it is the default Look & Feel for that platform.
To change the settings, select 【Preferences】 from the 【Preferences (P) Menu】. 【Preferences Dialog】 is displayed.
Select the window display style in the 【Look&Feel】 combo box of the 【Preferences Dialog】.

【Window display style】
   Windows:Windows-like display style The default when this program is started on Windows.
   Metal:A slightly angular metallic shiny display style
   GTK:Display style like Ubuntu. The default when this program is started on Ubuntu.
   Nimbus:a slightly rounded display style
   Aqua:Window style on Mac OS X. The default when this program is started on Mac OS X.
       

The display style does not switch immediately even if you select it here.
Exit the program and switch to the selected display style the next time you start it.
Unless you change the display style thereafter, this specified value is valid.

(2) Menu & Dialogs Font setting

The font used in menus and dialogs can be set.
Not only the characters is displayed by the font set here, but also the size of the external window or dialog is scaled according to the font size set.
The default font size is 12 points (before version V3.5 14 points).

To change the settings, select 【Preferences】 from the 【Preferneces (P) Menu】. 【Preferences Dialog】 is displayed.
Click 【Menu & Dialogs Font Button】 in 【Preferences Dialog】. 【Font Dialog】 is displayed

Even if you change the font here, it does not switch immediately.
Exit the program and switch to the specified font the next time you start it.
Unless the display font is changed thereafter, this specified value is valid.

(3) Screen menu

When an application is displayed on the desktop on Mac OS X or Ubuntu, the application menu leaves the window and is displayed as a screen menu on the desktop.
Since 【GR URL Input Field】 is embedded in the menu bar, it will not be displayed as it is.
To avoid this, you can change that the 【GR URL Input Field】 will be displayed at the bottom of the menu bar.

Select 【Preferences】 from 【Preferences (P) Menu】.
【Preferences Dialog】 is displayed.
If you check 【URL Column Lower Display】, the 【GR URL Input Field】 will be displayed below the menu bar.
Normally you should not check.
When Aqua is selected for Look & Feel on Mac OS X, the 【GR URL Input Field】 is always displayed in the lower row regardless of this specification.

(4) Display of piece box

When you display a GR or "position" of a handicap game, or in the case of a handicap game, you can display the dropped piece in the lower left of the shogi board window.

Select 【Preferences】 from 【Preferences (P) Menu】.
【Preferences Dialog】 is displayed.
If you check 【Display Piece Box】, the dropped pieces will be displayed.

(5) "Current move" Position Bar Color setting

【Move List】 and 【Engine Monitor】's 【Thinking Process Information】 and 【GR Analysis Monitor】's 【GR Analysis Information】,there are scrolled by moving the "position".
At that time, 【Current Move Position Bar】 showing the "current position" is displayed.
You can set that color.

Select 【Preferences】 from 【Preferences (P) Menu】.
【Preferences Dialog】 is displayed.
Click 【Current Move Position Bar Color Panel】 to display the color setting dialog.
You can specify the color there.

9.4 Language and Date format

(1) Language setting

From V3.7, the screen display and the contents of the GR can be displayed in English.
If you install SBrowserQ, either English or Japanese will be selected and started depending on the language setting of the platform.
The Language selection ​​will be English except the language setting of the platform is Japanese.

You can also switch the language setting after starting.
Select 【Preferences】 from the 【Preferences (p) Menu】.
【Preferences Dialog】 is displayed.
Select the language you want to switch in 【Language Selection Combo】 of 【Language & Date】.
Even if you click the 【OK Button】 and close the 【Preferences Dialog】, it does not switch immediately.
Exit the program and will be switched to the specified language the next time you start it.

When displaying "move" in English screen display (【Move list】 or "Thinking process" of 【Engine Monitor】 , etc.) GRE-style "move" expression (See Appendix GRE-style move expression ) will be used in this program.

(2) Date and Time format settings

From V3.7, the date and time formats used for screen display and input are determined depending on the country at the time of installing SBrowserQ.

CountryDate FormatTime Format
Japanyyyy年MM月dd日hh時mm分ss秒
USAMM/dd/yyyyhh:mm:ss
Other countriesdd/MM/yyyyhh:mm:ss

You can also switch the settings for the date after starting.
Select 【Preferences】 from the 【Preferences (p) Menu】.
【Preferences Dialog】 is displayed.
Select the date format you want to switch in 【Date Format Selection Combo】 of 【Language & Date】.
Even if you click the 【OK Button】 and close the 【Preferences Dialog】, it does not switch immediately.
Exit the program and switch to the specified date format the next time you start it.
The date format is only for screen display and date input, and does not affect the date format of GR when the file is saved.

9.5 Other operation settings

(1) Pinning the dialog box

【Operation Panel】, 【GR Edit Board】, 【Game Information Dialog】, 【Tsume Shogi Information Dialog】, 【Position Dictionary Board】 moves together with the movement of the main window. (It looks like it is stuck on the main window)
This is only an operation when the main body window is moved, and is not pinned when the shogi board window is expanded or contracted.

To stop this operation, remove the checkmark from 【Specify Dialog Pining】 in 【Preferences Dialog】.

(2) Sound setting

It is possible to generate a piece move sound as a sound effect at a game, a research, a GR editing, and a game watching.
When you select 【Set Sound】 from the 【Operation (O) Menu】, the 【Set Sound Dialog】 is displayed.

【Set Sound Dialog】


If you click the 【On/Off】 button, if it is in the mute state (), it will be in the sound generation state, and in the sound generation state (), it changes to mute state.
This setting will be saved and will be valid the next time you start up too.

If you move the volume adjustment slider to the left, you can make the sound smaller, and if you move it to the right, you can make it larger.
Click the 【×】 button to clear this dialog.

   *Customization of sound
   "Sound" folder under the installation directory (SBrowserQ_VXX) of this program (Note)
   If you set it inside, you can generate your own piece move sound.

   File name shougi.wav
     The sound file format is "wav"

 (Note) For Mac OS X, under the Contentss/Java of the SbrowserQ.app file


Appendix GRE-style move expression

The English version will be displayed in GRE-style "move" expression for the 【Move List】 and the "Thinking process"of the 【Engine Monitor】, etc.
The expression form of the "move" will be described.
Originally, this was borrowed as is from used by the INTERNATIONAL SHOGI MAGAZINE that editor-in-chief is Ms. Karolina Styczynska of the female professional shogi player.

   "Move" expression example

          ▲×S64(53)+

   The first letter ▲ indicates a "turn". ▲ indicates the "black move", and △ indicates the "white move".

   The next letter x indicates that you have taken the opponent's piece . 
   There is no letter in this column unless you take the opponent's piece by moving the piece.
   When the letter * is displayed in this column, it indicates the action of dropping a piece.
   The next letter S indicates the kind of "move" piece. S is silver.
   The table below shows the kinds and correspondences of the pieces in English.

   The next two-letter numbers are the coordinates indicating the moving or dropping destination of the piece.
   These coordinates are indicated by numerical values ​​from 1 to 9 in order from the upper right of 
   the shogi board as the origin.
The numbers in the first column show the horizontal position of the shogi board, and the numbers in the second column show the vertical position of the shogi board. The next number in parentheses indicates the position of the piece before moving. This part is not always necessary, and is omitted in the case of that the pieces are naturally limited if the destination is indicated. In most cases there is no this part. When there are a plurality of pieces of the movement source that correspond to this move, this part is described when limiting which piece the target of the "move"s is. The last letter + is added when the piece is promoted. If the piece will be not promoted,there is no letter in this column.

Explanation of terms used in this guide

The typical shogi terms used in this guide are explained below. [] is a Japanese term.

GR
(Game Record)
[棋譜]A record of "move" in a game and other information.
In SBrowserQ, Game Record is abbreviated as GR.
Move[指手]To move a piece on the board or drop a piece.
Position[局面]It is the arrangement of all pieces, including pieces on the board and pieces in hand.
Turn[手番]The side of the player who can does "move" next.
Black[先手]The player who has the first turn at the game
White[後手]the player who has the second turn at the game.
Uwate[上手]The player who drops the piece in a handicap game.
It will always be the black turn.
Shitate[下手]The player who don't drops piece in a handicap game.
It will always be the white turn.
Tsume shogi[詰将棋]A problem of shogi that is packed with continuous check.