Scrabble3D Manual - New pages [en]

Configuration:Create Menu Language

2014-10-01T13:37:13Z

Ocye: Created page with " This page describes the alternate, legacy method of localization. The current procedure can be found here. By choosing a menu language, the d..."

This page describes the alternate, legacy method of localization.
The current procedure can be found [[Configuration:Localization|here]].

By choosing a menu language, the dialog elements of the program are shown in your localization. The items are read from a simple text file, using the ini style formatting but with the file extension <code>.lang</code>. The file has to be stored with UTF-8 encoding. <strike> If not available the program creates a new file ''english.lang'' which could be used as basis for new translations.</strike>

At the top of the file some general information are collected under the key word <code>[Header]</code>. That is <code>Author</code>, <code>Version</code>, and <code>Date</code> which are shown in the [[Configuration:Localization|configuration dialog]]. The identifier of <code>LangID=<value></code> will be used for the flag on the game server. It follows the [[wikipedia:List_of_ISO_639-1_codes|ISO 639-1 code]]. Furthermore you can add more information in the header like licensing or comments.

{| width="100%"
|width="75%"|
The section <code>[Translation]</code> lists all items that can be localized. The hard-coded controls have a name and a property which is used for identification. This is mi=Menuitem, cb=Checkbox, gb=Groupbox, lb=Label, for example. The properties <code>Caption</code> and <code>Hint</code> contain the text, caption is the actual label, hint the respective tooltip. Captions may contain of accelerator keys defined by the [[wikipedia:en:Ampersand|ampersand]] which allows the activation by alt+<key> of the respective feature. You can use any letter of the caption, or omit it at all. For example, the ampersand at <code>&Game</code> at the line with <code>tbNewGame.Caption=New &Game</code> makes the G underlined and provides access via alt+G. Alternatively you can use <code>New Ga&me</code> to have alt+M as accelerator key.

Many controls are created after program start and do not follow the default identification. For example, <code>r2dview_caption=2D-view</code> or <code>rmain_infoappstarted=Program started</code>.
|width="25%"|
'''[Header]'''
Author=John Doe
Version=1
Date=2010-01-30
LangID=eo
Licence=Creative Commons
Comment=Just a demo
'''[Translation]'''
fmMain.Caption=Scrabble3D
tbExit.Caption=E&xit
tbExit.Hint=Fini programo
rMain_GameEnd=Ludofino

|}

A completely new localization can be created by copying and renaming an existing file or by just creating an empty file. If the empty file has the extension <code>.lang</code> and if it's placed in the [[Configuration:Localization|configuration directory]], you can "load it" after next restart. And loading means that all non-existing entries are replaced by the current setting.

Special formatting are %s (strings) and %d (decimal numbers). The position of these place holders is free but make sure the items contains it. For example, you can replace <code>rmain_gameendwin=Game is won by %s</code> by <code>rmain_gameendwin=%s wins the game.</code>. The statement %s will be replaced dynamically by the name of the player. In case of more than one formatting the sequence matters. In particular you must not interchange %s and %d.

For hints it is possible to define line breaks. To do so, add ''\\n'' at the position where you want to break the text. You may add as many line breaks as you need.

In case of multiple plurals you can use the pipe char to separate the forms. The plural forms are fix implemented and defined by language ID at the header. For example <code>Zero items|One item|Many items</code>, in case of French.

{{Languages|Configuration:Create_Menu_Language}}

[[Category:English]][[Category:Configuration]]

Configuration:Create Dictionary

2014-09-25T15:17:50Z

Ocye:

The computer checks the validity of placed words with every move (if not running in challenge mode) and asks for confirmation in case of unknown words. To avoid those queries and to let the computer participate in the game a comprehensible dictionary is essential.

The dictionary is just a simple text file with a formatting according the [[wikipedia:INI_file|ini file format], but with the ending <code>.dic</code>. The program is capable to read different encodings but will always save in [[wikipedia:UTF-8|UTF-8 format]].

If a dictionary is saved by the program, which happens after any change, the content will be encrypted. The corresponding <code>[Key]</code> must not get changed.

== Configuration of the header and applying of categories ==

{| width="100%"
|width="75%"|
General information are provided at the top, using the <code>[Header]</code> identification. Data on <code>Author</code> and <code>Version</code> will be shown in the [[Configuration:Dictionary|configuration dialog]]. You can enter more information here, like licensing or comments as well, but not all will be recognized and used by Scrabble3D. If the [[Configuration:Categories|standard category]] should get a different name as ''Standard'', you may enter it at <code>StandardCategory=<Name></code>. In case of an encrypted dictionary the <code>[Key]</code> to decode it follows. Don't touch this generated value.

Words can be assigned to [[Configuration:Categories|categories]], whose names are listed in the section <code>[Categories]</code>. Up to 255 categories can be used. The assignment of words to a particular category is done by the number.

The section <code>[Words]</code> contains all words. Letters are capitalized on reading. Every line corresponds to a word. If the word is followed by an equal sign the rest of the line (or up to the semicolon) describes the meaning of this word. If a semicolon follows the number identifies the category as defined in the section above.

|width="25%"|

'''[Header]'''
Author=John Doe
Version=0.0.1
Licence=GPL
Comment=Just a demo
StandardCategory=Nouns
'''[Categories]'''
1=Verb
2=Adjective
'''[Words]'''
AA
AARDVARK=an African anteater
ABDUCE=to abduct;1
ADDITIVELY=;2
|}
In the example the word AA has no meaning and is assigned to the standard category "Nouns". The second word AARDVARK got a meaning but no special category again. And the next two words are assigned to the category 1 (Verb) and 2 (Adjective) with or without a description.

== Handling of digraphs ==

{| width="100%"
|width="75%"|

Dictionary that contains of [[wikipedia:Digraph_(orthography)|digraphs]] or [[wikipedia:Trigraph_(orthography)|trigraphs]] needs special treatment. For a proper use of those multi characters letters you have to configure the [[Configuration:Rules|letter set]] accordingly.

For example, the Spanish Scrabble rules show the digraphs CH, LL, and RR as single character on one tile. Since it's not possible to enter the character directly, the dictionary replaces them by 1, 2, and 3. That means entries in the section <code>[Words]</code> like LLAMAR or CHAMPURRA are represented as 2AMAR and 1AMPU3A respectively. And to show digraphs instead of the number the dictionary adds a section <code>[Replace]</code> with the content 1=CH 2=LL 3=RR. In this case, the letter set uses 1..3 for letters.

You can use any character for replacement.

|width="25%"|

[Header]
Version=100003
Author=MIO
StandardCategory=Conforme al DRAE
License=Creative Commons NC3
Release=2010-05-21
Comentario=Los dígrafos CH, LL y RR han sido reemplazados
por 1, 2 y 3 respectivamente.
'''[Replace]'''
'''1=CH'''
'''2=LL'''
'''3=RR'''
[Categories]
[Words]
2AMAR
1AMPU3A
|}

== Integration of letter set ==

{| width="100%"
|width="75%"|
In case of a dictionary that does not have an inbuilt [[Configuration:Letters|letter set]] or if you define a very specific dictionary like math, it could be useful to add the appropriate standard letter set to the dictionary. If a distribution is provided with the dictionary, the program will check the current configuration after loading the dictionary and applies it on confirmation.

The parameter are specified at section <code>[Header]</code> with the (exact) key words <code>[Letters]</code>, <code>[Values]</code>, and <code>[Counts]</code>. The example shows the section from the "math" dictionary
|width="25%"|

[Header]
...
'''Letters'''=⁼,0,1,2,3,4,5,6,7,8,9,−,×,÷,+,.,!,^,²,³,√,∜,∞,>,<
'''Values'''=0,3,1,2,4,3,3,4,5,4,4,6,6,7,6,8,10,9,10,10,7,10,10,10,10
'''Counts'''=18,6,10,8,7,7,7,7,6,6,6,4,4,3,4,3,1,1,1,1,3,1,1,1,1
...
[Words]
−1+26×4⁼103=;3
−1+4×26⁼103=;3
...
|}

{{Languages|Configuration:Create_Dictionary}}

[[Category:English]][[Category:Configuration]]

Configuration:Network

2014-09-25T14:32:34Z

Ocye: Created page with "Network With ''Check for updates'' you configure the interval in which Scrabble3D checks for updates. By click on ''Now'' thi..."

[[File:Config-Network_en.png|right|thumb|300px|Network]]

With ''Check for updates'' you configure the interval in which Scrabble3D checks for updates. By click on ''Now'' this procedure is started immediately.

The option ''Use proxy for network connections'' allows the configuration in special settings and should be activated only if you need to communicate over proxy.

The page network contains not only network settings but as well a couple of miscellaneous features.

All user data are located in a special ''configuration directory'' with guaranteed write access. Under Windows XP this directory is located at c:\documents and settings\<user name>\locale settings\application data\Scrabble3D (Linux uses ~./.config/Scrabble3D). By default, the directories are hidden in the file browser. For convenience, you can copy the complete path to your file manager, or just open it directly per click on the button right hand.

Per ''Movie export'' it is possible to instruct Scrabble3D to export a sequence of screen shots from a game play and combine those using [https://www.ffmpeg.org/ ffmpeg] to a video clip. In order to start this feature you need to install the program, and enter the path here. In the field right-hand you can add parameters to the program call like the desired frame rate. Once you have configured the movie export this features is offered as another file type in the screen shot dialog.

{{Languages|Configuration:Network}}

[[Category:deutsch]][[Category:Configuration/de]]

Configuration:Messages

2014-09-25T14:06:30Z

Ocye:

[[File:Config-Messages_en.png|right|thumb|300px|Settings for messages]]

Message dialogs in Scrabble3D offer the option to prevent them from showing up the next time; as long as the type of the message remains equal (e.g. message, information, end of game etc). At the configuration page ''messages'' these settings can be reverted. Additionally, you can switch on/off jingles.
If the checkbox of an item is checked, the popup dialog will be shown. If the toggle button right hand is down, the jingle will be played.

[[File:Config-Messages-Popup_en.png|right|thumb|300px|Message dialog]]

If you want to get additional processing information you can activate the option ''Show debug messages''. This options might be helpful for bug tracking. Debug information are shown in the popup dialog only, identified by italic font.

=== Own jingles ===
The implemented jingles can be replaced by own wave files. To do so, just place a file with the respective name in the [[Configuration:Network|configuration directory]].

End of game: GameResult.wav
Own move: OwnMove.wav
Chat message: Chat.wav
Scrabble (self): Scrabble_self.wav
Scrabble (opponents): Scrabble_other.wav

Under Linux it is required to place the file in the configuration directory. Furthermore, you have to enter your sound server information here.

The last option ''Sound server'' affects only the Linux variants. You should enter the program here that you run to play wave files, for example paplay in case of Pulseaudio or aplay for Alsa. Optional parameters are possible, the wave file will be added as last parameter.

{{Languages|Configuration:Messages}}

[[Category:English]][[Category:Configuration]]

Configuration:Wings3D

2014-09-12T15:47:22Z

Ocye:

[http://www.wings3d.com/ Wings3D] is a free, open source, subdivision modeler. The program can be used to model and texture low to mid-range polygon models. Wings3D uses context sensitive menus; it is recommended to use a 3-button wheel mouse. It is available for most platforms, including Windows, Linux and Mac OS X, using the Erlang environment.

Scrabble3D uses three models: ''board'' which is obviously the game board, ''piece'' for the tiles, and ''letter'' that is attached to the tiles (all with the object and material files). If a design contains one of these files it is being used to override the implemented data. That means you can start with just a self-made board and keep the inbuilt tiles. The restrictions you have to bear in mind when creating your own design can be found [[Configuration:CreateDesign|here]].

The following examples were made with Wings3D 1.4.1 under Linux.

== Board ==

1. Create a new cube (right mouse button to open the context menu, and click 'cube').

[[File:Configuration-Wings3D_1-en.png|150px|1. Create a cube]]

2. After 'body selection' of the complete cube, the total size of the board is defined by 'Absolute Commands' > 'Scale'. Scrabble3D always paint from -10 to +10 so, with a little margin a new size of x=12, y=1, and z=12 makes sense.

[[File:Configuration-Wings3D_2-en.png|150px|2. Scale the cube to the appropriate size]]

3. The board is being painted at y=0. That means we have to move the cube down by -0.5 units at the y-axis. Select 'Move' from the context menu item 'Absolute Commands' to get the exact position.

4. Now the texture will be applied to the cube:
[[File:Configuration-Wings3D_3-en.png|150px|thumb|3. Texturing: UV mapping]]
* mark all faces that should be textured (usually all except the bottom)
* from context menu 'More' start 'UV Mapping'
* select all objects per ctrl+A in the new window ('AutoUV Segmenting')
* per context menu 'Continue' > 'Unfolding' the projection area is created and filled by a dummy texture
* since the area is quite large it makes sense to scale it per context menu 'scale' > 'uniform' (and move the mouse in one direction until the label shows 1000%)
* (to get a better spatial impression you can rotate the (smaller) side faces)
* in the form 'outliner' select and right click 'auvBG' (which is the newly created texture) and chose 'Make External..."
* enter a nice name for the texture, e.g. background.bmp, and save per 'Make external'
* replace this (dummy) graphic by any other (using the normal file explorer), for instance some kind of mahogany wood
* back in Wings3D select the texture, open the context menu, and run 'Refresh' to update the image

[[File:Configuration-Wings3D_4-en.png|150px|4. Texturing: Refresh of the texture]]

5. Per main menu 'File' > 'Export' > 'Wavefront (.obj)' your model will be exported. Use the name 'board.obj' (the material is saved automatically as board.mtl). Do not forget to store (and pack into the dsgn file later) your background image with these two files. It is only referenced in the material file.

[[File:Configuration-Wings3D_5-en.png|150px|5. Export as Wavefront object]]

== Tiles ==
1. Start with a new project and create a new cube. Scale it to x=1 and z=1. A height of y=0.2 should be fine for normal tiles.

2. Now you have to place the tile on the right position at x=0.5 and z=0.5. In case of a height of 0.2 you should move the tile up by y=0.1. The function is available via context menu 'Absolute Commands' > 'Move'.

[[File:Configuration-Wings3D_6-en.png|150px|1. Scaling and positioning]]

3. Now you may assign a texture to the tile, or you enter the reflexive characteristics of plastics for the material. If the tile should stay yellow you could try the following values (use Ignore for 'Vertex Color', 0.75,0.75,0.0 for Ambient and Diffuse, and 0.1,0.1,0.1 for Specular).

[[File:Configuration-Wings3D_7-en.png|150px|2. Adjusting the material properties]]

4. To have the tiles a little bit separated from each other, we use the function 'Bevel' from the context menu. But first the selection should be changed from all faces to only the top face (deselect by clicking the small icon at the form Geometry Graph, select the top face using the face selection mode). Then activate the Bevel function and move the mouse for the desired extend.

[[File:Configuration-Wings3D_8-en.png|150px|3. Bending the edges]]

5. Per main menu 'File' > 'Export' > 'Wavefront (.obj)' your model will be exported. Use the name 'piece.obj' (the material is saved automatically as piece.mtl).

== Letter ==

What is missing now at last, is the position where letters have to be drawn on the tile. This is just a simple plane but size and orientation matter here. If you want to use the tile with beveled edge on top - this is the exact place for the letter.

1. Mark all faces except the upper plane. To remove all selected, use 'Dissolve' from the context menu.

[[File:Configuration-Wings3D_9-en.png|150px|1. Remove all faces except that where the letter should be shown at]]

2. Deselect the lower side of the remaining plane (or rather mark only the upper). Per context menu 'More' > 'UV Mapping' plus select all (ctrl+A) and 'Continue' > 'Unfolding' you generate a dummy texture again.

3. This texture should get rotated and mirrored now. Open the context menu, select 'Rotate' and adjust to exactly 180°. Thereafter use 'Flip' > 'Horizontal'.

[[File:Configuration-Wings3D_10-en.png|150px|3. Mirror horizontally after rotation by 180°]]

4. Go to the 'Outliner' form and rename the material cube1_auv to 'letter'. The actual texture will be generated by Scrabble3D. You don't need to add the dummy texture to the design package.

[[File:Configuration-Wings3D_11-en.png|150px|4. Rename the material into 'letter']]

5. Set material's opacity to 0 to make the letter transparent.

[[File:Configuration-Wings3D_12-en.png|150px|5. Adjust transparency]]

6. Export the object per main menu > 'File' > 'Export' > 'Wavefront (.obj)' with the name letter.obj.

7. If you do not add the dummy graphic to the design package an error message will pop up. To fix the problem you can edit the material file manually. Just delete the line <code>map_Kd auvBG.tga</code>.

== Files ==
The files contain all Wings3D project data as well as object- and material data and the texture.

* [http://sourceforge.net/projects/scrabble/files/Designs/Wings3D/board.zip/download Board.zip]
* [http://sourceforge.net/projects/scrabble/files/Designs/Wings3D/piece.zip/download Piece.zip]
* [http://sourceforge.net/projects/scrabble/files/Designs/Wings3D/letter.zip/download Letter.zip]

{{Languages|Configuration:Wings3D}}

[[Category:English]][[Category:Configuration]]

Configuration:CreateDesign

2014-09-12T14:39:59Z

Ocye:

{| width="100%"
|width="75%"|
A ''design'' is a zip compressed file that contains at least the file "content.xml" and model data as well as textures in case of a [[Configuration:Wings3D|self-made design]]. All parameters concerning the configuration are entered into the config.xml and will be loaded on game start. Both the [http://en.wikipedia.org/wiki/XML XML format] as well as the content are similar to the actual Scrabble3D configuration stored in the file "Scrabble3D.conf", whereas only the section <code><Design></code> is of interest. That means you can just copy this section from your configuration into the content.xml to share your settings.

Additionally to the <code><Design></code> section, the file has to contain <code><General></code> (which is not the same as for Scrabble3D.conf). This section provides meta information. In particular, the parameter <code><Version></code> is important for the validity checks.

On loading a design the program expects self-made 3D models and textures with a predefined name. Otherwise the system standard is used. The board with the respective material file has the name "board.obj/board.mtl", tiles are known as "piece.obj/piece.mtl", and letters as "letter.obj/letter.mtl". The program looks for textures for premium squares under the names "Normal.bmp", "DoubleLetter.bmp", "TripleLetter.bmp", "QuadLetter.bmp", "DoubleWord.bmp", "TripleWord.bmp", "QuadWord.bmp", "Start.bmp", "Letter.bmp", "NewLetter.bmp", "MalusSingleLetter.bmp", "MalusDoubleLetter.bmp", "MalusTripleLetter.bmp" und "MalusQuadLetter.bmp".

To make a design available to the community just send it per email to the author of Scrabble3D (check the about dialog). By integrating this design into the process of [[Installation:AutoUpdate|auto updates]] it is published for all players.
|width="25%"|
<?xml version="1.0" encoding="utf-8"?>
<CONFIG>
<General>
<Version Value="1.0.1"/>
<MaxVers Value="1"/>
<Author Value="Scotty"/>
<Date Value="31.10.2013"/>
<Comment Value="Simple design without 3D"/>
</General>
<Design>
<Font>
<cbShowScore Value="True"/>
<cbRoman Value="False"/>
...
</Design>
</CONFIG>
Text of the file 'content.xml', that is packed (zip) into a design file (dsgn).
|}

{{Languages|Configuration:CreateDesign}}

[[Category:English]][[Category:Configuration]]

Configuration:ComputerOptions

2014-08-29T13:54:57Z

Ocye: Created page with "Computer options With the trackbars on this page the tactical behavior of the computer is controlled and, with appro..."

[[File:Config-ComputerOptions_en.png|right|thumb|300px|Computer options]]

With the trackbars on this page the tactical behavior of the computer is controlled and, with appropriate settings, the result is influenced on a positive side.

If you use the ''[[Rules:Variants|Cambio Secco]]'' in your game and enabled the checkbox at the respective configuration [[Configuration:ExtendedRules|page]], the computer will use it too. The ruler controls when the Cambio Secco is applied, that means if a moves scores below the setting.

The same is true for ''joker exchange''. For moves that scores below the given value the computer tries to replace a placed joker by the corresponding tile first. If not possible, it places the word or exchanges tiles.

Both rules are deactivated unless the feature is enabled. You can switch to the configuration page by clicking the caption. Currently, the computer is not able to use the what-if feature, and no trackbar is implemented for it, therefore.

The rules of ''exchange tiles'' control when to place a word or rather to change tiles. This function comes into play after the Cambio Secco and the joker exchange have been tried, if available. ''Value'' means what score would result at best, and ''length'' how many tile would be placed. Only if both are below the specified value the computer will change tiles. For example, you the best word scores with 19 points and contains 3 tiles from the rack. If you limit words to 20 points and at least 4 letters this word will not be used.

The last trackbar ''use joker only in advance of'' optimizes the use of jokers. If the best word with joker has no advantage to the second best without joker as specified the one without joker will be placed and jokers are preserved for the next move.

{{Languages|Configuration:ComputerOptions}}

[[Category:English]][[Category:Configuration]]

Configuration:DesignIllumination

2014-08-27T13:36:54Z

Ocye:

[[File:Config-DesignIllumination_en.png|right|thumb|300px|Illumination options]]

One of the most important features of OpenGL is the ability to simulate light. Ambient lighting is used for the radiant effect in lighting. It represents a fixed-intensity light source that affects all objects in the scene equally. Diffuse lighting is the re-emission from a surface. A "non-shiny" surface which re-emits everything that hits it (like snow or rough wood) would have a very high diffuse lighting value.

There are some more lightning features in OpenGL. For example, your illumination does not only depend on the light configuration but as well on the configuration of the material, which is done in the design.

The personalization of the basic variables is possible. That is the ''light position'' (Scrabble3D has only one source) on the x,y, and z-axis. And below you have access to the intensity of ''ambient'' and ''diffuse'' light in percent.

''Mipmapping'' is a technique for antialiasing of textures in relation to their distance. It means that textures are pre-calculated, optimized sequences of textures, each of which is a progressively lower resolution representation of the same image. Try to switch it off if you don't like the blur side effect.

With the option ''transparent board'' the texture of the board is either opaque, that means you cannot see the actual board behind the square, or transparent.

The last option ''reflective board'' simulates a polished board. The board will reflect pieces if this option is set.

{{Languages|Configuration:DesignIllumination}}

[[Category:English]][[Category:Configuration]]

Configuration:Design2DView

2014-08-27T13:14:42Z

Ocye:

[[File:Config-Design2DView_en.png|right|thumb|300px|Option for the 2D view]]

The page ''2D view'' allows to tweak the visualization of the board. First of all you can choose between ''OpenGL'' and ''Standard Graphics''. The 'Open Graphics Library' is a programming interface to achieve hardware-accelerated rendering, including perspective, [[Configuration:DesignIllumination|illumination]], and texturing. This modus has the option to create and share your [[Configuration:CreateDesign|own board]], or to use one provided by the community respectively. Those designs can have a freely defined form (for instance octagonal), the material is variable (the board can be made out of wood or metal), and the perspective is optional.

The latter can be adjusted directly in the [[Usage:2D-View|2D view]] or at this page. The ''distance'' (also known as zoom) changes the z-axis (use the mouse wheel alternatively). With ''pitch'' you can change the plane angle on the horizontal axis (change it directly with left mouse pressed somewhere on the view). The value can vary between zero (parallel) and 90 (top view). The third option for the perspective, ''translation'', moves the board up or down (with pressed alt key you can move the board on both x- and y axis). All perspective settings are restored to the default by pressing alt + 0 (zero).

If you do not want to adjust the perspective directly with the mouse, uncheck the respective option ''adjust per mouse''.

All these options are not available in the standard graphics mode.

The visualization of ''joker'' and ''random'' tiles contains a small decorator in the lower right corner. If you want to change this decoration click on the icon and select the picture you want. Technically, white pixels will be transparent. (At the moment changes to these bitmaps are not stored and are not persistent after restart.)

{{Languages|Configuration:Design2DView}}

[[Category:English]][[Category:Configuration]]

Configuration:DesignColor

2014-08-26T09:57:03Z

Ocye:

[[File:Config-DesignBoardColor_en.png|right|thumb|300px|Board colors]]
[[File:Config-DesignPlayerColor_en.png|right|thumb|300px|Player colors]]

Almost all color settings can be adjusted for individual preferences. For example the color of normal squares are either green or ocher, depending on the region. Settings are applied immediately and stored automatically, independent from [[Configuration:Presets|presets]].

At ''Board colors'' the options for bonus and normal squares are listed. Per double click or click on the 'change' button the standard dialog for color settings opens. The 'user defined colors' within this dialog are applied according default settings to make the reactivation of the original configuration easy.

Under ''Player color'' you will find a special feature of Scrabble3D: tiles of players can have a distinct color when the option ''Use player color'' is enabled. Per click on one the panels below you can choose the color for players (1 to 4). And with ''Shaded'' the reading of the letter should be supported in case of bright colors.

Furthermore you can ''Mark the last move''. With this option you can easily identify the least moves of your opponents. Again, the colors can be chosen by click on the panel.

Chat messages get the same color as defined for the players during network mode. With the option ''Chat color luminance'' you may control the intensity of this color to make even yellow or other bright colors readable on white background. And in case of a system theme with darker background you might want to have text with rather more lightness.

The last option ''Background color'' can be used to change the appearance of the 2D and 3D view.

{{Languages|Configuration:DesignColor}}

[[Category:English]][[Category:Configuration]]

Configuration:DesignGeneral

2014-08-13T14:01:49Z

Ocye:

__NOTOC__

[[File:Config-DesignGeneral_en.png|right|thumb|300px|General design options]]

A multitude of options can be used to tweak the layout for your needs and preferences. When starting the program the chosen [[Configuration:Design|predefined design]] is loaded and thereafter modified according the last settings made. That means your personal setting of, for instance, the letter size will be persistent. But take care: all individual settings are overwritten when loading another predefined design.

Changes are applied immediately. It is not necessary to select a particular [[Configuration:Presets|preset]] since design options are stored separately.

== Options ==
With ''font name'' the currently active font is shown. In order to change click the button right hand which opens the standard font dialog. Only the font type identified by the name is taken from the dialog. Size, effects or font color is set differently.

Since fonts are different and have smaller or larger faces it's often necessary to adjust the font size. This is done by a proportional value entered at ''letter size''. The same is true for the font size of tile's value at ''number size'', which is usually smaller and has it's own control therefore. The specification in percent means the font size in relation to the square size so the board can be scaled easily.

''Bonus marker in 2D'' will toggle the small triangles around bonus squares that identifies the bonus even when a letter is placed on that field. This feature is enabled by default.

If someone dislikes the Greek letters shown at the third dimension in 3D games the next option ''Coordinates in roman letters'' is for alternate visualization. The x-axis is always labeled with Latin characters (A..Z), and the y-axis with decimal numbers (1..42). In case of boards that are larger than the number of available Greek characters Roman numbers will be used anyway.

With the switch ''Show score with each move result'' you can get the current score with the move information. For instance '1.player places SNAFU and receives 10 points. (1.player=23, 2.player=42)'. This information is redundant to what is shown in the [[Usage:Statusbar|status bar]].

''Bonus field description'' shows an informative text on bonus squares, if checked. For instance, the red square may have a caption '3x word'. The option has no effect when the visualization is done in [[Configuration:Design2DView|OpenGL mode]].

The ''toolbar'' with access to functions in 3D mode will be shown only in those games. Because all [[Usage:3D-View|functions]] are available as well via mouse and keyboard, this option hides the toolbar or shows it again.

The option ''Lock 3D board'' is again a feature for 3D games. It controls what happens when you [[Usage:3D-View/de|switch the active dimension]]. Either the cube is rotated to the new view or remains in the current position.

With ''rack position'' you control where the rack is being located. Either right hand above the messages or below the 2D-view. It depends on your screen size and resolution which option is the best.

The option ''Flat panels'' influences the visualization of views. Non-flat panels are slightly elevated, flat do not have that bevel.

And per ''status bar'' you can clean up the view even more. Uncheck to hide the status bar completely.

{{Languages|Configuration:DesignGeneral}}

[[Category:English]][[Category:Configuration]]

Configuration:SpecialBoard

2014-08-12T15:25:42Z

Ocye: Created page with "Own board layout The chosen predefined board is adopted here and can be changed. If you want t..."

[[File:Config-SpecialBoard_en.png|right|thumb|300px|Own board layout]]

The chosen predefined [[Configuration:Board|board]] is adopted here and can be changed.

If you want to use a larger or smaller board just enter the desired size at ''board size''. A minimum of 2x2 and a maximum of 48x48 should be sufficient for all needs.

The three-dimensional game can be activated with the radio button ''3D''. In this case, the board is configured layer by layer as for 2D games. The layer is changed with the trackbar above the preview.

You can change the bonus squares by either left click - that iterates through the options, or via right click. The context menu provides all available bonuses. For instance, you can move the start point to some different location (but it's important to have at least one start square) or to clutter the board with bonuses. Perhaps you want to play with malus too. Try it around a bonus field to make the bonus expensive. The options 'letter' and 'new letter' are disabled and cannot integrated in the board, therefore. Available are the usual letter- and word multiplicators and malus for letters with up to four times of the tile's value.

{{Languages|Configuration:SpecialBoard}}

[[Category:English]][[Category:Configuration]]

Configuration:ExtendedRules

2014-08-07T15:35:24Z

Ocye:

__NOTOC__

[[File:Config-ExtendedRules_en.png|right|thumb|300px|Rule options]]

The subitem ''options'' below rules provides some options to adopt the game for regional standards as well as some newly introduced features.

== Simple check boxes ==
=== Joker exchange ===
As a new feature, Scrabble3D introduces the option to exchange previously placed jokers with the equivalent letter. Just move the tile onto the placed joker and drop it if this option is set and the letters are the same (the drag symbol shows whether or not dropping is possible). When you exchange a joker nothing else is allowed thereafter - no change of tile, no placement of letters.

=== Jokerization (What-if-only variant) ===
With ''Jokerization'' also known as what-if-only variant allows the exchange of a tile at the rack into a joker. However the move is treated as valid subsequently only when the move scores with at least points as defined at the bonus for a Scrabble/Bingo (usually 50 points). The functions is available in every move for one tile on the rack. The joker is not drawn from the bag so you will probably end with more jokers on the board than originally defined.

=== Cambio Secco ===
''Cambio Secco'' is a well known extension at the Italian rules. Once in a game you can exchange all tiles on the rack without losing the right to move.

=== Treat zero moves as pass ===
With the option ''Treat zero moves as pass'' the effect of moves with zero points to the game end is controlled. If the option is checked the change of tiles or invalid moves are counted as well as a pass.

=== Subtract/Add left tile's value ===
These two options control the final evaluation. The score of all not placed tiles will be deducted from the player's result, if the option is set. The sum of all deducted values is added to the result of the player who ended the game. Therefore, the option to add left tile's value is available only if subtraction is checked.

== Numerical Options ==
=== Penalty for jokers left ===
If someone has jokers not placed after the game end, this could be penalized with extra points for every joker on the rack.

=== Passes until game end ===
Repeated pass lead to game end. With this option you control how often every player can pass (or do a zero point move in respect to setting above). The default setting if 2 for English means that every player can have 2 passes so in total 4 times no tile is placed. You get informed about the remaining moves in the [[Usage:Messages|messages]]. If one of the player makes a valid move the number of passes is set to zero.

=== Bonus on game end ===
A player who ends the game with a Scrabble may receive an extra bonus for this feat. The value 0 means no bonus is given, which is the default.

=== Limit exchange to #tiles ===
Some regional rules restrict the change of tiles at the rack to a certain number of tiles left in the bag. For instance, the Spanish rules require more than 1 tile left, the Italian rule 3, and in French it is the number of tiles on the rack (that is 7). The English default 0 means that you can exchange as long as the bag is not empty.

=== Bonus für Scrabbles/Bingos ===
With this option you can change the bonus when all tiles are placed at once from the known 50 points to any other value. Consider to play with this option in combination with the jokerization.

=== Player sequence ===
This option replicates the setting from the [[Usage:NewGame|new game]] dialog. It is the only way to switch the sequence when in network mode, but available only if all players in the group run at least release 3.1.4.

{{Languages|Configuration:ExtendedRules}}

[[Category:English]][[Category:Configuration]]

Configuration:TimeLimit

2014-07-31T15:50:36Z

Ocye:

__NOTOC__

[[File:Config-TimeLimit_en.png|right|thumb|300px|Time control]]

A couple of modes for time control are available in Scrabble3D. In case of limit per game you can choose as well how to proceed after timeout.

All specification is done in hours:minutes:seconds (hh:mm:ss). Changes will be applied to the next game.

== Time control ==

=== No limit ===
Select ''no limit'' to have as much time as you need for all moves. The [[Usage:Toolbar|display at the toolbar]] will show the total used time per player instead of a countdown.

=== per move ===
If you decide to limit the time ''per move'' every player has only as much time per move as specified. If a player runs out of time the move is finished with the currently placed tiles. In this case you cannot correct the move even if the word check mode is '[[Configuration:WordCheckMode|takeback]]'. Misplaced tiles as well as unknown words lead to an invalid move.

=== per game ===
With a limitation ''per game'' you define the maximum time of the game. The value applies to the total time, that means it is equally split over players. For instance, if you run a game with two players and set the limit to 02:00:00 (two hours), every player will have up to one hour to play.

== Time penalty ==
In case of limitation ''per move'' the next player function is executed automatically on a time out. Thereby the move is finished and placed tiles are checked for validity.
For a limitation ''per game'' some options are available:

=== Game end for player ===
The player who has run out of time will 'pass' automatically. She will be asked in polls, but cannot place or exchange tiles. However, the auto pass function works in [[Network:Asynchronous_Game|asynchronous games]] only when the player loads the game.

=== Penalty per minute ===
Some tournament rules stipulate a penalty in form of deducted points for every minute. Of course this feature is only available if the player has enough points. Furthermore it is often limited to a certain number of repeated time-outs. Otherwise the auto pass function comes into play. The game applies the penalty automatically, you will get just a short information.
The British and American tournament rules allow up to 10 additional minutes, every one costs 10 points.

=== Game lost after final time out ===
You can decide whether or not a player who runs finally out of time can still win the game if she has gathered a high scoring, or if she forfeits the game. If you check this option (which is the standard in English tournaments), and the 10 additional minutes are expired, the score is zeroed. And of course this player will auto pass now.

{{Languages|Configuration:TimeLimit}}

[[Category:English]][[Category:Configuration]]

Configuration:WordCheckMode

2014-07-24T14:58:02Z

Ocye:

__NOTOC__

[[File:Config-WordCheckMode_en.png|right|thumb|300px|Word check mode]]

During the game it might happen that unknown words are placed. Scrabble3D offers three alternatives to check words beginning with a simple game for training purpose up to tournament rules. In any case the validation is done first by the computer based on the [[Configuration:Dictionary|dictionary]]; unknown words are not necessarily invalid. It might be unknown for the computer because it's a very long word, for example. And therefore the word can be confirmed anyway after the first validation.

=== Takeback ===
If you activate the option ''Takeback'', the current player is informed in case of unknown words. She decides to place another word or to continue with the poll.

=== Poll ===
First it's checked if the dictionaries of all connected players contain both the placed as well as every connected words (in local games it's of course just one dictionary). In case a word is not found at any dictionary, the move is placed into the confirmation ''poll''. That means all players decide about the validity. If all players confirm the placed words are treated as valid, but if only one disagrees the move is rejected.

=== Challenge ===
The validation is not done automatically in tournaments. You rather have a certain period (usually a few seconds) to object the move and to start the validation procedure. In Scrabble3D this is done by clicking the [[Usage:Toolbar|toolbar button]] ''challenge'' (you can use also the menu or press ctrl+H); the first click is being evaluated in case more than one player wants to object the move. The procedure then runs according the poll: first the check is done silently and only if one word is unknown for any player the confirmation poll is shown.

Additional to the common ''penalty'' that is given to the objecting player in case when all words are actually valid, you can receive an equivalent ''bonus'' for approved objections. Of course the score for invalid moves is set always to zero.

== CLABBERS ==

CLABBERS, an anagram of SCRABBLE, allows to play words with scrambled letters. The validity check tests not only the word itself but as well any permutation of letters. In real games the player has to specify which word is constituted by the anagram - this does not apply here. The increased ability to play parallel to pre-existing words makes for much higher scores.

{{Languages|Configuration:WordCheckMode}}

[[Category:English]][[Category:Configuration]]

Configuration:Localization

2014-07-17T13:35:45Z

Ocye:

[[File:Config-Localization_en.png|right|thumb|300px|Localization]]

With ''localization'' the language of labels in menus and dialogs is set. This setting is independent from the used dictionary; you can have an English interface and run games in Farsi.

The installation is as easy as possible. The dialog lists all available localizations (the list is refreshed on every check on updates). Files are hosted on Sourceforge.net, you can download it for free (see as well the [[Installation:Licence|license]]). Just double click an item or use the 'Load' button. If a file is not yet locally available you have to confirm the download. Local files are recognized by a version number. It is possible to delete local files via the trash icon.

Information about the localization is shown below the list: file name, author, and release date.

Localization related settings are saved automatically. Settings are not related to a [[Configuration:Presets|preset]]. All changes are immediately active.

== Transifex ==
The actual translation is done on [https://www.transifex.com/projects/p/scrabble3d/ Transifex]. This platform offers options for efficient and cooperative work. To join the localization team you have to register at Transifex. Via "English (United Kingdom) > Program > Translate now" you will find the English version.

To make the finished work available for the community just send an email to the author please. Scrabble3D is an open source project - every help is welcome!

== alternative localization ==
Previous versions of Scrabble3D used a different kind of localization. Some aspects are done more easily but many new features are not available. Both variants are still supported - the instruction for the legacy localization can be found [[Configuration:Create_Menu_Language|here]].

{{Languages|Configuration:Localization}}

[[Category:English]][[Category:Configuration/de]]

Configuration:Categories

2014-07-17T11:56:39Z

Ocye:

__NOTOC__

[[File:Config-Categories_en.png|right|thumb|300px|Categories]]

Words can be assigned to a ''category''. By deselecting a category the words are kept in the dictionary but will be treated as invalid. Words that are part of of a deselected category are highlighted with yellow background in the [[Usage:WordSearch|word search]] dialog.

The kind of such a category is left completely to the user respectively the author of the dictionary. For instance verbs and nouns can be identified, or a bi-lingual dictionary can be created where just one language is used at once, and, applied in the German dictionary, different reference books can be selected. However, categories should be taken carefully into consideration, since loading might be slowed down unnecessarily. The standard category "unknown" can be renamed to something else but cannot be disabled.
Words of a category that has been disabled by user are still available in the dictionary, and shown appropriate in the [[Usage:WordSearch|word search dialogue]], but will not be used by the computer and require acceptance if placed by user.

A dictionary can be loaded during a game and categories can be selected or deselected after game start as well. Information about loaded file and settings are synchronized in [[Usage:Network|network games]].

== English ==

Tournament Word List (TWL) is the official word authority for tournament Scrabble in the USA, Canada and Thailand. It is based on the Official Scrabble Players Dictionary (OSPD) with modifications to make it more suitable for tournament play. Its British counterpart is Collins Scrabble Words, and the combination of the two word lists is known as SOWPODS. (Wikipedia)

{{Languages|Configuration:Categories}}

[[Category:English]][[Category:Configuration]]

Configuration:Presets

2014-07-17T11:26:27Z

Ocye:

[[File:Config-Preset_en.png|right|thumb|300px|Presets]]

All settings related to the game play are saved in presets. Those presets comprises of all rules and the dictionary. For example, you can have one preset with tournament rules and another with settings for training purpose. Or define one preset for English and another for French both with the respective dictionary to switch between two languages. And if you want to quickly switch between classic Scrabble and Superscrabble you may define a set with the 21x21 board and the adjusted letter distribution.

However, it is not mandatory to store settings in a preset, values are effective with the next game. But to have it available after the next program start you need to save it. Furthermore, stored presets can be loaded directly from the [[NewGame|new game]] dialog.

== Load ==
To load a particular preset just select an entry from the drop-down menu. In case of modified settings you have to confirm first. When a preset has been loaded successfully the most important information are show below.

== Save ==
Settings can be saved under the given name per click on 'Save' (which is disabled unless some settings are changed). Alternatively, you can enter a new name, e.g. 'British English without time control' instead of 'Standard'. With enter or per save button the settings are saved with this name.

== Delete ==
You can remove a currently loaded preset per click on the trash icon.

{{Languages|Configuration:Presets}}

[[Category:English]][[Category:Configuration]]