https://github.com/vkvd/polyedit

2d lowpoly editor based on http://raincomplex.net/lowpolyeditor/
https://github.com/vkvd/polyedit

Last synced: 17 days ago
JSON representation

2d lowpoly editor based on http://raincomplex.net/lowpolyeditor/

• Host: GitHub
• URL: https://github.com/vkvd/polyedit
• Owner: vkvd
• License: mit
• Created: 2016-07-25T07:18:26.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-01-08T20:42:20.000Z (over 8 years ago)
• Last Synced: 2024-08-04T02:11:09.216Z (10 months ago)
• Language: C++
• Size: 21.3 MB
• Stars: 19
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• AwesomeCppGameDev - polyedit

README

        
# polyedit

### 2D lowpoly editor heavily based on [this one](raincomplex.net/lowpolyeditor)

![Image](Screenshots/screenshot.png)

### Download

[Direct link](https://github.com/vkvd/polyedit/releases/download/1.0/polyedit.exe)  

[Releases page](https://github.com/vkvd/polyedit/releases/)

### Libraries

This project uses:

* [SFML](http://www.sfml-dev.org/)

* [Tiny File Dialogs](https://sourceforge.net/projects/tinyfiledialogs/)

* [jsoncpp](https://github.com/open-source-parsers/jsoncpp)

* [imgui](https://github.com/ocornut/imgui)

* [SFML imgui backend](https://github.com/Mischa-Alff/imgui-backends)

### Building

**In VS2013/2015 (untested on anything else) the build must be set to "Release" instead of "Debug".**

The project looks for libraries to link against in the /include/ and /lib/ directories. Include and lib are in the repo for VS2013 - if you have any other compiler, drop the SFML and jsoncpp include directories in the project's include directories, and do the same for the lib, and it should compile; make sure to switch the dlls out as well. 

It has been tested on VS2013 and VS2015 - just switch out the libs/dlls for the corresponding ones for your compiler.

### Controls

Controls are very similar to the editor it's based on, with a few changes.

Panning works without a mouse.

- **Mouse controls**

  - Left click: Place point/select point

  - Right click: Select polygon with center nearest to mouse

  - Middle (scrollwheel) click: Pan camera

- **Keyboard controls**

  - S: Save image 

  - **Camera**

    - LControl: Identical to middle mouse - pan camera while held

    - Arrow keys: Move camera

    - +/-: Zoom

  - **Editor toggles**

    - W: Wireframe mode, only show colored outlines

    - H: Hide/show background image

    - X: Hide/show polygon centers (useful for seeing density/distribution and easier selection)

    - P: Hide/show polygon points

  - **Selection tools** 

    - Delete: Delete selection

    - Space: Clear selection

    - **Coloring tools**

      - A: Reaverage polygon color (useful for small changes that keep the same general color but add slight change)

      - O: Change polygon color to color at mouse point

      - C: Open color picker to select color

    - **Overlapping**

      - Comma: Send selection to back

      - Period: Send selection to front

**Antialiasing levels** are supported, just launch the exe with a number after it for the AA level.  

Example:  

    polyedit 8

for 8x AA.

  

### Platforms

It *theoretically* should work on all platforms, however it's only been tested on windows.

### Notes

Resizing is supported and should work but occasionally glitches.  

Images are saved on exit.  

Any point outside the boundary has the color of the closest in-image-boundary point - triangles made outside the image bounds should get correct colors.  

Saving pushes all out-of-bounds points inbound.  

The editor only recognizes the vertices file if it is in the same directory as the image with the same name.

### License

MIT License.