Faceposer: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(cleaned up some stuff. if you know a solution for issue #3 or #4, please lmk! :^))
Line 2: Line 2:
[[Image:Faceposer multiactors.jpg|right|250px|thumb|Faceposer playing back a complex scene with multiple actors.]]
[[Image:Faceposer multiactors.jpg|right|250px|thumb|Faceposer playing back a complex scene with multiple actors.]]


{{faceposer|4|nt=0}} is the SDK tool used to produce choreographed sequences for the Source engine. It creates [[Flex animation|facial expressions]] (including lip-syncing) and manages [[skeletal animation]]s, the position of actors in the world, and any map triggers that need to be fired during the scene.
{{faceposer|4|nt=0}} is the SDK tool used to produce choreographed sequences for the Source engine. It can create [[Flex animation|facial expressions]] (including lip-syncing), manage [[skeletal animation]]s, the position of actors in the world, and any map triggers that need to be fired during a scene.


*'''See [[Choreography creation]]''' for a step-by step guide to creating choreography in the Source engine.
*'''See [[Choreography creation]]''' for a step-by step guide to creating choreography in the Source engine.
*'''See [[Faceposer reference]]''' for a quick-reference guide to the different parts of the Faceposer interface.
*'''See [[Faceposer reference]]''' for a quick-reference guide to the different parts of the Faceposer interface.


{{Note|In order to open Faceposer in SDK 2013, use the Faceposer.bat file in located in the bin folder. Using the shortcut .exe will give you an error asking for Vconfig!}}
{{Note|To use Faceposer with your own 2013-based mod, you'll need to set the VPROJECT environment variable to the game directory of your mod.}}
 
{{Note|All imported audio should be encoded as 4-bit ADPCM WAV or 16-bit PCM WAV. The sampling rate can either be 11025 Hz, 22050 Hz, or 44100 Hz.}}
{{Note|To use Faceposer with your own 2013-based mod, set the VPROJECT path to the game directory of your mod.}}


== Issues ==
== Issues ==


{{todo|Clean up the grammar here, and verify if everything is correct here.}}
* Faceposer has missing icons for the Play / Stop / Pause buttons. To fix this, extract [http://steamreview.org/external/vdc/faceposer-icons.zip this] to your SDK's bin folder.
 
* The Phoneme Extractor is broken by default. This can be fixed by using the [[Phoneme_Tool#Using_Lipsinc_Speech_API|Lipsinc Speech API]] instead of the default Microsoft Speech API.
* Incorrect model image probably made in {{photoshop|3.1}}, with {{hlmw|3.1}}, or with the incorrect size will make the "Load model" menu freeze and turn white, you will need to stop the {{path|hlfaceposer|exe|icon=exe}} process to fix it.
* Faceposer has some trouble loading debug materials, and will spam the Output window constantly when it uses them. This can cause the program to stutter quite a bit.
* In SDK 2006/Orange Box (2007/2009/2013?) version of {{faceposer|3|nt=0}}, the Play/Stop/Pause (►/■/‖) buttons are missing their icons by default, and display as white boxes instead. To fix this, extract [http://steamreview.org/external/vdc/faceposer-icons.zip fix] to the proper folder, details [[Choreography_creation|here]].
* If your mod uses custom shaders, Faceposer will fail to render any materials that use them when it's launched via VPROJECT. Using the {{code|-game}} parameter fixes this, but then Faceposer will occasionally crash when loading models.
* Models may not load at all. To fix this, go into regedit, and delete {{path|HKEY_USERS\..\Software\Valve\faceposer}}. Another solution is to clean the {{path|hlfaceposer|rf|icon=file}} file in your SDK's bin folder.
* Similar to [[Half-Life_Model_Viewer#Issues|HLMV]], opening folders inside of the "Load model..." browser will give an error if said folder only exists within a VPK.
* To make faceposer '''Phoneme Editor''' extraction work (if you are using anything newer than Windows XP) there are plenty things you need to do. Let's work with Source SDK 2007 as the most stable revision. For some reasons there are lot's of [https://www.youtube.com/watch?v=R38qlnow6eI info] how to make it [https://www.moddb.com/engines/source/downloads/windows-vista7-phoneme-extractor-13 work] with <code>Microsoft Speech 5.1</code>, but its the wrong approach. (it doesn't work properly anyway and it's quality is far from ideal). Go to [https://developer.valvesoftware.com/wiki/Phoneme_Tool#Using_Lipsinc_Speech_API here]. Take <code>lipsinc_data/</code> from anywhere, even the leaked Half-Life 2 build, copy it to {{path|..\SourceSDK\bin\source2007\bin}}, copy {{code|ims_helper.dll}} and {{code|phonemeextractor_ims.dll}} from {{path|Source SDK Base 2013 Singleplayer\bin}} to {{path|..\SourceSDK\bin\source2007\bin}}, you can edit <code>GameConfig.txt</code> to add your mod here and launch faceposer through steam or just add a .bat file with "[[-game]]" to your mod (to make it work you will need many things! like to unpack proper shaders from <code>Source SDK Base 2007\vpks</code> (otherwise lips won't move) and other stuff, also don't forget [https://developer.valvesoftware.com/wiki/Can%27t_find_steam_app_user_info this], write the [https://steamcommunity.com/app/420/discussions/0/864971765497379056/?l=russian&ctp=5#c648817377943105270 correct] {{code|gameinfo.txt}} for old source engine games. Change "''Speech API''" to "''Lipsinc Speech API''" in Faceposer, it should work now.
* If models completely fail to load for you, or Faceposer is no longer starting, try deleting the {{path|HKEY_CURRENT_USER\Software\Valve\faceposer|icon=reg}} registry key, and delete the {{path|hlfaceposer|rf|icon=file}} file inside your SDK's bin folder.
* If all fine in Faceposer, but in game lips not moving and you use sounds from other games or old engine versions just don't forget that Faceposer formats also can be changed from one engine version to another, go to <b>Phoneme Editor</b>, then press <code>Redo Extraction</code>, if you want to get less size, try use "''export word data to'' {{code|.txt}}", then you can import it and then commit extraction to your sound files, same rule spreads on {{code|.vcd}} scene files, just resave them.
{{Note|Always make sure that your audio is encoded to 16 bit mono ADPCM/PCM format (stereo also work though). Otherwise you won't hear anything in game and lips won't move.}}


{{SDKTools}}
{{SDKTools}}

Revision as of 21:26, 30 November 2023

English (en)Русский (ru)中文 (zh)Translate (Translate)
Faceposer playing back a complex scene with multiple actors.

HLFaceposer Faceposer is the SDK tool used to produce choreographed sequences for the Source engine. It can create facial expressions (including lip-syncing), manage skeletal animations, the position of actors in the world, and any map triggers that need to be fired during a scene.

  • See Choreography creation for a step-by step guide to creating choreography in the Source engine.
  • See Faceposer reference for a quick-reference guide to the different parts of the Faceposer interface.
Note.pngNote:To use Faceposer with your own 2013-based mod, you'll need to set the VPROJECT environment variable to the game directory of your mod.
Note.pngNote:All imported audio should be encoded as 4-bit ADPCM WAV or 16-bit PCM WAV. The sampling rate can either be 11025 Hz, 22050 Hz, or 44100 Hz.

Issues

  • Faceposer has missing icons for the Play / Stop / Pause buttons. To fix this, extract this to your SDK's bin folder.
  • The Phoneme Extractor is broken by default. This can be fixed by using the Lipsinc Speech API instead of the default Microsoft Speech API.
  • Faceposer has some trouble loading debug materials, and will spam the Output window constantly when it uses them. This can cause the program to stutter quite a bit.
  • If your mod uses custom shaders, Faceposer will fail to render any materials that use them when it's launched via VPROJECT. Using the -game parameter fixes this, but then Faceposer will occasionally crash when loading models.
  • Similar to HLMV, opening folders inside of the "Load model..." browser will give an error if said folder only exists within a VPK.
  • If models completely fail to load for you, or Faceposer is no longer starting, try deleting the Registry PathHKEY_CURRENT_USER\Software\Valve\faceposer registry key, and delete the Filehlfaceposer.rf file inside your SDK's bin folder.
Map editors
Map compilers
VBSP VBSP • VVIS • VRAD • vmpi
Map tools
bspzip • glview • VBSP2 • vbspinfo
Model compilers
Model tools
Dmxconvert • Dmxedit • HLFaceposer HLFaceposer • HLMV HLMV • Itemtest • Modelbrowser • QC_Eyes
Texture tools
Height2Normal Height2Normal • height2ssbump • makevmt • mksheet • pfm2tgas • Shadercompile • Splitskybox • VTEX VTEX • VTF2TGA VTF2TGA • xwad
Sound tools
Engine tools
Other
Captioncompiler • Demoinfo • Elementviewer • MakeGameData • Motionmapper • Sfmgen • VConfig • Vfont • Vfont_decompiler • VICE • vpk
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Faceposer&oldid=358184"