####################################################################################################

  - The VCSSL Runtime (the Runtime Environment of the VCSSL)  ReadMe -

####################################################################################################

  VCSSL is a simple C-like script language for 2D/3D visualization, computation, simulation, 
  data-analysis, creating simple GUI tools, and so on.

      Official website:  https://www.vcssl.org/en-us/
      User's guide:      https://www.vcssl.org/ja-jp/doc/     (Japanese, not translated yet)
      Developed by:      RINEARN ( https://www.rinearn.com/ )

  This software - the VCSSL Runtime - is the runtime environment of the VCSSL.
  You can use the VCSSL Runtime for free of charge, 
  regardless of whether for commercial use or for non-commercial use. 


****************************************************************************************************
* About License
****************************************************************************************************

  The license file of the VCSSL Runtime is included in "License" folder 
  in the downloaded package as "RINEARN_Software_License.txt", but it is described in Japanese. 
  You must agree to all license terms to use the VCSSL Runtime. 

  The rough translation of main points of license terms are as follows: 

    * (In the following sentences, "RINEARN" means the vender/developer of the VCSSL Runtime.)
    * You will licensed from RINEARN about using the VCSSL Runtime only in case of you agree with all license terms.
    * The VCSSL Runtime is provided without any kind of warranties.
    * Any kind of RINEARN's liabilities and responsibilities are excluded.
    * License terms and the license agreement shall be governed by and construed in accordance with the laws of Japan.
    * You can redistribute the VCSSL Runtime with your VCSSL program (script) files. To redistribute it, you must include the license file of this software in the redistributing package, and, you must mention about the license of the VCSSL Runtime in the main document (e.g. README). Users of the VCSSL Runtime included in the redistributing package must agree to all license terms of this software to use it. 
    * You can NOT redistribute the VCSSL Runtime alone. 


****************************************************************************************************
* Please Extract the Downloaded ZIP File Before Using
****************************************************************************************************

  The downloaded package is compressed by ZIP (extension: .zip) format.
  At first, extract the ZIP file before using, otherwise software will not work correctly.

  * If you opened contents (including this file) of the ZIP file by double-clicking, 
    they are previewed temporary, so the ZIP file is not extracted permanently.


- For Microsoft(R) Windows(R)

  !!! IMPORTANT !!!
  At first, right-click the downloaded ZIP file and choose "Properties" from the menu, 
  and enable "Unblock" checkbox at the right-bottom (in the line of "Security") of 
  the properties-window. 
  Otherwise, when you extract the ZIP file or when you execute the RINPn, 
  security warning messages may pop up and the extraction/execution may fail.

  Then, right-click the ZIP file again, and extract it 
  by selecting "Extract All" and so on from right-clicking menu.


- For Linux(R), etc.

  Right-click the downloaded ZIP file and extract it by selecting the right-clicking menu, 
  or extract on the command-line terminal as follows:

      cd <the_folder_in_which_the_ZIP_file_is>
      unzip -O cp932 vcssl_???_en.zip       (???: version code)


****************************************************************************************************
* How to Execute a VCSSL program
****************************************************************************************************

- For Microsoft(R) Windows(R)

    Double-click the batch file "VCSSL_???.bat" (???: version code) in the extracted folder, 
    and then a file-chooser window will be launched, so choose the VCSSL program you want to execute.

    Also, you can execute a VCSSL program on the command-line terminal as follows, 
    if you added the path of "bin" folder in the extracted folder to the environment variable "Path".

        cd <the_folder_in_which_the_VCSSL_program_is>
        vcssl Example.vcssl


  [ About Java(R) Runtime Environment (JRE) ]

    Java(R) Runtime Environment is required for executing the VCSSL Runtime. 
    If there are no JRE in your environment (or the location of the JRE is not registered 
    in the environment variable "Path"), you optionally can download JRE to "jre" folder, 
    when this software have been launched at the first time.
    In that case, the JRE will be downloaded to "jre" folder of RINEARN Graph 3D, 
    from the official website of RINEARN ( https://download.rinearn.com/jre/ ).

    That JRE had generated by "jlink" tool of OpenJDK. 
    Information about the copyright and license of the OpenJDK and so on are as follows:

        Copyright: Oracle Corporation and/or its affiliates
        License:   GNU General Public License version 2 with the Classpath Exception
        Website:   https://openjdk.java.net/

    * See documents in the "jre" folder and README bundled in the JRE for more details.


- For Linux(R), etc.

    Execute the JAR file "VCSSL.jar" in the extracted folder on the command-line terminal as follows:

        cd <the_extracted_folder>
        java -jar VCSSL.jar

    Then a file-chooser window will be launched, so choose the VCSSL program you want to execute.
    If you want to specify the memory usage, execute with -Xmx optiopn:

        java -Xmx512m -jar VCSSL.jar     (For allocating 512MB)

    Also, you can execute a VCSSL program on the command-line terminal as follows, 
    if you added the path of "bin" folder in the extracted folder to the environment variable "PATH".

        cd <the_folder_in_which_the_VCSSL_program_is>
        vcssl Example.vcssl

    Only when the first time you use the vcssl command, 
    it might require to add the execution-permission as follows:

        cd <the_extracted_folder>/bin
        sudo chmod +x vcssl


  [ About Java(R) Runtime Environment (JRE) ]

    For executing the VCSSL Runtime on Linux(R) and so on, Java(R) Runtime Environment is required separately. 
    If you can use "apt" command on your command-line terminal,  you might install JRE by using apt.

    Firstly, search available packages:

        apt search jre      (or "apt-get" instead of "apt")

    and then install appropriate one, for example:

        sudo apt install default-jre        (or "apt-get" instead of "apt")
    or
        sudo apt install openjdk-?-jre      (?: version numbers)

    Please note that the runtime environment of the VCSSL will not work on JRE with the name ends with "-headles".


****************************************************************************************************
* Examples of VCSSL programs
****************************************************************************************************

  Various esamples are provided on the code archive of the VCSSL official website:

    https://www.vcssl.org/en-us/#code   (English)
    https://www.vcssl.org/ja-jp/code/   (Japanese)


####################################################################################################
* Oracle and Java are registered trademarks of Oracle and/or its affiliates. 
* Microsoft Windows is either a registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. 
* Linux is a trademark of linus torvalds in the United States and/or other countries. 
* Other names may be either a registered trademarks or trademarks of their respective owners. 
