KineBody Pro

Movable 3D Human Model





KineBody Pro Operating Instructions:

(last updated 240423)

Renaming Poses


Overview

Users of KineBody Pro PoseTools can name poses & save them to the Repository, as described here. Once saved, the poses can be renamed using the techniques described on this page.

KineBody Pro pose names consist of an alphanumeric root and a numeric suffix, e.g., ‘my pose-23’: the root is ‘my pose’, and the suffix is '-23'. The suffix number (less the '-') is a pose identification number, which is incremented automatically each time you save a pose to the Repository. Another suffix may be present, starting with an underscore '_' character: e.g., ‘my pose-23_1’. The numeric part after '_' is a ‘merge’ number (described further here) .

Pose renaming as described below only applies to the root part. The suffix(es) can't be edited.

By default, you'll select and rename one pose at a time, but you can also rename multiple poses together. By selecting various options, you can rename all poses that have the same root, or, all the poses in the Repository. For example, if you choose to rename the pose 'sitting-6' in the repository below, you can get different results:

Original poses Rename one: Rename, same root Rename, All
standing-003
sitting-6
run-22
sitting-23 		standing-003
crouching-6
run-22
sitting-23 		standing-003
crouching-6
run-22
crouching-23 		crouching-003
crouching-6
crouching-22
crouching-23

Caution: there is no undo capability for renaming poses. You may wish to backup your Repository to a file, before renaming, so that you can revert to the original names if necessary.

Controls for renaming poses are located in the Save & Restore section, at the right side of the KineBody Pro window; They’re normally hidden; to show them, click the ‘Edit’ icon next to the ‘View a stored pose’ menu, as shown:

Click the Edit icon to expand the Renaming controls.
 Expanded area of Renaming controls


Instructions:

  1. Select a pose to rename, using the 'View a stored pose' menu.
  2. The root part of the name will appear in the text box ‘New pose name’; you can edit the characters in that box to define the new name, using conventional text editing methods (select some/all, type characters/backspace, press return).
  3. Decide if you want the new name to apply to just the one pose, or multiple poses, then select the appropriate checkboxes labeled ‘Same root’ and ‘All’:
    • To change only 1 pose name, ensure the Same root and All checkboxes are both unchecked.
    • To change poses with the same root, check the Same root checkbox, and uncheck the checkbox labeled All’’.
    • To rename all poses, check the checkbox labeled ‘All’. (The Same root checkbox can be checked or unchecked: its status will be disregarded).
  4. Click the 'Rename' button to finalize the operation.
  5. Confirm the new names by viewing the contents of the 'View a stored pose' menu.


Details

If you plan to rename multiple poses, you can pick any matching pose, in Step 1: if renaming with the ‘Same root’ option, select any pose having that root; if renaming with the ‘All’ option, select any pose.

The ‘New pose name’ text box may show content other than a pose name, as follows:

Select a pose above will appear in the textbox after you start the app, or whenever you load a new repository using ‘Replace’ mode ( as described here). This message indicates that there’s no target pose to be renamed, until you choose one from the menu.
(blank) will appear if you select a target pose that doesn’t have a root,
or
when you clear the text box. (Note: it only appears after pressing Return, or clicking outside of the box).

This means the pose will be saved without a root part, i.e. only the numeric suffix will remain – but it’s still regarded as an acceptable pose name.

Note that pose names can include spaces. However, it’s not advisable to include leading spaces, or multiple spaces together (for instance, if attempting to justify or align parts of a name): such name segments will be shown incorrectly in the 'View a stored pose' menu.

Likewise, pose names can be 'empty', by clearing the pose name text box (e.g., by selecting all then backspace). The numeric suffix (with leading dash) cannot be deleted: it's necessary for uniquely identifying each saved pose.