﻿This Homebrew is an entry for the PSP Genesis competition 2011, sponsored by npt, psp-hacks.com, pspgen.com, pspslimhacks.com, exophase.com, pspcustomfirmware.com, daxhordes.org, gamegaz.jp, xtreamlua.com and wololo.net

Official website: http://wololo.net/talk/viewtopic.php?f=26&t=3536&start=0

################################## 
#AnyLanguageStudy                #
#Copyright Nakano 2011.          #
######## VERSION HISTORY #########
# V0.1 02/27/2011 (by nakano)    #
# * Initial release              #
# V0.2 03/02/2011 (by nakano)    # 
# * New word lists               #
# * Increased stability          #
# * Bug fixes                    # 
# * Optimizations for showing    #
#   long phrases.                #
# V0.3 03/05/2011 (by nakano)    #
# * Verb conjugation practice    #
# * Question font size can be    #
#   increased                    #
# * Added options menu           #
# * If user answers wrong, right #
#   answer is given (option)     #
# * User may set a delay before  #
#   answers are shown (option)   #
# V0.4 03/08/2011 (by nakano)    #
# * Support for picture word list#
# * Added range (option)         #
# * Example sentences (option)   #
# * Keys menu                    #
# * Minor bug fixes and          #
#   other optimizations          #
# * Added sentences for japanese #
#   and word list for kana       #
# * Added picture word list      #
# V0.5 03/13/2011 (by nakano)    #
# * A possibility to search      #
#   English definitions (replaces#
#   show keys from V0.4)         #
# * Added an option to           #
#   wait after the right choice  #
# * Added an option to change    #
#   the font color 				 #
# * Fixed a typo sring to string,#
#   which caused crash in certain#
#   situation                    #
# * Slight text changes          #
# * Modified logic, if word was  #
#   not known immediately. Now   #
#   it's not marked right when   #
#   you correct yourself         #
# * Parsed tatoeba sentences     #
# V0.6 04/22/2011 (by nakano)    #
# * Updated competition splash   #
# * Added analog support for     #
#   selection a file             #
# * Minor bug fixes.             #
# * Sentence zoom support        #
##################################

### About AnyLanguageStudy ###

AnyLanguageStudy is a PSP application for studying words, grammar and characters. It comes bundled with Japanese word lists to help you studying for Japanese Language Proficiency Test (JLPT). However, you may create your own study lists for any language. AnyLanguageStudy is an open source project without any specific license. You may use the source for non-commercial projects.

### Installation ###

Copy the folder AnyLanguageStudy to x:\PSP\GAME\. Works with Game Categories too.

### Word lists ###

AnyLanguageStudy folder includes a file dictionary.ini. The file contains the paths of word lists. If you create your own word list, simply add the a new line that has the path (for example language/myLanguage/myWordList.csv). If you do not want to use some word list, comment the line with #.

Word list format is comma-separated value (csv). This means words are separated with ;. For example, Finnish-English word list might have the following words:

auto;car
kissa;cat
aurinko;sun

Last word is always definition because same word might have multiple presentation formats. For example, Japanese-English word list might have the following words:

kuruma;くるま;車;car
neko;ねこ;猫;cat
hi;ひ;日;sun

An easy way to create lists is to use OpenOffice Calc and save the file as csv. After this you need to convert the file to UTF-8 without BOM encoding. Notepad++ can be used to achieve this. You may also want to use Notepad++ to remove all " characters.

### Picture word lists ###

You may also create picture word lists. In this case csv-file's definition is picture path. For example, cat;language/images/cat.png. Picture must end with .png. It is recommended that picture size is less than or equal to 480x272 (PSP's screen size). If you need more examples, see study_verbs_with_pictures.csv file. Only mode 1 is supported with pictures.

### Sentences ###

Sentences also use csv-format. Again last is definition. The sentence file should be put to the same folder as word lists that use the sentences. Sentence list must be named sentence.csv so that it is found. For example a line in sentence.csv might be:

Auto on nopea;Car is fast.

Let's assume that you're asked what "Car" is in Finnish (it's "Auto"). When you have answered right, the above sentence is shown as it has the word "Auto".

### Keys ###

UP: Move up / Switch mode (e.g. English-Japanese -> Japanese-English)
DOWN: Move down / Switch mode
RIGHT: Next page / Switch show (e.g. romaji -> hiragana -> kanji)
LEFT: Previous page / Switch show
ANALOG UP/DOWN: Increase/decrease font size or move up/down
ANALOG LEFT/RIGHT: Increase/decrease range or move left/right or previous/next page
R: Next page / Clear list of learned words
L: Previous page / Search
SQUARE: Select / Answer
TRIANGLE: Select / Answer
CIRCLE: Select / Answer
CROSS: Select / Answer
HOME: Quick quit (saving of learned words is done before quiting)
SELECT: Open word list menu (saving of learned words is done before menu shows up)
START: Open global options menu

### Thanks to ###
- Jonathan Waller (http://www.tanos.co.uk) for great JLPT lists!
- Meguro Language Center (http://www.mlcjapanese.co.jp/) for info about past JLPT tests and other vocabulary.
- Saora Inc JLPT-Practice website (http://www.jlpt-practice.com/Lesson/Verbs_Conjugation.aspx) for verbs conjucation exercise.
- Collin McCulley (http://www.epochrypha.com/japanese/) for example sentences.
- Japanese4All (http://www.japanese4all.com/learning/) for great study materials (e.g. picture word list).
- santhosh4gCode for providing a tool to convert kana to romaji (http://www.codeproject.com/KB/recipes/JapaneesTORomajiConverter.aspx). A fair warning it doesn't handle every situation, for example, hiragana "cha" becomes "chiya" when converted.
- MauveCloud for providing a javascript (http://www.mauvecloud.net/charsets/romaji.html) to solve the above mentioned problem (used in V0.2). 
- Zack (http://www.retroemu.com/forum/index.php?/topic/126-release-luaplayer-euphoria-v8-new-features-and-improvements/) for LuaPlayer Euphoria V8.
- BenHur for Intrafont (build within Euphoria).

### Special thanks to ###
 - cmbeke (from Qj.net forums) for helping with special file reading issue.

### My earlier Japanese related projects ###
2011: Japanese Sentence DataBase (http://jsdb.site88.net/)
2010: PSPEdict V0.4-V0.6 (http://forums.psp-hacks.com/f141/release-pspedict-v0-6-japanese-dictionary-t264609/)