ShowLookPreview

A body in front of the player wearing a look - on this screen alone.

The first call puts a body where the player looks, distance metres ahead on their own floor, facing them and dressed in what they wear, with the look’s parts on it, and turns the player’s view level onto it (whether they looked at the sky or at their feet); nobody else sees it. Every later call changes it in place: the look (written only when it changed), the distance along the same line, the turn, the height - what options leaves out keeps the last call’s. A creator holds the keyboard meanwhile (SetKeyboardCapture: the player neither walks nor turns away from the body); a player moved far from it (a teleport) finds it in front of them again at the next call. The body goes with HideLookPreview, a reload of the scripts, and the end of the session.

options: distance - metres in front (1.6 by default: the head and the chest; 0.9 is the face, 2.5 the whole body), turn - degrees the body is turned from facing the player (180 shows the back), height - metres up or down.

A look with gender = "female" shows a woman’s body (a change between the two makes the body anew where it stands); what the player wears is put on her too - a woman’s dress stands in for a man’s clothes and armour on her body, his hoods and helmets are left off (her own hair and face show), his boots show as they are and his scabbards without their waist belt.

Syntax

ShowLookPreview(look [, options])

Parameter	Type
look	table | string	{body, head, hair, beard, gender}, or its one-line form; {} shows the body as its soul makes it
options	table	{distance = 1.6, turn = 0, height = 0} (optional)

Returns

boolean - false when there is no player yet or no body could be made

Example

local look = {head = "m_head_004", hair = "m_hair_005_black", beard = "m_beard_03", body = "m_body_tan_02"}
ShowLookPreview(look, {distance = 1.2})
-- later: the player turned the preview with A / D
ShowLookPreview(look, {turn = 45})

See also

HideLookPreview · RequestLookChange · SetKeyboardCapture · the Looks and the character creator group of the index