vgui_movie_display

类层级
CMovieDisplay ↳CBaseEntity
movie_display.cpp

vgui_movie_display是一个点实体(en)，可在所有的 起源 游戏，自从 异形丛生 以来中使用。 (也存在于 之中)

vgui_movie_display on elevator screens in 传送门2. The video shown on the screen are located in portal2\media\exercises_horiz.bik.

This entity is used to display videos in the world. 传送门2 uses the Bink format for videos, while 传送门 2：社区特供版 (along with all 地层起源 games) uses the WebM format.

A movie screen is typically a brush face textured with elevator/elevator_screen or one of its variants. Make sure you click "Fit" in the Texture Application Tool.

错误:

• Non-functional in .
• If the video has sound, it will be heard at full volume everywhere in the map.
• The video restarts when pausing and unpausing the game.
• The movie display does not fade into fog, and rarely is visible through walls.  [todo tested in ?]

Stretching movies across multiple screens

The master/slave keyvalues and U/V inputs on the entity can be used to stretch a movie across multiple displays. The usual setup for this involves one vgui_movie_display with "_master" at the end of its targetname, which then controls a group of slave vgui_movie_displays that have "Forced Slave" enabled and the same "Group Name" as the master entity.

Place a slave vgui_movie_display for each screen at the lower-left corner of the face. Change the width and height to match each panel. The U/V inputs can be used to set which part of the image is displayed on each screen.

To start the movie, fire an "Enable" input at all vgui_movie_display entities; wildcards are useful for this.

Elevator videos

Valve includes a system for selecting elevator videos in custom maps. The arrival_departure_transition_ents instance includes a pair of instance parameters which can be used to set the arrival and departure videos respectively. The video_splitter.nut VScript will automatically handle setting the correct U/Vs.

Unfortunately, the default instances included in Portal 2 have broken elevator videos since the Perpetual Testing Initiative update. To fix, visit this steam guide.

Property Name	Value
Fix up Name
VMF Filename	instances/transitions/arrival_departure_transition_ents.vmf
Replace	$arrival_video media/faithplate.bik
Replace	$departure_video media/animalking.bik

The video_splitter script also contains a list of all singleplayer campaign maps and which videos each map should play. For mods, it is recommended to add the mod's maps to this list. Single maps should continue to use the method above.

Keyvalues

Name(en) (targetname) <target_source>[ Edit ]

这个名称是其他实体通过 输入/输出(en) 或其他 关键值(en)（如 parentname 或 target) 来引用该实体时使用的标识符。
该名称也会显示在 Hammer 编辑器的 2D 视图和 实体报告(en) 中。

参见: 所有实体均可使用的 通用键值、输入与输出(en)

Display Text (displaytext) <字符串(en)>

Unknown use, appears non-functional.

Movie Filename (moviefilename) <字符串(en)>

Path to the video file, located in media/. Portal 2 uses Bink (.bik) videos, while P2CE uses WebM (.webm) videos. See List of Portal 2 Movies for a list of default videos in Portal 2 (P2CE also includes WebM versions of these).

Group Name (groupname) <字符串(en)>

What group of vgui_movie_display entities it belongs to.

Loop Movie (looping) <布尔值(en)>

If true, the movie will be played in an endless loop.

Mute Movie ([todo internal name (i)]) <布尔值(en)> (仅存在于 之中)

If true, it will mute the movie.

Stretch to Fill (stretch) <布尔值(en)> (存在于自 以来)

If true, will resize the movie to fill the screen.

Forced slave (forcedslave) <布尔值(en)> (存在于自 以来)

Whether this is a "slave" vgui_movie_display that takes command from the master.

Force precache (forceprecache) <布尔值(en)> (仅存在于 之中)

Precache the movie referred to by Movie Filename on entity spawn.

Panel width (width) <整数(en)>

Width of the panel in units.

Panel height (height) <整数(en)>

Height of the panel in units.

Disable Scanline Overlay (noscanline) <布尔值(en)> (仅存在于 之中)

Enables/Disables the scanline overlay.

Use Custom UVs (custom_uv) <布尔值(en)> (仅存在于 之中)

Same as SetUseCustomUVs input, just as a keyvalue

U Min (u_min) <浮点型(en)> (仅存在于 之中)

U (horizontal) minimum (0-1)

U Max (u_max) <浮点型(en)> (仅存在于 之中)

U (horizontal) maximum (0-1)

V Min (v_min) <浮点型(en)> (仅存在于 之中)

V (vertical) minimum (0-1)

V Max (v_max) <浮点型(en)> (仅存在于 之中)

V (vertical) maximum (0-1)

Audio Volume (volume) <整数(en)> (仅存在于 之中)

Audio volume to use for video playback (0-10)

Inputs

Enable

Make movie visible.

Disable

Make movie invisible.

SetDisplayText <字符串(en)>

Sets the display text. Appears non-functional.

SetMovie <字符串(en)> (存在于自 以来)

Sets the movie to display.

SetUseCustomUVs <布尔值(en)> (存在于自 以来)

Use custom UVs.

TakeOverAsMaster  (存在于自 以来)

Start using this video as the master of it's group.

SetUMin <浮点型(en)> (存在于自 以来)

Set the minimum U.

SetUMax <浮点型(en)> (存在于自 以来)

Set the maximum U.

SetVMin <浮点型(en)> (存在于自 以来)

Set the minimum V.

SetVMax <浮点型(en)> (存在于自 以来)

Set the maximum V.

See also

• List of Portal 2 Movies