Player::setFaceFeature: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
m (fix a typo)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Sets the various freemode face features, e.g. nose length, chin shape. Scale ranges from 0.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 information (thx Mcfloy):
Index can be 0 - 19.
*0: Nose width (0 narrow, 1 wide)
{| class="wikitable"
*1: Nose height (0 top, 1 bottom)
 
*2: Nose length (0 grand, 1 petit)
! Index  
*3: Nose bridge (0 round, 1 hollow)
! Face feature     
*4: Nose tip (0 upward, 1 downward)
! Min             
*5: Nose bridge shift (-1 to the right, 1 to the left)
! Max           
*6: Brow height (0 top, 1 bottom)
|-
*7: Brow width (0 inward, 1 outward)
 
*8: Cheekbone height (0 top, 1 bottom)
| 0    
*9: Cheekbone width (0 narrow, 1 wide)
| Nose width      
*10: Cheeks width (0 wide, 1 narrow)
| -1.0 narrow      
*11: Eyes (0 opened, 1 closed)
| 1.0 wide      
*12: Lips (0 wide, 1 narrow)
|-
*13: Jaw width (0 narrow, 1 wide)
 
*14: Jaw height (0 top, 1 bottom)
| 1    
*15: Chin length (0 small, 1 long)
| Nose height      
*16: Chin position (0 inward, 1 outward)
| -1.0 top        
*17: Chin width (0 narrow, 1 grand)
| 1.0 bottom    
*18: Chin shape (0 simple chin, 1 double chin)
|-
*19: Neck width (0 narrow, 1 wide)
 
| 2    
| Nose length      
| -1.0 grand      
| 1.0 petite     
|-
 
| 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==
Line 53: Line 160:
==See also==
==See also==
{{Player_function_c}}
{{Player_function_c}}
[[Category:Player Appearance]]
[[Category:Clientside API]]
[[Category:Clientside API]]
[[Category:TODO: Example]]
[[Category:TODO: Example]]
[[Category:Server-side Function]]

Latest revision as of 19:56, 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 petite
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=19332"