~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Product Name: OpenPose for Poser 12 and 13
Copyright 2023 - All Rights reserved
By: Ken1171 Designs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Please note this tool REQUIRES Poser 12.0.993 or newer.

Ever wanted to use Poser to setup your AI image generation, using any Poser human figure to establish the pose, body proportions and camera framing, and then exporting a preprocessed OpenPose-compatible pose directly to Stable Diffusion? It's like creating the scene in Poser, and using Stable Diffusion as a rendering engine! This Poser plugin replaces the ControlNet OpenPose preprocessor, doing the job in 3D directly from Poser, producing much more reliable results.

All you need is a bare Poser figure! No need for clothing, hair, or even textures. Those will be created in Stable Diffusion using a text prompt, so the limit is your imagination! It's like having an infinite library of clothing, hair, styles, and even locations! 

This is a Python script for Poser that allows exporting figure poses, body proportions and camera framing from Poser to Stable Diffusion's ControlNet OpenPose AI. The included 10 pages PDF manual includes all the information you need to get started, as well as hints and tips for best results (with examples). 

These are some of the main features:

* 1-click OpenPose-compatible AI pose generation using any figure.
* Simple, easy to use, fully automated, powerful interface.
* Support for unlimited number of figures!
* Supports operating over 1 or multiple figures at once.
* Several options for how the OpenPose skeleton is generated.
* Support for no hands, simple hands or full hands/fingers!
* Individual options for including simple hands and/or feet.
* A complete set of powerful tools to edit the skeleton.
* A dedicated button to repose the skeleton when editing poses.
* Recursive bone chain removal.
* Recursive bone chain reposing.
* Automatic OpenPose image render setup and restoring.
* Automatic copying the OpenPose image to the clipboard.
* Options for customizing the OpenPose skeleton bones and display.
* Remembers your last used options.
* Informative tooltips describe extra options and information.
* Fully illustrated built-in PDF manual (launch it from the script!).
* Panel Persists when switching between rooms.
* Ability to disable auto-docking with the Poser interface. 
* Smart dockable panel integrates seamlessly with Poser.

Don't forget to add Ken1171_Designs to your favorite vendor list, so you don't miss any new release, sale or promotion.

++++++++++++++++++++++++++++++++++++++++++++++++
In order to work you must own Poser 12.0.993 or above. It will not work with older versions. In Poser, click Help > About Poser to see what version you have installed. The version is displayed on the bottom left corner.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Installation Instructions:

You can install this Python script in 2 different ways (requires Poser 12.0.993 or newer):

1. If you have the ZIP file: from Poser's main menu, choose File > Install from ZIP archive.
2. From Poser's built-in store: From the library's "Purchase" tab, click the "Renderosity" option. Now locate your purchased Python script tool, and click the respective "Install" button.

Once the script is installed, it will show it in Poser's main menu, from the Scripts menu.

+++++++++++++++++++++++++++++++++++++++++++++++++

Usage Notes:

* This script supports all Poser figures that follow the standard Poser rigging and bone naming conventions. 

* When generating OpenPose skeletons with full hands/fingers, it takes longer and Poser may appear irresponsive, but you just have to wait until it completes the task. It generates and manipulates 3D geometry in real-time, so please be patient. 

* For some reason, this script has better performance in P12, being potentially slower in P13.1.446 at the time of this writing. Hopefully, Bondware might have already fixed the Poser 13 performance by the time you are reading this. 

* Poser 13.1.446 has a bug that prevents rendered images from being copied to the clipboard. This script automatically copies the end result into the clipboard but P13 creates a blank image instead. This currently works in P12, but not in P13. The Poser bug has been reported to Bondware in March 2023, and awaits fixing. Hopefully, by the time you are reading this, Bondware might have already fixed it. 

* If the clipboard bug in Poser has been fixed, you can paste it directly into ControlNet OpenPose, without having to save it to file. However, you may want to save to file anyway just to have a copy of the pose, in case you want to reuse it later on. Since the image is already in the clipboard, you can just paste it in any folder you want. If the image from the clipboard is solid black, it means Bondware hasn't fixed the Poser 13 bug yet. 

* It is strongly recommended removing OpenPose skeleton bones that are hidden and that the camera cannot see. This will help removing pose ambiguity in Stable Diffusion, which leads to better AI generated poses. This script provides powerful tools to help with that, so we can remove a single bone, or an entire chain with just 1-click. I explain this in the PDF manual with illustrations and examples. 

* It is strongly recommended to remove the OpenPose skeleton(s) from the scene if you want to save it to PZ3 file. It won't cause errors if you do, but when you load it back, Poser will not preserve the geometry transformations created by the script, so the skeleton will be useless. The recommended procedure is to delete the skeletons, save the scene, and create them back later if you need to. This is an issue with Poser, not the script.

* Please consult the fully illustrated PDF manual for more details.

* Pressing the ESC key closes the tool without confirmation!

* The OpenPose tool is a native Poser panel, and can be freely resized, positioned, and even docked into the Poser interface. It will remember it's last position, size, and docking state next time you launch it.

* Auto-docking can be disabled by clicking the docking toggle button at any time.

* You can open the PDF manual at any time by clicking the "?" Help button at the bottom right.

+++++++++++++++++++++++++++++++++++++++++++++++++

Ownership Statement: Created by Ken1171 Designs.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

File List:

..\Ken1171\OpenPose P12
    install_python.json
    OpenPose.pyc

..\Ken1171\OpenPose P12\Classes
    BoneChainRemove.pyc
    BoneColors.pyc
    BoneCommon.pyc
    BoneMain.pyc
    BoneMainGUI.pyc
    BonePrefs.pyc
    BoneRender.pyc
    BoneRepose.pyc
    BoneScaling.pyc
    BoneTraverse.pyc
    BoneUtils.pyc

..\Ken1171\OpenPose P12\Classes\Images
    btn_About.png
    btn_DockableOff.png
    btn_DockableOn.png
    btn_Help.png

..\Ken1171\OpenPose P12\Classes\open_pose
    AboutHelpButtons.pyc
    ButtonsHighlightColor.pyc
    PanelLauncher.pyc
    PanelState.pyc
    RendoProcess.pyc
    Transforms.pyc
    WxDialogs.pyc

..\Ken1171\OpenPose P12\Manual
    OpenPose v1.0.0 Manual.pdf

..\Ken1171\OpenPose P12\Readme for OpenPose P12
    Readme For OpenPose P12.txt

++++++++++++++++++++++++++++++++++++++++++++++++++

Notes & Copyright
This product and its entire content are copyrighted :
Copyright 2023, Ken1171 Designs. All rights reserved.

You may use it for personal and commercial applications,
but you may not, under any circumstances, re-sell or re-distribute this product
free of charge or any derivative thereof, in whole or in part.

+++++++++++++++++++++++++++++++++++++++++++++++++++