MST Venue Setup - Revision history

Arrehn: /* Communicate These New Changes with your Staff and Performers */

2024-07-31T15:07:11Z

Communicate These New Changes with your Staff and Performers

← Older revision		Revision as of 15:07, 31 July 2024
Line 98:		Line 98:
	# Let them know where they can find your updated theater template with the MST centerpoint location.		# Let them know where they can find your updated theater template with the MST centerpoint location.
	# If you set your MST Centerpoint to a particular group and authorized access from that group in step 1, tell your performers that they should have this group active when using MST tools in your theater or performance area.		# If you set your MST Centerpoint to a particular group and authorized access from that group in step 1, tell your performers that they should have this group active when using MST tools in your theater or performance area.

			Please think about letting other MST Users know about your new theater! Send Arrehn Oberlander a message with a texture of your logo or name along with a notecard describing your group or theater, and you can be added to the "MetaHarpers Community Wall" at the in-world store and studio. This free promotion can help MST veterans and new users alike find each other.
	<br>		<br>

Arrehn: /* MST Cameras: Set Up Your Theater for Scripted Camera Capability */

2024-07-31T15:02:28Z

MST Cameras: Set Up Your Theater for Scripted Camera Capability

← Older revision		Revision as of 15:02, 31 July 2024
Line 78:		Line 78:
	# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)		# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)
	# You’re finished setting up seating.		# You’re finished setting up seating.
	~~<br>~~
	=== Cameras: Create a Camera Reset Mechanism ===		=== Cameras: Create a Camera Reset Mechanism ===

Arrehn: /* MST Cameras: Set Up Your Theater for Scripted Camera Capability */

2024-07-31T15:02:15Z

MST Cameras: Set Up Your Theater for Scripted Camera Capability

← Older revision		Revision as of 15:02, 31 July 2024
Line 78:		Line 78:
	# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)		# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)
	# You’re finished setting up seating.		# You’re finished setting up seating.
	~~<br>~~

	<br>		<br>
	=== Cameras: Create a Camera Reset Mechanism ===		=== Cameras: Create a Camera Reset Mechanism ===

Arrehn: /* Optionally Set Up Your Theater for Scripted Camera Capability */

2024-07-31T15:02:01Z

Optionally Set Up Your Theater for Scripted Camera Capability

← Older revision		Revision as of 15:02, 31 July 2024
Line 61:		Line 61:
	This step is not specific to MST, but many stages find it useful to create some kind of curtain that can obscure the performance area from view, so that set changes can happen more elegantly and be revealed in a well-managed surprise. Almost anything can work as a curtain, and there are many on the SL marketplace. There is also a "Smart Curtain" included in the MST package you are welcome to use. Once you've set up a curtain, give out the curtain controls or HUD to any staff or helpers that need access.		This step is not specific to MST, but many stages find it useful to create some kind of curtain that can obscure the performance area from view, so that set changes can happen more elegantly and be revealed in a well-managed surprise. Almost anything can work as a curtain, and there are many on the SL marketplace. There is also a "Smart Curtain" included in the MST package you are welcome to use. Once you've set up a curtain, give out the curtain controls or HUD to any staff or helpers that need access.

	== ~~Optionally~~ Set Up Your Theater for Scripted Camera Capability ==		== MST Cameras: Set Up Your Theater for Scripted Camera Capability ==

	If you plan to use scripted camera effects with your theater, product for HUD-based camera viewing, or use customized seats for furniture-based camera viewing.		If you plan to use scripted camera effects with your theater, product for HUD-based camera viewing, or use customized seats for furniture-based camera viewing.

Arrehn at 01:22, 31 July 2024

2024-07-31T01:22:53Z

← Older revision		Revision as of 01:22, 31 July 2024
Line 4:		Line 4:
	<br>		<br>

	''Special Note: I sometimes use the term "performance space", "venue", and "stage" interchangeably. In this context I'm talking about a specific boundary where your show takes place. It can be a building, a sky platform, a beach, or whatever else you can imagine.''		''Special Note: I sometimes use the term "performance space", "venue", "theater", and "stage" interchangeably. In this context I'm talking about a specific boundary where your show takes place. It can be a building, a sky platform, a beach, or whatever else you can imagine.''
	<br>		<br>

Line 61:		Line 61:
	This step is not specific to MST, but many stages find it useful to create some kind of curtain that can obscure the performance area from view, so that set changes can happen more elegantly and be revealed in a well-managed surprise. Almost anything can work as a curtain, and there are many on the SL marketplace. There is also a "Smart Curtain" included in the MST package you are welcome to use. Once you've set up a curtain, give out the curtain controls or HUD to any staff or helpers that need access.		This step is not specific to MST, but many stages find it useful to create some kind of curtain that can obscure the performance area from view, so that set changes can happen more elegantly and be revealed in a well-managed surprise. Almost anything can work as a curtain, and there are many on the SL marketplace. There is also a "Smart Curtain" included in the MST package you are welcome to use. Once you've set up a curtain, give out the curtain controls or HUD to any staff or helpers that need access.

	== Optionally ~~set up~~ Theater ~~Furniture~~ for Scripted Camera Capability ==		== Optionally Set Up Your Theater for Scripted Camera Capability ==

	You ~~don’t~~ need to ~~use specially prepared furniture~~ for ~~most of MST’s features, but if you wish~~ to use MST ~~scripted~~ cameras ~~in your theater~~ you ~~will need specially prepared~~ furniture. ~~Usually this~~ involves ~~either using~~ the ~~seats that come with~~ the MST package, ~~or taking the scripts out of these seats~~ and placing ~~them~~ into your own furniture. ~~The specific details of how~~ to ~~do this~~ are ~~outlined below.~~		If you plan to use scripted camera effects with your theater, product for HUD-based camera viewing, or use customized seats for furniture-based camera viewing.

			=== Cameras: My theater does not want to require specific seats. How does my audience see the MST camera effects? ===
			You will need to either purchase and install the [https://doc.metaharpers.org/Immersive_Experience_Effects MetaHarpers Immersive Experience] to provide an easy, HUD-based method for your audience to see scripted camera effects.

			=== Cameras: My theater intends to use audience seats. How can I make the seats work with MST cameras? ===
			Generally you can make any one-seater or two-seater furniture into something that can show MST scripted camera effects. The general process involves removing a few scripts from the example seat included in the MST package, and placing this into your own furniture. You are also free to use the MST theater seat directly if you desire! You may use the following steps as a guide for setting up seats that are compatible with MST Scripted Camera effects:

	# First, rez the “MST Theater Seat” object near your stage. It’s important to start with this object even if you have your own custom seating. After rezzing the MSt Theater Seat, edit the “~seatConfig” notecard inside. Edit the line that says “VENUE” to match your centerpoint’s name. For example, if your centerpoint is named AugustusCP then you should make your seat configuration notecard have a line “VENUE=AugustusCP”. Save the notecard.		# First, rez the “MST Theater Seat” object near your stage. It’s important to start with this object even if you have your own custom seating. After rezzing the MSt Theater Seat, edit the “~seatConfig” notecard inside. Edit the line that says “VENUE” to match your centerpoint’s name. For example, if your centerpoint is named AugustusCP then you should make your seat configuration notecard have a line “VENUE=AugustusCP”. Save the notecard.
	# Watch your nearby chat window for a line that looks like “MST Theater Seat: Venue configuration set for AugustusCP” that will appear AFTER you save the notecard. It should say the name of whatever you have named the centerpoint object. If this does not happen, double check each notecard to make sure you have no mispelllings or formatting errors. Only continue after you see this line appear after saving or updating the MST Theater Seat “~seatConfig” notecard.		# Watch your nearby chat window for a line that looks like “MST Theater Seat: Venue configuration set for AugustusCP” that will appear AFTER you save the notecard. It should say the name of whatever you have named the centerpoint object. If this does not happen, double check each notecard to make sure you have no mispelllings or formatting errors. Only continue after you see this line appear after saving or updating the MST Theater Seat “~seatConfig” notecard.
	# Edit the “~seatConfig” notecard again, and add “ALLOW=” lines to match those you have allowed in your centerpoint’s configuration notecard. At a minimum you should allow your own UUID and the owner of the centerpoint if this is not you.		# Edit the “~seatConfig” notecard again, and add “ALLOW=” lines to match those you have allowed in your centerpoint’s configuration notecard. At a minimum you should allow your own UUID and the owner of the centerpoint if this is not you.
	# At this point, you can ~~clone the MST Theater~~ you’ve set up to create chairs for your audience. Feel free to change its textures or name. If you want to use custom seating read on:		# At this point, you can copy this chair you’ve set up to create an array of chairs for your audience. Feel free to change its textures or name. If you want to use custom seating read on:
	# If you wish to use your own seating, copy the “~seatConfig” notecard into your custom furniture, along with the “~camSeatManager” and the “~camSeat1” script. When finished moving these scripts into your furniture, either re-save the ~seatConfig notecard or “reset scripts” on your custom furniture. Make sure you see the message “(name of your custom seating): Venue configuration set for <your centerpoint name>” similar to step 2.		# If you wish to use your own seating, copy the “~seatConfig” notecard into your custom furniture, along with the “~camSeatManager” and the “~camSeat1” script. When finished moving these scripts into your furniture, either re-save the ~seatConfig notecard or “reset scripts” on your custom furniture. Make sure you see the message “(name of your custom seating): Venue configuration set for <your centerpoint name>” similar to step 2.
	# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)		# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)
Line 74:		Line 80:
	<br>		<br>

			<br>
			=== Cameras: Create a Camera Reset Mechanism ===

			If you are planning to use scripted camera features described above, normally performers will reset or “clear” camera control at the end of their show, returning control to the audience. However, sometimes unexpected events happen that will prevent the clear command from being sent. For example, the performer might crash, or the region might restart at a particularly bad time. If for whatever reason the performer cannot reset camera control, your audience may be "stuck" looking at the last camera location. To avoid this situation it is strongly advised that venues create a “camera reset mechanism”. There are many ways to accomplish this. Examples are:
	~~=== Optionally Create a Camera Reset Mechanism ===~~		* '''Gestures''': You can create a gesture that sends “/8 clearcam” when activated, or show directors can shout the “/8 clearcam” directly when needed. Whoever uses the gesture should be allowed to use the MST Centerpoint, as specified inside the centerpoint's VENUE_CONFIG notecard.
			* '''Buttons''': You may rez a button backstage somewhere that sounds "/8 clearcam" when touched. The button should be owned by whoever owns the MST centerpoint.
	If you are planning to use scripted camera features described above, normally performers will reset or “clear” camera control at the end of their show, returning control to the audience. However, sometimes unexpected events happen that will prevent the clear command from being sent. For example, the performer might crash, or the region might ~~crash~~. If for whatever reason the performer cannot reset camera control, your audience may be "stuck" looking at the last camera location. To avoid this situation it is strongly advised that venues create a “camera reset ~~button” and~~ rez it backstage somewhere ~~where all the performers know where it is~~. It should be owned by the centerpoint ~~owner and~~ should ~~shout~~ the ~~command “/8 clearcam” when pushed~~.		* '''Macro HUD''': You may also use your macro-HUD of choice such as the MST Programmable Button HUD to provide a camera reset capability. Whoever uses the HUD should be allowed to use the MST Centerpoint, as specified inside the centerpoint's VENUE_CONFIG notecard.

	If you need help making your own emergency clear cam button such as described above, contact Arrehn Oberlander or a friendly scripter.		If you need help making your own emergency clear cam button such as described above, contact Arrehn Oberlander or a friendly scripter.
	If you do make one and want to contribute it to the MST package, please let me know!		If you do make one and want to contribute it to the MST package, please let me know!
	~~Alternatively, you can create a gesture that sends “/8 clearcam” when activate, or show directors can shout the “/8 clearcam” directly when needed.~~
			<br>

	== Communicate These New Changes with your Staff and Performers ==		== Communicate These New Changes with your Staff and Performers ==
Line 88:		Line 97:
	Let all of your people know that you have created an official MST centerpoint location and what you have named it. If they are using the MetaHarper Show Tools Suite or ChoreoHUDs, this is very important info!		Let all of your people know that you have created an official MST centerpoint location and what you have named it. If they are using the MetaHarper Show Tools Suite or ChoreoHUDs, this is very important info!

	# Make sure to tell your performers who owns the centerpoint, so they can "Allow" the centerpoint from their own performance engines.		# Make sure to tell your performers who owns the centerpoint, so they can "Allow" the centerpoint from their own MST performance engines.
	# Let them know where they can find your updated theater template with the MST centerpoint location.		# Let them know where they can find your updated theater template with the MST centerpoint location.
	# If you set your MST Centerpoint to a particular group and authorized access from that group in step 1, tell your performers that they should have this group active when using MST tools in your theater or performance area.		# If you set your MST Centerpoint to a particular group and authorized access from that group in step 1, tell your performers that they should have this group active when using MST tools in your theater or performance area.
			<br>

			== Read more about best practices for setting up Performance Areas ==

			There may be additional resources in the [https://doc.metaharpers.org/Theater_Design Theater Design] section of this website.

Arrehn at 00:53, 31 July 2024

2024-07-31T00:53:36Z

Arrehn: /* STRONGLY SUGGESTED: Create a “Theater Template” for choreographers to build acts your performance space away from your region. */

2024-07-30T22:39:19Z

STRONGLY SUGGESTED: Create a “Theater Template” for choreographers to build acts your performance space away from your region.

← Older revision		Revision as of 22:39, 30 July 2024
Line 31:		Line 31:
	<br>		<br>

	== ~~STRONGLY SUGGESTED:~~ Create a “Theater Template” for choreographers to build acts your performance space away from your region. ==		== Create a “Theater Template” for choreographers to build acts your performance space away from your region. ==

	=== Why do I want to make a stage template? ===		=== Why do I want to make a stage template? ===
Line 45:		Line 45:

	<br>		<br>

	== Add an MST Centerpoint marker to your stage template ==		== Add an MST Centerpoint marker to your stage template ==
	=== Why should I add an MST centerpoint marker to my template? ===		=== Why should I add an MST centerpoint marker to my template? ===

Arrehn at 22:38, 30 July 2024

2024-07-30T22:38:52Z

← Older revision		Revision as of 22:38, 30 July 2024
Line 44:		Line 44:
	* '''Link and name''' Link your prims together. You may wish to change the prim type to “convex hull” to reduce the overall prim count if it helps. You’re now done. Name your template.		* '''Link and name''' Link your prims together. You may wish to change the prim type to “convex hull” to reduce the overall prim count if it helps. You’re now done. Name your template.

	== ~~Update~~ your ~~theater~~ template to ~~show users where to place their own MST Centerpoints.~~ ==		<br>
			== Add an MST Centerpoint marker to your stage template ==
			=== Why should I add an MST centerpoint marker to my template? ===
	In this step we’ll take the theater template you made earlier and make sure it marks where your choreographers should place their own MST Centerpoints, when working in their workspace area.		In this step we’ll take the theater template you made earlier and make sure it marks where your choreographers should place their own MST Centerpoints, when working in their workspace area.

Arrehn at 22:30, 30 July 2024

2024-07-30T22:30:34Z

← Older revision		Revision as of 22:30, 30 July 2024
Line 17:		Line 17:


	== Place and Customize ~~your~~ MST Centerpoint ==		== Place and Customize the Official MST Centerpoint ==

	Almost every MST tool will need to know the name of your stage, where it is, and who is allowed to use it. The “MST Centerpoint” object accomplishes all of this for you. Normally you would place it on the floor of your stage or just backstage, rename it, edit its configuration notecard, then optionally make it invisible and lock it in the build window. The detailed steps to accomplish this are described below:		Almost every MST tool will need to know the name of your stage, where it is, and who is allowed to use it. The “MST Centerpoint” object accomplishes all of this for you. Normally you would place it on the floor of your stage or just backstage, rename it, edit its configuration notecard, then optionally make it invisible and lock it in the build window. The detailed steps to accomplish this are described below:
Line 24:		Line 24:
	# '''Rez and record position''': Rez the “MST Venue Centerpoint (rename me)” object from your MST Tools folder, and move it to the location you’ve determined above. Rotate the MST Venue Centerpoint, if needed, so that the point of the triangle faces toward the audience. Once you have it in the right place, it is wise to go into the build window and record the X,Y, and Z coordinates of your centerpoint, then paste these into the centerpoint's description field. This way if for any reason it is moved or returned, you can remember where exactly to replace it.		# '''Rez and record position''': Rez the “MST Venue Centerpoint (rename me)” object from your MST Tools folder, and move it to the location you’ve determined above. Rotate the MST Venue Centerpoint, if needed, so that the point of the triangle faces toward the audience. Once you have it in the right place, it is wise to go into the build window and record the X,Y, and Z coordinates of your centerpoint, then paste these into the centerpoint's description field. This way if for any reason it is moved or returned, you can remember where exactly to replace it.
	# '''Choose a Name''': Rename the MST Venue Centerpoint. For example, if your stage is called “Augustus Stage” rename the centerpoint to something like “AugustusCP”. Shorter names are best, try to avoid spaces or unusual punctuation.		# '''Choose a Name''': Rename the MST Venue Centerpoint. For example, if your stage is called “Augustus Stage” rename the centerpoint to something like “AugustusCP”. Shorter names are best, try to avoid spaces or unusual punctuation.
	# Select your centerpoint and ~~edit~~ the notecard inside it named ~~“VENUE CONFIGURATION”~~.		# '''Open the notecard''' Select your centerpoint, look at the contents, and open] the notecard inside it named “VENUE_CONFIGURATION”.
	# ~~Customize~~ the “CHANNEL_CAMERA_VIEWERS” channels by adding or subtracting a few numbers ~~from each of these. These help reduce crosstalk with other MST stages nearby~~. For example, “CHANNEL_CAMERA_VIEWERS=-500010” ~~and~~		# '''Using Cameras? Think about customizing the camera channel''': If you plan to use scripted cameras, you may wish to customize the “CHANNEL_CAMERA_VIEWERS” channels to something unique, by adding or subtracting a few numbers. For example, “CHANNEL_CAMERA_VIEWERS=-500010”. There's nothing wrong with the defaults, but making your stage unique will allow people to rehearse or build up in the air without affecting your main performance stage.
	# ~~Explicitly~~ allow the ~~critical core staff of~~ your ~~theater~~. ~~It can be helpful and more flexible~~ to allow your stage ~~managers~~, ~~power users, people~~ who ~~may~~ be ~~helping create acts for others, or who may be running camera or special effects for others~~. ~~It’s most reliable~~ to allow by UUID. To get a UUID of a user, look at their profile and the UUID for that person will be listed at the top. Copy that value and paste it into an ALLOW line. For example, if wanted to allow Arrehn Oberlander, you would add the line “ALLOW=3c637a3e-370e-4bca-b18e-92b4692a685a” to ~~the file~~.		# '''Give your staff and choreographers access''': You will probably want to allow people other than yourself to use the official stage centerpoint. Anyone who might use MST technology at your stage will need to be allowed first. The easiest way to do this is to allow a specific group, usually whatever group already has rez rights on your stage land. In the build window set the group of the centerpoint prim to the group you want to allow access. In the VENUE_CONFIGURATION notecard , make sure the “ALLOW_SAMEGROUP=YES” line exists. Users who have an active group that matches the group of the centerpoint will now be allowed to use it. It's also possible to allow specific other users not in the group by their UUID. To get a UUID of a user, look at their profile and the UUID for that person will be listed at the top. Copy that value and paste it into an ALLOW line. For example, if wanted to allow Arrehn Oberlander, you would add the line “ALLOW=3c637a3e-370e-4bca-b18e-92b4692a685a” to your centerpoint's notecard. This is sometimes handy if you do not want people to have a particular group set active. Make sure to save the notecard after your changes.
	~~# Decide~~ if you want to ~~add in allow lines for all of your possible performers by name, or whether you just want to allow people who wear~~ a particular group ~~tag~~. ~~Typically, allowing a group is much easier~~ to ~~maintain. If you want to allow a group, in the build window set~~ the ~~group of the centerpoint prim to the group you want to allow access. In the VENUE_CONFIGURATION~~ notecard ~~, make sure the “ALLOW_SAMEGROUP=YES” line exists. Users who have an active group that matches the group of the centerpoint will now be allowed~~.		# '''Hide the Centerpoint''': Change the transparency of the MST Venue Centerpoint to make it invisible, and set the “lock” checkbox. If you want to move or adjust the notecard, first unlock the prim and then lock it again when you finish. Locking this object insures that it does not accidentally get moved or damaged, which could throw off all acts at your venue.
	# ~~Copy~~ the ~~x/y/z coordinates of the centerpoint’s location into the centerpoint’s “description” field. This is so you can move it back to where it’s supposed to be, if it ever moves accidentally.~~		# '''Finished!''' You’ve now finished setting up your centerpoint.
	# Change the transparency of the MST Venue Centerpoint to make it invisible, and set the “lock” checkbox. If you want to move or adjust the notecard, first unlock the prim and then lock it again when you finish. Locking this object insures that it does not accidentally get moved or damaged, which could throw off all acts at your venue.		<br>
	# You’ve now finished setting up your centerpoint.

	== Create a “Theater Template” for choreographers to build acts ~~specific to~~ your performance space~~. If you’ve already done this, skip to Step 3~~. ==		== STRONGLY SUGGESTED: Create a “Theater Template” for choreographers to build acts your performance space away from your region. ==

	In this step, we’ll describe how to build a rough-and-ready mockup of your theater, called a ‘Theater Template’. Choreographers use this by rezzing them in their own private ~~workspaces~~ to plan acts for your theater. You should encourage people to use ~~these~~ whenever possible to avoid competing for time in (and possibly cluttering) your actual theater outside of planned rehearsal times.		=== Why do I want to make a stage template? ===
			In this step, we’ll describe how to build a rough-and-ready mockup of your theater, called a ‘Theater Template’. Choreographers use this by rezzing them in their own private build areas to plan acts for your theater. You should encourage people to use templates whenever possible to avoid competing for time in (and possibly cluttering) your actual theater outside of planned rehearsal times.

	This step requires some basic but careful prim building skill. If you’re not a careful builder ask someone you trust to help out. Create plywood prims and carefully cover the entire floor of your performance area. Your plywood should follow the shape of the performance stage as closely as possible but be slightly above it, usually around 0.01m, in places where it is visible to the audience. When you cam out and move your camera back and forth slowly, facing the performance area, you should not see any flickering textures.		=== How to make an excellent template ===
			* '''Use Prims'''This step requires some basic but careful prim building skill. You do not need to use any fancy mesh for this, as typically you only need to make a simplified model of a rectangular, round, or spherical space. If you’re not a careful builder ask someone you trust to help out. Create full-perm plywood prims and carefully cover the entire floor of your official performance area. Your plywood should follow the shape of the performance stage as closely as possible but be slightly above it, usually around 0.01m, in places where it is visible to the audience. When you cam out and move your camera back and forth slowly, facing the performance area, you should not see any flickering textures. It is very important that the build you create have full perms so you can give them out to your choreographers easily.
	If you ~~do see flickering textures, make~~ your ~~plywood prims extend a hair further away from the stage until the flickering stops~~.		* '''Cover floors, walls, and ceilings''' As a rule a thumb, for parts of your performance area were your individual set designers and choreographers are likely to want to customize a background texture, make sure your prims extend OUT 0.1m, so that the plywood is exposed. Conversely, for areas where you do NOT want performers to put custom textures over your theater, keep any edges of your prims about 0.01m INSIDE the theater build and tint them full black, so they will not show and offer a visual cue that they are “out of bounds”. This will lets designers see where their “Edges” are, but not override your theater textures. If you need more than one prim to cover all of the performance area floor, align your floor prims as perfectly as possible to avoid any visible gaps or overlaps. It may be helpful to learn how to use the build window’s “alignment tool” to help with this.
			* '''Avoid Flickering''' Zoom your camera in and out of your build a little. If you see flickering textures from the floor showing through your plywood prims, make your plywood prims extend a hair further away from the stage until the flickering stops.
	As a rule a thumb, for parts of your performance area were your individual set designers and choreographers are likely to want to customize a background texture, make sure your prims extend OUT 0.1m, so that the plywood is exposed. Conversely, for areas where you do NOT want performers to put custom textures over your theater, keep any edges of your prims about 0.01m INSIDE the theater build and tint them full black, so they will not show and offer a visual cue that they are “out of bounds”. This will lets designers see where their “Edges” are, but not override your theater textures.		* '''Include Backstage Areas''' Depending on how much detail your choreographers and designers will need, add prims to cover the walls, roof, and backstage area of your stage. Backstage areas are helpful to model for movers that may need to move to or from the backstage, for example.
			* '''Color-code your temple''' Texture or tint all the faces that are visible to the audience that your performers should retexture a grey or similar neutral but non-pitch-black color. Tint all the rest of the faces you do not wish your performers to cover up, and especially interior areas that cannot be seen by the audience 100% black.
	If you need more than one prim to cover all of the performance area floor, align your floor prims as perfectly as possible to avoid any visible gaps or ~~overlap flickering~~. It may be helpful to learn how to use the build window’s “alignment tool” to help with this.		* '''Link and name''' Link your prims together. You may wish to change the prim type to “convex hull” to reduce the overall prim count if it helps. You’re now done. Name your template.

	~~Optionally, depending~~ on how much detail your choreographers and designers will need, add prims to cover the walls, roof, and backstage area of ~~the performance area similarly~~ to the ~~floor~~.

	Texture or tint all the faces that are visible to the audience that your performers should retexture a grey or similar neutral but non-pitch-black color.

	Tint all the rest of the faces you do not wish your performers to cover up, and especially interior areas that cannot be seen by the audience 100% black.

	Link your prims together. You may wish to change the prim type to “convex hull” to reduce the overall prim count if it helps. You’re now done. Name your template~~. Set it to have copy and mod permissions at the very least, if not full perm, and place it where your performers can copies~~.

	== Update your theater template to show users where to place their own MST Centerpoints. ==		== Update your theater template to show users where to place their own MST Centerpoints. ==

Arrehn at 17:26, 30 July 2024

2024-07-30T17:26:06Z

← Older revision		Revision as of 17:26, 30 July 2024
Line 2:		Line 2:

	This page contains information for theater and venue owners who wish to use MST technology. Setting up MST in an official venue does not require specialized technical skills, but it does require you to follow some detailed steps carefully. I’ve listed these below.		This page contains information for theater and venue owners who wish to use MST technology. Setting up MST in an official venue does not require specialized technical skills, but it does require you to follow some detailed steps carefully. I’ve listed these below.
	~~=== Preparations and Requirements ===~~		<br>
	*
	* You do not need to be a builder, but you do need basic familiarity with your viewer’s build window for tasks such as selecting objects, moving objects, setting object coordinates, locking objects, and changing transparency, renaming, and editing notecards.
	* Make sure your performance area fits inside a single region. In general, MST does not support multi-region venues. If you have a setup where performers are on one region, and your audience is on another - this will work but not every feature is supported. In in doubt, ask [https://world.secondlife.com/resident/3c637a3e-370e-4bca-b18e-92b4692a685a Arrehn Oberlander].
	* Make sure your performance area where you will be rezzing sets, props, and backdrops has at least a 20 meter buffer space between it and the edge of the region. Automatic rezzing of large objects close to region borders can be problematic. Also make sure that your stage floor is at least a few meters above the ground terrain, and at least 50 meters below the 4096 maximum-buildable altitude limit.
	* If you plan to support scripted cameras in your venue, you will need furniture for audience members to sit on. You may use the MST Theater Seats in the MST folder, or you may use your own furniture. If you use your own furniture, your furniture must have “mod” permissions, and must allow avatars to sit directly on your furniture without having to rez furniture poseballs, like some older-style furniture sometimes does. MST camera scripts have been tested with “AVsitter ™” system style furniture.
	* Make sure your performance area is stable, and ideally your stage objects should have the ‘locked’ box checked in the SL build window so that it can not be accidentally moved, resized, or returned. If you move or resize your performance area, you may have set up the MST centerpoint again (more on this below).

			''Special Note: I sometimes use the term "performance space", "venue", and "stage" interchangeably. In this context I'm talking about a specific boundary where your show takes place. It can be a building, a sky platform, a beach, or whatever else you can imagine.''
			<br>

	== ~~Place your MST Centerpoint~~ and ~~Change a few Settings~~ ==		=== General Preparations and Requirements ===

	Almost every MST tool will need to know ~~what~~ your ~~venue’s name~~ is, who is allowed to use it~~, and where it is physically located in the sim~~. The “MST Centerpoint” object accomplishes all of this for you. ~~Just~~ place it on the floor of your stage, rename it, edit its notecard, then make it invisible and lock it in the build window. The detailed steps to accomplish this are described below:		* '''Build Window Comfort''': You do not need to be a builder, but you do need basic familiarity with your viewer’s build window for tasks such as selecting objects, moving objects, setting object coordinates, locking objects, and changing transparency, renaming, and editing notecards.
	#		* '''Region''': Ensure your stage area fits inside a single region. In general, MST does not support splitting your performance staff across different regions. If you have a setup where performers are on one region, and your audience is on another - this will work and has been done, but not every feature is supported. In in doubt, ask [https://world.secondlife.com/resident/3c637a3e-370e-4bca-b18e-92b4692a685a Arrehn Oberlander].
	# Locate the center of ~~your stage (~~or ~~similar performance area)~~. ~~There are many ways~~ to ~~do this~~. ~~One simple way that works in many cases is to visually estimate~~ the center of ~~your~~ stage, ~~then select~~ the floor ~~object at that spot~~. ~~Note~~ the X and ~~Y coordinates~~ of ~~that object in your build window~~.		* '''Buffer Zones for Rezzing''': Make sure your performance area where you will be rezzing sets, props, and backdrops has at least a 20 meter buffer space between it and the edge of the region. Automatic rezzing of large objects close to region borders can cause problems due to built-in SL limitations. Also make sure that your stage floor is at least a few meters above the ground terrain floor, and at least 50 meters below the 4096 maximum-buildable altitude limit.
	# Rez the “MST Venue Centerpoint (rename me)” move it to ~~X and Y coordinates~~ you’ve determined ~~are your stage center. Set the height so that the MST Venue Centerpoint prim is barely visible~~. Rotate the MST Venue Centerpoint, if needed, so that the point of the triangle faces toward the audience.		* '''Land Experience''': You should add an allowed Experience to your land or region. The Experience name is "MetaHarpers Interactive Theater" and it is rated G. This will help your MST tools, particularly movers and group dance inviters work faster.
	# Rename the MST Venue Centerpoint. For example, if your stage is called “Augustus Stage” rename the centerpoint to something like “AugustusCP”. Shorter names are best.		* '''Scripted Camera Support''': If you plan to support scripted cameras, your actors and staff will be able to see camera effects by virtue of using HUDs or movers included in the MetaHarper Show Tools package. However, your passive audience visitors who are not in the show will need some way to see the scripted camera effects. This can be accomplished by customized furniture (typically anything that sits 1-2 avatars and has mod permissions will work, see the Camera section for specific details). If you wish instead to use attached HUDs instead of customized seats, this is also an option. For more details see the [[Immersive_Experience_Effects\|MetaHarpers Immersive Theater Land Experience]] section
			* '''Lock the permanent parts of your stage''': Regardless of whether your stage is a building, an island, or a platform, do be sure to check the "locked" checkbox on any parts of it that are intended to be permanent. This will save you hours of frustration by ensuring that no part of your stage structure inadvertently moves or changes, and will always be synchronized with your rezzers.


			== Place and Customize your MST Centerpoint ==

			Almost every MST tool will need to know the name of your stage, where it is, and who is allowed to use it. The “MST Centerpoint” object accomplishes all of this for you. Normally you would place it on the floor of your stage or just backstage, rename it, edit its configuration notecard, then optionally make it invisible and lock it in the build window. The detailed steps to accomplish this are described below:

			# '''Choose a Location''': Locate where you would like the centerpoint to be placed. Typically this will be in the center of wherever you plan to rez the most props or dynamic scenes. The closer you can place the centerpoint to where you would wish any props to be rezzed, the faster rezzing will be. Typically people use the center of their stage area or just backstage, either on the floor or slightly under the floor. Wherever it is, try to keep it more than 20m away from a region edge, more than 4m away from the terrain floor, and try to keep it 20m or so away from where any audience member might be standing or sitting, because sometimes SL does not allow large objects to be rezzed if they would clip over on top of an avatar.
			# '''Rez and record position''': Rez the “MST Venue Centerpoint (rename me)” object from your MST Tools folder, and move it to the location you’ve determined above. Rotate the MST Venue Centerpoint, if needed, so that the point of the triangle faces toward the audience. Once you have it in the right place, it is wise to go into the build window and record the X,Y, and Z coordinates of your centerpoint, then paste these into the centerpoint's description field. This way if for any reason it is moved or returned, you can remember where exactly to replace it.
			# '''Choose a Name''': Rename the MST Venue Centerpoint. For example, if your stage is called “Augustus Stage” rename the centerpoint to something like “AugustusCP”. Shorter names are best, try to avoid spaces or unusual punctuation.
	# Select your centerpoint and edit the notecard inside it named “VENUE CONFIGURATION”.		# Select your centerpoint and edit the notecard inside it named “VENUE CONFIGURATION”.
	# Customize the “CHANNEL_CAMERA_VIEWERS” channels by adding or subtracting a few numbers from each of these. These help reduce crosstalk with other MST stages nearby. For example, “CHANNEL_CAMERA_VIEWERS=-500010” and		# Customize the “CHANNEL_CAMERA_VIEWERS” channels by adding or subtracting a few numbers from each of these. These help reduce crosstalk with other MST stages nearby. For example, “CHANNEL_CAMERA_VIEWERS=-500010” and

← Older revision		Revision as of 00:53, 31 July 2024
Line 9:		Line 9:
	=== General Preparations and Requirements ===		=== General Preparations and Requirements ===

	* '''Build Window Comfort''': You do not need to be a builder, but you do need ~~basic~~ familiarity with your viewer’s build window for tasks such as selecting objects, moving objects, setting object coordinates, locking objects, and changing transparency, renaming, and editing notecards.		* '''Build Window Comfort''': You do not need to be a regular builder, but you do need familiarity with your viewer’s build window for tasks such as selecting objects, moving objects, setting object coordinates, locking objects, and changing transparency, renaming, linking objects, setting object permissions, and editing notecards. If you are not comfortable with these things, you should find someone who can help you with some of these steps.
	* '''Region''': Ensure your stage area fits inside a single region. In general, MST does not support splitting your performance staff across different regions. If you have a setup where performers are on one region, and your audience is on another - this will work and has been done, but not every feature is supported. In in doubt, ask [https://world.secondlife.com/resident/3c637a3e-370e-4bca-b18e-92b4692a685a Arrehn Oberlander].		* '''Region''': Ensure your stage area fits inside a single region. In general, MST does not support splitting your performance staff across different regions. If you have a setup where performers are on one region, and your audience is on another - this will work and has been done, but not every feature is supported. In in doubt, ask [https://world.secondlife.com/resident/3c637a3e-370e-4bca-b18e-92b4692a685a Arrehn Oberlander].
	* '''Buffer Zones for Rezzing''': Make sure your performance area where you will be rezzing sets, props, and backdrops has at least a 20 meter buffer space between it and the edge of the region. Automatic rezzing of large objects close to region borders can cause problems due to built-in SL limitations. Also make sure that your stage floor is at least a few meters above the ground terrain floor, and at least 50 meters below the 4096 maximum-buildable altitude limit.		* '''Buffer Zones for Rezzing''': Make sure your performance area where you will be rezzing sets, props, and backdrops has at least a 20 meter buffer space between it and the edge of the region. Automatic rezzing of large objects close to region borders can cause problems due to built-in SL limitations. Also make sure that your stage floor is at least a few meters above the ground terrain floor, and at least 50 meters below the 4096 maximum-buildable altitude limit.
Line 31:		Line 31:
	<br>		<br>

	== Create a “Theater Template” ~~for choreographers to~~ build ~~acts~~ your ~~performance space away from your region~~. ==		== Best Practice: Create a “Theater Template” so you can build and plan performances without tying up your main stage. ==

	=== Why do I want to make a stage template? ===		=== Why do I want to make a stage template? ===
	In this step, we’ll describe how to build a rough-and-ready mockup of your theater, called a ‘Theater Template’. Choreographers use ~~this~~ by rezzing them in their own private build areas to plan acts for your theater. You should encourage people to use templates whenever possible to avoid competing for time in (and possibly cluttering) your actual theater outside of planned rehearsal times.		In this step, we’ll describe how to build a rough-and-ready mockup of your theater, called a ‘Theater Template’. This step is not specific to MST tools, it's mentioned because it's a best practice for theaters in general. Choreographers use stage templates by rezzing them in their own private build areas to plan acts for your theater. You should encourage people to use templates whenever possible to avoid competing for time in (and possibly cluttering) your actual theater outside of planned rehearsal times. Even if you are the only performer in your theater, there are still many good reasons to build and test most of your performance outside of the public performance area.

	=== How to make an excellent template ===		=== How to make an excellent template ===
	* '''Use Prims'''This step requires some basic but careful prim building skill. You do not need to use any fancy mesh for this, as typically you only need to make a simplified model of a rectangular, round, or spherical space. If you’re not a careful builder ask someone you trust to help out. Create full-perm plywood prims and carefully cover the entire floor of your official performance area. Your plywood should follow the shape of the performance stage as closely as possible but be slightly above it, usually around 0.01m, in places where it is visible to the audience. When you cam out and move your camera back and forth slowly, facing the performance area, you should not see any flickering textures. It is very important that the build you create have full perms so you can give them out to your choreographers easily.		* '''Use Prims'''This step requires some basic but careful prim building skill. You do not need to use any fancy mesh for this, as typically you only need to make a simplified model of a rectangular, round, or spherical space. If you’re not a careful prim builder, ask someone you trust to help out. Create full-perm plywood prims and carefully cover the entire floor of your official performance area. Your plywood should follow the shape of the performance stage as closely as possible but be slightly above it, usually around 0.01m, in places where it is visible to the audience. When you cam out and move your camera back and forth slowly, facing the performance area, you should not see any flickering textures. It is very important that the build you create have full perms so you can give them out to your choreographers easily.
	* '''Cover floors, walls, and ceilings''' As a rule a thumb, for parts of your performance area were your individual set designers and choreographers are likely to want to customize a background texture, make sure your prims extend OUT 0.1m, so that the plywood is exposed. Conversely, for areas where you do NOT want performers to put custom textures over your theater, keep any edges of your prims about 0.01m INSIDE the theater build and tint them full black, so they will not show and offer a visual cue that they are “out of bounds”. This will lets designers see where their “Edges” are, but not override your theater textures. If you need more than one prim to cover all of the performance area floor, align your floor prims as perfectly as possible to avoid any visible gaps or overlaps. It may be helpful to learn how to use the build window’s “alignment tool” to help with this.		* '''Cover floors, walls, and ceilings''' As a rule a thumb, for parts of your performance area were your individual set designers and choreographers are likely to want to customize a background texture, make sure your prims extend OUT 0.1m, so that the plywood is exposed. Conversely, for areas where you do NOT want performers to put custom textures over your theater, keep any edges of your prims about 0.01m INSIDE the theater build and tint them full black, so they will not show and offer a visual cue that they are “out of bounds”. This will lets designers see where their “Edges” are, but not override your theater textures. If you need more than one prim to cover all of the performance area floor, align your floor prims as perfectly as possible to avoid any visible gaps or overlaps. It may be helpful to learn how to use the build window’s “alignment tool” to help with this.
	* '''Avoid Flickering''' Zoom your camera in and out of your build a little. If you see flickering textures from the floor showing through your plywood prims, make your plywood prims extend a hair further away from the stage until the flickering stops.		* '''Avoid Flickering''' Zoom your camera in and out of your build a little. If you see flickering textures from the floor showing through your plywood prims, make your plywood prims extend a hair further away from the stage until the flickering stops.
Line 46:		Line 46:
	<br>		<br>

	== Add an MST ~~Centerpoint~~ marker to your ~~stage template ==~~		== Best Practice: Add an MST centerpoint marker to your Stage Template ==
	~~=== Why should I add an MST centerpoint marker to my template? =~~==		In this step we’ll take the theater template you made earlier and modify it so thatg it marks where your choreographers should place their own MST Centerpoints when working in their personal build areas. This is useful so that when your performers are working in their own build areas, they will use centerpoints that will line up exactly with your main venue. There are actually many ways to communicate where the centerpoint should go, but here we will simply assume you are adding a marker in to your stage template.
	In this step we’ll take the theater template you made earlier and ~~make sure~~ it marks where your choreographers should place their own MST Centerpoints, when working in their ~~workspace area~~.

	# Rez your theater template and place it over your actual stage as exactly as possible.		# Rez your theater template and place it over your actual stage as exactly as possible.
	# Create a new box prim, call it “<name of your centerpoint> MST centerpoint goes here”, color it red and shrink it to a small size, smaller than the actual MST centerpoint.		# Create a new box prim, call it “<name of your centerpoint> MST centerpoint goes here”, color it something bright such as red, and shrink it to a small size, smaller than the actual MST centerpoint.
	# Copy the coordinates of your theater’s MST centerpoint you set up in step 1. Paste these coordinates into your box prim so that it will move exactly on top of your MST centerpoint.		# Copy the coordinates of your theater’s MST centerpoint you set up in step 1. Paste these coordinates into your box prim so that it will move exactly on top of your MST centerpoint.
	# Copy the rotation values of your theater’s MST centerpoint you set up in step 1. Paste this rotation into your box prim so that it will face the same direction as your MST centerpoint.		# Copy the rotation values of your theater’s MST centerpoint you set up in step 1. Paste this rotation into your box prim so that it will face the same direction as your MST centerpoint.
	# Link your box prim to your theater template.		# Link your new box prim centerpoint marker to your theater template.

	You’re done! Distribute this new template to your choreographers as usual.		You’re done! Distribute this new template to your choreographers as usual.

			== Best Practice: Set up a "Curtain" mechanism if you haven't already ==

			This step is not specific to MST, but many stages find it useful to create some kind of curtain that can obscure the performance area from view, so that set changes can happen more elegantly and be revealed in a well-managed surprise. Almost anything can work as a curtain, and there are many on the SL marketplace. There is also a "Smart Curtain" included in the MST package you are welcome to use. Once you've set up a curtain, give out the curtain controls or HUD to any staff or helpers that need access.

	== Optionally set up Theater Furniture for Scripted Camera Capability ==		== Optionally set up Theater Furniture for Scripted Camera Capability ==

Line 68:		Line 72:
	# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)		# If your custom seating supports more than one avatar sitting on it at one time, unpack the “MST allow more seated avs” box and copy scripts as needed into your furniture. For example, if your furniture supports 3 avatars, copy “~camSeat2” and “~camSeat3” scripts into your furniture. You can copy and rename this scripts if needed to support larger amounts of avatars on a single chair. (CAUTION: when one avatar stands up or crashes in the middle of a scripted camera sequence, this causes some minor disruption to other avatars seated on the same piece of furniture. This is an SL limitation.)
	# You’re finished setting up seating.		# You’re finished setting up seating.
			<br>



	=== Optionally Create a Camera Reset Mechanism ===		=== Optionally Create a Camera Reset Mechanism ===