Divine Elegance Showroom

==================================
Divine Elegance Showroom     (QQDESR)
by QQuix    -   Jun/2008    -    Version 1.0 
==================================

Short Description
=============
This mod creates a showroom in Divine Elegance’s basement where live models will wear whatever Palonirya has for sale.
And Palonirya is so proud of her showroom that she decided to share it with all clothes and armor merchants in Cyrodill. ANY store. YES! Armor too. 
Therefore, she invites all her fellow merchants to send samples of their merchandise and she will expose it and sell it for them. And the invitation extends not only to the traditional stores, but also to all the new arrivals (i.e., OOnas Outfitters, Apachii Goddess Store etc).
The models will take turns walking the catwalk, wearing those fancy clothes added by other mods, and the player may look at them and choose which ones to buy
When a model is on stage, the player may add that particular set of clothes to his "Wish List". Or skip it. Or disregard it.
The showroom is run by Balonirya (Palonirya's twin sister). She sells only the items the player has selected in the Wish List (likely, a much, much shorter list).
This Mod is designed to show clothes and armor from any mod that adds them to one of the game shops. Even items/shops that will be created in the future.

Objectives
========
The motivation for this Mod came from my personal struggle through the massive number of new clothes I added to the game.
My objectives while developing this Mod were:
1. To be able to see the clothes before buying
2. To split the huge list in Palonirya's buy/sell menu into smaller, more manageable lists
3. To fully appreciate the work of all those modders that spent a lot of time and effort to create amazing new clothes and armor for our enjoyment. To them, I dedicate this Mod.

Description
=========
When you get to Divine Elegance, go downstairs. The original private basement is now a public area showroom. 

Palonirya has issued three invitations that the player may take to any three stores of her/his choice and read it to the store owner, inviting him to show his wares at the showroom. The player keeps the invitation and may use it to invite a different merchant later on. Therefore, at any given time there may be up to three guest merchants ‘exposing’ in the showroom.
In the showroom there are four catalogs: one is always Palonirya’s, the other three contain items from each of the guest merchants (one catalog for each merchant, of course). 
You may go to a shop that is already exposing in the showroom and invite the owner again. The owner will send whatever new items he has (items that were not there at the time of the previous invitation).
 
The invitations are in the showroom desk. Take them with you.

The models will only wear composed sets, either built by the player or from Palonirya's Special Selection.

In the Showroom, the player must compose "Sets of Clothes" (usually matching upperbody/lowerbody/boots/gloves etc) by selecting items from one of the Catalogs.
Once composed, the set is added to the sets the models will wear on stage and the items will be removed from the Catalog.
In the beginning, the Catalog may be as big as Palonirya's buy/sell menu, but it gets shorter over time, as the player composes new sets. 

Palonirya's Special Selection sets are pre-defined sets composed of matching items from a few pre-defined Clothes Mods.

When a model is on stage, the player may add that particular set of clothes to his "Wish List". Or skip it. Or disregard it.
Skipped sets will remain active and will show up again in a round-robin fashion.
Disregarded sets are decomposed and its items are added to the player's Blacklist.
Wishlisted sets are also decomposed and its items are added to the player's Wishlist.

At any time the player may review the Wishlist or the Blacklist and select individual items to be sent back to the Catalog, where they may be used to compose new sets, allowing for a very large number of combinations.


The player commands are issued by activating (spacebar) the items on the desk (you can't miss it). The names of the controls are self-explanatory (I hope)
The items may be rearranged on the desk to fit the player´s preferences. You also can take them wherever you like, i.e., backstage. But you have to grab and carry them using the grab key (keyboard Z). 

Inside the desk there are a few additional, less used commands [see Player Controls, below]


Player Controls and other concepts
============================
On the desk by the stage there are a few items that may be activated by the player. 
Three are command-type activators: "Next" , "Add to Wishlist" and "Add to Blacklist"
Seven are inventory-like lists: "Wishlist", "Blacklist", 4 x "Catalog" and "Now showing..."

Each item is always in one of four places: Catalogs, Wishlist, Blacklist or in a set to be worn by the Models
The items flow as follows, based on the player’s commands

 Wishlist >>>>>>> Catalog <<<<<<< Blacklist		
       ^      (3)                 v                 (4)       ^
       ^                           v (5)                       ^
       ^                           v                             ^
       <<<<<<<<<< sets/Model >>>>>>>>>>
                (1)                                  (2)

          (1) - "Add to Wishlist" moves the items from the Model on stage to the Wishlist
          (2) - "Move to Blacklist" moves the items from the Model on stage to the Blacklist
          (3) - Clicking on an item in the Wishlist moves it back to the Catalog
          (4) - Clicking on an item in the Blacklist moves it back to the Catalog
          (5) - Clicking on items in the Catalog composes a new set


>>>>> Next <<<<<<<<<<
This little table bell, when activated by the player, orders the Model on stage to go backstage and the next model to come in. The Models love to be on stage, so they come in quickly and take their time when ordered out. If you use it too quickly, you may have all six models on stage at the same time, which may be nice to look at, but may be confusing if you want to send items to one of the lists (see below)
The next model will always wear the next set of clothes. If there are no sets to wear, she will wear her standard robe (i.e., if you have less than six sets composed and all are being used by other Models)

>>>>> Add to Wishlist and Add to Blacklist <<<<<<<<<<
In both cases, the ‘active’ set is decomposed and its items are added to the proper list
The ‘active’ set is the last one that came to the stage. It is active from the time the Model enters the stage until she is ordered out. Note that you may order her out even before she enters the stage if you hit the Next command too quickly. In this case, the set does not become active and you have to wait for the next time it comes around to do something to it.

>>>>> Now showing… <<<<<<<<<<
This list shows the items in the active set.
If you have more than one Model on stage and are not sure which is active (last one that entered the stage), just open this list. The set shown here is the one that will be added to your Wishlist/ Blacklist if you hit the corresponding “Add to” command at this moment.
This list may also be used to select individual items to add to your Wishlist, as opposed to adding all the items by using the “Add to Wishlist” control. Let’s say you liked the boots of a particular set and don’t care about the remaining items. Select the boots and, when you close the menu, they will be added to your Wishlist, the remaining items will be added to the Blacklist and the set will be decomposed

>>>>> Wishlist and Blacklist <<<<<<<<<<
Items added to one of these lists are ‘out of the way’, helping reduce the Catalog list size.
The only real difference between them is that Wishlisted items appear in Balonirya’s buy/sell menu. This way, when you go to buy things from Balonirya, you will only see items you liked. You may buy them at any time.
You may move items from these lists back to the Catalog, so you may use those items to compose new sets. Just open the list (activating the corresponding item on the desk) and click on the item you want to send back to the original Catalog

>>>>> Catalogs <<<<<<<<<<
The Catalogs hold any item that is not in one of the lists and is not part of a composed set.
The main use of the Catalogs is to compose new sets. To compose a set, open the catalog and select all the items you want to have in the set. Make sure you don’t select two items for the same body part (like two pants or two boots) as only one of them will show on the Model. Think of it as if you were taking items from the store shelves and giving them to someone to try.
It works as any other container in the game. Items selected in the container inventory go to the player’s inventory and items selected in the player’s inventory go to the container’s.
When you close the Catalog, all items selected are used to compose a new set and will show up on stage sooner or later. And, yes, they are removed from the player’s inventory. 
WARNING: Don’t move any of your own items to the Catalogs or to any of the other lists. You may lose it.

>>>>> Palonirya’s Special Selection <<<<<<<<<<
Palonirya’s Special Selection are predefined sets the mod tries to compose automatically. The main objectives are to quickly reduce the size of the Catalog list and to have something to look at before you compose your own sets. 
After the initial composition, PSS sets are no different from any other set you compose yourself.
For this version, PSS is focused on Growlfs Hot Clothes (either v4.1 or v5). So if you have Growlf installed, about half of his hundreds of items are already composed into 60-120 sets. If you have other massive clothes mod, let me know and I will include it in the next version.
Oh, yes . . . if you have Growlfs, the models will wear something lighter when resting backstage.

>>>>> Lighting <<<<<<<<<<
There are three groups of light sources you can turn on and off . . . or should I say: there are three groups of candles you can light up and extinguish:
- Wall candles: There are eight wall candles on the columns – each may be turned on/off by using the miniature bellows and torch.
- Chandeliers – three: the one closer to the stairs has an orange light, the center one is plain white and the last one goes toward the yellow. 
- Floor candles – two groups of candles on silver plates. One on each side of the stage 
The controls for the chandeliers and floor candles are on the column in the niche under the stairs.
Play with them to find the combination that suits your taste.

PLAYER CONTROLS INSIDE THE DESK
The numbers have no special meaning. They are there to set the order on the list.
The icons kind of show to whom the order is directed.

>>>>> Model orders <<<<<<<<<<
Two quite self-explanatory orders to stop and resume the Model movement: 
“Stand still for a moment” – she will stop (this command is ignored until she first arrives at the center of the stage)
“OK. You may continue now” – she will resume her path.

>>>>> Balonirya’s orders <<<<<<<<<<
“Show/Don’t show item names” -  Toggles the message appearing in the top left of the screen showing the names of the items the Model is wearing (the first five items only). If you consider messages distracting, don’t turn it on.

“Dismiss all sets” – a quick way to start over. As the name implies, it decomposes all sets and sends the items back to the Catalog(s) they came from. It also rebuilds the internal infrastructure of the sets, in case it gets corrupted [see Technical Comments and Issues].

>>>>> Cleaning Lady orders <<<<<<<<<<
“Put all back on the desk” - asks her to put all desk items back where they should be (just in case you misplace one of them)
“Remember my desk setup” - tells her to remember how you like your desk organized.
“Reset desk setup” - asks her to put all desk items back in the original position. Player setup is ‘forgotten’ when you use this command.


Technical Comments and Issues
=========================
This is my first Mod. I gave my best to make it as good and stable as I could within the game engine/CS/OBSE specifications and my technical knowledge of them.
As with any other mod you activate: Save often until you are confident the mod is stable!

Several features in this mod are “proof of concept”, i.e.:
- The Cleaning Lady
- Light switches
- The use of activators to give orders (instead of dialogs)
- The inventory menus as option lists (instead of dialog / message box)
- Even activators inside an Inventory menu (the desk)
- (and some of the code)
In other words: they are there, first, to see if they are feasible. Second, if they are useful. And third (which is up to you), if the players like them or not.
Although I don’t intend to change them in this mod, your feedback is important, as it may tell modders with similar needs whether they should use similar features or avoid them.

Players that installed the Beta version didn’t report any major problem, so I am confident this version should be OK.

One user (pkstar) mentioned he couldn’t build new sets. I coded some ‘bug traps’ and, after many hours, it happened to me. The traps showed that the internal structure of the sets was corrupted, but I couldn’t determine what caused it. It never happened again, and I dont know if it is a bug in the code or, maybe, in the engine. To be on the safe side, I added the “Dismiss all sets” command, which rebuilds the whole infrastructure of the sets. So, if this happens to you, use the “Dismiss all sets” and everything should be back to normal.

Another user (Xzen) noticed that the skin of the Nord model got a greenish tone when she was on right side of the stage. I found that it happens under very specific circumstances: (1) The video setup has antialiasing on, (2) the light source has any green on its RGB and (3) the subject is at the edge of the light radius. To solve it, I increased the light radius and, if worst comes to worst, added light switches.
Looks OK now. 

Talking about lights … be aware that the more light sources fall on a subject, the more (heavy) calculations the game engine has to make, resulting in a lower FPS. 

Compatibility - I avoided changing anything in the game: The only thing changed from the original game is Divine Elegance's basement door, which, now, leads you to the new showroom. This way, the only possible incompatibility is with a mod that changes or depends upon DE's original basement.

There were two major challenges in developing this Mod:
First, I wanted it to be fully independent from the clothes mods. This is accomplished by checking DE cell for new items added to the shop. New items, from whatever mod they came from, are added to the Showroom Catalog. This "detection" can only happen when the player is in the DE shop, so, after activating new clothes mods, if you load a game saved while in the showroom, make sure you go upstairs and back so the new items may be added to the Catalog (games saved anywhere else are no problem, as you have to go thru the shop to get to the showroom, anyway)

The second was the GUI. I personally dislike message boxes and dialogs (and they wouldn’t do it, anyway) so I chose the Inventory Menu as the main interface between the player and the lists. As a result, this Mod adds/removes a LOT of items to containers. 

The bottom line is that this mod has some heavy scripting that may lead to technical issues.
Although users of the Beta version didn’t report any of these and although I reduced the potential impact to a minimum along the development (special thanks to Vagrant0 for his technical warnings and suggestions), it is fair to mention that this minimum may still cause one or both of the following issues:

1. Memory usage: depending on how many cloth items are scripted, it seems that, in some circumstances, the script remains in memory after the item is removed. As far as i know, I removed all of these "circumstances" from my initial coding and the memory bloat shouldn’t happen. but the player is advised to savegame>exit game>restart game>loadgame when playing for long periods in the showroom.
2. Savegame size: Every time the player composes a new set of clothes, a new container may be added to the game and will take space in the saved game. These containers are reused, so it is a high-watermark scenario. It looks like each container adds about 0.3Kb to the saved game. But I figure that a player that adds hundreds of new clothes to the game can afford an additional 30 to 60Kb in his saved game.

The good news is that this mod is absolutely superfluous and isolated and may be deactivated at any time without further consequences to the game. Even items bought from Balonirya shouldn’t be affected if you deactivate this mod, as long as you keep the mod that added the item (the game engine does not care if the vendor you bought the items from is still in business or not)

So, if you like the mod but experience some problem, you may use the following procedure to still take advantage of it:

1. Save the game  (SaveA)
2. Activate this mod
3. Go to the Showroom and take your time enjoying the show and building your lists
4. Write down the item you liked in a piece of paper (or take snapshots of your Wishlist)
5. Go upstairs to the shop and save the game  (SaveB)
6. Exit the game and deactivate this Mod
7. Reload SaveA and continue your game normally (as if this Mod was never installed)

Now, you can use your notes anytime to buy whatever you liked from Palonirya herself

If you add new clothes afterwards, you just save your game, reactivate this Mod, reload SaveB, go down to the showroom to watch the new clothes and make new selections, take notes, exit, deactivate this Mod again and reload you game. Again, use your notes to buy from Palonirya.

This Mod was developed using the CS 1.2.404 and OBSE v0014a


WARNING - Mature Contents
=======================
Although this Mod does not add anything related to mature contents, I tagged it as Mature as it may be used to display some degree of nudity.

The degree of nudity is directly related to the clothes the player added to the game. 

But, even with vanilla clothes, the player may compose a set with only a pair of Blue Suede Shoes. The girls are professional models and will wear whatever the customer asks. So, in this case, she will walk around naked, proudly showing that magnificent pair of shoes.

I also did my best to prevent the models to become naked when you deactivate a clothes mod and load a game where one of them is wearing some (now missing) items from the deactivated mod. But, maybe there are some unforeseen circumstances when it won't work. 

Requirements
===========
OBSE v0014a - no way to do it without it - download from   http://obse.silverlock.org
UMPA Sexy Walk - for the models' animation - hit fits perfectly for this Mod's purposes. This Mod just wouldn’t be the same without it. Download from http://www.tesnexus.com/downloads/file.php?id=15829

Future Improvements
=================
Running out of ideas … open for suggestions.

Installation
=========
The same as most Mods:
1.  Unzip the files to your "OblivionData" directory
2.  Activate the DESR esp in your mod manager
3.  If you don’t have it yet, install "UMPA Sexy Walk" Data files so the models can use the animation. (Install UMPA's esp, if you want your female character to walk the same way)

Special Thanks
============
UMPA for his amazing animation and for allowing me to use it (I encourage you all to try "UMPA Dance and Pose" and "UMPA Disco" - Lots of fun!!)
Vagrant0 and Nosisab for their technical advices
Dragoon Wraith (from CS WIKI) and may others from the TES Nexus Forums for their suggestions and encouraging
Growlf, whose overwhelming number of items motivated me to develop this Mod
Users of the Beta version that gave feedback (suggesting, rating and/or raising issues).

Limitations and special situations
===========================
1. It seems that sometimes the AI gets lost: when time passes quickly (i.e., fast travel, seep and wait)   the Models AI advances but the Model herself remains in the same position. The most common scenario is when she leaves the stage: the AI advances so she ‘thinks’ she is by the column at the stage exit and goes straight to the laundry chest, but she is still in the middle of the stage and her straight path goes thru the curtains. In this case she would keep walking against it. The mod detects this situation and moves her closer to her destination. I cant do better that that. So, if you return to the showroom after some time, you may see one or more of the Models going in the direction of the curtains and passing right thru it. It doesn’t look that bad, as it is a curtain, and not a solid wall, after all.
 
2. The DE Catalog is updated the first time you enter Divine Elegance after loading a savegame. This will catch new clothes from a mod that you have just activated and add them to the Catalog. It will check Palonirya’s stock at that moment. If you have already bought some of her clothes before you install this mod, her stock may not be full and those missing items will not show up in the Catalog in the first moment. Depending on how the clothes mod set up its vendor container, these items will show up in a few game days later, after the vendor container respawns. 
The same is true for guest merchants: their catalos are built with whatever clothes/armor they have for sale at the moment you invite them.

3. Most wearable items are designed for a particular kind of body and will replace the original body part of whomever equips them (your character, NPCs and, in this case, the Models on stage)
So, if you compose a set, say, with a shirt based on one body and pants based on another, they may not fit well at the waist. If you see something like this on the models, it will happen to anyone in the game (PC or NPC), with or without this mod.
 

Version history
============
Version 1.0:  Jun 2008
- Shared showroom + invitations + additional catalogs
- Added lights and light switches
- Added “Dismiss all sets”
- Added extra curtains to reduce distraction
- Added commands to pause/resume Models
- Reworked Models action packages to workaround AI glitches
- Reequip player’s items after opening one of the lists
- Added message showing items on models
- Added command to reset desk setup
- Added desk and placed less used commands inside
- Replaced backstage lights with fakes to reduce FPS drop
- Added adjustments to Balonyria’s heading so she doesn't stay too long facing backstage

Version 0.0:  Jun 2008




Do whatever you want with this Mod for your personal use, but contact me if you plan to share anything based on it.  


Please, let me know any bugs you may find or suggestions, questions or comments you may have – add a comment to the file download page or send me a Personal Message in the Nexus Forums.

I am mostly concerned with:
- Bugs that may show under different game/hardware environments
- Typos the spell check may have missed (in the game and here)
- Grammar - English is not my native language
- Any suggestion to improve this text