Skip to content

Commit 0d937a5

Browse files
committed
add test inputs and README for llappearanceutility
1 parent f924367 commit 0d937a5

File tree

7 files changed

+1176
-0
lines changed

7 files changed

+1176
-0
lines changed

indra/llappearanceutility/README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# llappearanceutility
2+
3+
This directory contains the appearance utility employed by the bake service to process avatar textures and handle various other appearance-related functions. Please note that this utility is currently configured to build only on Linux systems.
4+
5+
## Prerequisites
6+
7+
Ensure the following prerequisites are met before building and testing the utility:
8+
9+
- **X11 Display**: Ensure an X11 display is available, either virtual or physical, with the `DISPLAY` environment variable set appropriately (e.g., `DISPLAY=:1`).
10+
- **Linux Build Environment**: Confirm that the Second Life Viewer can be built on your Linux system.
11+
12+
## Testing
13+
14+
Given the constraints with GitHub runners, we instead utilize Behavior-Driven Development (BDD) tests to evaluate the `llappearanceutility` through the bake service. For local development, test inputs and their expected outputs are provided below.
15+
16+
### Test Commands
17+
18+
1. **Baking Textures**:
19+
```sh
20+
appearance-utility-bin --agent-id de494a4f-f01a-47a4-98cf-c94ef9ecca38 --texture /viewer/indra/llappearanceutility/tests/texture.llsd > /viewer/indra/llappearanceutility/tests/texture.llsd.output
21+
```
22+
23+
2. **Generating Bake Parameters**:
24+
```sh
25+
appearance-utility-bin --agent-id de494a4f-f01a-47a4-98cf-c94ef9ecca38 --params /viewer/indra/llappearanceutility/tests/params.xml > /viewer/indra/llappearanceutility/tests/params.xml.output
26+
```
27+
28+
3. **Calculating Joint Offsets**:
29+
```sh
30+
appearance-utility-bin --agent-id de494a4f-f01a-47a4-98cf-c94ef9ecca38 --joint-offsets /viewer/indra/llappearanceutility/tests/joint-offsets.xml > /viewer/indra/llappearanceutility/tests/joint-offsets.xml.output
31+
```
32+
33+
These commands will execute the utility with specific test inputs and direct the output to corresponding files for validation.

indra/llappearanceutility/tests/joint-offsets.xml

Lines changed: 1 addition & 0 deletions
Large diffs are not rendered by default.

indra/llappearanceutility/tests/joint-offsets.xml.output

Lines changed: 1 addition & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)