Posted August 10, 2023 by zoron
PpdEditor is an editor for paperdoll, a 2d paper doll model. The goal of it is to make sharing paper dolls between different games easier.
The paperdoll model consists of three parts: doll, slot, and fragment.
Dolls are the fundamental parts of your model. Normally, they represent faces, bodies, or any other assembled objects in your projects. A doll contains multiple slots.
Slots are where your paper doll can have alternative styles. For example, in a doll that represents a human's face, they could be eyes, mouth, nose, and so on.
A slot can be placed in different positions inside the doll (eg. slot of eyes). Not all slots need to have images to be shown, they can be empty. For instance, an empty 'hair' slot means that the person is bald.
Each slot has several alternative images to display. they're called 'candidates'. And those candidates are all defined as fragments.
Fragments are image assets that you can put into a slot as candidates. In paperdoll
, all fragments are raster images. One fragment can be used in multiple slots.
There are two ways slots and their fragment candidates are connected.
Below is a brief chart showing the main concept of paperdoll.
The editor is an open-source and cross-platform software, written in Rust and powered by eframe.
The editor provides a built-in example, you can open it from the file menu.
Once you have your works done, you can save it as a ppd file.
paperdoll provides a Rust sdk for you. Here is a brief guide to load the paperdoll model and render it in your projects: