Shop mannequins

The mannequins in a clothes shop wear what the shop actually sells. A shop grammar places its display pieces as usual (a figure on its feet, a torso on legs, a lingerie window, a dress form, a counter bust); the room's dressing then puts a live figure on each of them, dressed in a coordinated outfit drawn from the venue's clothes stock. Click one to buy the whole outfit or try it on.

#How it works

1. The dressing file Rooms/Dressing/mannequins.uldressing has a rule with a MANNEQUIN table (see Room dressing). Its ON names the display pieces it may replace.
2. For each such piece, the first pieces entry (below) whose match fits the piece's name says which forms may stand there, which of the piece's materials to hide, and where the figure stands.
3. The game draws, seeded by the building (the same figures on every visit): a form (of the sex the piece shows: _Male in its name), an outfit recipe, garments for it from the venue's stock, a skin and a pose.
4. The figure is put up, dressed, posed once, and then never updated again until its outfit changes.

The baked figure stays when the venue sells no clothes (no .ulshop with a Clothing: line at its tag), when no pieces entry matches, when no complete outfit can be found, or when the room already has MAX live figures.

Garments go on the figures exactly as on people (same skeleton, same leader-posed garment meshes), at their base fit: the forms are the morphless figure the garments were made on.

#A mannequin file

<mod>/Mannequins/*.ulmannequin, JSON. Every mod's files are read in load order; an entry whose id comes again replaces the earlier one (a pieces entry: its match).

json{
	"forms": [
		{ "id": "female", "gender": "Female", "mesh": "Mannequins/mannequin_f.glb" },
		{ "id": "female_bust", "gender": "Female", "mesh": "Mannequins/mannequin_f_bust.glb",
		  "slots": ["Neck", "Collar"], "outfits": ["necklace"], "poses": ["still"], "skins": ["velvet_black"] }
	],
	"skins": [
		{ "id": "chrome", "color": [0.85, 0.86, 0.88], "roughness": 0.14, "specular": 0.5, "metallic": 1.0 }
	],
	"skin_by_piece": [ { "match": "*_Chrome*", "skin": "chrome" } ],
	"poses": [
		{ "id": "arms_down", "weight": 2,
		  "bones": { "lShldrBend": [0, 42, 0], "rShldrBend": [0, -42, 0] } }
	],
	"outfits": [
		{ "id": "casual", "weight": 3, "pieces": [
			{ "category": "Top", "types": ["tee", "tank", "shirt"] },
			{ "category": "Bottom", "types": ["pants", "shorts", "skirt"] },
			{ "category": "Shoes", "types": ["sneaker", "flat"] },
			{ "category": "Outerwear", "chance": 0.3 } ] }
	],
	"pieces": [
		{ "match": "Display_Mannequin_Figure_*", "forms": ["female", "male"] },
		{ "match": "Display_Bust_Black", "forms": ["female_bust"], "hide": ["Body"], "anchor": "neckLower", "offset": [0, 0, 27], "scale": 0.75 }
	]
}

#Forms

Shipped forms (ul_Base/Meshes/Mannequins/, made by Tools/Mannequin/export_mannequin.py):

Jewellery is worn the same way as clothes (.ulcloth garments in the Neck, Ear, Wrist and Finger slots), so busts and hands are dressed like the full figures.

#Skins

A skin is a material, not pictures: color (linear RGB), roughness, specular, metallic, sheen (velvet). Shipped: white, grey, black, chrome, velvet_black, velvet_cream. skin_by_piece keeps a figure the colour its piece was made in (*_Black* stays black); a pieces entry's skin fixes it outright. Otherwise the skin is rolled among the form's skins.

#Poses

bones turns bones from the figure's rest pose: [x, y, z] degrees about the figure's own axes, x pointing to the figure's left, y to its back, z up, applied x first, then y, then z; each bone about its own joint, parents before children, so a turned upper arm carries the forearm with it. After the turn the figure is lowered or raised so its lowest foot stands where it stood ("ground": false to keep it where the bones put it: a hand, a bust). forms limits a pose to those forms. weight is how often it is drawn.

These are the axes of Blender's world with the figure facing -Y, so a pose can be tried on the body in Blender first: blender -b -P Tools/Mannequin/preview_poses.py -- <body.glb> <file.ulmannequin> <out.png> [pose ids] renders each pose front and side, exactly as the game applies it.

Shipped: arms_down, hand_on_hip, three_quarter, walking_stride, contrapposto; still (the partial forms) and hand_upright.

#Outfits

A recipe is a list of pieces, each drawn from the stock that the form can show:

A recipe may also say max_sexiness (no piece scored above it: a full figure in a clothes shop wears clothes, not a bra and hot pants) and spread (default 1). The pieces of one outfit never share a slot, and stay within spread of the first piece's Sexiness: so a figure reads as one look. Shipped recipes: dress, casual, smart, coat (the full figures; an outer layer only over nothing, since a shirt under a jacket pokes through it on a figure that never moves), lingerie (the lingerie figures and window), and torso_top, lingerie_set, bra, legwear, necklace, earrings, hand_jewellery for the partial forms (weight 0: only where a form or piece names them).

#Pieces

#The dressing rule

lua-- Rooms/Dressing/mannequins.uldressing
return {
	NAME = "mannequins",
	GRAMMARS = { "shop_clothes", "shop_fashion", "shop_luxury", "shop_department", "shop_sports", "shop_outdoor", "sex_shop" },
	RULES = {
		{ ID = "mannequin_live", ON = { "Display/Mannequin", "Display/Showcase", "Display/DressForm", "Display/Bust" },
		  MANNEQUIN = { STOCK = "shop", MAX = 6, FREEZE = "static" } },
	},
}

#In the game

Clicking a mannequin opens its menu: Buy this outfit (the price of every piece together) buys each garment through the till like a shelf item, and Try it on opens the shop's fitting rails with the outfit already on the player (offered when the figure is of the player's sex). When a limited garment's last one is sold, the mannequins of that building take it off, as the shelves lose their last box; it is back when the shop restocks.