# README

# Sketsa SVG Editor 9.1

## Contents

- What is it?
- What's New?
- System Requirements
- Upgrading to newer version
- Installing Application
- Launching Application
- Bug Reports and Feedback
- Licensing and legal issues

## What is it?

> Sketsa SVG Editor is a cross platform vector drawing application based on SVG. Scalable Vector Graphics (SVG) is a graphics format and technology based on XML developed by W3C. With Sketsa, you can create vector graphics that can be scaled and printed at any resolution, without losing detail or clarity. You also get instant visual feedback on what you changed.

> Sketsa features various tools for optimizing content creation, giving designers unsurpassed support for creativity. These tools include property palette, DOM editor, source editor, resources editor, SVG specific shape tools, transformation tools, and additional illustration tools. It uses SVG as a native file format.

> Sketsa requires Java 11.0.4 or higher (https://adoptopenjdk.net).
> As a cross platform application, Sketsa runs on any platform that support Java 11.0.4 or higher
> eg: Microsoft Windows, Unix or Linux, Mac OSX, etc.

> Features:

> - SVG native file format
> - Property palette
> - DOM Editor
> - Source Editor
> - Defs Editor: gradient and filter
> - SVG specific shape tools <rect>, <ellipse>, <line>, <polyline>, <polygon>
> - Additional illustration tools: Pencil tool for freeform shape and Pen tool for curve shape
> - Basic Text Tool
> - Transformation tools: rotate, skew, scale, and translate
> - Rasterizer or export to JPEG and PNG
> - Plugins Support
> - Build on top Netbeans Platform
> - Written entirely in Java™

> The latest news about Sketsa SVG Editor can be found at http://www.kiyut.com

## What's New

> ver 9.1

> - Fix zoom value locale problem
> - Various enhancements and bug fixes
> - Updated to use Apache Netbeans 12.0

> ver 9.0

> - Various enhancements and bug fixes
> - Updated to use Java 11.0.4
> - Updated to use Apache Netbeans 11.3

> ver 8.0.1

> - Fix installer
> - Various enhancements and bug fixes

> ver 8.0

> - Improved UI
> - Performance Improvement
> - Updated to use Apache Batik 1.10)
> - Updated to use Netbeans Platform 8.2
> - Various enhancements and bug fixes

> ver 7.1.1

> - Fix invalid control character introduced into the SVG Document
> - Improved Source Editor

> ver 7.1

> - Improved Preview
> - Improved JFileChooser for SVG files
> - Add HTML tab display name
> - Updated to use Apache Batik (rev 1396431)
> - Updated to use Netbeans Platform 7.3.1

> ver 7.0.1

> - Fix Registration
> - Other minor bug fixes

> ver 7.0

> - Improved DOM Editor
> - Fix Ubuntu Unity global menu
> - Fix Transform Dialog (NullPointerException)
> - Fix ToolboxTopComponent
> - Fix Navigator (NPE and Update)
> - Various enhancements and bug fixes
> - Updated to use Netbeans Platform 7.2

## System Requirements

> - Java 11.0.4 or higher (https://adoptopenjdk.net)
> - 1024 x 768, 16-bit (thousands of colors) color display or higher
> - Mouse or equivalent pointing device

## Upgrading to newer version

> You need to remove the older version, please use one of the following:

> - Use the "[INSTALL-DIR]\Uninstaller\uninstaller"
> - Delete the older version folder eg: "C:\Program Files\Kiyut\Sketsa-xxx"
> - Rename the older version folder eg: "C:\Program Files\Kiyut\Sketsa-xxx"

## Installing Application

> To install the product, please do the following:

> - unzip the file
> - on Microsoft Windows double click setup.exe or setup.jar
>   on Linux/Unix run setup, if necessary chmod +x setup to make it executable
>   on Mac OSX run the Java setup by clicking on the setup.jar
>   or you can try the Mac OSX installer (experimental) which is available at http://www.kiyut.com/products/sketsa/download.php
>   on other platform type "java -jar setup.jar"
> - follow the on screen instruction

> Alternatively, you also could install/run the Sketsa without GUI installer (Unix/Linux user):

> - unzip the file
> - copy the ../packs/Sketsa-xxx into a folder/directory of your choice
> - Unix/Linux run chmod +x Sketsa-xxx/bin/sketsa
> - you are done

> note: the installer wizard is basically just copying the folder as above into your preferred folder asked by the wizard and create icon shortcut.

## Launching Application

> - on Microsoft Windows just run Sketsa from Desktop Shortcut or Start Menu - All Programs - Kiyut - Sketsa
>   on Mac OSX
>   - open the Terminal program (inside Applications folder - Utilities)
>   - type "cd [INSTALL-DIR]/bin/" eg: cd /home/user-name/Kiyut/Sketsa/bin/
>   - type "./sketsa"
>   - or you can just run Sketsa by double click the file sketsa at "[INSTALL-DIR]/bin/sketsa" eg: /Applications/Kiyut/Sketsa/bin/sketsa and choose open with terminal
>   on other platform run [INSTALL-DIR]/bin/sketsa, if necessary chmod +x sketsa to make it executable
> - enjoy the product

> ### Error cannot find Java 1.8 or higher

> If you encounter this error cannot find Java 1.8 or higher, please reinstall the AdoptOpenJDK (if you use AdoptOpenJDK)

> - Choose Change / Custom
> - Set JAVA_HOME variable enabled
> - Set Javasoft(Oracle) registry key enabled

> Alternatively, you can edit the [INSTALL_DIR]/etc/sketsa.conf file and set the jdkhome directly by:

> - Uncomment the jdkhome entry, by removing the # symbol
> - Set it to your java path eg:
>   jdkhome="C:\Program Files\AdoptOpenJDK\jdk-11.0.4.11-hotspot"

## Bug Reports and Feedback

> For technical support, bug reports, feature requests, or any feedback, please send email to support@kiyut.com or visit our support page. If possible, please include details of your development environment (eg: Operating System, Java VM version, etc), steps to recreate the problem and attach any examples you have where applicable.

> Your feedback is important to us in order to get a better idea of how to make Sketsa SVG Editor a better product for you. If you have an idea for a new feature, or a better way of doing something, please do not hesitate to drop us a note at support@kiyut.com or visit our support page.

## Licensing and legal issues

> For legal and licensing issues, please read the all LICENSE files in the legal folder.

> Thank you for using Sketsa SVG Editor.