Skip to content

Latest commit

 

History

History
57 lines (34 loc) · 2.97 KB

README.md

File metadata and controls

57 lines (34 loc) · 2.97 KB
Raw

libGDX Path Editor

libGDX Path Editor lets you easily create complex pathes your game characters can move along. It uses a Catmull-Rom spline to construct a path curve between all vertices that you define via WYSIWYG editor. The result path is a list of all spline vertices (control and intermediate) saved in XML/JSON file, for each vertex its position and rotation angle are stored.

How to use

  1. Create a new project, specify destination folder and project name.

    Step 1: create a new project

  2. Now add a first screen, specify screen name and size.

    Step 2: add a screen

  3. Add a background image to your screen, specify its name, texture and texture scale coefficient. Background image should contain a visual path which needs to be represented as a set of vertices.

    Step 3: add a background image

  4. Now you can create a path as a spline by defining its control vertices. Turn on "Add vertex" mode, specify path name, intermediate vertices number (between each pair of control vertices), select color of control, intermediate and selected vertices.

    Step 4.1: add a path

    Add first 4 vertices (the minimum number required to create a spline) by clicking on a visual path on a background image - and the first spline's segment would appear.

    Step 4.2: create first spline segment

    By adding more and more control vertices you create a whole path. When path is ready, turn off "Add vertex" mode.

    Step 4.3: create whole path

  5. You can change the control vertex position by turning on "Move vertex" mode, click on a vertex (it becomes highlighted) and drag it to a new location. When done, turn off "Move vertex" mode.

    Step 5: try to move path vertex

  6. You can insert a new control vertex between a two neighboor vertices by turning on "Insert vertex" mode. Select the first and the second vertices and click somewhere outside the path - a new control vertex will be added between them. When done, turn off "Insert vertex" mode.

    Step 6.1: try to insert new path vertex Step 6.2: try to insert new path vertex Step 6.3: try to insert new path vertex

  7. You can remove a selected control vertex by turning on "Remove vertex" mode and clicking on a desired vertex. When done, turn off "Remove vertex" mode.

    Step 7.1: try to remove path vertex Step 7.2: try to remove path vertex

  8. You can remove a whole path by clicking on "Clear Path" button.

Right now you can add only one path per screen, but you can have many screens in one project.

There is a sample project in the /demo folder.