SWF Sound Automation Tool v2.5 HTML Help/Documentation

Transcription

1 Index Welcome to "SWF Sound Automation Tool v2.5" About XYZSoftware Software License Agreement How to Register? Using "SWF Sound Automation Tool v2.5" Menu Bar Options File Menu Edit Menu Run Menu Player Menu Window Menu Help Menu Project Settings Preferences Screen Working as a Batch Process "How do I..." Section Work with application interface Create a new project Load an existing project Add MP3/WAV files to a project Upload SWF files to FTP server automatically Use spawn session Play generated SWF's Create new Output Types Resample MP3 files Use SWF Sound Libraries SWF Sound Automation Tool v2.5 HTML Help/Documentation Tutorials Creating Your First Project Editing Preferences Screen Uploading SWF's to FTP Server (SWF Sound Automation Tool v2.5 By XYZSoftware)

2 Welcome to "SWF Sound Automation Tool v2.5" Back to Index Bottom XYZSoftware is proud to present "SWF Sound Automation Tool v2.5", the best MP3/WAV to SWF conversion tool for automation. "SWF Sound Automation Tool v2.5" designed as a powerful and user-friendly tool that will enable you to convert MP3 and WAV files to streaming or event based.swf sound files. In this new release, we added resampling of MP3 files, conversion to real SWF streaming audio format and also ability to create SWF sound libraries. Main features of SWF Sound Automation Tool v2.5 are as follows; Conversion of MP3/WAV files to Streaming or Event Based SWF sounds. Resampling of MP3 files Creating SWF Sound Libraries Recording via a microphone and direct conversion to SWF Selecting hundreds of sound files at a time for conversion Easy-to-use interface FTP server file uploads XML based project creation High compression rate Can run as a batch process Ability to convert more than 100 files in just 5 minutes "SWF Sound Automation Tool v2.5" intended to be used by all levels of web designers; beginner, intermediate and professional Macromedia Flash users, Flash game programmers and Online education companies. XYZSoftware wishes you to enjoy our product. Director Arda ORCAN XYZSoftware Welcome to "SWF Sound Automation Tool v2.5" Back to Index Top About XYZSoftware Back to Index Bottom Since 1998, we are developing programs,tools and components that help the developers as well as the end-users. We have a wide range of programs both written by Java, C++ and Delphi. Our company have some unique tools that can be downloaded anywhere from web, but generally, we are working on personalized solutions for our customers. We have a professionalized group of designers and programmers that work 7/24 for your satisfaction. If you need a solution for your company and want to work with a company which can create the most efficient, and effective solutions, we will be glad to be working with you. For finding out more about our company or downloading other programs by XYZSoftware, please do not hesitate to contact us: contact@xyz-software.com Web Site: About XYZSoftware Back to Index Top Software License Agreement Back to Index Bottom SWF Sound Automation Tool v2.5 Copyright , XYZSoftware, Inc.All Rights Reserved. Software License Agreement You should carefully read the following terms and conditions before using this software. DISCLAIMER

3 Users of "SWF Sound Automation Tool" must accept this disclaimer of warranty: ""SWF Sound Automation Tool" is supplied as is. XYZSoftware, Inc. disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of "SWF Sound Automation Tool"." DISTRIBUTION The registered version of "SWF Sound Automation Tool" cannot be distributed without the expressed written permission of XYZSoftware, Inc. You may copy and distribute the unmodified evaluation version of this software in electronic form. You are prohibited from charging for or distributing this software with other products (commerical or otherwise) without the expressed permission of XYZSoftware, Inc. INTELLECTUAL PROPERTY This program is owned by XYZSoftware, Inc. and is protected by U.S. and international copyright laws. Violation of this copyright is a serious offense VIOLATION OF COPYRIGHT IS A SERIOUS OFFENSE. EVALUATION VERSION This is not free software. Subject to the terms below, you are hereby licensed to use this software for evaluation purposes without charge for a period of 10 days. If you use this software after the 10 day evaluation period a registration fee is required. Credit card ordering is available, as described in the section Ordering Information/Order Form. When payment is received you will be asked for the Registration Code which is a unique number for each machine and which can be found on the 'Registration Confirmation' window of the program. (The Number which is written in red.) After XYZSoftware gets the Registration Code they will send you an Unlocking code for full version of "SWF Sound Automation Tool". For more information about Registering and payment methods visit REGISTERED VERSION One registered copy of "SWF Sound Automation Tool" may either be used by a single person who uses the software personally on one or more computers,or installed on a single workstation used nonsimultaneously by multiple people, but not both. You may access the registered version of "SWF Sound Automation Tool" through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network. For instance, if 5 different workstations will access "SWF Sound Automation Tool" on the network, each workstation must have its own "SWF Sound Automation Tool" license, regardless of whether they use "SWF Sound Automation Tool" at different times or concurrently. NO DISASSEMBLY OR DECRYPTION You may not disassemble, decompile or decrypt the Software without the expressed permission of XYZSoftware, Inc. USER LICENSE You may use this program only on a single computer. This program is the property of XYZSoftware, Inc., and is protected by U.S. and international copyright laws. VIOLATION OF THIS COPYRIGHT IS A SERIOUS OFFENSE, PUNISHABLE BY THE UNITED STATES GOVERNMENT. Software License Agreement Back to Index Top How to Register? Back to Index Bottom Registration procedure for "SWF Sound Automation Tool v2.5" is quite simple. After 10 days of evaluation you must buy "SWF Sound Automation Tool v2.5" in order to continue using. For buying instructions of "SWF Sound Automation Tool v2.5" please have a look at our web site.

4 After buying the program Reg.Net will notify us about your purchase. Then you will get an from us asking for your Customer Code. Each computer has an unique "customer code" for "SWF Sound Automation Tool v2.5". You can find out your customer code by clicking 'Enter Reg Code' button on the Nag Screen. A window will popup asking an unlocking code for the program. In this window the Numbers Written in Red and with bigger fonts is the Customer Code for the machine which the program has been installed on (Registration Number). You must send us your Customer Code by to us. (Addition to your customer code we will appreciate if you also send us your Organization Name and your License Name) After getting your Customer Code we create an unlocking code and optionally an organisation name and a License Name and send you an containing these values. When you apply these values your program will be registered and the nag screen will go away. How to Register? Back to Index Top Using "SWF Sound Automation Tool v2.5" Back to Index Bottom Below is a screen capture of "SWF Sound Automation Tool v2.5".

5 "SWF Sound Automation Tool v2.5" main screen consists of several parts which are explained in detail below Menu Bar: The Menu bar displays the menu headings. The menus that are available depend on what is open in the workspace. Menu items that appear in grey either do not apply or are unavailable based on the project selections. You can display menu commands by clicking the menu in the Menu bar. Also, you can select or execute a menu command using the following methods: Clicking the item in the menu, Using the cursor keys to highlight a menu item, and pressing the Enter key. Pressing shortcut keys from keyboard. Available keyboard shortcuts can be seen on the right side of the menu items. Toolbar:The toolbar provides buttons that access some of the frequently used commands in the menus. To activate a command, click its toolbar button. If a command is unavailable, its buttons appears greyed-out. Sound Files Panel:In Sound Files Panel, you see list of sound files selected for conversion. By right clicking on the panel, you can easily add or remove selected files from your current project. Project Settings Panel:The Project Settings Panel consists of three main parts. In Conversion Settings, you can set the conversion options and select whether you want to resample your MP3 files. In Output Settings, you set Output SWF file information such as streaming sound files, frames per second, frame tuning, etc. In FTP Server Settings, you can enter your FTP server information to upload created SWF sound files/libraries after the conversions are completed. Log Panel:Shows information on generated SWF sound files on current session. When double clicked on a successful conversion log your current swf player will run the generated swf file. In addition, you can easily see the file size of the swf file. Using "SWF Sound Automation Tool v2.5" Back to Index Top Menu Bar Options Back to Index Bottom File Menu: File Menu > New Project: Used to create a new project. If the project currently worked on is modified, the application

6 will ask whether to save it or not. File Menu > Open Project: Used to load a previously saved project. If the project currently worked on is modified, the application will ask whether to save it or not. File Menu > Save Project: Used to save the changes made to a project. If the project is not previously saved, save as dialog box will appear to give a name to the project. File Menu > Save Project As: Used to save a project with a different name. File Menu > Preferences: Used to create new swf sound output modes or modify existing modes. You can find more information on preferences screen here. File Menu > Exit: Used to close the application. If the project currently worked on is modified, the application will ask whether to save it or not. Edit Menu: Edit Menu > Add File(s): Used to add sound files to the project. When clicked, a selection dialog box will appear, where multiple selection of files are allowed. Edit Menu > Remove File(s): Used to remove selected sound files from the project. If no file is selected, this option will appear grey. Edit Menu > Save Session Log: Used to save the session log information to a text file. Edit Menu > Clear Session Log: Used to delete the text in session log panel. Edit Menu > Enable Session Log: When unchecked, the conversion log information is no more added to log panel. Edit Menu > Select All: Used to select all sound files on current project. Edit Menu > Invert Selection: Used to invert selections on the sound files list. Run Menu: Run Menu > Start Conversion: Creates the SWF files with defined project settings applying to all sound files. If no sound file is added to a project this option will appear grey. Run Menu > Spawn Sesison: Opens a SWF Sound Automation Tool application, where you can work with different projects simultaneously. Player Menu: Player Menu > Record: Starts recording the sound through the microphone and simply converts it to SWF. Player Menu > Start: Starts playing the last selected sound file on the main panel. If no file is selected, this options appears to be grey. Player Menu > Pause: Pauses the sound file being played. Player Menu > Stop: Stops the sound file being played. Window Menu: Window Menu > Project Settings: Opens/Closes Project Settings Panel. Window Menu > Sound Files: Opens/Closes Sound Files Panel. Window Menu > Logs: Opens/Closes Logs Panel. Window Menu > Reset Panel Layout: Resets Panel Layouts to application default. Application needs restart to apply. Window Menu > Reset Menu Layout: Reset Menu Bar and Toolbar layouts to application default. Application needs restart to apply. Window Menu > Reset All Items: Reset all panels to application default. Application needs restart to apply. Help Menu: Help Menu > Tip of the Day: Opens the "Tip of the Day" screen. Help Menu > Help: Opens help screen of the application. Help Menu > Web Page: Opens in web browser. Help Menu > Register: If the application is registered, shows registry information. If not registered, opens registry screen. For more detail on registering the product, refer to "How to Register?" section. Help Menu > About: Shows version and registrant information. If the application is not registered, the days left in trial version can be learn. Menu Bar Options Back to Index Top Project Settings Back to Index Bottom

7 Project Settings: Project Settings Panel consists of 3 main Option Groups: Conversion Settings: Resample MP3 Files: If you want to resample your MP3 files in the current project you need to check this option. Output Mode (Quality/Mode/Bitrate): the user can select conversion quality, mode and bitrate of swf sound file. Depending on the selected sound conversions may be unsuccessful, in that case you may need to change these settings. Output Settings: Output Type: Lists all predefined output types. In preferences screen you can add new output types. You can easily select and apply output settin output folder of a predefined type to the current project. Sync: Select whether the output SWF will play in streaming format or in event based format. Frame/Seconds: You can set frame per second for your SWF file. Practically, this option do not change the output SWF file, however advanced Fl users may use this option for calculation needs. Frame Tuner: Here, you can set the stopping point of the sound. When you want to play the file in loops, and the start and end points do not com the sound you can set it. Output Folder: You can set to which folder the SWF's will be generated. Stop Actions (None / Start / End): With these options you can set where SWF file should stop. If you select "Stop Action To Start", you need to ca start it from another SWF file. FTP Server Settings: Here you give the details of your FTP server to upload the generated SWF files. If "Upload Files" option is checked, you can not leave address and ftp directory fields blank. Also, if you want to connect the ftp server anonymously, you have to set the user name as "Anonymous". Project Settings Back to Index Top Preferences Screen Back to Index Bottom Preferences Screen: This screen consists of two main parts, general preferences part, and output type information part. General Preferences: In general preferences, you can set the default mode and default output folder for your projects. These defaults is only applied after you restart the application. It is important that, default output folder is not related with an output mode, but related with the application in general.

8 Output Type: In output type part, you can set default conversion quality, mode and bitrate options for existing output modes. In addition, you can also define your own output types, so that you can easily apply your desired sound quality options to every project easily. To add a new output mode, click on "Add New" button, and fill the necessary information on the dialog window shown, such as the name, quality, mode, and bitrate. After adding a user-defined output type, you can set this mode as default output mode from general preferences. Preferences Screen Back to Index Top Working as a Batch Process Back to Index Bottom SWF Sound Automation Tool has the ability to be used as a part of an automation project, or a web site. All of the functionality of the program can be manipulated with the command prompt. The task manager can be assigned to run the program from the command prompt (DOS) with the parameters needed. Also this program can be interacted with popular databases like Oracle, MS SQL, MySQL, MS Access for performing some routine automation processes with the help of the parameters sent within the command prompt. The command prompt parameters for SWF Sound Automation tool are as follows: SWFSOUNDAUTOMATE -AUTO -F:filename [-HIDE] [-SHUTDOWN] -AUTO (required) : -AUTO parameter runs the application as a batch process. If you forget to add these parameter, SWF Sound Automation Tool only opens the project for further changes. -F:filename (required) : -F parameter is a required paramater. filename stands for the.snx file to be processed. If the project path has whitespaces in it, do not forget to add quotes in filename parameter. Ex: swfsoundautomate - f:"c:\example Projects\example.snx" -auto -hide -HIDE (optional) : With -HIDE parameter, the application works hidden (i.e. do not show application screen when running). -SHUTDOWN (optional) : -SHUTDOWN parameter, closes the application after batch process is completed. Note that, by setting -HIDE parameter without -SHUTDOWN, application screen is just hidden, until the processing is completed. To use batch processing in SWF Sound Automation Tool, you should know the XML structure of.snx files, which is explained in detail below: <swfsoundautomateproject> <prgid>xyz2000</prgid> <filever>2.5</filever> <ProjectName>C:\Example Projects\example.snx</ProjectName> <OutputType>0</OutputType> <Quality>1</Quality> <Mode>s</Mode> <Bitrate>64</Bitrate> <Frequency>22.050</Frequency> <OutputFolder>C:\Example Projects\</OutputFoldertype> <Files> <File>C:\mp3s\test1.mp3</File> <File>C:\mp3s\test2.mp3</File> <File>C:\WAVs\test3.wav</File> <File>C:\WAVs\test4.wav</File> </Files> <StopAction>0</StopAction> <FramePerSeconds>12</FramePerSeconds> <FrameTuner>0</FrameTuner> <runupload>0</runupload> <resamplemp3>1</resamplemp3> <synctype>1</synctype> <ftpaddress>ftp.testftp.com</ftpaddress> <ftpuser>anonymous</ftpuser> <ftppass></ftppass>

9 <ftpport>21</ftpport> <ftppasvmode>0</ftppasvmode> <ftpdir>/projects</ftpdir> </swfsoundautomateproject> swfsoundautomateproject, prgid, filever: These tags must exist in a SWF Sound Automation project file. ProjectName : This tag stands for the project name and file path of the project. Quality, Mode, Bitrate: Output Settings of the sound files. OutputFolder : Sets where the output swf files will be created. Files : List of sound files to be converted. StopAction, FramePerSeconds, FrameTuner: These tags configure swf frame options. runupload, ftpaddress, ftpuser, ftppass, ftpport, ftppasvmode, ftpdir : Ftp server information for uploading generated swf files. Working as a Batch Process Back to Index Top "How do I..." Section Back to Index Bottom 1. How do I work with application interface? 2. How do I create a new project? 3. How do I load an existing project? 4. How do I add MP3/WAV files to a project? 5. How do I upload SWF files to FTP server automatically? 6. How do I use spawn session? 7. How do I play generated SWF's? 8. How do I create new Output Types? 9. How do I resample MP3 files to reduce their size? 10. How do I use SWF Sound Libraries in my projects? Work with application interface: When using "SWF Sound Automation Tool v2.5", you can customize the application interface easily. All of the panels and menus are draggable and their positions are saved when you close the program. Also from the Window Menu you can open/close the panels that you want. In addition, from Window Menu you can reset the application interface to its defaults. Creating a new project: To create a new project, select "File > New Project" from Menu Bar. You can also click on the "New" icon from the toolbar. Load an existing project: "SWF Sound Automation Tool v2.5" saves project information in XML file format with ".snx" extension. When you select "File > Open Project", or click on "Load" icon from the toolbar a Load dialog box will appear. Select the ".snx" file containing project information and press "Open" button on the dialog box. If there is an open and not saved project at that time, you will be asked whether to save the project or not. Add MP3/WAV files to a project: There are several ways to add sound files to a project. You can choose from Menu Bar "Edit > Add File(s)" option (same button is also available on toolbar). A dialog box would appear where you can select multiple files by using CTRL and/or SHIFT keys. In addition, you can easily drag and drop sound files from windows explorer to "SWF Sound Automation Tool > Sound Files Panel" to add these files. Upload SWF files to FTP server automatically: First of all, you need to check "Upload files when finished" CheckBox on the "Project Settings" panel. Below that CheckBox, you have to enter the necessary FTP login information. If you need to connect FTP server anonymously, do not forget to enter "Anonymous" as the User Name. A detailed log file is created for the upload information and conversion in the Output Folder. Use "Spawn Session": By session spawning, it is meant that you can run multiple "SWF Sound Automation Tool v2.5" application simultaneously. You can work with different projects at the same time. Play generated SWF's: The bottom frame on the application shows the conversion logs. When a conversion is completed it shows whether the conversion is successful. When you double click on this line, you can play SWF file by your default Flash player. Create new Output Types: By default, SWF Sound Automation Tool has two output types, "SWF for Inranet", and "SWF for Internet". If you want to create other types, you can use "File > Preferences" option from MenuBar. For more information on this

10 panel you can look at Preferences Screen or simply read Uploading SWFs Tutorial. Resampling MP3 Files: In Project Settings Menu, you need to check the "Resample MP3 files" box for MP3 resampling. If not checked, the audio conversion setting only apply to WAV files. Using SWF Sound Libraries: In Macromedia Flash 6.0, you can use SWF Sound Libraries but it is not fully supported, it is only experimental. To use the sound library you have to manually export it to a movie. That means sound libraries are not suitable to be used for automation purposes. "How do I..." Section Back to Index Top Creating Your First Project - Tutorial Back to Index Bottom In this tutorial, we will explain how you can create a simple SWF step-by-step. 1. Start SWF Sound Automation Tool from Start > Programs > XYZSoftware > SWF Sound Automation Tool > SWF Sound Automation Tool or by double-clicking on the SWF Sound Automation Tool shortcut on the desktop. The application starts with a new project by default. In addition, a new, unsaved project is named as "untitled.snx". 2. Now to start with, we should add sound files to our project. There are several ways to add a sound file. You can select Edit > Add File(s) from Menu Bar. You can click on Add button from Toolbar. Or simply, you can press <"F5"> button from keyboard. A dialog box appears, where you can add multiple sound files into the project. Click "Open" button after you select files. 3. Next step we need to deal with, is arranging project settings. If you have added any MP3 files in your project, click on "Resample MP3 Files" and select "SWF for Internet". In

11 Quality box, 1 refers to highest quality but slower conversion, whereas 10 refers to lowest quality, but faster conversion. In Output Settings, select "Stop Action to End" for running the SWF file to play only once.for our first project, leave Frame/Seconds and Frame Tuner settings as they are. When starting a new project, the Output Folder is set as Application Path as default. If you want you can select another folder by clicking "..." button, or enter the path manaully. 4. Now we are ready to generate our first SWF sound. To convert all sound files in your project into SWFs you can: You can select Run > Start Conversion from Menu Bar. You can click on Run from Toolbar. Or simply, you can press <"F9"> button from keyboard. 5. When convertion is completed successfully, "Output Logs" panel is updated. When you double-click an item on the panel the generated swf will be played. Note that, if conversion fails for some reason, it will also shown in the log panel. 6. Now save this project for future. Click on File > Save Project As from Menu Bar.

12 Or, click Save from Toolbar. Or simply click <"CTRL+S"> from keyboard. By completing this tutorial, you have learnt how you can create SWFs using SWF Sound Automation Tool and save your projects. Creating Your First Project - Tutorial Back to Index Top Editing Preferences Screen - Tutorial Back to Index Bottom In this tutorial, you will learn how to use Preferences Screen efficiently. 1. To open Preferences Screen, click File > Preferences from Menubar. 2. Preferences Screen serve two main purposes. First, you can define default output mode and output folder of the application. Second, you can create custom output modes for your needs. 3. Selection of default output mode and output folder can be done through simple comboboxes. 4. To create a new output mode, you need to click "Add New" button, give its name and set the properties as you wish. 5. In addition, you can also change default properties of output modes by changing quality, mode and bitrate settings and clicking on "Save" Button. As you see, Preferences Screen is simple to use and also may be very helpful when automating your sound conversions. Editing Preferences Screen - Tutorial Back to Index Top Uploading SWF's to FTP Server - Tutorial

13 Back to Index Bottom In this tutorial, you will learn how to upload generated SWF sound files to your FTP server automatically. 1. Through this tutorial, you can look at FTP Server Settings Panel for detailed field explanations, if you wish. 2. First of all, to upload generated SWFs you have to check "FTP Server Settings" box, to enable entering necessary information. 3. Then you need to enter ftp server address, ftp port, your username and password to acces the ftp. In addition, you have to enter the ftp directory to upload the files. You can select Run > Start Conversion from Menu Bar. You can click on Run from Toolbar. Or simply, you can press <"F9"> button from keyboard. 4. If all the ftp information is entered correctly, the SWF files would be uploaded after the conversion process is completed. Note that, for each conversion process a log file is created in which detailed file upload information is written. By completing this tutorial, you can upload SWF sound files to your FTP server easily. Uploading SWF's to FTP Server - Tutorial Back to Index Top