TupiTube Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
;#;
[[start#Tupi's First Animation Exercise|Back to Main Page]]
;#;
=====A Very Basic Example=====
====1. First things, first!====
Tell a story! Do you have a story to tell? It's the first step to create an animation project. Usually, newbies start drawing over the first frame from Tupi's Animation Module, not having the slightest idea about what will happen in the last frame of their projects; this definitely is not a good strategy to create your first animation exercise.

As any kind of project, animations also require a minimum level of planning. Before grabbing the pen or the mouse in your computer, take a moment to think about your idea and ask to yourself: What is the story I want to tell? No matter how small your project is, invest a few minutes to think about the details that will take part of your animation. Try to answer questions like these: Which are my characters? How they will look like? Where they will come from? Where they will move toward? How many scenes will you include in your project? The bigger your animation is, the answers to all these questions require more specific details.

For professional animators, the result of this planning is reflected in a document known as the **script**, which contains the whole story, references and descriptions of the animation project. The script will be the recipe  that an entire team of animators will have to follow to make that project come true. 
Understanding that as newbie you are your own team, you must not despise the idea of writing your own scripts. This is a good exercise to make you a great animator. When you think of the importance of writing your script, think about the importance of the blueprints for an architect or the music scores for a musician.

For our first example, we have chosen a very simple idea: let's create a basic animation of a butterfly flying around the canvas, following a path like this:

{{ wiki:basic_example_butterfly_path.png }}
;#;
**Fig 1**. Butterfly's path
;#;

The butterfly will appear from the left side of the screen, moving to the right and disappearing in just few seconds. That's all folks.
Probably you're thinking that we could try more complex and interesting animations, but remember that this is just our first example. Our goal right now is just to get used to the Tupi basic resources.
 
Well, now that we have created the mini-script for our example, let's get to work!
-----
====2. Starting a new project====

It's time to run Tupi for the first time:

{{ wiki:basic_example_tupi_ui.png }}
;#;
**Fig 2**. Tupi main window
;#;

At this point you have two options, either to create a new project or to open an existing one. As this is our first time, we will create a new project by clicking on the first icon of the top toolbar:

{{ wiki:basic_example_new_icon.png }}
;#;
**Fig 3**. Creating a new project
;#;

A small dialog will show up on your screen. You will have to enter some basic information about your animation project: a file name, the author name, the size/resolution of our animation in pixels, the background color and the frames per second (FPS) we want to use initially.

For this example, we are going to fill in just the first two fields of the form, using the default values for the other parameters:

{{ wiki:basic_example_new_dialog.png }}
;#;
**Fig 4**. New project dialog
;#;

When you click the OK button, the Tupi workspace is set to start our project. The starting point is always the Animation module and more specifically, a blank canvas containing the first frame of our animation. Ok, we're ready to start drawing!
-----
====3. Drawing Time!====
Every time we create a new project, the **Animation tab** is selected, the **Pencil** tool is enabled by default and our canvas is pointing to the first frame of our timeline, so we are ready to illustrate!

{{ wiki:basic_example_animation_module.png }}
;#;
**Fig 5**. Animation module
;#;

Now, let's start drawing a line. It will be the reference path to guide the flight of our butterfly. Note that this is an item that we will use as a temporal helper to draw our animation. As we need it in every frame, we will add it from the **Static Background Mode**. To activate this mode, we need to select it from the first combo in the top panel: 

{{ wiki:basic_example_animation_modes.png }}

{{ wiki:basic_example_static_bg.png }}
;#;
**Fig 6**. Enabling static background mode
;#;

Time to draw our first line!

{{ wiki:basic_example_path01.png }}
;#;
**Fig 7**. Drawing a line
;#;

Notice that you can adjust the reference path using the **Nodes Selection** tool, available from the left side toolbar:

{{ wiki:basic_example_nodes01.png }}
;#;
**Fig 8**. Nodes selection tool
;#;

When you select the reference path clicking on it, a bunch of green nodes will show up and your path will look like this:

{{ wiki:basic_example_path02.png }}
;#;
**Fig 9**. Activating nodes selection
;#;

Now, try to smooth your reference path editing the nodes that you consider are requiring some adjustment. Our goal here is to define the definitive flying route for our butterfly. The final result should be something like this (more or less):

{{ wiki:basic_example_path03.png }}
;#;
**Fig 10**. Final reference path
;#;

As our reference curve is done, we have to get back to the **Frames Mode** to start our animation: 

{{ wiki:basic_example_frames_mode.png }}
;#;
**Fig 11**. Enabling frames mode
;#;

Time to draw our main character. The first thing we'll do is to adjust the thickness of our pencil by clicking on the **Brush Properties** button located in the external left sidebar: 

{{ wiki:basic_example_brush_properties.png }}
;#;
**Fig 12**. Brush properties panel
;#;

Choose the size you want for the pencil brush:

{{ wiki:basic_example_brush_thickness.png }}
;#;
**Fig 13**. Setting the pencil thickness
;#;

Now, all we need is to choose the color we want to use for our first sketch. To do this, we must click on the **Color Palette** button, located on the external left sidebar:

{{ wiki:basic_example_color_palette.png }}
;#;
**Fig 14**. Color palette
;#;

We will choose a brown color for the butterfly body and some blue for the wings. So, let's start with brown:

{{ wiki:basic_example_brown_color.png }}
;#;
**Fig 15**. Selecting brown color
;#;

Ok, now pick the **Pencil** tool and start drawing:

{{ wiki:basic_example_pencil_tool.png }} {{ wiki:basic_example_sketch01.png }}
;#;
**Fig 16**. Drawing the butterfly body
;#;

Following with the wings, change the pencil color and finish the first position of our butterfly. Remember that we are still drawing in the frame #1:

{{ wiki:basic_example_blue_color.png }} {{ wiki:basic_example_sketch02.png }}
;#;
**Fig 17**. Drawing the butterfly wings
;#;

It's a good practice to save your projects from time to time while you are working on it. So, let's save it. 

{{ wiki:basic_example_save_project.png }}
;#;
**Fig 18**. Saving project
;#;

Ok, the first frame of our animation is done. Now we must draw the rest, so let's create more frames.
-----
====4. Adding new frames====
It's time to add more frames to our project. Let's do it from the Exposure Sheet panel located at the right side of Tupi's interface. The procedure is pretty simple, you just have to click on the second cell of the only column in the panel. In other words, you are selecting the **Frame #2** from the **Layer #1**, just like this: 

{{ wiki:basic_example_adding_new_frame.png }} 

{{ wiki:basic_example_new_frame.png }}
;#;
**Fig 19**. Adding a new frame
;#;
We'll repeat this procedure every time we need a new frame. For now, it's time to work on the second one, so we'll need to draw our butterfly in a new position, but before we have to activate the **Onion Skin** feature to see the previous frame as a reference in our canvas:

{{ wiki:basic_example_onion_skin.png }} 

{{ wiki:basic_example_onion_control.png }}
;#;
**Fig 20**. Activating onion skin
;#;

With this handy resource, we can realize the current position of the objects and characters that we are animating from previous and next frames. Did you notice that before activating the **Onion Skin**, Frame #1 was completely invisible? Well, now it looks like the Frame #2 were translucent:

{{ wiki:basic_example_skin_in_action.png }}
;#;
**Fig 21**. Onion skin feature in action
;#;

Using the information of the first frame as reference, we'll draw the butterfly again, but this time moved a little forward:

{{ wiki:basic_example_sketch03.png }}
;#;
**Fig 22**. Drawing the butterfly in the second frame
;#;

Ok, now we'll add a third frame, but before continuing we will enable the visibility of more previous frames (10 for this example) from the **Onion Skin** control, so you could see how your animation is progressing as you add more frames:

{{ wiki:basic_example_adding_third_frame.png }} 

{{ wiki:basic_example_ten_previous.png }}
;#;
**Fig 23**. Adding third frame and rising to 10 the previous frames in the onion skin control
;#;

**Tip:** You can enable the **Onion Skin** feature either for previous and next frames. So, feel free to set as many frames backward and forward as you want to. This functionality will help you to develop smooth animations. 

Now, we'll continue drawing our third frame following exactly the same steps we took before:

{{ wiki:basic_example_sketch04.png }}
;#;
**Fig 24**. Drawing the butterfly in frame #3
;#;

At this point, it's very likely that you wonder: How many frames are we going to need for this animation? Well, that's a good question you'll learn to answer by yourself as you create more and more projects. Practice is the key, nevertheless there are factors that help you to calculate this value: scene complexity, the frames per seconds you choose, etc.
For now, we will draw as many frames as we need to complete our mini-script:

{{ wiki:basic_example_sketch05.png }}
;#;
**Fig 25**. Drawing the butterfly in frame #6
;#;

{{ wiki:basic_example_sketch06.png }}
;#;
**Fig 26**. Drawing the butterfly in frame #9
;#;

{{ wiki:basic_example_sketch07.png }}
{{ wiki:basic_example_sketch08.png }}
{{ wiki:basic_example_sketch09.png }}
{{ wiki:basic_example_sketch10.png }}
;#;
**Fig 27**. Screenshot of frames #21, #31, #45, #46
;#;

**Tip:** For this exercise we had to work on 73 frames. Now, it's very important to keep something in mind: you don't have to draw the last frame of your project in order to visualize how your animation is progressing. In fact, it's a good habit to check it every few frames, to ensure that your frame's composition is creating the result that you are expecting for your project. So, let's take a look at it.
-----
====5. Time to preview our project!====
Ok, we already have half the frames of our animation done, so it's time to visit the **Player** module. Now, there is no general rule about how many frames you need to create before making a preview of your project. This is another skill that you'll have to develop with practice. In other words, you choose whenever you want to preview your works while you are animating.

{{ wiki:basic_example_player_preview.png }}
;#;
**Fig 28**. Preview of the project from the Player module
;#;

Additionally, keep in mind that to play your on-going animation doesn't affect your project at all, so you can do it as many times as you want to. The main goal of this feature is to provide you a way to check the progress of your project, so you can detect and fix any issue early, ensuring the final result that you are expecting.
The preview interface is quite straightforward and easy to use, besides the **Control Panel** contains all the options necessary to play your animation, either frame by frame or completely.

{{ wiki:basic_example_player_controller.png }}
;#;
**Fig 29**. Player control panel
;#;

At the bottom of the module, you will find a **Properties Panel** full of handy information about the project: the name of the current scene, the frames total of the scene, the scene duration and the frames per second (FPS) current value. The FPS parameter is editable, so you are able to adjust it depending on how fast you want to play your current animation. The larger FPS value, the faster your scene will go. Therefore a smaller value will produce a slower reproduction.  

**Tip:** The Loop option is a handy feature if your scene have few frames and you want to appreciate how smooth your animation is going. You can enable or disable it anytime.

{{ wiki:basic_example_loop.png }}
;#;
**Fig 30**. Player loop checkbox
;#;

Ok, now it's time to continue our project adding and drawing more frames to complete the whole reference path, according to our script. 
So please, review the previous section and finish all the pending frames for your project. It's likely that you feel exhausted of drawing so many illustrations after a while, but this is part of the frame-by-frame animation technique and that's the reason we chose a simple character for this first exercise. 

Are you done with all the missing frames? Well, It's time to remove the reference path we created at the beginning of this exercise. So, go back to the **Static Background Mode**, activate the **Object Selection** tool and pick the curve, then remove it clicking on the **Trash** icon and get back to the **Frames Mode**.

**Note:** As optional task, you could illustrate a background for the butterfly flight from the **Static Background Mode**. In fact, we did it for this example, but it's up to you. 

{{ wiki:basic_example_object_selection.png }}
;#;
**Fig 31**. Object selection tool
;#;

{{ wiki:basic_example_trash_icon.png }}
;#;
**Fig 32**. Trash icon
;#;

Now, are you agree with the result you watched from the **Player** module? Ok, then it's time to create our first video file!
-----
====6. Exporting to video file!====
Once your animation project is done, it's time to export it as a video file so you can publish it and share it. To do this, we have to open the **Player tab** and click on the **Export** button.

{{ wiki:basic_example_export_feature.png }}
;#;
**Fig 33**. Export feature
;#;

A wizard dialog will show up. The first thing you have to choose is the format/extension you want for the video file:

{{ wiki:basic_example_export_wizard01.png }}
;#;
**Fig 34**. Format selection dialog
;#;

In the second dialog, you have to select the scenes of your project that you want to export. In this case, it's only one:

{{ wiki:basic_example_export_wizard02.png }}
;#;
**Fig 35**. Scene selection dialog
;#;

Finally, in the third dialog you have to set the name for your video file and the path where you want to export it:

{{ wiki:basic_example_export_wizard03.png }}
;#;
**Fig 36**. File export dialog
;#;

Once you clicked on the **Export** button, your video file will be created. Depending on the number of scenes and the frames total, this process could take either seconds or minutes. When it finally finishes, you will be able to reproduce your video file from any media player. We are done!

{{ wiki:basic_example_video.png }}
;#;
**Fig 37**. Final result
;#;

**Note:** Either the {{wiki:example.tup|source file (.tup)}} and the [[https://www.youtube.com/watch?v=QjiIVEgH6HI|video]] of this basic example are available in case you want to take a closer look at them. We hope this exercise inspires you to create your own animation projects, so keep practicing! 
-----
;#;
[[start#Tupi's First Animation Exercise|Back to Main Page]]
;#;