Giter VIP home page Giter VIP logo

blender-fountain-addon's Introduction

Fountain script add-on for Blender

About

This add-on allows Blender to use Fountain to describe a storyboard or a screenplay if you prefer.

Watch this introduction video for an overview.

Motivation

Storyboarding is hard. Inside Blender, we can use grease pencil to help draw the animation. However, a script must start from somewhere and that's where a good fountain script can help you out. It's a simple markup language that allows you to quickly show actions and dialogues for a screen play scene. Something like

EXT. BRICK'S PATIO - DAY

A gorgeous day.  The sun is shining.  But BRICK BRADDOCK, retired police detective, is sitting quietly, contemplating -- something.

The SCREEN DOOR slides open and DICK STEEL, his former partner and fellow retiree, emerges with two cold beers.

STEEL
Beer's ready!

BRICK
Are they cold?

In turn, this simple text can be used to generate a PDF. The later requires an application. You can browse the Fountain apps page for a list of those. Personally, I find that CinemaVision Fountain Editor does a very good job, is full featured and it's free.

In the source, there is a fountain script and the resulting PDF.

Once you're happy with the script, use this plugin and start to add the grease pencil elements to get your scene to come to life. The source contains an example blend file with a really bad storyboard in grease pencil. I'm not exaggerating, it's bad... Still, if you import the script with the add-on and do play (make sure to click on show information) you'll quickly see the value of mixing fountain scripts and Blender.

Installation

Do the usual install from disk by specifying that you want to install from disk. You can grab the release from GitHub.

  • In File / User Preferences, select add-ons
  • Click on "Install Add-on from file"
  • Save user settings
  • The addon is inside the Animation tab of the toolbar

Features

This animation add-on allows you to:

  • Import a fountain script
    • This adds markers to elements inside the script like
      • Section headers
      • Scene headers
      • Transitions
      • Dialogue
      • Actions
  • View the fountain elements on the View3D
    • Click on 'Show Scene Information' to enable this
  • Click on a fountain marker to
    • quickly jump in the timeline
    • move the cursor to the appropriate line in the script
  • Clear all markers
  • Update the fountain script
    • This adds notes that identify the frame and duration of each element.
  • Clean Script
    • This removes the notes to have a cleaner version of the script. Useful when exporting the text.
  • Print markers
    • prints the time and the marker's content. Useful for YouTube (I guess)
  • Sync markers
    • after you move the markers around make sure that fountain is aware of the changes.

Usage

  • In the text editor, open or write a fountain script.
  • In the fountain add-on under the animation tab, select the script
  • Click import
  • Notice that markers are added to the timeline
    • Default duration is 0.5 seconds per word and 1 second per action phrase.
  • Click on a scene element
    • Notice the timeline moves
    • Notice the text cursor is moved
  • Enable the 'show scene information' to view onscreen information about the scene inside the 3D viewport.
  • Add greasepencil or other elements to complete your story board

Disclaimer

It's my first add-on for Blender, please let me know how to improve it.

blender-fountain-addon's People

Contributors

philippe-lavoie avatar tin2tin avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

tin2tin

blender-fountain-addon's Issues

wow, 2.8, scenes

Hi Phil,
First of all, bravo ! It's a gem you're creating.
I'd love to see it working in Blender 2.8. I don't use 2.79 anymore, well it's still there for your add-on :)

I also tried Blender as a storyboarding tool because I prefer 3D to hand drawing and camera moves are easy to implement into a scene.

Just one thing though: Multiple scenes should be created based on fountain script. In your video, everything is created under the same Blender scene.

Can't install

1.0 installed fine, but I can't install 1.2.1. Blender 2.79b. Win 8. Meaning I can see the files are being placed in the Blender Scripts folder, but it doesn't show up among the add-ons when searching "fountain"?

The addon failed to initialize in Blender 3.4.1

On trying to activate the addon, Blender 3.4.1 gives the following error:

Report: Error
Traceback (most recent call last):
File "/snap/blender/3132/3.4/scripts/modules/addon_utils.py", line 333, in enable mod = import(module_name)
File "/home//.config/blender/3.4/scripts/addons/fountain_script_init_.py", line 28, in from . import fountain
ImportError: attempted relative import with no known parent package

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.