Half-Life Model Viewer (Source)

From Valve Developer Community
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
English (en)Русский (ru)Translate (Translate)
Screenshot of Source version of HLMV.

Valve ship their own version of HLMV Half-Life Model Viewer (HLMV) with the Source SDK specifically for viewing models created for the Source Source engine. It appears to be based on the original HLMV 1.22 codebase but re-worked to use Source's own 3D viewport and material system.

It's unclear under what license it is used/distributed but Source HLMV still provides a credit and link to chUmbaLum sOft in its About menu. Several features of the Source HLMV have been copied from JHLMV.

Each iteration of the Source engine has a slightly updated version of the model viewer giving access to newer or enhanced features of the respective engine.

For the Source HLMV settings such as rendering options and background color is saved in the Windows registry and stored on a per model basis (Registry PathHKEY_CURRENT_USER\Software\Valve\hlmv). Unfortunately, there doesn't appear to be a way to set the standard options.

To launch HLMV, go to ...\common\game-name\bin, and run HLMV.bat. On some games (such as Left 4 Dead and later), you need to install and launch the Authoring Tools/SDK, then click "Model Viewer".

Source HLMV Features

  • Normal mapping
  • Specular mapping
  • Generating QC code for Hitboxes, Physics, Attachments, IKRule, Event
  • Visually displaying vertex weighting.
  • Animation blending
  • Pose parameters
  • LOD models
Games that have LOD are: Portal Portal, Portal 2 Portal 2, Portal: Revolution Portal: Revolution, Half-Life 2 Half-Life 2, Half-Life 2: Episode One Half-Life 2: Episode One, Half-Life 2: Episode Two Half-Life 2: Episode Two, Half-Life 2: Lost Coast Half-Life 2: Lost Coast, Half-Life 2: Deathmatch Half-Life 2: Deathmatch
  • Flex animations

Keybinds

  • LMB drag in the center of the viewport will orbit the camera.
  • LMB drag on the edge of the viewport will roll the camera.
  • Ctrl+LMB drag will orbit the light source.
  • RMB drag will dolly the camera back/forward.
  • Shift+LMB drag with pan the camera left/right up/down.
  • F5 will refresh the textures if they have been recompiled.
  • U will toggle UV chart view
  • T will toggle textured view.
    Note.pngNote:Normal mapping for textures is not checked on by default.

Launch Options

Argument Description
-screenshot Takes a screenshot of the given model and writes it to a TGA file, requires the path of the model to be given
Icon-Bug.pngBug: Only seems to produce full files when HLMV is run in Windows 8 compatibility mode  [todo tested in?]
-dump Writes to the console (stdout) specifying if the model is translucent or has material proxies
-noSteamdDialog [sic] Removes the old File Explorer browser when trying to open a file from the 'File' menu.
-tempcontent Attempts to add modname_tempcontent as a search path (e.g. hl2_tempcontent)
-olddialogs Adds the file explorer browser back to the 'File' menu, only works on versions that have it disabled by default.
-basedir Sets where to search for the dlls, only for Xbox 360
-novconfig Don't launch vconfig if no game was found

Usage

If you are starting from scratch, you can use HLMV to create a base set of hitboxes, and then modify them to fit your models needs. This page will take you step by step through the process.

Warning.pngWarning:you will need a model that compiles properly and has a least 1 bone that the geometry is skinned to.

Auto Generating hitboxes

The first thing we'll do is get HLMV to create a set of hitboxes for us. When it does this it will create a hitbox for every bone that has geometry skinned to it, and will fit the hitbox around that geometry.

  1. Open HLMV and load your model. From the Render tab press CTRL+H or select the Hit Boxes checkbox to view the hitboxes
    Hlmv hitboxes 01.jpg
  2. Select the Bones tab. If you did not create hitboxes in your .qc/.qci file(s) then the Auto-Generate Hitboxes checkbox should be ON. If you have specified some hitboxes, turning on the auto-generation will do nothing.
    Hlmv hitboxes 02.jpg
  3. With the auto-generated hitboxes visible, click Generate QC button. This will copy the .qc commands needed to create the auto-generated hitboxes into your clipboard.
    Hlmv hitboxes 03.jpg
  4. Open your model's .qc or create a new hitbox.qci file with your favorite text editor. CTRL+V to paste the autogenerated .qc lines into the file, save it, and recompile your model. It's a good idea to format the pasted commands into something more legible, especially if you plan on modifying the hitboxes. It should look something like this:
// .qc block generated by HLMV begins.
$surfaceprop "default"
$hboxset "default"
$hbox 0 "head"	   -14.83  -11.24  -23.58    32.59   11.24    9.46 "head"
$hbox 0 "spine1"	   -33.32  -20.38  -40.78    33.32   20.38   40.78 "spine1"
// .qc block generated by HLMV ends.

Creating new hitboxes and hitbox sets

The easiest way to create new hitboxes or hitbox sets is to simply cut/copy & paste the lines in the .qc that refer to a hitbox on the bone you'd like to add the hitbox to.

You can create a new hitbox set by adding $hboxset "your_set_name_here" and then cut/copy & pasting the .qc commands for an existing hitbox below.

Once you've finished adding the all the hitboxes and sets you need, save the file and recompile the model.

Modifying your hitboxes with HLMV

Once you have all of your hitboxes and sets added, it's much faster to use HLMV to edit the scale and position of them. You can do it directly in the .qc file, but it will require recompiling the model many times to review your changes and thus is a much more inefficient way of accomplishing the same thing.

  1. Open your model in HLMV, turn the hitboxes on, flip over to the Bones tab
    Hlmv hitboxes 04.jpg
  2. Select the set that contains the hitbox you would like to edit, and then the joint it is attached to. You'll see the boxes describing the hitboxes' position and size fill out.
    Note.pngNote:While this info represents what is defined in the .qc, it is presented differently. The .qc script defines the 2 opposite corners of the hitbox in relation to the bones pivot. HLMV converts that info into a more user friendly size and origin, or offset if you will, in relation to the bone's pivot.

    Hlmv hitboxes 05.jpg
  3. Edit the Origin and Size blocks and press the Update Hitbox button to see your changes.
    Hlmv hitboxes 06.jpg
  4. Repeat until all of the hitboxes in all of your sets are looking good.
  5. Click Generate QC to copy these new settings into your clipboard again and then replace your old hitbox info with it. Recompile your model. High-five someone.

Issues

  • If you find that HLMV is missing textures, such as floor, background, and cubemap, extract a set from a working SDK. Find them at materials/hlmv/ (e.g., in hl2_misc_dir.vpk for example).
  • HLMV has had a very wobbly history. Without warning it sometimes no longer works because of changes/updates done to the Source SDK.
  • Any .jpg model thumbnail made using Photoshop or ImageReady will crash HLMV. JPGs must use progressive encoding.
  • The normal map flag can be tricky to switch on depending on your graphic card.
  • Wireframe mode was broken shortly since after the release of the Source SDK, rendering the default texture (purple/black squares) over the model. To add injury to the insult, the flat shaded mode that provided some of the same functionality, was removed between Episodes One and Two. In later engine builds, the issues with wireframe mode has been resolved.
  • When selecting a submodel category, the second submodel is displayed in the 3D view, but the name of the first submodel is still being displayed as the selected in the dropdown menu (also present in Goldsrc versions).
  • When moving from folder to folder the scroll bar doesn't reset.
  • Texture resolution on models may be displayed at 1/4 of its actual resolution (Mipmap 1) on NVIDIA graphics cards.
  • When viewing models using materials that use "$cloakPassEnabled" "1" the triangle count will double what it actually is due to a calculation bug.
  • Using Options > Make Screenshot... doesn't seem to produce effective screenshots.
  • Since the Steampipe update, opening folders with the File -> (Steam) Load model... browser will give an error if the corresponding folder does not exist in the game's mod directory. A workaround for this is create the same folders in your game directory with the same structure as the game's VPK files.
  • Solution to above problem PowerShell script to create missing folders

See also

  • Prop Gallery
  • Modeling
  • HLMV++ HLMV++ - an alternative to HLMV for several Source games. It also adds a number of brand new quality of life fixes and features.

External links