Player::setFaceFeature: Difference between revisions

From RAGE Multiplayer Wiki
m (category)
(Replace face features list with a table + fix minimal values for "Chin position")
Line 1: Line 1:
Sets the various freemode face features, e.g. nose length, chin shape. Scale ranges from -1.0 to 1.0.
Sets the various freemode face features, e.g. nose length, chin shape. Scale ranges from -1.0 to 1.0.
Index can be 0 - 19.
Index can be 0 - 19.
{| class="wikitable"


Index information:
! Index  
*0: Nose width (-1.0 narrow, 1.0 wide)
! Face feature     
*1: Nose height (-1.0 top, 1.0 bottom)
! Min             
*2: Nose length (-1.0 grand, 1.0 petit)
! Max           
*3: Nose bridge (-1.0 round, 1.0 hollow)
|-
*4: Nose tip (-1.0 upward, 1.0 downward)
 
*5: Nose bridge shift (-1.0 to the right, 1.0 to the left)
| 0    
*6: Brow height (-1.0 top, 1.0 bottom)
| Nose width      
*7: Brow width (-1.0 inward, 1.0 outward)
| -1.0 narrow      
*8: Cheekbone height (-1.0 top, 1.0 bottom)
| 1.0 wide      
*9: Cheekbone width (-1.0 narrow, 1.0 wide)
|-
*10: Cheeks width (-1.0 wide, 1.0 narrow)
 
*11: Eyes (-1.0 opened, 1.0 closed)
| 1    
*12: Lips (-1.0 wide, 1.0 narrow)
| Nose height      
*13: Jaw width (-1.0 1.0, 1 wide)
| -1.0 top        
*14: Jaw height (-1.0 top, 1.0 bottom)
| 1.0 bottom    
*15: Chin length (-1.0 small, 1.0 long)
|-
*16: Chin position (0 inward, 1.0 outward)
 
*17: Chin width (-1.0 narrow, 1.0 grand)
| 2    
*18: Chin shape (-1.0 simple chin, 1.0 double chin)
| Nose length      
*19: Neck width (-1.0 narrow, 1.0 wide)
| -1.0 grand      
| 1.0 petit      
|-
 
| 3    
| Nose bridge      
| -1.0 round      
| 1.0 hollow    
|-
 
| 4    
| Nose tip        
| -1.0 upward      
| 1.0 downward  
|-
 
| 5    
| Nose bridge shift  
| -1.0 to the right  
| 1.0 to the left  
|-
 
| 6    
| Brow height      
| -1.0 top        
| 1.0 bottom    
|-
 
| 7    
| Brow width      
| -1.0 inward      
| 1.0 outward    
|-
 
| 8    
| Cheekbone height
| -1.0 top        
| 1.0 bottom    
|-
 
| 9    
| Cheekbone width  
| -1.0 narrow      
| 1.0 wide      
|-
 
| 10  
| Cheeks width    
| -1.0 wide        
| 1.0 narrow    
|-
 
| 11  
| Eyes            
| -1.0 opened      
| 1.0 closed    
|-
 
| 12  
| Lips            
| -1.0 wide        
| 1.0 narrow    
|-
 
| 13  
| Jaw width        
| -1.0 narrow     
| 1.0 wide      
|-
 
| 14  
| Jaw height      
| -1.0 top        
| 1.0 bottom    
|-
 
| 15  
| Chin length      
| -1.0 small      
| 1.0 long      
|-
 
| 16  
| Chin position    
| -1.0 inward      
| 1.0 outward    
|-
 
| 17  
| Chin width      
| -1.0 narrow      
| 1.0 grand      
|-
 
| 18  
| Chin shape      
| -1.0 simple chin
| 1.0 double chin  
|-
 
| 19  
| Neck width      
| -1.0 narrow      
| 1.0 wide      
|}
<br>
<br>
==Syntax==
==Syntax==

Revision as of 18:08, 7 February 2020

Sets the various freemode face features, e.g. nose length, chin shape. Scale ranges from -1.0 to 1.0. Index can be 0 - 19.

Index Face feature Min Max
0 Nose width -1.0 narrow 1.0 wide
1 Nose height -1.0 top 1.0 bottom
2 Nose length -1.0 grand 1.0 petit
3 Nose bridge -1.0 round 1.0 hollow
4 Nose tip -1.0 upward 1.0 downward
5 Nose bridge shift -1.0 to the right 1.0 to the left
6 Brow height -1.0 top 1.0 bottom
7 Brow width -1.0 inward 1.0 outward
8 Cheekbone height -1.0 top 1.0 bottom
9 Cheekbone width -1.0 narrow 1.0 wide
10 Cheeks width -1.0 wide 1.0 narrow
11 Eyes -1.0 opened 1.0 closed
12 Lips -1.0 wide 1.0 narrow
13 Jaw width -1.0 narrow 1.0 wide
14 Jaw height -1.0 top 1.0 bottom
15 Chin length -1.0 small 1.0 long
16 Chin position -1.0 inward 1.0 outward
17 Chin width -1.0 narrow 1.0 grand
18 Chin shape -1.0 simple chin 1.0 double chin
19 Neck width -1.0 narrow 1.0 wide


Syntax

player.setFaceFeature(index, scale);

Required Arguments

  • index: int
  • scale: float

Return value

  • Undefined

Example

function updateAppearance(genderChanged) {

    if (genderChanged) {
        mp.players.local.model = characterData.gender ? mp.game.joaat("mp_m_freemode_01") : mp.game.joaat("mp_f_freemode_01");

        setTimeout(sUpdateAppearance, 100);
    }

    else
        sUpdateAppearance();
    }

    function sUpdateAppearance() {
        
        for (var i = 0; i < 20; i++)
            mp.players.local.setFaceFeature(i, characterData.faceFeatures[i]);
    }
}

See also

Retrieved from "https://wiki.rage.mp/w/index.php?title=Player::setFaceFeature&oldid=19331"