source: ps2launchargs/source/uLaunchELF/LAUNCHELF.CNF@ 1126

# ----------------------------------------------------------------------
# File name:    LAUNCHELF.CNF           Revision Date: 2008.07.19
# Created by:   Ronald Andersson        Creation Date: 2006.02.02
# Purpose:      Define new format and defaults for LaunchELF CNF files,
#               to serve as a guide in developing the code implementing
#               these changes.
# ----------------------------------------------------------------------
# Note that LaunchELF v3.41t (or later) will accept this file as-is when
# loading CNF, but if you modify any settings so that LaunchELF saves
# the file again, then all comments will be removed. Also note that each
# LaunchELF version can only recognize those variables that were defined
# for that version. Using newer variables with older versions is futile.
# It should not crash the program, but will not have meaningful effects.
# ----------------------------------------------------------------------
CNF_version = 3
# ----------------------------------------------------------------------
# The CNF_version variable MUST exist for a CNF to be accepted as valid,
# and it must also be the first variable defined in the file. That way
# an old CNF can't cause damage when read by new LaunchELF versions.
#
# From LaunchELF v3.81 the CNF_version value will be 3 or higher, which
# means that the Screen_X and Screen_Y offsets are valid for gsKit, as
# used by that program version. Also, when that program version is used
# with a CNF file having lower CNF_version value than 3, then the old
# screen offsets will be converted to ones suitable for gsKit.
# ----------------------------------------------------------------------
# In v3.95 Multi-language support was added, which caused the built-in
# MISC/ device and its subprograms to be named according to the language
# file activated. But CNF files won't work unless the strings used in a
# launch key match existing device and program names. This now made it
# necessary to add the device and subprogram strings to the CNF format.
# They will still be altered when a new language is loaded, but if you
# then revert from that change, the names should also revert properly.
# (Which is what failed to work without having this stuff in the CNF.)
# ----------------------------------------------------------------------
Misc = MISC/
Misc_PS2Disc = PS2Disc
Misc_FileBrowser = FileBrowser
Misc_PS2Browser = PS2Browser
Misc_PS2Net = PS2Net
Misc_PS2PowerOff = PS2PowerOff
Misc_HddManager = HddManager
Misc_TextEditor = TextEditor
Misc_JpgViewer = JpgViewer
Misc_Configure = Configure
Misc_Load_CNFprev = Load CNF--
Misc_Load_CNFnext = Load CNF++
Misc_Set_CNF_Path = Set CNF_Path
Misc_Load_CNF = Load CNF
Misc_ShowFont = ShowFont
Misc_Debug_Info = Debug Info
Misc_About_uLE = About uLE
# ----------------------------------------------------------------------
# Next follows the 12 (as yet) launching links, here kept in traditional
# order, though users are allowed to vary the order at will. For these
# 12 variables the following name conventions apply:
#
# "LK_" is an abbreviation for "Launch Key" and is used as a prefix for
# the key descriptor (eg: "Square"). That is then followed by the suffix
# "_E1" which is an abbreviation for "Execution Method 1". At present
# that is the only method we have, but hopefully that will change...
#
# The default value for most of these should be an empty string, except
# that one link should start the file browser, so people can start to
# copy stuff without having to make a new CNF.
# ----------------------------------------------------------------------
LK_auto_E1     =
LK_Circle_E1   = MISC/FileBrowser
LK_Cross_E1    =
LK_Square_E1   =
LK_Triangle_E1 =
LK_L1_E1       =
LK_R1_E1       =
LK_L2_E1       =
LK_R2_E1       =
LK_L3_E1       =
LK_R3_E1       =
LK_Start_E1    =
# ----------------------------------------------------------------------
# v3.78 adds three new launch key definitions, but they will never be
# created automatically. If added by a user they will however be kept in
# the CNF as saved in the future, and those settings will then override
# the built-in defaults for the buttons 'Select', 'Left', and 'Right'.
# The values shown below will map those buttons identically to defaults,
# though that is not the way it's handled for real defaulting. Use empty
# strings to disable the keys entirely (for 'child safe' installations)
# ----------------------------------------------------------------------
LK_Select_E1 = MISC/Configure
LK_Left_E1   = MISC/Load CNF--
LK_Right_E1  = MISC/Load CNF++
# ----------------------------------------------------------------------
# After the launch key definitions we have the variables for diverse
# settings, most of which use obvious naming schemes and have their
# traditional default values. Some exceptions are the variables for
# GUI colour values, which are described in the next section.
# ----------------------------------------------------------------------
LK_auto_Timer   = 10
Menu_Hide_Paths = 1
# ----------------------------------------------------------------------
# Next we have the GUI colour values, for which I made some choices that
# differ widely from all the other variables so far. First and foremost,
# I switched their data format to pure hex, to make it practical for a
# human to edit the byte values. I also added a suffix to the names,
# so the user has a mnemonic key to the usage of the byte values.
# And finally, I chose some new default values that I've been working on
# for a while. The effects of these settings are as follows:
#
# Normal text is fully black, while the background is half-level white.
# Border, submenus, and LaunchELF title text use a medium grey colour,
# with half the brightness of the background, while alerts and progress
# messages use a clear but subdued red colour.
#
# My goal with these defaults was to achieve max clarity with no glare,
# and I think this succeeded fairly well, though the final results do
# depend greatly on your monitor settings as well.
# ----------------------------------------------------------------------
# With the addition of the HddManager, four more colours were added to
# this array, for use in graphical presentations, like pie charts.
# ----------------------------------------------------------------------
# With the addition of icon display mode for FileBrowser, the graphical
# colours are used for these icons as well
# ----------------------------------------------------------------------
GUI_Col_1_ABGR = 00808080
GUI_Col_2_ABGR = 00404040
GUI_Col_3_ABGR = 00990060 # Iritscen: Made selection color more visible
GUI_Col_4_ABGR = 00000000
GUI_Col_5_ABGR = 00006060
GUI_Col_6_ABGR = 00006000
GUI_Col_7_ABGR = 00E0E0E0
GUI_Col_8_ABGR = 00000000
# ----------------------------------------------------------------------
# Screen_X and Screen_Y are offsets used to center the LaunchELF screen
# on the physical TV screen. The values shown below are old defaults,
# but nowdays it's better to leave them out completely, which is why
# these lines were made into comments below. This way the program can
# choose correct defaults for the TV_mode and Screen_Interlace settings
# you've chosen further down in this file. And the values you use for
# Screen_X and Screen_Y, whether those defaults or modified values, will
# still be saved here whenever you save CNF in the future.
# ----------------------------------------------------------------------
#Screen_X  = 632
#Screen_Y  = 50
# ----------------------------------------------------------------------
# Note that I have changed the default for IOP reset, as this has been
# long-term tested now, and proven superior to starting without it.
# I have also changed the default for CDVD checking, as the old default
# could cause lockup on some PS2 models if started with empty tray.
# ----------------------------------------------------------------------
Init_CDVD_Check  = 0
Screen_Interlace = 1
Init_Reset_IOP   = 1
Menu_Pages       = 1
GUI_Swap_Keys    = 0
# ----------------------------------------------------------------------
# The variables below have been added after the original design (v3.41t)
# of the new CNF format. They should be used as follows:
# ----------------------------------------------------------------------
# USBD_FILE is valid in v3.41u and later versions. It's used to choose
# an alternate USBD.IRX file, which LaunchELF will then use instead of
# the embedded one. You can set it in the 'STARTUP SETTINGS' screen.
# ----------------------------------------------------------------------
USBD_FILE =
# ----------------------------------------------------------------------
# NET_HOSTwrite is valid in v3.44 and later versions. It can enable
# the ability of the networked HOST interface to write on your PC HDDs!
# Users who want to avoid risks for their PC should leave it as default,
# which disables these new abilities. For safety reasons it can only be
# changed by direct user editing. Edit it to a non-zero value to enable
# the new abilities. (You'll need a very new ps2client.exe as well.)
# ----------------------------------------------------------------------
NET_HOSTwrite = 0
# ----------------------------------------------------------------------
#SKIN_FILE is used to select a JPG file that will be used as background
#for the LaunchELF screen. Its value should be the full JPG pathname.
#The default value is an empty string, meaning that the colour set by
#GUI_Col_1_ABGR above will be used for screen background instead.
# ----------------------------------------------------------------------
SKIN_FILE =
# ----------------------------------------------------------------------
#GUI_SKIN_FILE is used to select a JPG file that will be used the same
#way as SKIN_FILE, but only in the main launch menu. This allows the
#design of screens that use the JPG to display GUI 'buttons' etc. But if
#no such file is specified (or loadable at runtime) then the usage falls
#back on the regular methods.
# ----------------------------------------------------------------------
GUI_SKIN_FILE =
# ----------------------------------------------------------------------
#Menu_Title is a string that will be displayed at the top left of the
#screen. Its main purpose is to allow users to have different titles
#for different config pages. It is editable in "STARTUP SETTINGS".
# ----------------------------------------------------------------------
Menu_Title =
# ----------------------------------------------------------------------
# Menu_Frame flags whether or not the big frame that encloses the menu
# should be visible or not. By default it will be visible.
# ----------------------------------------------------------------------
Menu_Frame = 1
# ----------------------------------------------------------------------
# SKIN_Brightness is used to modify the brightness of a JPG skin, thus
# allowing this to be set without changing the JPG file. The default is
# 50, for using the JPG as-is, lower values will darken it while higher
# values will brighten it. The maximum value allowed is 100.
# ----------------------------------------------------------------------
SKIN_Brightness = 50
# ----------------------------------------------------------------------
# Show_Menu flags whether or not the main menu is visible when a GUI
# skin is selected. By default it will be visible.
# ----------------------------------------------------------------------
Show_Menu = 1
# ----------------------------------------------------------------------
# TV_mode is used to seup the video mode to suit your TV. You may use
# the following values in the current implementation:
# 0 => Automatic adaption of video mode to suit your console (default)
# 1 => Enforce NTSC video mode regardless of console
# 2 => Enforce PAL video mode regardless of console
# ----------------------------------------------------------------------
TV_mode = 0
# ----------------------------------------------------------------------
# Popup_Opaque may be set to force popup menus to use simple background
# colour (GUI_Col_1_ABGR) inside such menu box, instead of transparently
# using the skin (if any) as background. If no skin is used then this
# setting has no visible effect. Its default value is for transparency,
# so change it to 1 to make such menus opaque.
# ----------------------------------------------------------------------
Popup_Opaque = 0
# ----------------------------------------------------------------------
# Init_Delay is used to delay the start of all uLaunchELF interactions,
# which also includes the possible timeout and startup of a default ELF.
# The purpose of this delay is to allow the user to release any buttons
# that may have been used in commanding a mod chip, or some program to
# start uLaunchELF, to avoid having those buttons misinterpreted as new
# commands intended for uLaunchELF. Its value specifies how many seconds
# of extra delay to use, with the default value being zero.
# ----------------------------------------------------------------------
Init_Delay = 0
# ----------------------------------------------------------------------
# USBKBD_USED allows you to disable initialization of the USB keyboard
# driver. This is mainly useful when you need to test some specific
# software without any USB drivers active. For example, when testing
# software that should provide its own USB drivers. Such a test would
# be ruined if USB drivers were already active when starting the test.
# ----------------------------------------------------------------------
USBKBD_USED = 1
# ----------------------------------------------------------------------
# USBKBD_FILE is a string used to specify an alternate IRX file for the
# USB keyboard driver, which uLaunchELF will then use instead of the
# embedded one. You can set it in the 'STARTUP SETTINGS' screen.
# Note that this is only compatible with PS2SDK drivers, not Sony stuff.
# Just leave this string undefined (empty) to use the built-in driver.
# ----------------------------------------------------------------------
USBKBD_FILE =
# ----------------------------------------------------------------------
# KBDMAP_FILE is a string used to specify an alternate key map KBD file
# for the USB keyboard driver, which will then be used instead of the
# default map. You can set it in the 'STARTUP SETTINGS' screen.
# ----------------------------------------------------------------------
KBDMAP_FILE =
# ----------------------------------------------------------------------
# Menu_Show_Titles is a flag that when set enables the use of Launch
# key titles in the menu. Previously this was controlled by the variable
# Menu_Hide_Paths, but that is no longer the case. By default the new
# variable is enabled, though this only affects launch keys that have
# some title string defined.
# ----------------------------------------------------------------------
Menu_Show_Titles = 1
# ----------------------------------------------------------------------
# CNF_Path can be used to override the path choice for CNF handling, by
# setting it to the value needed after IOP reset is performed. This is
# mainly intended to allow HDD installed setups to find a CNF in the
# launch folder, but can also be used for CD installs, to switch to use
# of a folder in MC after loading CNF values from a CNF on CD. You can
# edit this path in the "Startup Settings" submenu.
# ----------------------------------------------------------------------
CNF_Path =
# ----------------------------------------------------------------------
# USBMASS_FILE is a string used to specify an alternate IRX file for the
# USB mass storage driver, which uLaunchELF will then use instead of the
# embedded one. You can set it in the 'STARTUP SETTINGS' screen.
# ----------------------------------------------------------------------
USBMASS_FILE =
# ----------------------------------------------------------------------
# From v3.95 a language definition file may be used to set the strings
# for most menus and dialogs in uLaunchELF, and that file choice is
# stored here. The default value is just an empty string, causing the
# internal defaults to be used for everything. These defaults are also
# identical to the contents of the file "English.lng" that we released.
# ----------------------------------------------------------------------
LANG_FILE =
# ----------------------------------------------------------------------
# From v4.02 the character font may be replaced by one loaded from an
# external file, whose path is stored in the FONT_FILE entry. As usual
# for file choices, the default is an empty string, causing the internal
# font to be used. That will also be the result if a specified file is
# missing or has an invalid format. (Fonts are released separately.)
# ----------------------------------------------------------------------
FONT_FILE =
# ----------------------------------------------------------------------
# From v3.84 two settings of JpgViewer are also saved here. These are
# the slideshow interval timer (in seconds), and the picture transition
# choice, a value from 1-4, with 1==NONE, 2==ZOOM 3==FADE, 4==BOTH.
# In v3.96 another setting was added, being a flag for fullscreen mode. 
# To save latest slideshow settings, just enter the main configuration
# menu and exit it again using the OK command. This resaves the file.
# Viewer settings found in a CNF will be used instead of the original
# defaults, which are the values shown below.
# ----------------------------------------------------------------------
JpgView_Timer = 5
JpgView_Trans = 2
JpgView_Full = 0
# ----------------------------------------------------------------------
# From v3.92 Two options for PSU gamesave files are saved here.
# Set PSU_HugeNames non-zero to make PSU names contain both original
# gamesave folder names and the gamesave titles (from icon.sys).
# Set PSU_DateNames non-zero to make PSU names contain a timestamp from
# the original save data, appended to the normal name.
# Both options can be set simultaneously, for very detailed names, like:
# "BESLES-5245800_Disgaea(1) Ep.1 LV1_2006-07-23_14-46-33.psu"
# As yet they are not available in config menus. Use TextEditor instead.
# ----------------------------------------------------------------------
PSU_HugeNames = 0
PSU_DateNames = 0
# ----------------------------------------------------------------------
# PSU_NoOverwrite was added in v3.93, to eliminate redundant backups.
# It's only useful to set it non-zero when PSU_DateNames is also set, as
# it is otherwise ignored. When used, backup of timestamped PSU files
# check for an identical PSU filename at the destination, and if such
# a file already exists the operation exits without error, as if a new
# backup had been made. Thus you can select all saves on an MC and use
# psuPaste to backup only those that have changed since last time.
# This improvement was contributed by 'ffgriever' at ps2-scene.
# ----------------------------------------------------------------------
PSU_NoOverwrite = 0
# ----------------------------------------------------------------------
# FB_NoIcons can be used to disable the new icon display mode of the
# uLE FileBrowser. By default this is enabled, with this variable zero.
# In icon mode the FileBrowser will display a small icon in front of
# every file or folder name, with different shapes for folder vs file.
# The icons will reuse colours already defined as follows:
# Folders use Color5=='Graph1', ELFs use Color6=='Graph2', and other
# files will all use Color7=='Graph3'. By default these colours will
# be setup as yellow, green, and white, but can be changed for 'skins'.
# In icon mode objects marked for operations are displayed differently
# by switching to a slightly different icon definition (with a 'hole').
# But if FB_NoIcons is set non-zero then the FileBrowser will revert
# to the traditional form, using no icons at all, and marking selected
# objects with an asterisk to the left of the file name.
# ----------------------------------------------------------------------
FB_NoIcons = 0
# ----------------------------------------------------------------------
# LK_xx_Title is not one variable but many. You can replace the 'xx' by
# one of 15 button designations (eg: Square, Select, etc), and use them
# to define your own titles that will be used instead of ELF names in
# the main menu. If no such titles are defined then the ELF names are
# used instead, and titles will not be saved to the CNF for such cases.
# To have these titles displayed the variable Menu_Hide_Paths must be
# set to a non-zero value. You can set it in the CONFIG menu which is
# also where you can conveniently edit the titles for all launch keys.
# By editing the CNF directly you can also edit titles for three more
# commands, as shown by the examples below (NB: They are not defaults)
# ----------------------------------------------------------------------
LK_Select_Title = Configure uLaunchELF
LK_Left_Title = Load 'lower' CNF file
LK_Right_Title = Load 'higher' CNF file
# ----------------------------------------------------------------------
# PathPad_Lock allows you to lock changes to the browser navigation
# shortcuts in the PathPad array. So if you set PathPad_Lock non-zero,
# the 'Set' and 'Clear' commands will no longer be active in the PathPad
# menu. This will prevent you from changing any of the entries, so the
# default value is zero, which allows you to set up or change entries.
# NB: Setting it non-zero must be done by text editor, for the present.
# ----------------------------------------------------------------------
PathPad_Lock = 0
# ----------------------------------------------------------------------
# PathPad[xx] is not one variable but many. You can replace the 'xx' by
# any number from 00 through 29 (inclusive), and assign each variable of
# this kind a path string. Lists of those paths can then be accessed in
# the file browser for easy navigation, by calling up the PathPad menu
# with the R2 button. By default these strings are empty, and are not
# then saved to the CNF. Only non-empty strings will be saved, so the
# example below is not a default value, but simply an example. Since the
# PathPad entries are not normal configuration variables, they're always
# included at the end of the CNF file.
# ----------------------------------------------------------------------
PathPad[14] = hdd0:/__common/-PS1 MC Backups/
# ----------------------------------------------------------------------
# End of file: LAUNCHELF.CNF
# ----------------------------------------------------------------------