yyc12345/BallanceBlenderHelper
1
0
Fork 0
Code Issues Pull Requests Releases Activity

doc: translate documentation

Browse Source
This commit is contained in:
yyc12345 2024-07-23 11:01:41 +08:00
parent f215d3487f
commit 421f01b3db
2 changed files with 52 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/docs/en/group-operations.md
View File

@ -1,4 +1,28 @@
# Group Operation
!!! info "Work in Progress"
This part of manual still work in progress.
## Select by Group
`Ballance - Select by Virtools Group` provides a feature to filter by Virtools grouping data.
The feature starts with 5 different selection strategies that match Blender's selection methods exactly (Set, Extend, Subtract, Invert, Intersect). Simply use it like a Blender selection. Then, select the name of the group you need and start a selection or filter.
!!! note "About pattern selection"
If you can, use the Subtract or Intersect modes whenever possible. Because this avoids analyzing too many objects. For example, selecting a general range first and then filtering using Intersect mode is more efficient than using Set mode directly.
## Quick Grouping
The BBP plugin adds the ability to quickly group objects in 2 places. The first is the object context menu: you can select a series of objects and right click to find the quick grouping feature in the object context menu. Second is the Objects menu in Outline view: you can right-click on a selection of objects in the Outline view to find the quick grouping feature. Both menus are shown below.
![](../imgs/grouping.png)
### Group into...
Groups the selection into the group of your choice.
### Ungroup from...
Ungroups the selection from the group of your choice.
### Clear All Groups
Clear all groups for the selection. You will be asked to confirm this before executing to avoid misbehavior.

28
docs/docs/en/legacy-align.md
View File

@ -1,4 +1,28 @@
# Legacy Alignment
!!! info "Work in Progress"
This part of manual still work in progress.
`Ballance - 3ds Max Align` provides an alignment function similar to the way alignment works in 3ds Max.
The so-called legacy alignment feature is a perfect reimplementation of the 3ds Max alignment operations in Blender. It makes it possible for many mappers who switch from 3ds Max to Blender to get up to speed faster and provides some convenient alignment operations. The image below shows legacy alignment in action.
![](../imgs/legacy-align.png)
## Usgae
Legacy alignment supports aligning multiple objects to a single object by first selecting the objects to be aligned in turn, then selecting the reference object at the end of the alignment (i.e. making it the active object), and then clicking `Ballance - 3ds Max Align` to bring up the legacy alignment panel, after which you can start the alignment operation.
## Introduction of the Panel
In the panel, `Align Axis` specifies the axis you want to align to, you can multi-select here to specify more than one axis, without specifying any axis you will not be able to do the alignment operation, and thus you will not be able to click the `Apply` button.
`Current Object` is the alignment reference object, which is the active object in the scene, usually the last object you selected. This option specifies what value you need to reference for alignment, with `Min` (minimum value on axis), `Center (Bounding Box)` (center of the bounding box), `Center (Axis)` (origin of the object), and `Max` (maximum value on axis) available. These options are consistent with the alignment options in 3ds Max.
The `Target Objects` are the objects that are being aligned, there may be many of them, in this option it is also specified what values you need to refer to them for alignment. The options have the same meaning as `Current Object`.
The `Apply` button, when clicked, will press the current page's configuration into the operation stack and reset the settings above, allowing you to start a new round of alignment operations without having to perform a legacy alignment again. The number of operations in the stack is shown below the `Apply` button.
!!! info "What the Apply button does"
Understanding this part is not useful for mapping, and you don't need to read what's in this box unless you're interested.
By design, Blender doesn't support so-called "operations inside the Operator", but with a few tricks we simulated Apply effect similar to the one in 3ds Max.
The Apply button is actually a specially displayed BoolProperty that listens to its value change event and, while avoiding recursive calls, records the current setting in a hidden CollectionProperty and resets its own value and displayed properties to make a visual "apply". Operator processes the alignment requirements accumulated in the CollectionProperty in turn when executing.