1001 Touch Games

###################################################
1001 Touch Games
Lista plików TEKSTOWYCH do przetłumaczenia.
###################################################

1. Data/localization/us/texts_games.txt:
    Nazwy gier + Teksty wykorzystywane w poszczególnych grach, niektóre z nich są współdzielone pomiędzy większą ilością gier,
    niektóre nie. Format: na początku każdej linii unikalny identyfikator tekstu (bez spacji), a potem do końca linii
    treść danego tekstu (mogą być spacje, tabulatory, ale znak nowej linii już nie).

2. Data/localization/us/helps/*.txt:
    Teksty wyświetlane jako pomoc do gier: opisy zasad, itp.
    Ponadto help do menu gry i teksty współdzielone przez wszystkie helpy.
    
3. Data/localization/us/texts_mapNames.txt:
    Nazwy wariantów gier lub poszczególnych map niektórych gier.
    Format jak przy pierwszym pliku.
    
4. Data/localization/us/texts_menu.txt:
    Teksty wyświetlane dynamiczne w menu głównym.
    Format jak przy pierwszym pliku.
    
5. Data/localization/us/game_wordSearch/maps/*.txt (poza filenames.txt):
    Katalog z plikami tekstowymi, używanymi jako słowniki w grze WordSearch (wykreślanka).
    
6. Data/Keyboard/characters.txt
    spacja, enter i nazwa jezyka

7. Data/localization/us/texts_controll_menu.txt:
    Teksty wykorzystywane jako napisy na przyciskach i innych elementach interfejsu użytkownika
    w menu głównym.
    
8. Data/localization/us/game_hidden/Lang.txt:
    Nazwy obiektów, które należy znaleźć na planszy w grach typu Hidden Object (których jest 7). ---- WZIAC OD LODZI ----------------


##################################################
1001 TouchGames
Lista plików GRAFICZNYCH do przetłumaczenia.
##################################################

1. Logo Nintendo, SelectSoftu i Teyonu
    Data/data_menu/loading_screen/
    Do tego odpowiedni psdk: Data/data_menu/loading_screen.psd

2. Logo gry
    Data/data_menu/
    Chyba w prawie kazdym psdku do menu

3. Loga minigier
    Data/data_menu/logos/
    Do tego odpowiedni psdk: Data/data_menu/logos.psd
    Wszystkie fonty wykorzystane w logach są tutaj W:\Dev\Team_Piotrek_Natalia\InProgress\1001 TouchGames DS\_GRAFIKA 2D\fonty\fonty_Moniki
    Natomiast psdki tutaj (ale nie wiem czy aktualne, pytac Moniki), tutaj: W:\Dev\Team_Piotrek_Natalia\InProgress\1001 TouchGames DS\_GRAFIKA 2D\nasze\psd warstwy\Loga stare wersje

4. 'START' od racingu
    Data/data_games/game_Rally/...


#################################################
1001 TouchGames
Ilosci znakow dla niektorych, waznych slow
#################################################

1. Nazwy gier - MAX 25 ZNAKOW - wyswietlane w Choose Game GC, Choose Game BGH (oprocz tego jeszce w samych grach, jednak tam maja duzo miejsca)
Wystepuja (tuz po Legendzie) w pliku: 
Data/localization/us/texts_games.txt

2. Slogany - MAX 100 ZNAKOW - (teksty w jednym zdaniu opisujace gre), wyswietlane w oknach Choose Game GC, Choose Game BGH, Before Game (oprocz tego jeszce w helpach gier, jednak tam, maja duzo miejsca)
Wystepuja (ostatni dlugi akapit, przedrostki 'game_desc_) w pliku: 
Data/localization/us/texts_menu.txt

3. Nazwy kategorii - MAX 30 znakow - wyswietlane w Choose Game GC, Choose Game BGH, HS?
Wystepuja (niestety w kilku miejscach) w plikach:
Data/localization/us/texts_menu.txt
Data/localization/us/texts_controll_menu.txt

4. Przyciski w menu (w tym dolnym pasku, we wszystkich oknach) - środkowe MAX 15 znakow, boczne MAX 12 znakow

5. Jeszcze troche roznych miejsc...

###################################################
1001 Touch Games
List of TEXT files to translate.
###################################################

1. Data/localization/us/texts_games.txt:
    Game names + Strings used in specific games, some of them are shared between a larger number of games,
    some aren't. Format: a unique string identifier at the start of the line (without spaces), followed by the given string's content until the end of the line
    (can contain spaces, tabulators but no newlines)

2. Data/localization/us/helps/*.txt:
    Strings shown as help for games: description of rules, etc.
    Moreover help for the game menu and strings shared by all help.

3. Data/localization/us/texts_mapNames.txt:
    Names of game variants or names of specific maps for some games.
    Format is the same as the first file.

4. Data/localization/us/texts_menu.txt:
    Strings dynamically shown in the main menu.
    Format is the same as the first file.

5. Data/localization/us/game_wordSearch/maps/*.txt (other than filenames.txt):
    Folder containing text files used as dictionaries in WordSearch (crosword puzzle).

6. Data/Keyboard/characters.txt
    Space, enter and language names

7. Data/localization/us/texts_controll_menu.txt:
    Strings used as labels on buttons and other UI elements
    in the main menu.

8. Data/localization/us/game_hidden/Lang.txt:
    Names of objects that need to be found on the board in games like Hidden Object (of which there's 7). ---- TAKE FROM ŁÓDŹ ----------------


##################################################
1001 TouchGames
List of GRAPHIC files to translate.
##################################################

1. Nintendo, SelectSoft and Teyon logos
    Data/data_menu/loading_screen/
    Appropriate PSD for this: Data/data_menu/loading_screen.psd

2. Game logo
    Data/data_menu/
    Probably in almost every menu PSD

3. Mini-game logos
    Data/data_menu_logos/
    Appropriate PSD for this: Data/data_menu/logos.psd
    All fonts used in logos are here W:\Dev\Team_Piotrek_Natalia\InProgress\1001 TouchGames DS\_GRAFIKA 2D\fonty\fonty_Moniki
    PSDs, however, are here (I don't know if they're up-to-date, though, ask Monika), here: W:\Dev\Team_Piotrek_Natalia\InProgress\1001 TouchGames DS\_GRAFIKA 2D\nasze\psd warstwy\Loga stare wersje

4. 'START' for racing
    Data/data_games/game_Rally/...


#################################################
1001 TouchGames
Character counts for specific important words
#################################################

1. Game names - MAX. 25 CHARACTERS - shown in Choose Game GC, Choose Game BGH (also in the games themselves, though they have a lot of space there)
They show up (after the legend) in the file:
Data/localization/us/texts_games.txt

2. Slogans - MAX. 100 CHARACTERS - (strings describing the game in one sentence), shown in the Choose Game GC, Choose Game BGH, Before Game windows (also in the games' help, though they have a lot of space there)
They show up (the last long paragraph, 'game_desc_' prefix) in the file:
Data/localization/us/texts_menu.txt

3. Category names - MAX. 30 characters - shown in Choose Game GC, Choose Game BGH, HS?
They show up (unfortunately in multiple places) in the files:
Data/localization/us/texts_menu.txt
Data/localization/us/texts_controll_menu.txt

4. Menu buttons (in that bottom bar, in all windows) - cented MAX. 15 characters, side MAX 12 characters

5. And various other places...

//Legenda
// \n enter
// >< twarda spacja
// %f liczba float
// %d liczba int
// %s string

//Legend
// \n enter
// >< hard space
// %f float number
// %d int number
// %s string

Katalog "Keyboard" zawiera:

1.keyboard_vertical.psd, keyboard_horizontal.psd

- warstwa <canvas='Background'> jest niezbedna, poniewaz sluzy do pozycjonowania calej klawiatury

- warstwa <canvas name='textBox'> i jej label - nie sa niezbedne

- litery pozycjonowane sa nastepujaco:
-- pozycja y - wyznaczona poprzez helpery (<... type=helper>)
-- pozycja x - litery ustawiane sa automatycznie z kodu, czyli: centrowanie do srodka psdka, odstepy pomiedzy literami wyznaczane przez warstwe <img=marginHelper> w grupie <button name='letter'>

- helpery (<... type=helper>) s³uza jedynie do wyznaczenia pozycji w pionie (y). Nie jest brana pod uwage ich wysokosc, szerokosc czypozycja w poziomie (x)

- gdy brakuje jakiejs warstwy (lub jest blednie nazwana), to program nie powinien sie wywalic (jesli sie wywali to prosze mi zglosic - Nat)


2. characters.txt

- <special> <special2> - znaki specjalne

- <en> <pl> <es> <it> <fr> <de>
    - pierwsze trzy linijki  to trzy rzedy liter w klawiaturze. W pliku tekstowym mozna zmieniac jedynie wartosci liter, nie mozna zmieniac ilosci liter w rzedzie
    - kolejne 3 linijki to slowa: nazwa_jezyka (english), nazwa_spacji (space), nazwa_entera (return). Mozna zmieniac wartosci tych slow.

- <hints> - kazda linia to kolejny dymek. Kazdy dymek przypisany jest do pierwszej litery (np. A). Dymek moze zawierac max 10 liter (w tym pierwsza litera). Polozenie liter pobierane jest z psd'ka. Obrazek dymka przypisywany jest z kodu. 

- brak pliku characters.txt w projekcie powoduje wywalenie programu

3. font.data, font.png

- brak ktoregos pliku z fontem powoduje wywalenie programu

4. tap.wav

- obecnie dzwieki nie dzialaja

FAQ:

? Program sie wywalil
- Prawdopodobnie brakuje jakiegos pliku w katalogu 'Keyboard'. Sa to pliki: font.data, font.png, characters.txt, keyboard_vertical.psd, keyboard_horizontal.psd (iPhone, iPad), katalogi z nazwami psdkow, tap.wav

? Klawiatura sie nie wyswietla
- Prawdopodobnie GameCoder nie wywolal funkcji show()

? Nie wyswietla sie TextBox
- Prawdopodobnie GameCoder nie wywolal funkcji show_textbox()

? Nie wyswietlaja sie zadne litery i napisy
- Prawdopodobnie GameCoder nie podal zadnego jezyka podczas ladowania klawiatury load()

? Brakuje niektorych obrazkow
- Prawdopodobnie warstwy sa zle nazwane

? Niektore obrazki wyswietlaja sie w punkcie (0,0)
- Prawdopodobnie warstwy helperow sa zlenazwane

? Brakuje przycisku 'globe'
- Prawdopodobnie GameCoder podal podczas ladowania klawiatury (load) tylko jeden jezyk, a wiec przycisk 'globe' do przelaczania jezykow nie jest potrzebny

The "Keyboard" folder contains:

1. keyboard_vertical.psd, keyboard_horizontal.psd

- the <canvas='Background'> layer is necessary, as it is used to position the entire keyboard

- the <canvas name='textBox'> layer and its label - aren't necessary

- letters are positioned as follows:
-- y position - determined through helpers (<... type=helper>)
-- x position - the letters are laid out automatically by the code, so: centered to the middle of the PSD, distance between letters specified by the <img=marginHelper> layer in the <button name='letter'> group

- helpers (<... type=helper>) are only used to determine vertical position (y). Their height, width and horizontal position (x) is ignored.

- when a layer is missing (or named incorrectly), the program shouldn't crash (if it does crash then report it to me - Nat)


2. characters.txt

- <special> <special2> - special characters

- <en> <pl> <es> <it> <fr> <de>
    - first three lines are three rows of characters on the keyboard. In the text file you can only change the values of the characters, you can't change the number of characters in a row
    - the next 3 lines are the words: language_name (english), space_name (space), enter_name (return). You can change the value of these words.

- <hints> - each line is another popup. Each popup is assigned to the first character (e.g. A). The popup can contain at most 10 characters (including the first character). Leters position are taken from the PSD. The popup icon is assigned in code.

- if the characters.txt file is missing from the project, the program will crash

3. font.data, font.png

- if either of the font files are missing, the program will crash

4. tap.wav

- sounds don't currently work

FAQ:

? The program crashed
- A file in the 'Keyboard' folder is likely missing. These files are: font.data, font.png, characters.txt, keyboard_vertical.psd, keyboard_horizontal.psd (iPhone, iPad), folders named after the PSDs, tap.wav

? The keyboard doesn't show up
- GameCoder likely didn't invoke the show() function

? TextBox doesn't show up
- GameCoder likely didn't invoke the show_textbox() function

? No letters or labels show up
- GameCoder likely didn't specify any language while loading the keyboard load()

? Some images are missing
- Layers are likely incorrectly named

? Some images show up at the coordinates (0,0)
- Helper layers are likely incorrectly named

? There's no 'globe' button
- GameCoder likely only specified one language while loading the keyboard (load), hence the 'globe' button for switching languages isn't needed