Page 1 of 275 1 2 3 11 51 101 ... LastLast
Results 1 to 10 of 2742

Thread: HyperLaunch 2.x Released

  1. #1
    Administrator
    BadBoyBill's Avatar
    Join Date
    Jun 2008
    Location
    Cali
    Posts
    7,639
    Thanks
    3
    Thanked 797 Times in 83 Posts

    Default HyperLaunch 2.x Released

    Current Version 2.25c

    Please read carefully before using.

    *Note: Using HyperLaunch 2 will be required for the next HS 2.0, this is also compatible with the HS1.x

    About: For new users. Basically HyperLaunch is a seperate game launcher for emulators and programs. HyperSpin can launch games on its own, but by enabling HyperLaunch you open up a whole new world of scripted game launching. Scripted game launching is much better because scripts can control exactly what happens during the launching of a program or game. It also controls the exiting. This is especially important for arcade cab users because we want the most professional looking system possible. Launching a game cleanly and exiting cleanly is what HyperLaunch is all about. Normal users do not have to know how all this works, you should just enable it and maybe configure a few settings for your specific needs.

    Purpose: The purpose of this different version of HyperLaunch is:


    1. To make it easier for new users to use. The current HL requires people to learn how to update an ahk file and recompile it to make changes. This version eliminates that. You never compile HyperLaunch or its modules.

    2. To make HL modular. This means that each system has a different mini script that users can download on a per emu basis. A new user can simply download the module for the system and thats it. This eliminates having to add systems to HyperLaunch via scripting.

    3. To make HL settings such as emulator exit keys editable from outside the script. This re-enforces number 1 above. The user should not have to edit the script.

    4. HL "IS" a command line program that HS calls to launch emu's for cleaner launching and exiting. It has alwasy been this way and still is, but now HL has a mini gui if you double click it. This makes it so you can test your emulator configs and game launching without even running HS. HyperSpin is not needed to test your game launching.





    INSTALLATION:

    How the 3 ini system works:
    All three files are found in your HyperSpin\Settings\ folder.
    Settings.ini:
    • This file contains settings not specific to your wheels. It would contain keys, paths, settings, etc that you wouldn't change on a per-system basis for whatever reason

    Global Settings.ini:
    • This file contains the same keys found in the systemname inis, but will have the default settings that affect every wheel. If you want to turn on and configure a feature on every wheel without having to touch all the systemname inis, this is where you do it.

    "systemname".ini:
    • This file contains the same keys found in Global Settings.ini but is specific for the system. Default values for all the keys are use_global. If you change the value, it will only affect this system.

    Any keys you still have in the wrong ini will NOT BE RECOGNIZED. You can change them to your hearts content and they will have no effect. On your first launch, HL2 will copy your existing settings from Settings.ini into Global Settings.ini so you don't have to. I will keep this function in place until HS2 is here.

    Step1:
    On first launch, HyperLaunch 2 will create many new ini keys in Settings.ini and Global Settings.ini. The first time you launch a game, it will also create keys in that systems ini. So the first time you setup a new system, it's a good idea to just launch a game from it, even it it fails, just to have the ini keys generated for you. Then go back and edit them if you need to.

    Example Settings.ini keys:
    Code:
    [HyperLaunch]
    Exit_Script_Key=~q & ~s
    Exit_Emulator_Key=~Esc
    Toggle_Cursor_Key=~t
    Path_To_Daemontools=
    Path_To_CPWizard=
    Last_System=MAME
    Last_Rom=1942
    Step2.
    Make a new folder in your install directory called Modules. Each module goes into a folder of the system name. Your install directory is your root Hyperspin folder. It should always be placed in the root of one of your drives, like this:
    Code:
    C:\Hyperspin\
    or
    D:\Hyperspin\
    The reason you want it here is to minimize the chance of running into a 255 character limit in your paths.

    Using the above example, you should now have a folder like so:
    Code:
    C:\Hyperspin\Modules\
    For each system you have in your C:\Hyperspin\Databases\Main Menu\Main Menu.xml, you need to create a folder using the same name exact name in that xml.
    Example:
    Code:
    C:\Hyperspin\Modules\MAME\
    Now visit HyperList, create a login if asked. For each folder you made, download a module of the emu you want to use and place it in the folder for that system. When saving the module, be sure to name it exactly the same as the folder you are placing it in:
    Example:
    Code:
    C:\Hyperspin\Modules\MAME\MAME.ahk
    Step3.
    Download the new HyperLaunch 2.x package at the bottom of this post and extract it into your root Hyperspin folder from above (eg C:\Hyperspin\). Any updates to HyperLaunch will be posted at the bottom of this post.

    Whats inside:
    HyperLaunch.exe (The compiled launcher, source code can be found on HyperList)
    autohotkey.dll (This is why we dont have to compile modules)
    7z.dll (Required for 7z functions)
    7z.exe (Required for 7z functions)

    Step4.
    Each module contains notes at the top that you are REQUIRED to read and follow. Many modules have user settings you can edit below the notes section to turn emu or module features on or off, or just make controlling the emu easier without having to run it manually.

    Some modules also require additional downloads that can be found on the FTP until HyperList supports hosting of these files. If you try to run a system, and it warns about a missing file in your modules folder, chances are it's found on the FTP.





    HOW TO USE
    Once everything is done you should be good to go. Assuming you have mame configured in your settings already you can now run a test without even opening HyperSpin.

    Double click HyperLaunch.exe. You will see the mini gui where you can run tests.



    Simply type in the name of the System and the Rom Name and click test.

    If your game runs, then it will run from HyperSpin.

    DO NOT attempt to compile HyperLaunch.ahk to a new exe unless your using a special version of autohotkey. Autohotkey_H. See notes at the top of script for link and info. DO NOT attempt to compile any module ahk, they must stay in plain text ahk script!




    HOW TO USE DAEMON TOOLS LITE SUPPORT:
    Daemon Tools Lite is required for a number of emulators out there to properly load cd/dvd based games and to fully take advantage of audio tracks from the original games. Some emus come with the ability to mount an iso, but this does not mean it's the preferred method. Do your research first to see if your emu loses any features by mounting internally rather then through DT.

    Step 1:
    • Download Daemon Tools Lite from the official site: http://www.daemon-tools.cc/eng/products/dtLite and click download, not buy.
    • Run the exe to install DT and select Free License. Careful what you select during install. Being a free program, they try to install some questionable 3rd-party apps. Be sure to disable these on the install wizard. You also do not need SPTD, but if you decide to install it, you will have to reboot finish installing it. This is used for some advance emulation features not really needed for emulation. You also don't need the windows gadget, so uncheck that.
    • Choose your installation path. I suggest keeping it default, like "C:\Program Files (x86)\DAEMON Tools Lite\" (for a 64-bit system).

    Step 2:
    • Make sure you configure the path to Daemon Tools in your Hyperspin\Settings\Settings.ini. Open the ini and in the [HyperLaunch] section at the top:

    Code:
    Path_To_Daemontools=C:\Program Files (x86)\DAEMON Tools Lite\DTLite.exe
    • Make sure that path and exe matches where you installed DT. If the key is not there, either add it, or run HL2 once and it will be added for you.

    Step3:
    • If DT asked you to reboot, do so now.
    • You should now have a DT icon in your running tasks in your task bar. You also by default have a DT virtual Drive already setup and assigned a drive letter for you.
    • Now right click the DT icon and select Virtual Devices->Add SCSI Virtual Drive. It will create a SCSI virtual drive with the next available drive letter. This is the suggested drive for some systems.
    • That's it for setting up DTLite. You will find additional instructions in the in any of the modules that use DT. Follow those to get DT setup with your emu/module.





    HOW TO USE PER GAME MODULE SUPPORT:
    This allows you to create one module per game, might be required for some PC Games if you need more functionality then what PCLauncher can give you.
    HL2 will add this default ini key automatically:
    systemname.ini
    Code:
    [exe info]
    Per_Game_Modules=false
    [*]Per_Game_Modules - This only needs to be added if individual games have their own scripts. This would probably be true for a PC games wheel




    HOW TO USE CPWIZARD SUPPORT:
    HL2 will add these default ini keys automatically:
    Settings.ini
    Code:
    [HyperLaunch]
    Path_To_CPWizard=false
    Global Settings.ini
    Code:
    [HyperLaunch]
    CPWizard_Enabled=false
    CPWizard_Delay=8000
    CPWizard_Params=-minimized -timeout 9000
    systemname.ini
    Code:
    [exe info]
    CPWizard_Enabled=use_global
    CPWizard_Delay=use_global
    CPWizard_Params=use_global
    Definitions:
    • Path_To_CPWizard - Make sure this points to your CPWizard.exe
    • CPWizard_Enabled - Enables or disables CPWizard support on a global or system basis
    • CPWizard_Delay - The amount of time, after cpwizard runs, before continuing to load the module, in milliseconds
    • CPWizard_Params - ?? unsure (someone please let me know if I have these right)






    HOW TO USE 7Z SUPPORT:
    If you happen to want 7z support for your roms (meaning any rom can be zipped and work with any emulator where the module supports it) then follow this guide to set it up.

    Now you can use any compressed rom with any emulator. This requires only a couple lines in each module (most modules have been updated to support this). HyperLaunch will first check if your rom exists in the archive before attempting to extract. Then it will extract to your 7z_extract_dir and send the correct path and extension to your emulator to be launched. Your romExtension has to include the archive file type and the rom you want to look for inside the archive. So for example you compress your game boy color games with 7z, romExtension should be set to gbc,7z.

    Rom names inside the archive need to match the name of the archive, which also matches the game's name in your xml. So for example, if you have a rom named "Mario (USA).rom", your 7z needs to be called "Mario (USA).7z".

    The rom you want to load (the one sent to the emulator), must not exist in a folder inside the archive. It's ok to have folders, like if you wanted to zip up your Pop Cap games and have them extract on launch. But for simple roms and isos, do not use any folders.

    Only the rom that HyperLaunch is looking for has to be the same name. This is the case with CD/DVD based games with multiple tracks as files. You might have an archive called "Wipeout (USA).7z" and inside you can have "Wipeout (USA).cue, Track1.bin, Track2.bin, Track3.bin, etc". This would work as long as the cue contains the correct filenames to find the tracks and you set cue as your rom extension.

    You have a choice in each system if you want to delete the temp uncompressed roms or keep them. The benefit of keeping them is you can track what games have been played or keep locally only the roms you play the most for quickest launch speeds. This is really nice paired with server hosted roms or a NAS box.

    Global Settings.ini will contain the Global defaults:
    Code:
    [HyperLaunch]
    7z_Enabled=false
    7z_Extract_Dir=%A_Temp%\
    7z_Delete_Temp=true
    Each system ini you can define a separate extract to folder, or keep the default windows temp folder defined for you in the Global Settings.ini.
    Code:
    [exe info]
    7z_Enabled=use_global
    7z_Extract_Dir=%use_global
    7z_Delete_Temp=true
    Definitions:
    • 7z_Enabled - Do you want to let HyperLaunch uncompress the roms for you? Set to true if your emulator doesn't support the compressed format your roms are in.
    • 7z_Extract_Dir - The temp dir we want to uncompress our rom to, Default is your windows temp folder
    • 7z_Delete_Temp - If true, will delete the temp folder upon exit of the module






    HOW TO USE FADEIN AND ITS IMAGES:
    Create a folder in your Hyperspin\Media\Systemname\Images\ called GameStart. HyperLaunch will search and load these images if found: top.png (banner shown along the top of the screen during loading), middle.png (banner in the middle during loading), bottom.png (banner along the bottom of the screen during loading).

    Optionally, you can place an image for each romname in this folder, and HyperLaunch will replace the middle.png with it instead. This allows custom per-game images (like control images) to be shown before loading the game.

    In order to turn on the images or fadein/fadeout, we use a 2-part system to enable either global, or system specific, user settings.

    HL2 will automatically add this key to your Settings.ini:
    Code:
    [HyperLaunch]
    Fade_In_Interrupt_Keys=anykey
    HL2 will automatically add these keys to your Global Settings.ini:
    Code:
    [HyperLaunch]
    Fade_In=false
    Fade_Out=false
    Fade_Color=0x000000
    Fade_In_Duration=500
    Fade_Out_Duration=500
    Fade_In_Delay=0
    It will also automatically add these system-specific ini keys in each systemname.ini:

    Code:
    [exe info]
    Fade_In=use_global
    Fade_Out=use_global
    Fade_Color=use_global
    Fade_In_Duration=use_global
    Fade_Out_Duration=use_global
    Fade_In_Delay=use_global
    What this does is, as long as you have "use_global" set in any of your system.ini's, it will use the value from your Settings.ini. If you want a specific system to have its own setting, just change "use_global" to a same value type as found in the Settings.ini. So for example, fade_color uses a hex color (0x000000) in the Settings.ini, so in your systemname.ini, it would also have to be a hex color (0x00FF00).

    Definitions:
    • Fade_In - If true, Hyperspin will fade out to the fade_Color set below. Set to false when troubleshooting a module for launching problems.
    • Fade_Out - If true, the emulator will fade out when exiting to the fade_Color set below. Set to false if you run a true fullscreen emulator or you see flashes instead of fading, or when troubleshooting a module for launching problems. This will only work correctly with windowed fullscreen resolutions, not true fullscreen.
    • Fade_Color - Color you want to fade to when loading and exiting. This is a 6-digit RGB color Value.
    • Fade_In_Duration - The speed at which the fade_in occurs in milliseconds.
    • Fade_Out_Duration - The speed at which the fade_out occurs in milliseconds.
    • Fade_In_Delay - How long your images will stay on screen before continuing to load the emu. This can be interrupted by hitting any key defined in fade_in_interrupt_keys.
    • Fade_In_Interrupt_Keys - If set as "anykey" (the default), all keys on the keyboard will interrupt the fadeIn screen. If you want to customize what keys will interrupt, change this value to list of all your desired keys. Example, you want to use F1, F5, Left Shift and Right Control, this variable would look like {F1}{F5}{LShift}{RCtrl}. Joysticks are not supported, but you can have a joystick button send a keyboard key via any keyremapping software. You can find the list of definable keys here. Note: letters and numbers do not need to be defined, they are automatically always enabled.






    HOW TO USE KEYMAPPER:
    ONLY Xpadder (2012 versions) and JoyToKey (v5+) and Autohotkey scripts are supported options for keymapper functionality. Will not work with JoyToKey v3 or below.
    Create a folder in Hyperspin\ called "Keymapper Profiles" (this can be changed in Settings.ini). This will be where you place your keymapper profiles. The folder structure works like this (using MAME as the example system):
    Hyperspin\Keymapper Profiles\ - place your Hyperspin profile here (ex. Hyperspin.xpadderprofile) - This profile is only "needed" if you have to remap controls while browsing in Hyperspin.
    Hyperspin\Keymapper Profiles\ - place your default profile here (ex. default.xpadderprofile) - This will be your main profile and used for all systems you don't make system-specific profiles for.
    Hyperspin\Keymapper Profiles\MAME - place your system MAME profile (ex. MAME.xpadderprofile) here and any MAME rom-specific profiles here. (ex. 88games.xpadderprofile).

    The profile chosen when you launch a game works like this: It will first look for a rom profile, if not found, it looks for a system profile, if not found, it looks for the default profile for all systems. Lastly, if no default profile, it will load the Hyperspin profile. If no profiles are found, it will error out.
    So to recap, the order profiles are loaded are:
    1. Game specific profile
    2. System specific profile
    3. Default profile
    4. Hyperspin profile



    On exit of emu, HyperLaunch will close or unload your keymapper if no Hyperspin profile is found. If you have created a Hyperspin profile, it will load it.

    Xpadder Setup:
    1. Run it and follow the initial setup prompts.



    xPadder multi-player support:
    If you want to load multiple profiles, one for each player (up to 4), you simply have to add another profile with the same name, but add a [p#] after it. For example, you would load Mame.xpadderprofile to player 1 and Mame [p2].xpadderprofile to player 2. Don't forget the space. For 4 players you would have "Mame" "Mame [p2]" "Mame [p3]" "Mame [p4]". This works for all 4 profiles in the hierarchy above.

    If you want to install one of the keymappers, use whatever one you like, but xpadder is a better choice.

    JoyToKey Setup:
    1. Start JoyToKey in a minimized mode
    2. Hide icon from taskbar when minimized



    Autohotkey Setup:
    1. Create a new ahk file and place your remaps you want to use in ahk code. You can find more info about how to remap via ahk here. A list of support ahk keys can be found here.
    2. Save the file as the game, system, hyperspin, or default profile you want HyperLaunch to load it for.
    3. So let's say you want to remap a to b and c to d using ahk for the rom "Mario" for Mame. You would create a "Mario.ahk" in "Keymapper Profiles\Mame\" and in it you would find the following remaps:
      Code:
      a::b
      c::d
    4. You would also have to set keymapper=ahk either as your global setting in Settings.ini or only specifically for Mame in the Mame.ini.


    INI Setup:
    In order to turn on the keymapper support, we use a 2-part system to enable either global, or system specific, user settings. HL2 will add these default settings to your Settings\Settings.ini:
    Code:
    [HyperLaunch]
    Keymapper_Path=
    Keymapper_Profiles_Path=%A_ScriptDir%\Keymapper Profiles\
    Note: The Profile Path will get translated to read out to your Hyperspin folder when you look at it.

    It will also create these in Global Settings.ini file like so:
    Code:
    [HyperLaunch]
    Keymapper_Enabled=false
    Keymapper=
    Finally, it will add these system-specific ini keys to the systemname.ini:
    Code:
    [exe info]
    Keymapper_Enabled=use_global
    Keymapper=use_global
    What this does is, as long as you have "use_global" set in any of your system.ini's, it will use the value from your Settings.ini. If you want a specific system to have its own setting, just change "use_global" to a same value type as found in the Settings.ini.

    Definitions:
    • Keymapper_Enabled - Iif true, enables keymapper support for all systems that have "use_global" set in their systemname.ini
    • Keymapper - Default is blank, but choices are "xpadder" or "joytokey" or "ahk"
    • Keymapper_Path - Default blank, this is the path to your keymapper exe, for example C:\Hyperspin\Utilities\xpadder\xpadder.exe
    • Keymapper_Profiles_Path - The path all your keymapper profiles are stored, default is Hyperspin\Keymapper Profiles\


    Note: If you have Keymapper enabled for a system, you need to make sure you have one of the 4 profiles from above located in your Keymapper_Profiles_Path for all games. So lets say you have xpadder enabled for Mame and made only a Mario Profile, but don't have a default, hyperspin, or Mame profile and you decide to play Gradius, you would get an error that you have Keymapper enabled, but could not find a valid profile. If you don't want to remap any keys for any other Mame games, you can just create a blank profile called Mame.xpadderprofile and you won't get the error anymore.

    Tips for those having issues working with Keymapper support:
    • Remove any profiles you have saved in the folder that xpadder.exe resides in.
    • Make sure xpadder it is set to load the last used profile on Windows startup (which will always be Hyperspin unless you load up a different one after exiting HS).






    HOW TO SETUP MULTIGAME SUPPORT:

    What this is:
    A long awaited feature requested by many over the years and has used up most of my free time over the past month to create. This gives you the ability to swap a game disc/disk/tape while playing an emulator, using a friendly and highly customizable GUI.

    Why do I need this?:
    Have you ever played a game and it asks you to insert Disc 2 and you say to yourself "well this sucks, I have to unmount this game or select File->Open, find the new game, then load/mount it" just to continue playing? Many systems from old cartridge and tape based ones to the latest DVD ones require some sort of disc swap to occur at some point in the game. This does all the work for you by popping up a GUI and automagically finding the games and only showing you ones that match what you already have running!

    Features:
    • Customizable Image artwork - (use the default ones provided for you or create your own. It will space your images across the screen evenly for you!)
    • Use your HS Artwork (Disc/Disk/Tape Scans) - (Instead of the provided defaults, you can optionally use these images, You only have to turn this feature on and set the Artwork folder your files are in. MG will load your artwork directly from your Artwork folder.)
    • Customizable Default or Per-rom Background Image support - (will load a default.png in your Media\system\Images\MultiGame\ or a romname.png one if it exists)
    • Customizable Background Color - (this is default when an image does not exist, you can change it to any color and set it's opacity if you prefer to see what's going on underneath)
    • Customizable Text - (Don't like the default greeting? Have it say what you want! You can change many aspects of the text including size, font, color, bold/italic/underline/etc, quality, and more)
    • Automatically downloads Image artwork from Hyperspin-fe.com and puts it in your image folder
    • Automatically downloads gdip library into a "Modules\Module Extensions\" Folder
    • Resize Images - (Stretch or shrink your images upto 3x it's size. They are anti-aliased to help mitigate jaggies)
    • All ini keys needed for MultiGame support are automatically created in your Global Settings and System inis for you
    • Use your arrow keys to navigate the GUI
    • Customizable keys to show the GUI, exit the GUI, and select a game - (limited to what ahk supports)
    • Feedback Sound - (Play a sound beep as you move your cursor from one game to the next. Pitch of the sound can be changed to anything you want)
    • Customizable Exit Effect - (When you choose a game, you have the choice to pixelate or grow the selected image. More may be added later.)
    • 7z support - (Let's say you launch a game from HS, then switch discs. If both games were extracted with 7z, and you like to keep your temp dir clean, HL2 will delete all the games launched from your current session)


    How roms MUST BE NAMED:
    HS2 will contain MultiGame support from the menu so you will no longer need multiple wheels to show one game that has multiple discs or carts. To use this functionality, some naming standards had to be put in place so when parsing your xml, it recognizes these games. Basically a tag gets put on the end of your romname, in parenthesis, saying what type of media and what number it is, example:
    Code:
    Final Fantasy VII (USA) (Disc 1).iso
    Final Fantasy VII (USA) (Disc 2).iso
    Final Fantasy VII (USA) (Disc 3).iso
    A space MUST EXIST between the media type and the number.

    Four media names are supported at the moment: Cart, Disc, Disk, and Tape. Where Tapes can have Sides:
    Code:
    Crystals Of Kings (Europe) (Tape 1 Side A).tzx
    Crystals Of Kings (Europe) (Tape 1 Side B).tzx
    The above media tags must be the last thing in parenthesis in your rom name.
    You can read more about names on this thread.

    How do I use this in my modules?:
    • Simply download a module that has already been updated with MG support and set your ini keys to get the look you want, or update your own module with the following info:
    • This is a feature as of HyperLaunch v2.25. It is injected into the module if you have MG enabled. Just make sure you are running at least this version, and you will have it. Modules need a custom label, much like CloseProcess, called MultiGame. If you attempt to enable MultiGame support and do not have this section in your module, you will get an error about not being able to find MultiGame.
    • The MultiGame section needs to contain code on what to do after you select your game from the MultiGame GUI. It is fed some variables that you use to pass to the emu or daemontools to mount your new game. If you want to use the feature and create your own method to change discs, here are the variables you need to know about:
      • selectedRom = The full path, name and extension of the game you selected as it exists in your romPath
      • currentButton = The number of the image you selected to load
      • mgRomPath = The path to the game (If 7z is enabled, this will be updated to reflect the path after extracting has occured)
      • mgRomName = The name of the game w/o an extension
      • mgRomExt = The extension of the game (If 7z is enabled, this will be updated to reflect the extension after extracting has occured)
      • mgCancel = Set when you exit the GUI and did not choose a game. You will need this on some emus where script is required to restore the emu if it lost focus or was minimized by bringing up the GUI
    [*]Each module also needs to contain a PreMultiGame label. This is where you can put code if you need to put the emu in a state for the MG GUI to work properly. For example you may need to take the emu out of fullscreen or minimize it before bringing up the GUI. Then put code in the MultiGame label to put the emu back after changing disks.
    NOTE: EVERY MODULE YOU WANT THIS TO WORK IN WILL NEED CODE TO TELL THE EMU AND/OR DAEMON TOOLS HOW TO CHANGE DISCS

    Limitations:
    Due to the nature of how true fullscreen works in windows, some emus might not play well with this feature when in true fullscreen mode. The GUI may take your emu out of fullscreen so it can do it's thing to swap games. Code needs to exist to put your emu back in fullscreen if this occurs. Utilize the PreMultiGame section of the module!
    Some emus might not like a rom to be swapped while it is running. There is not much you can do about these so pick an emulator that allows this.
    If you store your games on a network drive or a very slow HDD, you may notice some small lag after hitting your key to till the GUI comes up. This is because it has to query the drive quite a few times and find the roms that match the current one. Good thing is it only has to do this once per session. So subsequent presses of the MG key will be instant because the table of games has already been created.
    If you use 7z to extract very large games, you probably already have lag from when you launch the game from HS until it starts. You will have the same lag from the GUI. If you don't like this, keep your roms extracted. Space is cheap.

    I will update modules as I go to support this feature. So far Xebra (Sony PlayStation) is already updated, but only when using daemon tools lite. I tried to get the emu to swap discs internally while another is running, but I think it has to be done outside of the emu.

    Explanation of the new INI keys:
    Global Settings.ini will be injected with all the new keys the first time you launch any game on any wheel.
    Your system ini will be injected with the new keys first time you launch a game from that system's wheel.

    Settings.ini Default Key Values:
    Code:
    [HyperLaunch]
    MultiGame_Key = NumpadSub
    MultiGame_Select_Key = Enter
    MultiGame_Exit_Key = Esc
    Global Default Key Values:
    Code:
    [HyperLaunch]
    MultiGame_Background_Color = FF000000
    MultiGame_Side_Padding = .2
    MultiGame_Y_Offset = 500
    MultiGame_Image_Adjust = 1
    MultiGame_Font = Arial
    MultiGame_Text_1_Options = x10p y30p w80p Centre c80FFFF00 r4 s100 Bold Italic
    MultiGame_Text_1_Text = Please select a game
    MultiGame_Text_2_Options = w96p cffffffff r4 s50 Center Bold Italic
    MultiGame_Text_2_Offset = 70
    MultiGame_Use_Sound = True
    MultiGame_Sound_Frequency:=300
    MultiGame_Exit_Effect = none
    MultiGame_Selected_Effect = rotate
    MultiGame_Use_Game_Art = false
    MultiGame_Art_Folder = Artwork1
    System Ini Only Default Key Value:
    Code:
    [exe info]
    MultiGame_Enabled = true
    Definitions:
    • MultiGame_Enabled: Set this to true to turn on MG support and enable the MG key
    • MultiGame_Key: This is your key to bring up the MG Gui
    • MultiGame_Select_Key: This is the key you press to select a game on the MG Gui (Note; keys to navigate the GUI are your arrow keys and are NOT configurable)
    • MultiGame_Exit_Key: This is the key to cancel out of the MG GUI
    • MultiGame_Background_Color: Background color in ARGB format, first to characters denote the opacity, see text formatting options below for further info
    • MultiGame_Side_Padding: Percentage of padding (empty space), in decimal (eg 0.2 = 20 percent of unused space will be used on the sides), we allocate for left and right screen edges to keep images from touching the screen edge
    • MultiGame_Y_Offset: Adjust this to offset your images from the bottom of the screen. A positive number moves the images up, a negative moves it down
    • MultiGame_Image_Adjust: Multiplier to adjust the size of the images. Use this if you want to shrink or grow the images
    • MultiGame_Font: Specify the Font to use. Default is Arial as most systems should have this installed
    • MultiGame_Text_1_Options: Set the text options for the middle of the screen
    • MultiGame_Text_1_Text: Set the text for the middle of the screen
    • MultiGame_Text_2_Options: Set the text options for above the images
    • MultiGame_Text_2_Offset: How much to offset the text above the images from the image itself. A positive number moves the text up, a negative moves it down
    • MultiGame_Use_Sound: If true, will play a SoundBeep when an arrow key is pressed
    • MultiGame_Sound_Frequency: The frequency of the SoundBeep
    • MultiGame_Exit_Effect: Choices are pixelate, grow, or none. This animates the image when you press your Select Key
    • MultiGame_Selected_Effect: Choices are grow or rotate. This animates the selected image when moving around with the arrow keys. I suggest rotate only for discs as you probably don't want to rotate a cart.
    • MultiGame_Use_Game_Art: If true, uses artwork from the game as images on GUI instead of the default ones. Set the Artwork folder your art is stored in on the MultiGame_Artwork_Folder key
    • MultiGame_Art_Folder: This if the folder the image artwork you want to use is stored in 9eg Artwork1, Artwork2, Artwork3, or Artwork4)


    Text Formatting Options:
    • w (width): Area you force the text to stay constrained to. If p is used after the value, it denotes the percentage of the image width So w90p, means to allow the text to use 90% of the image width. If p is not used, the value represents pixels
    • c (color): In ARGB, preceded with the opacity. So DD000000 would be partial black, and FF000000 would be solid black. Preceed the color with a c to denote it is a color (cFF000000) - For more info see: http://en.wikipedia.org/wiki/RGBA_color_space
    • r (quality): The following chart explains the different effects you can apply
      SystemDefault = 0
      SingleBitPerPixelGridFit = 1
      SingleBitPerPixel = 2
      AntiAliasGridFit = 3
      AntiAlias = 4
    • s (size): Size of the Font
    • Formatting Options: Top, Up, Bottom, Down, vCenter, vCentre, Centre, Center, Regular, Bold, Italic, BoldItalic, Underline, Strikeout, NoWrap (you can use as many as you like, but careful with the positioning options as you may cover up the image art)


    At a minimum, your module MUST CONTAIN THESE LABELS OR ELSE YOU WILL ERROR ON LAUNCH WITH MULTIGAME ENABLED:

    Code:
    PreMultiGame:
    Return
    MultiGame:
    Return


    Like to thank Kodiak for the initial CD images and stupus for taking them a big step further and creating all the default images to date. Also like to thank brolly for taking the time testing all this stuff.





    HOW TO USE SKIPCHECKS:
    This is for Hyperspin 2.0 ONLY. *Warning* setting this to true should only be used for special case scenarios, like systems that do not use roms. Example - MUGEN, OpenBOR, and PopCap.

    This will allow you to skip most checks, including path, rompath, exe, and romextensions. Hyperspin will assume you have everything setup correctly and just launch what you tell it. Using MUGEN as an example, it will just launch the exe required to start a MUGEN game, w/o having to create a blank txt file or a batch/lnk file to pass the initial rom check.

    HL2 will add this key automatically to your systemname.ini:

    Code:
    [exe info]
    Skipchecks=false
    Definitions:
    • Skipchecks - If true, HyperLaunch 2, paired with HyperSpin 2 only, will skip most rom/path checks. In HS1, it will skip many checks done with HL2, but not ones done from HS.






    HOW TO HIDE YOUR CURSOR:

    This feature gives you the ability to hide your mouse cursor for all systems, or one system at a time.

    HL2 will automatically add this key to your Global Settings.ini:
    Code:
    [HyperLaunch]
    Hide_Cursor=false
    It will also add this key to your systemname.ini:
    Code:
    [exe info]
    Hide_Cursor=use_global
    What this does is, as long as you have "use_global" set in any of your system.ini's, it will use the value from your Settings.ini. If you want a specific system to have its own setting, just change "use_global" to a same value type as found in the Settings.ini.





    HOW TO HIDE YOUR TASKBAR:

    This feature gives you the ability to hide your taskbar for all systems, or one system at a time.

    HL2 will automatically add this key to your Global Settings.ini:
    Code:
    [HyperLaunch]
    Hide_Taskbar=false
    It will also add this key to your systemname.ini:
    Code:
    [exe info]
    Hide_Taskbar=use_global
    As an alternative method for taskbar hiding, which you may need for pesky emus that might restore it on you or you taskbar bleeds through application somehow, you can use the script I made below. Just be sure to turn off HL2's taskbar hiding as they will interfere with each other.

    1. Download the HideTaskbar.zip attached at the bottom of this post.
    2. Extract it wherever you like and Open HyperHQ.
    3. Goto Main Settings -> Startup/Exit and set the Startup Program to HideTaskbar.exe
    4. Make sure Hide_Taskbar in your Settings\Settings.ini is set to false (we don't want HyperLaunch to control taskbar hiding because it is being hidden by HideTaskbar.exe instead)





    HOW TO HIDE YOUR DESKTOP:

    This feature gives you the ability to hide your desktop for all systems, or one system at a time. It will black out the background. This will not hide your taskbar, use Hide_Taskbar for that. This may conflict with Fade support, so this is for those who don't want Fade, but want a simple black background instead.

    HL2 will automatically add this key to your Global Settings.ini:
    Code:
    [HyperLaunch]
    Hide_Desktop=false
    It will also add this key to your systemname.ini:
    Code:
    [exe info]
    Hide_Desktop=use_global




    TROUBLESHOOTING:
    1. Open ALL modules in notepad and follow the instructions at the top.
    2. Check if you are running the latest HyperLaunch, found at the bottom of this post.
    3. Check if you have HyperLaunch enabled in HyperHQ by going to Wheel Settings -> Emulator -> Execution = HyperLaunch
    4. Check you are running the latest module of the system/emulator you are trying to launch. Always stay upto date with module versions found on HyperList, I will not offer support for older modules or ones you found on the forum/ftp unless stated otherwise.
    5. At the top of each module has an emu version number. The module was ONLY tested to work with that specific version emu. I cannot stay upto date with every emu release, so eventually a module may break with newer emu releases. After you have exhausted all other options and you still cannot get the module to run, make a post and I will look into updating the module.
    6. Did you open the module up in Notepad (or your preferred text editor) and follow all the notes at the top?
    7. Did you set the user settings at the top of the module? Many modules have settings at the top that require manual changing for the emu to work properly. I set what I believe should be default on them, but they may not work for you. These settings will overwrite any changes you make in the emu itself, so it is vital you are aware they are there and set them appropriately.
    8. If you feel like you are seeing too much of the emulator launch process (eg. the emu window showing before the game does), did you setup and turn on fade support to hide it? Each of my modules are designed to use fade as your finishing touch. When fade is off, you are supposed to see emu windows or something launching and/or closing. This is how windows works when programs take focus. Fade makes an attempt to hide all that.
    9. If you edit the module in anyway besides the user settings at the top, you take full responsibility if something doesn't work.
    10. Do not PM the author asking for help on a module. First search the forum for your problem, if you just cannot find any info on it, make a post on a relative thread, or create a new one.
    11. Lastly, before you post, test that your emu works via command line by creating a .bat file in your emu folder, then running it. Some emus don't work via command line and I have written procedures to automate launching otherwise, so you can skip this step for those. The bat file should look like this (using N64 as an example):
      Project64.exe "C:\Roms\Nintendo 64\Super Mario 64 (USA).zip"
    12. If the bat file successfully launches your emu and your rom works, good chance the module has an issue and you should post your log.
    13. Include your ENTIRE HyperLaunch.log (found in your Hyperspin dir) in your post.
    14. Please use pastebin to post scripts or relative info if you feel it is necessary. Screenshots or videos go a long way to helping solve your issue.





    DOWNLOADS:
    HYPERLAUNCH 2.25c DOWNLOAD
    HideTaskbar Download

    Modules
    CLICK HERE
    Last edited by djvj; 11-08-2012 at 05:58 PM.
    Download every Theme all at once with FTP access! FTP accounts are now created automatically when you upgrade your account.

    My Cabs:


  2. The Following 54 Users Say Thank You to BadBoyBill For This Useful Post:

    ajbenson18 (07-04-2012), Amauriel (04-23-2013), anakin257 (01-21-2013), andyco40 (04-11-2013), AndyE (08-21-2012), Apparishion (03-25-2013), ashurax (05-17-2013), Aurel100 (09-30-2013), bax (04-10-2013), bent98 (12-26-2012), Boogieman_nl (10-04-2012), clicyu76 (12-11-2012), copyman (12-18-2013), craiganderson (03-30-2014), Cruel Moose (02-07-2013), cybermode (07-14-2012), deanmorrison (03-20-2013), djordman (05-05-2013), DonCorleon (01-31-2013), eohjay (01-04-2013), flink (08-15-2012), Fursphere (03-04-2013), groo (08-24-2012), hiorik (04-09-2013), Inquisitom (06-18-2013), irfdude (06-20-2013), jackhammersalm (07-22-2012), jevante (05-02-2013), jkonami (02-01-2013), johnny323 (03-20-2013), johnscrub (08-28-2012), Jonnykool (01-18-2013), lagonda (05-07-2013), lmsilva (04-07-2014), marcade (02-16-2013), Markussage (07-09-2014), MonkeyJug (02-09-2013), Mrtbiggums187 (08-11-2013), normanx9 (06-30-2012), oNiGHTo (07-08-2012), pagecranker (01-26-2013), rdhanded2 (12-29-2012), relic (05-28-2013), rhdmaster (02-04-2013), roliveir (03-16-2013), shaybe (02-19-2013), Skeletor101 (08-06-2012), stonegb (03-19-2013), ukarage (01-02-2013), Vithe (07-24-2012), Waxmann (05-06-2013), willzer* (06-25-2012), yaksplat (12-06-2012), zauche (05-12-2013)

  3. #2
    Ultimate HyperSpin Guru
    djvj's Avatar
    Join Date
    Mar 2009
    Location
    Long Island
    Posts
    8,103
    Thanks
    1,069
    Thanked 2,457 Times in 1,053 Posts
    Blog Entries
    3

    Default

    Great, can't wait to test. Typing a system name and rom name I can already see as being annoying. At least pull the system names from the Main Menu.xml. If you were planning this already, then disregard.
    "Computer games don't affect kids; I mean if Pac-Man affected us as kids, we'd all be running around in darkened rooms, munching magic pills and listening to repetitive electronic music."

    HyperLaunch's New Official Home

    If you appreciate my work:


    My Apps:
    Window Logger
    Idle Volume Adjuster
    ExplorerRestorer
    Rom Folder Cleaner
    Module Updater
    My Guides:
    How To Mod Guncons with Aimtrak

  4. The Following User Says Thank You to djvj For This Useful Post:

    ashurax (05-17-2013)

  5. #3
    Administrator
    Dazz's Avatar
    Join Date
    Jun 2008
    Location
    Keller / Watauga, Texas
    Posts
    6,089
    Thanks
    2
    Thanked 5,550 Times in 82 Posts

    Default

    Quote Originally Posted by djvj View Post
    Great, can't wait to test. Typing a system name and rom name I can already see as being annoying. At least pull the system names from the Main Menu.xml. If you were planning this already, then disregard.
    It will eventually pull the name name and rom from the command lines, but this is just for testing purposes.

  6. #4
    Ultimate HyperSpin Guru
    djvj's Avatar
    Join Date
    Mar 2009
    Location
    Long Island
    Posts
    8,103
    Thanks
    1,069
    Thanked 2,457 Times in 1,053 Posts
    Blog Entries
    3

    Default

    Some specialized scripts require hidedesktop turned off, or turned on at specific locations of a script. Having this global does not support this.
    Last edited by djvj; 12-05-2010 at 10:41 AM.
    "Computer games don't affect kids; I mean if Pac-Man affected us as kids, we'd all be running around in darkened rooms, munching magic pills and listening to repetitive electronic music."

    HyperLaunch's New Official Home

    If you appreciate my work:


    My Apps:
    Window Logger
    Idle Volume Adjuster
    ExplorerRestorer
    Rom Folder Cleaner
    Module Updater
    My Guides:
    How To Mod Guncons with Aimtrak

  7. #5
    Administrator
    BadBoyBill's Avatar
    Join Date
    Jun 2008
    Location
    Cali
    Posts
    7,639
    Thanks
    3
    Thanked 797 Times in 83 Posts

    Default

    Quote Originally Posted by djvj View Post
    Great, can't wait to test. Typing a system name and rom name I can already see as being annoying. At least pull the system names from the Main Menu.xml. If you were planning this already, then disregard.
    So you would rather run it from the commandline? You can do that if you would rather not use the gui.

    Edit: I see what your saying, so I do have it so it remembers the last system so you dont have to type it again. The first param System is not always pulled from the System Name depending on what your doing. So if your testing a script you should only have to type it once. Further tests wont need typed again and again.

    Quote Originally Posted by djvj View Post
    Some specialized scripts require hidedesktop turned off, or turned on at specific locations of a script. Having this global does not support this.
    Ok good point, I will add a new option to the settings to make this optional. If its needs to be called later then you can turn it off then write your own hide desktop function in the module since you cant call a function from the subscript.
    Last edited by BadBoyBill; 12-05-2010 at 10:54 AM.
    Download every Theme all at once with FTP access! FTP accounts are now created automatically when you upgrade your account.

    My Cabs:


  8. #6
    Ultimate HyperSpin Guru
    djvj's Avatar
    Join Date
    Mar 2009
    Location
    Long Island
    Posts
    8,103
    Thanks
    1,069
    Thanked 2,457 Times in 1,053 Posts
    Blog Entries
    3

    Default

    Can you add cpwizard as a variable and setting, like path_to_daemontools. Many people use this parameter to set the path to their CPWizard.exe. To build this custom into each script is unnecessary.

    Maybe "path_to_cpwizard"
    "Computer games don't affect kids; I mean if Pac-Man affected us as kids, we'd all be running around in darkened rooms, munching magic pills and listening to repetitive electronic music."

    HyperLaunch's New Official Home

    If you appreciate my work:


    My Apps:
    Window Logger
    Idle Volume Adjuster
    ExplorerRestorer
    Rom Folder Cleaner
    Module Updater
    My Guides:
    How To Mod Guncons with Aimtrak

  9. #7
    Administrator
    BadBoyBill's Avatar
    Join Date
    Jun 2008
    Location
    Cali
    Posts
    7,639
    Thanks
    3
    Thanked 797 Times in 83 Posts

    Default

    aight will do
    Download every Theme all at once with FTP access! FTP accounts are now created automatically when you upgrade your account.

    My Cabs:


  10. #8
    Administrator
    BadBoyBill's Avatar
    Join Date
    Jun 2008
    Location
    Cali
    Posts
    7,639
    Thanks
    3
    Thanked 797 Times in 83 Posts

    Default

    I also added a scrolling text box for debugging the module instead of a message box cuz long scripts would go off the screen. That'll be in the next minor release also.
    Download every Theme all at once with FTP access! FTP accounts are now created automatically when you upgrade your account.

    My Cabs:


  11. #9
    Administrator
    BadBoyBill's Avatar
    Join Date
    Jun 2008
    Location
    Cali
    Posts
    7,639
    Thanks
    3
    Thanked 797 Times in 83 Posts

    Default

    Udpated to 2.01

    Added scrollbox instead of message box for debugging longer scripts when using the debug module option.

    Added Enter key shortcut to test modules.


    ------
    @djvj
    I didnt add your two requests yet for these reasons.

    1. For the hidedesktop option - I havent fully thought out how to implement this yet. I thought about having a setting in a per emu setting hideDesktopOff=true, then you can add your own stuff to the scripts that have to have it.

    2. CPWizard - is this so you can see in game controls. Launch modules should not include anything like this in with the module since the module is just for starting and exiting games. If it needs to be an option then it should go into the main script and have an option to turn it on or off, not just have a path to it. Also does it need its own hotkey or does it do its thing on its own. Does it need to be on or off on a per emu basis or just a general on or off. If its per emu then we need it in each systems settings not in the main settings.
    Download every Theme all at once with FTP access! FTP accounts are now created automatically when you upgrade your account.

    My Cabs:


  12. #10
    Ultimate HyperSpin Guru
    djvj's Avatar
    Join Date
    Mar 2009
    Location
    Long Island
    Posts
    8,103
    Thanks
    1,069
    Thanked 2,457 Times in 1,053 Posts
    Blog Entries
    3

    Default

    I only have cpwizard configured for mame. But I plan to incorporate it into more systems later, I just know many do use it for all their systems. Maybe someone who has it setup for multiple systems can chime in on its use.
    "Computer games don't affect kids; I mean if Pac-Man affected us as kids, we'd all be running around in darkened rooms, munching magic pills and listening to repetitive electronic music."

    HyperLaunch's New Official Home

    If you appreciate my work:


    My Apps:
    Window Logger
    Idle Volume Adjuster
    ExplorerRestorer
    Rom Folder Cleaner
    Module Updater
    My Guides:
    How To Mod Guncons with Aimtrak

  13. The Following User Says Thank You to djvj For This Useful Post:

    johnny323 (03-20-2013)

Page 1 of 275 1 2 3 11 51 101 ... LastLast

Similar Threads

  1. Questions for the "HyperLaunch 2.x Released" tutorial
    By Buxilaks in forum HyperLaunch Legacy Archive
    Replies: 6
    Last Post: 10-23-2012, 08:06 AM
  2. PinMAME 2.5 has been released.
    By Dazz in forum HyperPin Main Forum
    Replies: 0
    Last Post: 06-06-2012, 05:40 AM
  3. HyperLaunch 2.x Released
    By BadBoyBill in forum HyperSpin Main Forum
    Replies: 877
    Last Post: 10-06-2011, 12:47 PM
  4. Hyperlaunch 1.04 released
    By brian_hoffman in forum HyperSpin Main Forum
    Replies: 68
    Last Post: 09-05-2009, 03:42 PM

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •