Badge time.png   The Paragon Wiki Archive documents the state of City of Heroes/Villains as it existed on December 1, 2012.

Difference between revisions of "Costume File"

From Paragon Wiki Archive
Jump to: navigation, search
m (Scale)
m (layout reorg, decimal align)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
 +
 +
[[Issue 13]] introduced the ability to ''save'' and ''load'' costumes.
  
 
A costume file contains the necessary data to reproduce a costume, from body and facial scales to the colors and patterns on each individual costume piece on a character.
 
A costume file contains the necessary data to reproduce a costume, from body and facial scales to the colors and patterns on each individual costume piece on a character.
  
 
Costume files are saved in the ''<tt>INSTALLDIR/data/Costumes/</tt>'' folder.
 
Costume files are saved in the ''<tt>INSTALLDIR/data/Costumes/</tt>'' folder.
 +
 +
The costume editor also provides a button to ''Attempt Fix'' for cases when a saved costume contains costume parts that have not been unlocked for the character loading the costume, or contain legacy parts that have been reorganized in the costume editor. This button attempts to substitute the closest match available for the costume part(s) in question, and allows the player to proceed from the costume load screen to the costume editor interface and manually edit the costume, rather than prevent the costume from loading altogether. After restoring the costume, saving the newer version of the costume is a good idea!
  
 
== File structure ==
 
== File structure ==
  
Costume files define the model scales and the costume pieces on the model. If any of the model scales are 0, they are omitted, except the first, which defines the model's height and can never be zero.
+
Costume files encode character model scales with a label and a number. If any of the model scales are 0, they are omitted, except the first, which defines the model's height and can never be zero. Scale specs use the following format:
  
{| width=100%
+
:Scale ''#''
|- width=50%
+
:BoneScale ''#''
|
+
:ShoulderScale ''#''
=== Minima ===
+
:ChestScale ''#''
{| class=wikitable width=80%
+
:WaistScale ''#''
|- align=right
+
:HipScale ''#''
! width=20% | &nbsp;
+
:LegScale ''#''
! width=20% | Female
+
:HeadScales  ''#''''#'',  ''#''
! width=20% | Male
+
:BrowScales  ''#'',  ''#'',  ''#''
! width=20% | Huge
+
:CheekScales  ''#'',  ''#'',  ''#''
| width=20% align=center | Notes
+
:ChinScales  ''#'',  ''#'',  ''#''
|- align=right
+
:CraniumScales  ''#'',  ''#'',  ''#''
| '''Scale'''
+
:JawScales  ''#'',  ''#'',  ''#''
| -27
+
:NoseScales  ''#'',  ''#'',  ''#''
| -33
+
| -33
+
| align=center | 4'0"
+
|- align=right
+
| '''BoneScale'''
+
| -1
+
| -1
+
| -1
+
| align=center | Physique
+
|}
+
|
+
=== Maxima ===
+
{| class=wikitable width=80%
+
|-
+
! width=20% | &nbsp;
+
! width=20% | Female
+
! width=20% | Male
+
! width=20% | Huge
+
| width=20% align=center | Notes
+
|- align=right
+
| '''Scale'''
+
| 36
+
| 25
+
| 25
+
| 8'0"
+
|- align=right
+
| '''BoneScale'''
+
| 1
+
| 1
+
| 1
+
| align=center | &nbsp;
+
|}
+
  
|}
+
Scales are followed by costume piece data blocks, which specify the particulars about each individual costume piece including pattern and colors. Costume piece data blocks use the following format:
<!--
+
FEMALE
+
Scale -27 >> 36
+
BoneScale -1 >> 1
+
ShoulderScale -1 >> 0.9984
+
ChestScale -1 >> 1
+
WaistScale -1 >> 1
+
HipScale -1 >> 1
+
LegScale -0.1 >> 0.02
+
HeadScales  -1,  -1,  -1 >> 1,  1,  1
+
BrowScales  -1,  -1,  -1 >> 1,  1,  1
+
CheekScales  -1,  -1,  -1 >> 1,  1,  1
+
ChinScales  -1,  -1,  -1 >> 1,  1,  1
+
CraniumScales  -1,  -1,  -1 >> 1,  1,  1
+
JawScales  -1,  -1,  -1 >> 1,  1,  1
+
NoseScales  -1,  -1,  -1 >> 1,  1,  1
+
  
MALE
+
:(TBA)
Scale -33 >> 25
+
BoneScale -1 >> 1
+
ShoulderScale -1 >> 1
+
ChestScale -1 >> 1
+
WaistScale -1 >> 1
+
HipScale -1 >> 1
+
LegScale -0.1 >> 0.02
+
HeadScales  -1,  -1,  -1 >> 1,  1,  1
+
BrowScales  -1,  -1,  -1 >> 1,  1,  1
+
CheekScales  -1,  -1,  -1 >> 1,  1,  1
+
ChinScales  -1,  -1,  -1 >> 1,  1,  1
+
CraniumScales  -1,  -1,  -1 >> 1,  1,  1
+
JawScales  -1,  -1,  -1 >> 1,  1,  1
+
NoseScales  -1,  -1,  -1 >> 1,  1,  1
+
  
HUGE
+
=== Model scales ===
Scale -33 >> 25
+
As of [[Issue 15]], players who have purchased the [[Super Booster III: Superscience|Superscience]] [[Booster Pack]] have the option of altering model height and body type at the [[tailor]] in addition to costume pieces and head scales. Since it can be difficult to reproduce scale settings accurately with the sliders when changing body types, manually editing the numerical scale settings in the [[costume file]] gives players much greater control over costume changes.
BoneScale -1 >> 1
+
 
ShoulderScale -1 >> 1
+
The following reference table gives the minimum and maximum values for each scale appropriate to each body type.
ChestScale -1 >> 1
+
----
WaistScale -1 >> 1
+
                      FEMALE              MALE & HUGE
HipScale -1 >> 1
+
                '''Minimum'''  '''Maximum'''  |  '''Minimum'''  '''Maximum'''
LegScale -0.1 >> 0.02
+
        ''Scale''    -27      36      |    -33       25
HeadScales -1, -1-1 >> 1, 1,  1
+
    ''BoneScale''    -1       1       |    -1         1
BrowScales  -1,  -1-1 >> 1, 1,  1
+
''ShoulderScale''    -1       0.9984 |    -1         1  
CheekScales  -1,  -1-1 >> 1, 1,  1
+
    ''ChestScale''    -1       1      |    -1         1   
ChinScales  -1-1, -1 >> 1,  1,  1
+
    ''WaistScale''    -1       1       |    -1         1   
CraniumScales -1,  -1-1 >> 1,  1,  1
+
      ''HipScale''    -1       1       |    -1         1   
JawScales  -1,  -1,  -1 >> 1,  1,  1
+
      ''LegScale''    -0.1     0.02    |    -0.1       0.02
NoseScales  -1,  -1,  -1 >> 1, 1, 1
+
                                    +
 +
  Head/face scales                  |
 +
  for all models    -1       1       |    -1         1
 +
----
 +
<!--
 +
head scales - L,H,W? Which order?
 
-->
 
-->
 
{{wip}}
 
{{wip}}

Revision as of 20:29, 13 August 2009

Overview

Issue 13 introduced the ability to save and load costumes.

A costume file contains the necessary data to reproduce a costume, from body and facial scales to the colors and patterns on each individual costume piece on a character.

Costume files are saved in the INSTALLDIR/data/Costumes/ folder.

The costume editor also provides a button to Attempt Fix for cases when a saved costume contains costume parts that have not been unlocked for the character loading the costume, or contain legacy parts that have been reorganized in the costume editor. This button attempts to substitute the closest match available for the costume part(s) in question, and allows the player to proceed from the costume load screen to the costume editor interface and manually edit the costume, rather than prevent the costume from loading altogether. After restoring the costume, saving the newer version of the costume is a good idea!

File structure

Costume files encode character model scales with a label and a number. If any of the model scales are 0, they are omitted, except the first, which defines the model's height and can never be zero. Scale specs use the following format:

Scale #
BoneScale #
ShoulderScale #
ChestScale #
WaistScale #
HipScale #
LegScale #
HeadScales #, #, #
BrowScales #, #, #
CheekScales #, #, #
ChinScales #, #, #
CraniumScales #, #, #
JawScales #, #, #
NoseScales #, #, #

Scales are followed by costume piece data blocks, which specify the particulars about each individual costume piece including pattern and colors. Costume piece data blocks use the following format:

(TBA)

Model scales

As of Issue 15, players who have purchased the Superscience Booster Pack have the option of altering model height and body type at the tailor in addition to costume pieces and head scales. Since it can be difficult to reproduce scale settings accurately with the sliders when changing body types, manually editing the numerical scale settings in the costume file gives players much greater control over costume changes.

The following reference table gives the minimum and maximum values for each scale appropriate to each body type.


                     FEMALE              MALE & HUGE
                Minimum   Maximum  |  Minimum   Maximum
        Scale    -27      36       |    -33        25  
    BoneScale     -1       1       |     -1         1  
ShoulderScale     -1       0.9984  |     -1         1  
   ChestScale     -1       1       |     -1         1  
   WaistScale     -1       1       |     -1         1  
     HipScale     -1       1       |     -1         1  
     LegScale     -0.1     0.02    |     -0.1       0.02
                                   +
Head/face scales                   |
for all models    -1       1       |     -1         1