Player::setFaceFeature: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
m (fix a typo)
 
(10 intermediate revisions by 7 users not shown)
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 information (thx Mcfloy):
Index can be 0 - 19.
*0: Nose width (-1 narrow, 1 wide)
{| class="wikitable"
*1: Nose height (-1 top, 1 bottom)
 
*2: Nose length (-1 grand, 1 petit)
! Index  
*3: Nose bridge (-1 round, 1 hollow)
! Face feature     
*4: Nose tip (-1 upward, 1 downward)
! Min             
*5: Nose bridge shift (-1 to the right, 1 to the left)
! Max           
*6: Brow height (-1 top, 1 bottom)
|-
*7: Brow width (-1 inward, 1 outward)
 
*8: Cheekbone height (-1 top, 1 bottom)
| 0    
*9: Cheekbone width (-1 narrow, 1 wide)
| Nose width      
*10: Hoes width (-1 wide, 1 narrow)
| -1.0 narrow      
*11: Eyes (-1 opened, 1 closed)
| 1.0 wide      
*12: Lips (-1 wide, 1 narrow)
|-
*13: Jowl width (-1 narrow, 1 wide)
 
*14: Jowl height (-1 top, 1 bottom)
| 1    
*15: Chin length (-1 small, 1 long)
| Nose height      
*16: Chin position (-1 inward, 1 outward)
| -1.0 top        
*17: Chin width (-1 narrow, 1 grand)
| 1.0 bottom    
*18: Chin shape (-1 simple chin, 1 double chin)
|-
*19: Neck width (-1 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 31: Line 138:
==Example==
==Example==
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
// todo
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]);
    }
}
</syntaxhighlight>
</syntaxhighlight>
==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"