Authoring muvee Styles

Introduces the mechanics of creating a new style based on an existing one.

Describes the structure of a typical muvee in terms of its parts. You need to know this as a style author before the rest of the documentation will make any sense.

.... walk you through authoring muvee styles.

Describes the contents of a style’s "data.scm" file. This file defines everything that is unique about your style, so understanding how to edit this file is important.

Lists all the currently available primitive effects and transitions, describes what they do, what their parameters are, etc. A useful reference when authoring styles.

Gets you Scheme-literate in a sprint. If you are familiar with Scheme or muSE, you can skip this. It is more for those new to both.

Contents

    1 License

    2 Getting Started

      2.1 Setup

      2.2 Copy the blank template style

      2.3 Change the name and description of your style

      2.4 Add a visual effect

      2.5 Style icon and preview (optional)

      2.6 Launch muvee Reveal

      2.7 Now what?

    3 Style Package Structure

      3.1 Location

      3.2 Package contents

        3.2.1 icon.png

        3.2.2 preview.wmv

        3.2.3 strings.txt

        3.2.4 data.scm

      3.3 Resources

      3.4 Creating a variant style

      3.5 More about strings.txt

    4 Anatomy of a muvee

      4.1 Automatic editing

    5 Tutorials

      5.1 Adding a new theme to Scrapbook

      5.2 Basic editing

      5.3 Putting a bounce into the Reflections style

    6 Specifying Style Behaviour

      6.1 muSE

      6.2 The style-parameters section

        6.2.1 continuous-slider

        6.2.2 discrete-slider

        6.2.3 switch

        6.2.4 one-of-many and one-of-few

        6.2.5 color

        6.2.6 Responding to style parameters

      6.3 Title and Credits

      6.4 Controlling a style’s music response

        6.4.1 Segment duration pattern

        6.4.2 Segment duration scaling factor

        6.4.3 Transition duration scaling factor

        6.4.4 Time warping

        6.4.5 Music descriptors

      6.5 Descriptor matching

      6.6 The shot vector transform

        6.6.1 The shot object

        6.6.2 Basic shot properties

        6.6.3 Presentation properties

          6.6.3.1 shot.treatment

          6.6.3.2 shot.presenter

          6.6.3.3 shot.entry-effect and shot.exit-effect

        6.6.4 Utility functions

      6.7 Miscellany

    7 About effects and transitions

      7.1 Introduction

        7.1.1 Terminology

      7.2 Primitive effects

        7.2.1 Effect name

        7.2.2 Input pattern

        7.2.3 Parameter specification

        7.2.4 Types of values

        7.2.5 File and directory values

        7.2.6 Fixed parameters

        7.2.7 Explicit animation curves

        7.2.8 Computed animation curves

      7.3 Combining effects

        7.3.1 effect-stack

        7.3.2 transition-stack

        7.3.3 layers

        7.3.4 remap-time

      7.4 Variable effects

        7.4.1 Using computed parameter values

        7.4.2 Using sequences

        7.4.3 Using effect-selector

        7.4.4 Responding to music descriptors

        7.4.5 Using special conditionals

        7.4.6 Controlling effects with style parameters

      7.5 Music triggered effects

        7.5.1 triggered-effect

      7.6 Transitions

      7.7 Segment information functions

      7.8 Source information functions

      7.9 Render information

      7.10 Unit helper functions

      7.11 Getting into deep waters

        7.11.1 What is an effect?

        7.11.2 Rolling your own effects

        7.11.3 The effect primitivity restriction

        7.11.4 Rolling your own effect combinators

      7.12 A note on Image Operators

      7.13 Applications of effects

        7.13.1 The segment effect

        7.13.2 The global effect

        7.13.3 The transition

        7.13.4 Title to Body and Body to Credits transitions

    8 Sound effects

      8.1 (sound ....) syntax

      8.2 Unit helper functions

    9 List of primitive effects and transitions

      9.1 Alignment

      9.2 Alpha

      9.3 Blur

      9.4 BlurLayers

      9.5 Cg

      9.6 ColorQuad

      9.7 ColorMapRGB

      9.8 ColorSelect

      9.9 CropMedia

      9.10 CrossFade

      9.11 Desaturate

      9.12 Distort

      9.13 Flip

      9.14 FragmentProgram

      9.15 GradientFade

      9.16 GradientFade_ColorBorder

      9.17 Greyscale

      9.18 HeightMap

      9.19 Light

      9.20 LookAt

      9.21 Mask

      9.22 Material

      9.23 MovingPolygons

      9.24 OldMovieLines

      9.25 OldMovieScratches

      9.26 PageCurl

      9.27 Perspective

      9.28 PictureQuad

      9.29 RadialBlur

      9.30 RapidOverlay

      9.31 Reflect

      9.32 ReflectAndRipples

      9.33 RGBtoYUV

      9.34 Rotate

      9.35 Saturate

      9.36 Scale

      9.37 SeamlessBackground

      9.38 Sepia

      9.39 Shatter

      9.40 Snow

      9.41 TextOut

      9.42 TextureSubset

      9.43 Translate

      9.44 VertexProgram

      9.45 VolumetricLights

    10 ShowTime - the muvee timeline

      10.1 video

      10.2 video-loop-track

      10.3 with-inputs

      10.4 Lower level functions

        10.4.1 mes:video

        10.4.2 mes:image

        10.4.3 Working with image data during construction

    11 Utility functions

      11.1 fetch-uri

        11.1.1 Exceptions with fetch-uri

    12 A Gentle Introduction to muSE

      12.1 Expressions

      12.2 Evaluating an expression

        12.2.1 List expressions

        12.2.2 Quoted expressions

      12.3 Functions

      12.4 Applying operators to operands

      12.5 Truth and falsehood

      12.6 Conditional evaluation

        12.6.1 if

        12.6.2 case

      12.7 Temporary names using let

      12.8 Recursive functions

    Index

Last updated: Friday, May 13th, 2011