# Changeset 2aeaea9572 in tspsg

Ignore:
Timestamp:
Nov 2, 2013, 5:44:47 PM (4 years ago)
Branches:
appveyor, master
Children:
Parents:
50b202f04d
git-author:
Oleksii Serdiuk <contacts@…> (11/02/13 17:44:47)
git-committer:
Oleksii Serdiuk <contacts@…> (11/03/13 20:48:44)
Message:

Files:
3 edited

### Legend:

Unmodified
 r50b202f04d ------------------------------- ### WHAT'S NEW ### ### What's New ### - Support for embedded base64 encoded images when saving solution as HTML (Ticket #4). - The ability to setup page-related options for printing (Ticket #5). - Solution graph size can now be controlled using Output/GraphWidth setting in tspsg.ini. Value is in centimeters. (Ticket #8) HTML ([Ticket #4][]). - The ability to setup page-related options for printing ([Ticket #5][]). - Solution graph size can now be controlled using Output/GraphWidth setting in tspsg.ini. Value is in centimeters. ([Ticket #8][]) ### CHANGES & IMPROVEMENTS ### ### Changes & Improvements ### - Any value that is entered into task table and doesn't contain selecting a language. - Handheld version includes larger icons (48x48 instead of 32x32). - If after running Save As dialog file name doesn't have an extension .tspt will be automatically appended. - If after running Save As dialog file name doesn't have an extension .tspt will be automatically appended. - Translucency effect is available on all desktop platforms. No check for its support by window system is made at this moment. Blur is ### BUGFIXES ### ### Bugfixes ### - Bug #2: Solution graph is too small on high resolution screens. - Bug #3: Solution graph font size should be fixed. - Bug #6: Bug: Actions in Options Menu. - Bug #7: No Cancel option in Unsaved Changes dialog under Symbian. - Bug #9: Solution graph is still exported to HTML when graph - [Bug #2][]: Solution graph is too small on high resolution screens. - [Bug #3][]: Solution graph font size should be fixed. - [Bug #6][]: Bug: Actions in Options Menu. - [Bug #7][]: No Cancel option in Unsaved Changes dialog under Symbian. - [Bug #9][]: Solution graph is still exported to HTML when graph generation is disabled. - Language name was not loaded in its menu item's status tip which caused status tip to be "Set application language to ". caused status tip to be *Set application language to *. - Icons in toolbar configuration dialog didn't follow style and one of them wasn't shown. [Bug #2]: http://bugs.tspsg.info/ticket/2 [Bug #3]: http://bugs.tspsg.info/ticket/3 [Ticket #4]: http://bugs.tspsg.info/ticket/4 [Ticket #5]: http://bugs.tspsg.info/ticket/5 [Bug #6]: http://bugs.tspsg.info/ticket/6 [Bug #7]: http://bugs.tspsg.info/ticket/7 [Ticket #8]: http://bugs.tspsg.info/ticket/8 [Bug #9]: http://bugs.tspsg.info/ticket/9 ------------------------------- ### WHAT'S NEW ### ### What's New ### + Solution graph generation. + Support for switching between available Qt styles. + Toolbar customization support (only on desktop platforms). + An option to remember last used directory when saving and opening. + Automatically check for updates at the given interval option (only - Solution graph generation. - Support for switching between available Qt styles. - Toolbar customization support (only on desktop platforms). - An option to remember last used directory when saving and opening. - Automatically check for updates at the given interval option (only on Windows platform at this moment). ### IMPROVEMENTS ### ### Improvements ### + Improved the solution output generation algorithm. It is now about - Improved the solution output generation algorithm. It is now about 1.65 times faster. + Dragging and dropping task file on the main window now opens it. + The deafult output font is now DejaVu LGC Sans Mono and it comes - Dragging and dropping task file on the main window now opens it. - The deafult output font is now DejaVu LGC Sans Mono and it comes "embedded" in the executable. + The current desktop icon theme in Linux is now used if it follows - The current desktop icon theme in Linux is now used if it follows freedesktop.org icon theme and icon naming spesifications. + Translations are now "embedded" in the executable but may be - Translations are now "embedded" in the executable but may be overrided by placing files with the same names in l10n folder. + Support for Windows 7 Taskbar Extensions (namely, Progress Bars). - Support for Windows 7 Taskbar Extensions (namely, Progress Bars). ### CHANGES ### ### Changes ### * About dialog was "tabified". Added GPL License and Credits tabs. * Platform dependent settings (e.g. paths) are saved per-platform. * 32x32 icons are used on handheld platforms. This slightly decreases - About dialog was "tabified". Added GPL License and Credits tabs. - Platform dependent settings (e.g. paths) are saved per-platform. - 32x32 icons are used on handheld platforms. This slightly decreases the size of handheld versions. Desktop icons are still 128x128. * Windows binary builds were moved from MSVC to Mingw-w64: no more - Windows binary builds were moved from MSVC to Mingw-w64: no more Visual C++ Runtime dependency. ### BUGFIXES ### ### Bugfixes ### - Solution related actions not disabled when solution is canceled. - "Autosize" setting was never saved and was always on. - Autosize setting was never saved and was always on. -------------------------------- ### WHAT'S NEW ### ### What's New ### + New TSPSG icon. + Symmetric mode: in this mode the cost of travel from city 1 to - New TSPSG icon. - Symmetric mode: in this mode the cost of travel from city 1 to city 2 and vice versa is the same. + Printing of solution results (if the platform supports it). + Saving solution to PDF (if the platform supports printing). + An ability to reset all settings to their defaults: hold Shift - Printing of solution results (if the platform supports it). - Saving solution to PDF (if the platform supports printing). - An ability to reset all settings to their defaults: hold Shift while clicking Save button in the Settings Dialog. + An ability to generate fractional random numbers. + An ability to set the fractional accuracy (in decimail places). + An ability to select between using native and Qt's file dialogs - An ability to generate fractional random numbers. - An ability to set the fractional accuracy (in decimail places). - An ability to select between using native and Qt's file dialogs when opening and saving tasks and solutions. + An ability to disable showing of the solution steps' matrices in - An ability to disable showing of the solution steps' matrices in solution output. + An ability to enable scroll to the end of the solution output after - An ability to enable scroll to the end of the solution output after solving. + An ability ot enable automatic resize of columns and rows to their - An ability ot enable automatic resize of columns and rows to their contents on its change. + Basic support for Symbian. + Check for updates functionality (only in Windows version at this - Basic support for Symbian. - Check for updates functionality (only in Windows version at this moment). ### IMPROVEMENTS ### ### Improvements ### + Improved the solution algorithm. + The maximum number of cities in task was increased to 50. - Improved the solution algorithm. - The maximum number of cities in task was increased to 50. NOTE: Showing the solution steps' matrices is disabled by default for tasks with more than 15 cities to considerably speed up the generation of the solution output process. + List of alternate candidates for branching is now displayed. + Warning about possible non-optimal result. + Open a file, passed as command-line argument. + Currently opened file name is displayed in the Main Window title. + "Save Solution" and "Back to Task" buttons in Solution tab for - List of alternate candidates for branching is now displayed. - Warning about possible non-optimal result. - Open a file, passed as command-line argument. - Currently opened file name is displayed in the Main Window title. - "Save Solution" and "Back to Task" buttons in Solution tab for better usability. + The size of the toolbar buttons is now determined based on the - The size of the toolbar buttons is now determined based on the device DPI in Windows Mobile and Symbian. + SIP show/hide handling in Windows Mobile. + Toolbar state and position are now saved and restored with the Main - SIP show/hide handling in Windows Mobile. - Toolbar state and position are now saved and restored with the Main Window state and position. + Window translucency support in Windows Vista and Windows 7. - Window translucency support in Windows Vista and Windows 7. ### CHANGES ### ### Changes ### * The resulting path is now sorted, always starts from City 1 and has - The resulting path is now sorted, always starts from City 1 and has "City 1 -> City n -> ... -> City 1" format. * Translations were moved from i18n to l10n folder to follow common - Translations were moved from i18n to l10n folder to follow common standards. * Reworked the Settings Dialog layout. * Reworked the About dialog. - Reworked the Settings Dialog layout. - Reworked the About dialog. ### BUGFIXES ### ### Bugfixes ### - A solution couldn't be found for some tasks while the task had at This is initial TSPSG release. ### FEATURES ### ### Features ### * Solving taks with up to 5 cities. * Generating tasks. * Saving solution results to HTML and ODF. * Importing tasks from ZKomModRd. * Multilinguality: English, Russian and Ukrainian languages. * Linux/UNIX, Windows and Windows Mobile support. - Solving taks with up to 5 cities. - Generating tasks. - Saving solution results to HTML and ODF. - Importing tasks from ZKomModRd. - Multilinguality: English, Russian and Ukrainian languages. - Linux/UNIX, Windows and Windows Mobile support.
 r50b202f04d TSPSG Installation Guide ======================== Thank you for trying TSPSG. This document will guide you through the steps necessary to compile and run TSPSG. TABLE OF CONTENTS: 1. REQUIREMENTS 2. ASSUMPTIONS 3. SUPPORTED PLATFORMS 4. BUILDING AND INSTALLATION 4.1. COMMON INFORMATION 4.2. GENERAL PROCEDURE 4.3. LINUX/UNIX/BSD 4.4. WINDOWS 4.4.1. USING MINGW 4.4.2. USING VISUAL STUDIO 4.5. WINDOWS MOBILE 4.6. SYMBIAN 4.7. OTHER PLATFORMS, SUPPORTED BY QT 5. UNINSTALLATION 6. TROUBLESHOOTING 6.1. WINDRES.EXE CRASH 7. NOTES 8. REFERENCES 1. REQUIREMENTS TSP Solver and Generator Installation Guide =========================================== Thank you for trying **TSP Solver and Generator**. This document will guide you through the steps necessary to compile and run **TSPSG**. 1. Requirements --------------- To be able compile TSPSG you need to have Qt libraries. The minimum supported version of Qt is 4.5.0. The recommended version is 4.6.x or higher. NOTE: Please, note that there will be some regressions in functionality if your version of \em Qt is lower than the recommended. 2. ASSUMPTIONS To be able compile **TSPSG** you need to have *[Qt libraries](http://qt-project.org/)*. The minimum supported version of *Qt* is **4.5.0**. The recommended version is **4.6.x** or higher. **NOTE:** Please, note that there will be some regressions in functionality if your version of *Qt* is lower than the recommended. 2. Assumptions -------------- This guide assumes that you already have Qt libraries and all necessary prerequisites installed. This guide assumes that you already have *Qt* libraries and all necessary prerequisites installed. Also, the following assumptions are made: - For Linux/UNIX: lrelease and qmake are avilable in $PATH. - For Windows (minGW) and Symbian: you have installed Qt SDK or prebuilt libraries and have Start Menu items for Qt tools. - For Windows (Visual Studio) and Windows Mobile: the Qt libraries reside in C:\Qt\. - For Windows Mobile: Windows Mobile 5.0 Pocket PC SDK or later is installed. 3. SUPPORTED PLATFORMS - For **Linux/UNIX/BSD**: lrelease and qmake are avilable in $PATH. - For **Windows** (*MinGW*) and **Symbian**: you have installed *Qt SDK* or prebuilt libraries and have Start Menu items for *Qt* tools. - For **Windows** (*Visual Studio*) and **Windows Mobile**: the *Qt* libraries reside in C:\Qt\. - For **Windows Mobile**: *Windows Mobile 5.0 Pocket PC SDK* or later is installed. 3. Supported Platforms ---------------------- TSPSG is oficially supported and tested on the following platforms: - Linux: Gentoo AMD64 and Kubuntu 9.10 64-bit AMD. - Windows: Windows XP 32-bit and Windows 7 64-bit. - Windows Mobile: Windows Mobile 6.5 Professional Edition. 4. BUILDING AND INSTALLATION ---------------------------- ### 4.1. COMMON INFORMATION ### To be able ot build TSPSG you need to have the following Qt modules: QtCore, QtGui and QtSvg. The first two are required, the last one is optional. To get support for additional image formats (i.e., JPEG and TIFF) you'll additionally need corresponding Qt imageformats plugins. If you want to build TSPSG without SVG support add nosvg to qmake CONFIG parameter, so that qmake command will typically be: **TSPSG** is oficially supported and tested on the following platforms: - **Linux**: *Gentoo AMD64* and *Kubuntu 9.10 64-bit AMD*. - **Windows**: *Windows XP 32-bit* and *Windows 7 64-bit*. - **Windows Mobile**: *Windows Mobile 6.5 Professional Edition*. 4. Building and Installation ---------------------------------------------- ### 4.1. Common Information ### To be able ot build **TSPSG** you need to have the following *Qt* modules: *QtCore*, *QtGui* and *QtSvg*. The first two are required, the last one is optional. To get support for additional image formats (i.e., **JPEG** and **TIFF**) you'll additionally need corresponding *Qt imageformats* plugins. If you want to build **TSPSG** without **SVG** support add nosvg to *qmake* CONFIG parameter, so that *qmake* command will typically be: qmake CONFIG+=release CONFIG+=nosvg This way you will not depend on QtSvg module but will not be able to export solution graph in SVG format. TSPSG uses qmake PREFIX parameter to determine installation path for make install command. If you don't specify it when running qmake, it This way you will not depend on *QtSvg* module but will not be able to export solution graph in **SVG** format. **TSPSG** uses *qmake* PREFIX parameter to determine installation path for make install command. If you don't specify it when running qmake, it will be assigned the default value depending on the platform: Platform          | Default PREFIX value -------------------|------------------------------------- Linux/UNIX/BSD    | /usr -------------------|------------------------------------- Windows           | %PROGRAMFILES% environment variable | (usually, it is "C:\Program Files") -------------------|------------------------------------- Windows CE/Mobile | "\Program Files" -------------------|------------------------------------- Symbian           | -------------------|------------------------------------- NOTE: Please, note that there are no installation and/or packaging rules for MacOS and other platforms not mentioned in this table. By default, TSPSG uses precompiled header when being built. If you experience problems with it you may add CONFIG+=nopch parameter to qmake to disable the generation and use of the precompiled header. ### 4.2. GENERAL PROCEDURE ### | Platform              | Default PREFIX value                  | |-----------------------|-----------------------------------------| | **Linux/UNIX/BSD**    | /usr                                  | | **Windows**           | %PROGRAMFILES% environment variable\* | | **Windows CE/Mobile** | \Program Files                        | | **Symbian**           | *\*                           | \* - usually, it is C:\Program Files. **NOTE:** Please, note that there are no installation and/or packaging rules for **MacOS** and other platforms not mentioned in this table. By default, **TSPSG** uses precompiled header when being built. If you experience problems with it you may add CONFIG+=nopch parameter to *qmake* to disable the generation and use of the precompiled header. ### 4.2. General Procedure ### On most platforms the general building and installation procedure is: 1. Run lrelease to generate binary translation files (.qm) from the source (.ts). 2. Run qmake with CONFIG+=release parameter to generate makefiles. 3. Run make utility (e.g., make, nmake, mingw32-make) to build TSPSG. 4. Run make utility with 'install' parameter (without quotes). NOTE: It is important to run lrelease before qmake, or qmake will not "pick up" the translations when generating installation rules. ### 4.3. LINUX/UNIX/BSD ### Open a shell, navigate to the directory where you have TSPSG source 1. Run lrelease to generate binary translation files (*.qm*) from the source (*.ts*). 2. Run qmake with CONFIG+=release parameter to generate makefiles. 3. Run make utility (e.g., *make*, *nmake*, *mingw32-make*) to build **TSPSG**. 4. Run make utility with install parameter. **NOTE:** It is important to run lrelease before qmake, or qmake will not "pick up" the translations when generating installation rules. ### 4.3. Linux/UNIX/BSD ### Open a shell, navigate to the directory where you have **TSPSG** source downloaded and type cd tspsg--src where is the version of TSPSG you downloaded. Now run where *\* is the version of **TSPSG** you downloaded. Now run lrelease tspsg.pro If make step finished without errors you can install TSPSG by running If make step finished without errors you can install **TSPSG** by running sudo make install depending on your distribution. The executable goes to /bin; COPYING, ChangeLog.txt, README.txt and INSTALL.txt go to /share/doc/TSPSG-. ### 4.4. WINDOWS ### TSPSG will be installed to \TSPSG folder. NOTE: Please, read the Section 7 after reading this Section. #### 4.4.1. USING MINGW #### Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Qt Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run The executable goes to /bin; *COPYING*, *ChangeLog.md*, *README.md* and *INSTALL.md* go to /share/doc/TSPSG-. ### 4.4. Windows ### **TSPSG** will be installed to \TSPSG folder. **NOTE:** Please, read the [Section 7](#s7) after reading this Section. #### 4.4.1. Using MinGW #### Unpack the downloaded source code of **TSPSG** with your favourite compression software. Now launch the **Qt Command Prompt** from the Start Menu, navigate to the directory where you unpacked the source and run lrelease tspsg.pro mingw32-make NOTE: Make process may fail with a crash of windres.exe. If you've run into this issue, please, read the Section 6.1. If make step finished without errors you can install TSPSG by running **NOTE:** Make process may fail with a crash of *windres.exe*. If you've run into this issue, please, read the [Section 6.1](#s61). If make step finished without errors you can install **TSPSG** by running mingw32-make install #### 4.4.2. USING VISUAL STUDIO #### Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Visual Studio Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run #### 4.4.2. Using Visual Studio #### Unpack the downloaded source code of **TSPSG** with your favourite compression software. Now launch the **Visual Studio Command Prompt** from the Start Menu, navigate to the directory where you unpacked the source and run C:\Qt\bin\lrelease tspsg.pro nmake If make step finished without errors you can install TSPSG by running If *make* step finished without errors you can install **TSPSG** by running nmake install ### 4.5. WINDOWS CE/MOBILE ### Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Visual Studio Command Prompt from the Start Menu and run ### 4.5. Windows CE/Mobile ### Unpack the downloaded source code of **TSPSG** with your favourite compression software. Now launch the **Visual Studio Command Prompt** from the Start Menu and run set PATH=C:\Qt\bin;%PATH% nmake There is no automated installation process for Windows Mobile build. To install TSPSG on your PDA you need to create a folder on your device and copy the following files to it: - tspsg.exe from release folder in the source directory. - QtCore4.dll and QtGui4.dll from C:\Qt\bin folder. - msvcr90.dll from C:\Program Files\Microsoft Visual Studio 9.0\VC\ce\dll\armv4i folder. - all *.qm files from l10n folder in the source directory to l10n subfolder. ### 4.6. SYMBIAN ### Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Qt for Symbian Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run There is no automated installation process for **Windows Mobile** build. To install **TSPSG** on your PDA you need to create a folder on your device and copy the following files to it: - *tspsg.exe* from release folder in the source directory. - *QtCore4.dll* and *QtGui4.dll* from C:\Qt\bin folder. - *msvcr90.dll* from C:\Program Files\Microsoft Visual Studio 9.0\VC\ce\dll\armv4i folder. - all *.qm* files from l10n folder in the source directory to l10n subfolder. ### 4.6. Symbian ### Unpack the downloaded source code of **TSPSG** with your favourite compression software. Now launch the **Qt for Symbian Command Prompt** from the Start Menu, navigate to the directory where you unpacked the source and run lrelease tspsg.pro make release-gcce WARNING: You need to unpack the source to the same drive as Symbian SDK and the path must not contain any spaces or TSPSG won't build. **WARNING:** You need to unpack source code to the same drive as **Symbian SDK** and the path must not contain any spaces or **TSPSG** won't build. If make step finished without errors you can generate sis installation make sis You'll get tspsg.sis file in the source directory. Copy it to your phone and run or install using Nokia PC Suite. NOTE: You need to install Qt libraries on your device before installing TSPSG. Usually, it should be enough to install qt_installer.sis from the Qt installation directory. Alternatively, if you have installed Nokia Smart Installer you can run You'll get *tspsg.sis* file in the source directory. Copy it to your phone and run or install using **Nokia PC Suite**. **NOTE:** You need to install *Qt* libraries on your device before installing **TSPSG**. Usually, it should be enough to install *qt_installer.sis* from the *Qt* installation directory. Alternatively, if you have installed **Nokia Smart Installer** you can run make installer_sis You'll get an tspsg_installer.sis that will automatically download and install the required Qt libraries on TSPSG installation. NOTE: Please, be aware that you have to sign the sis file to be able to install it on your device. You can use Open Signed Online[2] to quickly sign the sis file for your device. Alternatively, you can try to enable the installation of self-signed files in the phone settings. Please, reffer to your phone manual on the instructions how to do this. ### 4.7. OTHER PLATFORMS, SUPPORTED BY QT ### While TSPSG is oficially supported only on Linux, Windows and Windows Mobile it should be possible to compile it on any platform, supported by Qt. To do so, please, refer to the Section 4.1 for the general build and installation procedure. 5. UNINSTALLATION You'll get an *tspsg_installer.sis* that will automatically download and install the required *Qt* libraries on **TSPSG** installation. **NOTE:** Please, be aware that you have to sign the sis file to be able to install it on your device. You can use [Open Signed Online][1] to quickly sign the sis file for your device. Alternatively, you can try to enable the installation of self-signed files in the phone settings. Please, refer to your phone manual on the instructions how to do this. ### 4.7. Other Platforms, Supported by Qt ### While **TSPSG** is oficially supported only on **Linux**, **Windows** and **Windows Mobile** it should be possible to compile it on any platform, supported by *Qt*. To do so, please, refer to the [Section 4.2](#s42) for the general build and installation procedure. 5. Uninstallation ----------------- Usually, it is enough to replace 'install' parameter with 'uninstall' in the installation command from the Section 4. Also, you can manually delete all installed TSPSG files and directories. 6. TROUBLESHOOTING Usually, it is enough to replace install parameter with uninstall in the installation command from the [Section 4](#s4). Also, you can manually delete all installed **TSPSG** files and directories. 6. Troubleshooting ------------------ ### 6.1. WINDRES.EXE CRASH ### When building under Windows using minGW toolchain make process may fail with windres.exe crash (access violation). This is a known bug in windres.exe regarding processing resource files with UTF-8 (cp65001) encoding [1]. To be able to successfully build TSPSG you will need to download and replace windres.exe with a fixed version. To do this: 1. Open https://sourceforge.net/projects/mingw/files/ in your ### 6.1. WINDRES.EXE Crash ### When building under **Windows** using **MinGW toolchain** make process may fail with *windres.exe* crash (access violation). This is a known bug in *windres.exe* regarding processing resource files with *UTF-8 (cp65001)* encoding ([Bug 10165][2]). To be able to successfully build **TSPSG** you will need to download and replace *windres.exe* with a fixed version. To do this: 1. Open in your favourite browser. 2. Find and download the latest version of GNU Binutils. At the time of writing this guide it was binutils-2.20.1-2-mingw32-bin.tar.gz. 3. Unpack the file bin\windres.exe from the downloaded archive to \mingw\bin\ replacing the existing one. of writing this guide it was *binutils-2.20.1-2-mingw32-bin.tar.gz*. 3. Unpack the file *bin\windres.exe* from the downloaded archive to \mingw\bin\ replacing the existing one. 4. Now run mingw32-make distclean in the TSPSG directory and repeat the installation process. 7. NOTES -------- qmake doesn't always enclose installation paths in quotes. This may in the **TSPSG** directory and repeat the installation process. 7\. Notes -------------------------- *qmake* doesn't always enclose installation paths in quotes. This may cause some files not to be installed or removed when their path contains spaces. In this case it is safe to delete these files and TSPSG installation directory manually. 8. REFERNECES ------------- [1] http://sourceware.org/bugzilla/show_bug.cgi?id=10165 [2] https://www.symbiansigned.com/app/page/public/openSignedOnline.do **TSPSG** installation directory manually. [1]: https://www.symbiansigned.com/app/page/public/openSignedOnline.do [2]: http://sourceware.org/bugzilla/show_bug.cgi?id=10165