Advanced Editing

These pages document advanced editing of sessions in Yuukspace. Beginners Beware!

Custom CSS in Spirals
Advanced Settings
YuukSpace Script (YSS)

Custom CSS in Spirals

Custom CSS is a powerful tool in spiral sessions that let you edit virtually anything style-wise in a session.

Some key elements are:

.distractor - Classic Distractors
```
.distractor {
  color: white
}
```

.focus-line - Contains the text that is center-focused on the screen

.focus-line {
  animation: breathing 4s linear infinite;
  font-family: sans-serif;
  color: #DDE;
  text-shadow: -1px 0 black, 0 1px black, 1px 0 black, 0 -1px black;
  font-size: 4vh;
  text-wrap: none;
  overflow: hidden;
  z-index: 30;
  text-align: center;
  margin-top: -0.25em;
}

#spiral-gif - Contains the Spiral if the Spiral is an Image (.gif) (If in VR Mode, use .gif-fit). By default, the spiral is:

#spiral-gif, .gif-fit {
    position: absolute;
    width: 50%;
    height: 100%;
    top: 0;
    opacity: .3;
    z-index: 1;
    background: url(/static/utils/large.gif) no-repeat center center;
    background-size: cover;
    overflow: hidden;
    text-align: center;
}

#image - Contains the Breathing Image Background. Images are set in the style attribute of the #image <div> as a background.

#image {
    animation: _ngcontent-ng-c139187180_zoomin 1.5s linear infinite;
    position: absolute;
    top: 0;
    width: 50%;
    height: 100%;
    background-repeat: repeat;
    background-position: center center;
    background-size: contain;
    overflow-x: hidden;
    overflow-y: hidden;
    overflow: hidden;
}

Additional Baked-in Fonts

heartFont - Makes font appear in block lettering with hearts.
```
.focus-line {
  font-family: 'heartFont', sans-serif;
}
```
dumbassFont - Makes font appear with some characters randomly rotating backwards
```
.focus-line {
  font-family: 'dumbassFont', sans-serif;
}
```

Baked-in Animations

breathing - Makes text or images appear to be breathing in and out.
Example Usage:
```
.focus-line {
  animation: breathing 4s linear infinite;
}
```

Advanced Settings

Found at the bottom of the Session Settings page of any given session, the Advanced Settings frame can be selected to open up a configuration area for a variety features. While the default configuration settings are often more than enough for a given session, the Advanced Settings will provide you with an array of new options to tweak and modify sessions to your own personal tastes.

While all session types contain an Advanced Settings configuration area, not all types contain the same configuration options. For the purposes of this guide, we'll be using the Advanced Settings menu from a Brainwash Spiral Task. This is because - with the exception of Write Lines Tasks - Brainwash and Mantra tasks contain all options from other task types. Individual Advanced Settings guides may be added to the individual session type pages of this wiki in the future if they become necessary.

Advanced Settings for sessions entail the following configuration options:

Audio URL - This option will allow you to add a link to an audio track that will play while a subject runs the session. This can be a hypnotic file, ambient noises or music, static, or really whatever else you'd like. If the session lasts longer than the audio file's length, the track will automatically repeat once it reaches its conclusion.

Please note that the link must point directly to the file, meaning a link that ends in .mp3, .flac, .wav, etc. Links to Youtube, Soundcloud, etc. will NOT work. If you don't have your own place to host such files, you can use the Stash page to upload any necessary media and receive valid links for them.

Spiral URL - As with the Audio URL settings, this setting will allow you to add a link to an image, animation, or video that will replace the default spiral that plays over Brainwash, Mantra, and Advanced Spiral Tasks.

Please note that this doesn't necessarily need to be a spiral. It can be anything that you'd like to transparently display over your sessions. Get creative!

Also similar to the Audio URL option, any links must point directly to the file. Again, the Stash page is your best friend for this if you don't have your own hosting solution.

Spiral Opacity - This option will allow you to customize the transparency of the spiral in use, whether it's the default spiral or a custom one you're using via the Spiral URL option. Any number between 0 and 1 is a valid entry, with 0 indicating full transparency (you won't see the spiral at all) and 1 indicating full opacity (you will ONLY see the spiral).

Image Switch Frequency - This option determines how long an image will be displayed on the screen before a new one is displayed. The lower the amount configured, the faster the images in your session will cycle.

This setting will make the difference between the images in your sessions looking like a fast-paced subliminal blur or a slow and leisurely slideshow.

BST: Word Duration/MST: Line Duration - This option determines how long a word or line (depending on whether this is a Brainwash or Mantra Spiral Task, respectively) stays on the screen before cycling to the next word or line. The number configured in this option, along with the Image Switch Frequency option, will set the pace for your session.

If you want your subject to take time to read each word or line carefully, you might set this number higher. If you'd like them to be forced to read as quickly as possible without dwelling on any particular word or line, you might set it lower.

Distractor Base Frequency - This option determines how long a session will wait after a distractor is spawned before a new one is generated. Lowering this number will result in distractors spawning in more quickly. Increasing it will cause them to take longer to spawn.

Distractor Duration - This options determines how long a distractor will stay on the screen before disappearing. A higher amount of milliseconds will result in distractors staying on screen longer, while a lower amount will result in a shorter length of display.

Distractor Duration can be combined with the Distractor Base Frequency option to great effect. For example, a low frequency time and a high duration time will cause a large amount of distractors to appear and stick around, "cluttering" the screen with suggestions.

Distractor Wall Re-render Frequency - This option determines how long a text wall will display on screen before a new one is generated and replaces it. A longer duration will leave the text wall on screen for a longer period of time, while a shorter one will reduce the time the wall is displayed.

Distractors have random activation - As its description states, this option will randomize the frequency at which distractors are displayed, using the Distractor Base Frequency as the base number for the randomization function.

Distractor Types - Consisting of Wall and Classic-type distractors, these options will enable distractors of the selected type.

Wall distractors will create a wall of text using any entered Distractor Lines, then apply that wall over the session with a transparency filter, similar to the way that spirals are displayed. This text will shift depending on the amount of time configured under Distractor Wall Re-render Frequency.

Classic distractors will display any entered Distractor Lines in random locations on the screen. The frequency with which they appear and the length that they stay on screen can be modified using the Distractor Base Frequency and Distractor Duration options, respectively.

Both options may be enabled at the same time.

Custom CSS - In the context of Yuuk.space, CSS is used to customize the design, layout, and variations in display for your sessions. The most common usage for it will be to customize the text being displayed. For example, you can use CSS to specify a font to use in a session, as well as change font size, color, and animations.

For more information on this subject, please see the Custom CSS in Spirals page.

Delete Session - Found under the aptly-named Danger Zone section of the Advanced Settings configuration area, this button will delete the session. Simply select it, confirm the deletion, and the session will be erased.

YuukSpace Script (YSS)

YuukSpace Script (YSS) is the scripting language used in AST sessions.

YSS allows you to fire custom events and define different blocks within the same session.

Example Script:

[anchor;id=top]
[setting.session.type=bst]
[setting.spirals.line_duration=1500]
[controller=random]
[block=start;id=initial]
[setting.session.type=mst;id=initial]
[setting.spirals.line_duration=2000;id=initial]
[style.text.main.color=#FF0000;apply=1] This is a test of the first block
Second line
Third Line[sound=/static/testing/ding.mp3]
[block=end;id=initial]
[block=start;id=bsttest]
[setting.session.type=bst;id=msttest]
[setting.spirals.line_duration=1000;id=msttest]
This is a test of the BST block
BST block tests are cool [sound=/static/testing/ding.mp3]
[style.text.main.color=#FF0000;apply=1] BST application is fun
[block=end;id=bsttest]

Element Reference

[anchor] (Not Yet Implemented)

Allows you to define a location in the script to go to, with required extra parameter id denoting the unique name of the location.

Usage:

[anchor;id=backhere]
.....
[block=end;id=someOtherPlace;goto=backhere]

[setting.*]

Used to define settings for the session. Pass the extra attribute `id` to denote that the parameter should be associated with a certian block session.

Current Settings Implemented:

[setting.session.type=sessionType] - Sets the session type. Supported Session Types: bst (Brainwash Spiral Task), mst (Mantra Spiral Task)
[setting.spirals.line_duration=durationHere] - Determines how long the line/word should be on the screen. durationHere should be time in Milliseconds.

[style.*]

Used to define on-screen style changes. Extra attributes include `id` to denote that the style change should only occur in the block and `apply` that accepts a positive number or the word 'always' to determine how long the style change should last for.

[style.*] is usable inline in BST and MST sessions.

Current Style Implemented:

[style.text.main.color=hexGoesHere] - Sets the color of the session center text using a Hexadecimal Representation. (i.e. #0066FF)
[style.text.main.add_class=classNameHere] - Adds an arbitrary class to the session center text. Class name can only be one and should not include the CSS selector (.)
[style.text.main.size=sizeHere] - Changes the size (All CSS units of size accepted) of the session center text.
[style.text.main.font_family=fontFamilyHere] - Sets the font family css attribute for the session center text. Accepts a string. Single Quotations should be around custom font families.

[sound]

Used to play a sound effect. Takes no attributes. URL for Sound can be direct or relative.

[sound] is usable inline in BST and MST sessions.

[controller] (Not Yet Implemented)

Used to determine how the session's blocks are controlled. Two valid choices are `sequential` (default) and `random`. Sequential will go down the list of blocks in order, random will generate a random list from the available blocks and play them in that order. Note: If you select Random, any text outside of a block will be played at the end of the randomized block list no matter where it is in the script.

[block]

Block is used to create a compartmentalized session within an AST session. Blocks require a start value and an end value, with each containing the ID attribute. Block End Values can also include the optional goto attribute to jump to another part of the session forward or backward. Warning, at the current time of development, jumping backward will create an infinite loop that will make the AST session impossible to finish. Blocks can have localized settings by denoting the ID attribute on settings tags.

[setting.spirals.line_duration=1500] # Set line duration to 1500ms globally.
[setting.session.type=mst] # Set global session type to MST
[controller=sequential]
Welcome
Lets begin
Be a good subject.
[block=start;id=lineChange]
[setting.spirals.line_duration=2000;id=lineChange] # set line duration to 2000ms for the lineChange block only. After the block is finished, the global settings will be back in play.
[setting.session.type=bst;id=lineChange] # Set this block only to be an BST session. After this block, global settings will take back over.
This is a test
I love tests
I am a good test. [sound=/path/to/positve.mp3]
This is a test
I love tests
I am a good test. [sound=/path/to/positve.mp3]
This is a test
I love tests
I am a good test. [sound=/path/to/positve.mp3]
This is a test
I love tests
I am a good test. [sound=/path/to/positve.mp3]
[block=end;id=lineChange]