Openpose Editor BO-NIN
Openpose data editor
© 2023 NKMR AppWorks
English / Japanese
itch.io: https://nkmr-aw.itch.io/bonin
Openpose Editor BO-NIN is an editor for editing Openpose data, runs standalone on Windows.
It can create and edit data (COCO Model/18 points) and images used when ControlNet is enabled in Stable Diffusion WebUI or ComfyUI, etc.
Increase or decrease the number of stick figures by one. “ Press ”-“ to decrease by 1 person and ”+“ to increase by 1 person. However, the lower limit is 1 person and the upper limit is 5 figures. Please note that the 5 limit is a limitation of this editor and does not indicate a detection limit; it is only imposed because an increase in the number of keypoints reduces operability. You can comfortably operate up to 2 figures.
Changes the width of the canvas (the black rectangle area). The pull-down menu contains frequently used values, but you can also input values from the keyboard. After inputting the values, press the “apply resizing” button (4) to apply the changes. Note that the appearance of the canvas may not match the size of the canvas depending on the scale described below. When the scale is set to 1, the set value and the appearance will match. The upper limit is 8 and the lower limit is 4096, but 256 or more is recommended.
Change the height (width) of the canvas. Other than that, it is the same as in 2.
This button reflects the input values of 2 and 3 on the screen. They will not be changed unless you press this button.
Changes the drawing line of stick figures. “ type 1” and “type 2” will draw a thick straight line and a curved line, respectively. This setting is not saved in JSON, but affects the PNG image.
Sets the opacity of stick figures. This setting has no effect until after the background image has been loaded.
Sets the opacity of the loaded background image. It takes effect only after the background image has been loaded.
Change the display scale of the canvas: 100% is the equal display, the lower limit is 10%, and the upper limit is 200%. The same operation can be performed with the mouse wheel. Pressing down the mouse wheel returns the scale to 100%.
Reads JSON files. Only files with the “json” extension are accepted. If the file fails formatting or data integrity checks, it will fail to load. The same operation can be performed by dragging a file onto the canvas.
Loads a background image. Only files with the extension “png”, “jpg”, “jpeg”, or “webp” are accepted. The same operation can be performed by dragging the file onto the canvas.
Save the edited Openpose data in JSON format. Click the button to open the file dialog, specify a file name and destination, and save the file.
Save the edited Openpose data image in PNG format. Press the button to open the file dialog and specify a file name and destination to save the file. If a background image is loaded, the background will be darkened by moving before saving the file, so the background image will not be displayed in the saved image. This specification is made in consideration of the intended use.
*Note*
When creating a PNG image using the “save image” button, the software takes a screenshot of the screen and processes it. Therefore, if the image is taken with another application window or taskbar in front of the software, their contents will be reflected in the image. Please check the image after saving the PNG file, and if no other windows or other information are visible, there is no problem. If the canvas is too large, please adjust the scale beforehand so that the image fits on the screen.
If you have changed the scale, the image quality may be worse than if you had taken a screenshot at 100% scale, because the screenshot is taken at the displayed size and then enlarged or reduced to adjust it to the original setting size. This may not be a problem when used on ControlNet, etc., but please be aware of this just in case. Note that image quality will be significantly degraded when the scale is set lower than 50%.
Restores the canvas to its initial state at startup. Only the scale will remain the same. If necessary, return it to 100%.
Saves the editor’s current settings. Note that some settings may not be saved. The configuration is saved in the folder containing the “bonin.exe” file under the name “config.ini”. If the file does not exist, it will be automatically created, or if it already exists, it will be overwritten.
Message field. The displayed message will disappear after a certain period of time.
The buttons are used to select or deselect all keypoints at once. “set them free” deselects, “all” selects all, “1” selects the first person, “2” selects the second, and so on. Buttons corresponding to non-existent numbers are disabled (grayed out). For example, if there is only one keypoint for 1 person, all buttons after “2” will be disabled.
If you have operated other similar editors, you will be able to operate it in a similar way, but I will briefly explain how to operate it.
Each point of a stick figure is called a keypoint. If you press the mouse button at the point and drag the mouse, you can move only that keypoint. The movement ends when the mouse button is released.
If you start dragging at a place where there is no keypoint, a rectangular frame that displays the selected area will appear. When one or more keypoints are in this frame, release the mouse button to end the drag, and all the keypoints in the frame will be selected.
In the selected state, the display will look like the following.
Rotation handle. Dragging it moves each selected keypoint around the center line of 2. The movement is confirmed when the handle is released.
The center point of the selection. Moving the selection also moves the center point. This is not a handle.
This handle deforms with line symmetry with respect to the center line running through the center point.
This handle deforms with point symmetry with respect to the center point.
By manipulating these handles, each keypoint in the selected area moves in tandem. To deselect a range, right-click or click once outside the selected range. When the selection disappears, it is back to the deselected state.
It is best to use this range selection for rough modifications and overall positional corrections, and to adjust the position of fine adjustments on a point-by-point basis.
Loading a background image will make it easier to determine a rough pose.
Note that the application not currently support automatic recognition by loading images.
The configuration file “config.ini” is initially created automatically when the editor is started. If the file already exists, it will be overwritten. If you want to return to the state in which you just downloaded the file, delete the “config.ini” file. It will be automatically created when you start the editor again. You may want to change some settings, so we will describe some settings that may be useful.
handlesize: If you find the handles are too small to grab when selecting a range, increase this value to increase the size of the handles. The minimum value is 3, the maximum value is 10, and the default value is 5.
msgtime: If the message disappears too quickly, increase this number to extend the display time. The unit is milliseconds, where 1000 is one second. The minimum value is 500, the maximum value is 30000, and the default value is 3000.
wheel: You can change the scale by rotating the mouse wheel, but if you want the scaling to correspond inversely to the direction of the wheel, change this. The default value is 1. Setting it to -1 will reverse the process. Please set 1 or -1.
l1 - l15: Up to 15 size values can be registered to be displayed in the candidate list for width and height. Only integers between 128 and 2048 are valid. An error will occur at startup if you enter anything other than a number. If you set a number outside the range, the minimum or maximum value will be set.
This application runs single-threaded, so if you experience heavy processing, please try changing the power plan. Changing from “Power Saving” to “Balanced” or “High Performance” may slightly improve usability.