snuq / QuickTitling

QuickTitling Addon For Blender

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

QuickTitling Addon For Blender 4.0

This addon will create and edit simple scenes for title overlays.

Watch the demo video showing some features:
Demo Video

Watch the tutorial video showing how to make a title:
Tutorial Video

Development for this script is supported by my multimedia and video production business, Creative Life Productions
But, time spent working on this addon is time I cannot spend earning a living, so if you find this addon useful, consider donating:

PayPal Bitcoin
paypal Bitcoin Donate QR Code
1JnX9ZFsvUaMp13YiQgr9V36EbTE2SA8tz

Or support me by hiring Creative Life Productions if you have a need for the services provided.

Installation

  • Use the 'Branch' menu on the upper-left to select the branch for your Blender version
  • Download the addon from the green 'Clone or download' button, and click 'Download ZIP'
  • Open Blender, and from the 'Edit' menu, select 'Preferences'.
  • In this new window, click on the "Add-ons" tab at the left.
  • Click the 'Install...' button at the top-right of this window.
  • Browse to and select the zip file you downloaded, click the 'Install Add-on' button.
  • You should now see the addon displayed in the preferences window, click the checkbox next to the name to enable it.
  • Once installed, the interface can be found in the sequence editor properties panel.

Title Editing

When a created QuickTitle is selected, the settings can be adjusted and will be shown in real-time. It is recommended to enable OpenGL preview in the sequencer preview area to keep editing quick.

Select a title in the VSE to edit it, or select no titles to edit new presets, or create new titles.

Titles can be edited from the sequencer preview window, or from the QuickTitling panel

You can add a new title from a built-in or custom preset directly in the sequencer by pressing 'Shift-T' and selecting a preset. This will overwrite the current selected preset, and create a new title at the cursor location.
This menu will also appear as a 'QuickTitle' sub-menu in the default sequencer strip add menu.

The QuickTitling panel is divided into two sections:

Presets Selction

The top lets you select or import presets, create titles, and update the selected title.

  • Select Preset Menu

    Displays the internal presets, and all presets you have created in the current scene.
    Click on a preset name to load it into the preset editor.
    This menu will not be displayed when editing a title to prevent accidental overwrite.
    Custom presets will have a 'X' button next to them in the menu, click this to delete the preset.

  • Import Preset Button

    Opens a file dialog to browse to a saved xml preset file.
    When opened, the preset will be loaded into the preset editor, it must be saved after this.
    This will not be displayed when editing a title to prevent accidental overwrite.

  • Create New Title Button

    This will use the settings in the preset editor to create a new title in the VSE.
    This will not be displayed when editing a title.

  • Render To Image Button

    This will create a static image of the currently selected title, you will be prompted for a location to save the image.
    The original title will be muted, but unchanged, the image will be placed over it.
    This is useful for speeding up the timeline when using static (non-animated) titles.

  • Update Title Button

    This will force a manual update of all objects in the selected title.
    Use this to fix anything that might be displaying improperly, or when not using auto-update mode.

  • Auto-Update Titles Checkbox

    When activated, the title will be automatically updated when any settings are changed in the interface.
    Disable this if you wish to make several changes without slowing Blender down, or if you wish to make manual changes to the title scene.

Preset Editor

The bottom section is an editor for the currently selected preset, or title.

  • Save To Custom Titles Button

    Only activated if the current title or preset is modified.
    This will save the current title preset settings to the scene custom titles under the preset name.
    WARNING: This will automatically overwrite a custom title that already exists with the same name!
    Use this while editing a title to copy the preset back to the scene presets, so direct copies of the current title can be created.

  • Export Button

    Allows you to export your title preset to an xml file to share with others, or save for later.
    If you are exporting an existing title, a preview image will be generated in the same folder as the xml.
    Export to the script preset folder (<Blender's addon script folder>/QuickTitling/QuickTitling Presets) to have your title show up in the built-in titles.

  • Preset Name

    Give your preset a name here, this is what it will show up as in the preset menu when you save it, and it will define the name of the title scene.

  • Description

    Write some information about your title here.

  • Scene Length

    Frame length of the title scene.
    When editing a title, this will change the length of the sequence in the timeline.
    Do not change the length of the title by other means, or animations may be broken.

  • Z Depth Scale

    Determines how far apart title objects are in 3d space.
    If thick objects are colliding with each other, increase this value to spread them out.
    Note that changing this value will affect the shadows, larger values will result in larger and softer shadows.

  • Objects List

    A list of objects in this title are displayed here.
    The list order determines how close objects are to the camera. Objects higher in the list will be placed in front of objects lower in the list.
    Use the arrows on the right to change the object order.
    Click the 'X' button next to an object to delete it.
    Click on an object to select it, and edit it in the settings below.

  • Add Buttons

    Use these buttons to add new objects of the basic types.
    New objects will be placed at the top of the list.

  • Duplicated Selected

    Create a complete copy of the currently selected object in the list.

Object Editor

Edit the settings for the currently selected object.
Some settings and features will only be available for some object types.

General Object Settings:
  • Object Name

    Used to identify the object in the list.

  • Visible Checkbox

    Uncheck to disable this object in both the 3d view and in renders.

  • Text (Only For Text Objects)

    The text to be displayed by this object.
    You can add multiple lines of text using new line characters '\n'.
    Note that if you wish to put a backslash in the text, you must use two '\'.

  • Font Menu (Only For Text Objects)

    A drop-down menu showing all the loaded fonts in the blend file.
    Load additional fonts using the '+' button.

  • Wrapping Checkbox (Only For Text Objects)

    Enable word-wrapping on this text object. Use this to keep long lines from overflowing out of the view.

  • Wrapping Width (Only For Text Objects)

    Width of the text wrap area.
    A value of 1 is the full width of the screen.

  • Text Justification (Only For Text Objects)

    Determines the position of the text relative to it's center point.
    If wrapping is enabled, the text will justify to the edges of the bounding area.

  • Pos

    Use these values to position the object in the title.
    X is horizontal position. 0 is at the screen center, negative values move the object left, positive values move it right. 1 and -1 should be about the edges of the screen.
    Y is the vertical position. 0 is at the screen center, negative values move the object down, positive values move the object up.
    Z is the depth position. 0 is normal position, positive values will move the object towards the camera, negative values move it away. Because the title is in 3d perspective, this will change the horizontal and vertical positions of the object.

  • Rot

    Use these values to rotate the object in the title.
    Note that these will rotate the object around its center, so if text is left-justified, its rotation may be undesirable.
    X is the 'tilt' of the object along the X axis, positive values will rotate the object's top towards the camera, negative values will rotate it away.
    Y is the horizontal 'turn' of the object. Positive values will rotate it around to the right, negative rotate it around to the left.
    Z is the 'spin' of the object, while keeping it facing the camera. Positive values will spin it clockwise, negative spin it counter-clockwise.

  • Shearing

    Defines a 'slant' of the object, causing it to 'lean' forward or back. Positive values will 'lean' the object forward, negative 'lean' it back.
    This gives text an italic style, and will make a square into a rhombus.

  • Scale

    The overall scale of the object, changes height and width the same amount.

  • Width

    Adjust only the width of the object, make a square into a rectangle, or a circle into an oval.
    This is a multiple of the overall scale, both can be used at once.

  • Height

    Adjust only the height of the object. Like the width, this is a multiple of the overall scale.

Thickness Settings (Not For Image Objects)
  • Thickness (Not For Image Objects)

    Gives the object a 3d thickness, instead of being perfectly flat.

  • Bevel (Not For Image Objects)

    Cuts off the edges of the object, giving it rounded or squared off corners.
    Note that some fonts will not work well with this setting, if you see strange jagged edges, try a different font.

  • Bevel Resolution (Not For Image Objects)

    Resolution of the bevel, higher values result in curved corners, 0 results in sharp corners.

Outline Settings (Not For Image Objects)
  • Outline Enable (Not For Image Objects)

    Enables an outline for this object.
    This is actually a beveled copy of the object, so any issues with beveling will also show here.

  • Outline Size (Not For Image Objects)

    Size of the outline, larger numbers result in a wider outline.
    Note that setting this too high may cause strange artifacts around the object, especially on text.

  • Outline Alpha (Not For Image Objects)

    Alpha transparency of the outline, 0 is fully transparent, 1 is fully opaque.

  • Outline Color (Not For Image Objects)

    Color of the outline.
    Note that the outline will have no shading applied, it will be completely this color.

Material Settings
  • Set Material

    Enable this to display a dropdown menu allowing the material of this object to be set to a pre-existing material.
    This is useful for making multiple titles have the same material for similar objects, allowing for easily tweaking the materials of all at once.

  • Use No Shading

    Enable this to make the material of this object a solid color with no shading or specularity.

  • Cast Shadows

    Enable this to allow this object to cast shadows on objects behind it.

  • Material Color

    Basic diffuse color of the object.

  • Metallic

    How metallic the material appears. This will affect the color of the specular reflections.

  • Specular

    Set the amount of reflectivity or 'shinyness' on this object.
    0 results in no shinyness, 1 is full shinyness.

  • Roughness

    Determines how sharp or wide the specular reflections are.
    At 0 the material will have very sharp reflections, at 1 the reflections will be completely soft.

  • Alpha

    Set the transparency of this object. 0 is fully invisible, 1 is fully opaque.

  • Texture (Only For Image Objects)

    Load an image or video to display it on this object.

  • Map Image To View (Only For Image Objects)

    When checked, the image texture will be fit to the entire camera view area, instead of the size of the image object.
    In this mode, the image object itself will act as a 'mask' to make the texture visible.
    Other objects can have this texture set to them using the 'Set Material' option, for more complex masks.

  • Alpha Texture (Only For Image Objects)

    Load an image or video to control the alpha transparency of this image.
    This works best with a black and white image or video.

  • Loop Video (Only For Image Objects, Only With Video Texture)

    Enables looping on a video texture, repeat play of the video as long as needed.

  • Frame Offset (Only For Image Objects, Only With Video Texture)

    Offset the beginning of this video by a number of frames.
    Set this above 0 to cut off the beginning of the video.

  • Frame Length (Only For Image Objects, Only With Video Texture)

    The number of frames to play back of this video.
    This value will be set automatically to the length of the video when a new video is loaded.
    Set this lower than the default to cut off the end of the video.

Animations
  • Add Animation Menu

    Select an animation from this menu to add it to the current object.

  • Apply To All Objects

    Apply the animations of the current object to all objects in the title, overwriting any existing animations.

  • Animate In/Animate Out

    Enable this to animate this variable 'in' at the beginning of the title, or 'out' at the end.
    This allows things such as making the object fade in, or slide in at the beginning of the title.

  • In Length/Out Length

    How many frames to animate the variable in or out.
    Setting an alpha fade in to an in length of 15 means it will take 15 frames for the object to become fully visible.

  • In Frame Offset/Out Frame Offset

    Distance from the start or end of the title that the animation will take place.
    Setting the In Frame Offset to 30 will delay the in animation by 30 frames.
    Setting the Out Frame Offset to 30 will make the out animation end 30 frames before the end of the title.

  • In Amount/Out Amount

    The value that the in or out animation will end on.
    Set this to 0.5 for an alpha in animation to start the object at half visible, and fade to fully visible.

  • Animation Cycle Menu

    Select a cyclic animation from this menu to enable repeated animation on this object.
    Random - Results in a randomized animation curve. Useful for making an object randomly jump around.
    Sine - A smooth animation curve regularly alternating between high and low. Useful for making an object wobble back and forth.
    Tangent - Starts at one extreme value, slows down, and ends at another extreme. Useful for making an object spin.

  • X Scale (Only When Animation Cycle Enabled)

    Scales the animation curve along the time axis.
    Larger values results in longer animations.

  • Y Scale (Only When Animation Cycle Enabled)

    Scales the animation curve along the amplitude axis.
    Larger values result in higher animation values.
    Set this to negative to invert a tangent curve.

  • Offset (Only When Animation Cycle Enabled)

    Time offset of animation curve.
    Use this to desync multiple animation curves of the same type.

Title Lighting

This section controls the light positions and shadows of the title.
Each title is lit by 4 front lights, and one shadow casting lamp.

  • Lighting Width

    Determines the horizontal spacing for the front lights.
    1 is an average value, higher values will result in the light being further apart, lower values for closer together.

  • Lighting Height

    Determines the vertical spacing for the front lights.

  • Lights X Offset

    Move all front lights along the horizontal axis.
    0 will result in the lights being centered, negative values will move them to the left, positive values will move them to the right.

  • Lights Y Offset

    Move all front lights along the vertical axis.
    0 will result in the lights being centered, negative values will move the lights down, positive values will move the lights up.

  • Lights Rotation

    Rotate all front lights around their center point.
    Rotation values are in degrees.

  • Shadow Amount

    Determines how strong the shadows in the title will be.
    0 results in no shadows, higher values result in darker shadows.

  • Distance

    Vertical distance of the shadow casting lamp.
    Higher values result in longer and softer shadows.
    Setting this too low can result in the shadow lamp being inside another object, or not casting shadows from all objects.

  • Soft

    Softness of the shadows. 0 results in fully sharp shadows, higher values result in softer shadows.

  • X Offset/Y Offset

    Position of the shadow casting lamp.
    Use this to change the direction and angle of the shadows.
    Setting this too high will result in the shadows disappearing.

Editing Titles In The Sequencer Preview

If a title is selected in the sequencer, and while the mouse is over the preview window, the title can be edited using various shortcuts.

  • Ctrl-Left-Click on title elements to select them

  • Press 'G' to enter grab/move mode for the selected element. You can constrain movement to the three axis by pressing the x, y and z keys after entering move mode. When moving on a single axis, you can type in exact movement values.

  • Press 'S' to enter scale mode for the selected element. Like grab, you can constrain to an axis, or type in values directly. Constraining to the z axis will modify the object's extrude value (not available for image types).

  • Press 'R' to enter rotate mode for the selected element. Again, you can constrain on an axis, and type in values.

  • Press 'L' to enter grab mode for the shadow casting lamp. This will behave just like object grab mode.

  • Press Shift-A to open the add object menu.

  • Press 'X' or 'Delete' to delete the selected object.

  • Press 'Page Up' to move the selected object up one in the object stack.

  • Press 'Page Down' to move the selected object down one in the object stack.

Advanced Scene Editing

QuickTitling generates standard blender scenes that can be edited after they are generated. If you wish to edit the scene, it is recommended to remove 'QuickTitle:' from the scene name, this will prevent QuickTitling from updating the scene and overwriting anything you may have changed, but it will also prevent the usage of the interface to adjust title settings.

If you wish to maintain the ability to edit the title using QuickTitling:

  • New objects can be added and scene and render settings can be changed without issues.

  • If you wish to change a material, any settings not covered by the QuickTitling interface should be able to be changed without reverting. Extra textures can be added to objects, just for an image type make sure they are using texture slots other than the first two.

  • If you wish to edit an object, it is recommended to rename it, this will prevent QuickTitling from finding the object. After you rename it, delete it from the object list or it will be re-created on the next update.

About

QuickTitling Addon For Blender


Languages

Language:Python 99.9%Language:Batchfile 0.1%