Skip to main content
Version: 1.0 archive

Background & Canvas Settings - Complete Guide

Learn how to configure your canvas dimensions, choose board styles, and customize background colors in Scribe Animator. This guide covers the Canvas Settings panel accessible from the toolbar.

Visual orientation

Canvas size and board style live in Canvas Settings. Reusable image, gradient, and solid presets live in the separate Background Library.

Scribe Animator Desktop with the complete Canvas Settings panel showing size presets, custom dimensions, and board styles
The complete Canvas Settings panel controls output proportions and the base board treatment; it does not browse reusable background assets.
Screenshot callouts
  1. Canvas Settings
    This panel owns canvas dimensions and base board style.
  2. Canvas-size presets
    Choose a named aspect ratio such as YouTube, Square, Vertical, Widescreen, or HD.
  3. Custom dimensions
    Enter an explicit width and height when a preset does not match the delivery surface.
  4. Board style
    Choose the base whiteboard, chalkboard, or glassboard treatment.
  5. Custom Color
    Choose a project-specific solid board color when the named styles do not fit.
Scribe Animator Background Library open beside a blank canvas
The Backgrounds rail opens a browsable library for project- or scene-level presets and a local background upload path.
Screenshot callouts
  1. Backgrounds
    Open the library from the left rail.
  2. Project or Scene
    Choose whether the selected background should affect the project context or only the active scene.
  3. Background filters
    Narrow presets by all items, images, gradients, or solid fills.
  4. Preset grid
    Choose a visible card to apply that background to the selected scope.
  5. Upload Background
    Use a local JPEG, PNG, or GIF when the preset library does not contain the required art.
Product UI verification

Both captures and their control locations were checked against the running desktop editor with browser-based UI review on July 27, 2026. The current header has Export but no separate Share control. For the task-based workflow, follow Add images, assets, and backgrounds.

Application Layout Overview

Use the authentic screenshots above as the layout reference. Canvas Settings opens from the canvas toolbar and controls dimensions and board treatment. Backgrounds opens from the left rail and controls reusable project- or scene-level background assets. The central canvas previews the result immediately.

Canvas Settings Access:

  • Canvas Toolbar → ⚙️ Settings — Opens the Canvas Settings panel

Quick Start: Opening Canvas Settings

  1. Locate the gear in the canvas toolbar.
  2. Select it once to open Canvas Settings.
  3. Confirm the panel title before changing dimensions or board style.
  4. Drag the panel by its header when it obscures the canvas.
  5. Press Escape or use the close button when finished.

Method 2: Keyboard Shortcut

Press Escape to close the panel when open.

tip

The Canvas Settings panel is draggable! Click and drag the header to reposition it anywhere on screen without blocking your canvas work.


Canvas Settings Panel

When you click the ⚙️ Settings button, the Canvas Settings panel appears.

Panel Layout Overview

Panel sectionPurpose
Canvas-size presetsApply a named output aspect ratio and dimensions
Custom sizeEnter explicit width and height values
Board styleChoose Whiteboard, Chalkboard, Glassboard, or Custom Color when offered
Custom background colorSet a hex color after selecting Custom Color
AdvancedDevelopment-only processing controls; absent in production builds

The annotated complete Canvas Settings capture above is the source of truth for the visible controls.


Canvas Size Presets

Choose from popular aspect ratios optimized for different platforms.

Available Presets

PresetDimensionsAspect RatioBest For
YouTube (16:9)1920 × 108016:9YouTube, Vimeo, standard video
Square (1:1)1080 × 10801:1Instagram posts, social media
Vertical (9:16)1080 × 19209:16TikTok, Instagram Reels, Stories
Widescreen (21:9)2560 × 108021:9Cinematic presentations
HD (4:3)1440 × 10804:3Traditional presentations

Preset Selection Visual

Selecting a preset updates both dimensions and aspect ratio immediately. Use the table above to compare presets, then verify the canvas boundary before placing content. The named presets and displayed values in the running build take precedence over older diagrams.

tip

Choose your canvas size before adding content. Changing dimensions after adding objects may require repositioning elements.

note

The YouTube (16:9) preset at 1920×1080 is the most versatile choice for standard video content and online tutorials.


Custom Canvas Size

For specific requirements, enter custom width and height values.

Custom Size Input

FieldMeaningValidation
WidthHorizontal canvas pixels100–7680 px
HeightVertical canvas pixels100–4320 px

Changes apply immediately. Confirm that existing objects still sit inside the new boundary.

Custom Size Workflow

  1. Open Canvas Settings.
  2. Enter the required width and height.
  3. Confirm that each value remains within the supported range.
  4. Inspect the live canvas boundary and reposition existing objects when necessary.
warning

Setting very large canvas sizes (e.g., 4K at 3840×2160) may impact performance on slower devices. Recommended maximum is 1920×1080 for smooth editing.

Validation Rules

PropertyMinimumMaximumDefault
Width100 px7680 px1920 px
Height100 px4320 px1080 px

Board Styles

Board styles define the visual appearance and texture of your canvas background.

Available Board Styles

StyleColorTextureUse Case
Whiteboard#ffffffNoneClean, professional presentations
Chalkboard (Dark)#2d3748ChalkEducational, retro classroom feel
Chalkboard (Green)#2f855aChalkClassic school chalkboard look
Glassboard#f7fafcGlassModern, sleek corporate style
Custom ColorUser-definedNoneFull customization

Board Style Visual Comparison

StyleBase appearanceTextureTypical use
WhiteboardWhiteNoneClean presentations and general explainers
Chalkboard (Dark)Dark grayChalkClassroom or retro treatment
Chalkboard (Green)GreenChalkTraditional school-board treatment
GlassboardVery lightGlassModern, polished presentation
Custom ColorUser-selected hexNoneBrand or campaign color

The Canvas Settings screenshot proves the selectors. Preview the actual canvas to judge color and texture; text descriptions are not a substitute for the rendered result.

tip

Whiteboard is perfect for most use cases. Use Chalkboard styles when creating educational content with a classroom feel.


Custom Background Color

When you select Custom Color as the board style, additional color controls appear.

Color Picker Interface

After selecting Custom Color, use the visible color swatch for a system picker or type a supported hex value in the adjacent field. The canvas updates immediately.

Color Input Methods

MethodStepsBest for
Visual pickerSelect the swatch, choose a color, close the system pickerExploration
Hex inputEnter a 3- or 6-digit hex value such as #f00 or #3b82f6Exact brand colors

RGB, HSL, and named colors are not accepted by this field.

ColorHex CodeUse Case
Pure White#ffffffClean, minimal
Light Gray#f3f4f6Soft, professional
Cream#fef3c7Warm, inviting
Navy Blue#1e3a5fCorporate, serious
Dark Gray#1f2937Dark mode, cinematic
Pastel Blue#dbeafeCalm, educational
note

Changes apply immediately as you pick colors. There's no Apply button — what you see is what you get!

Color Format Validation

FormatValidExample
6-digit hex✅ Yes#3b82f6
3-digit hex✅ Yes#f00
RGB❌ Norgb(59, 130, 246)
Named colors❌ Noblue
warning

Only hex color codes are supported. RGB, HSL, and named colors will not work. Use a hex converter if needed.


Settings Persistence

All canvas settings are automatically saved to your project.

What Gets Saved

Project fieldExamplePurpose
Width1920Canvas width in pixels
Height1080Canvas height in pixels
Board styleCustomSelected base treatment
Background color#3b82f6Custom color when applicable

These values belong to project state; exact serialized field names are an internal contract and may differ from the labels shown in the editor.

Settings Lifecycle

Settings follow this lifecycle:

  1. A visible panel action updates the active project.
  2. The canvas previews the new project state.
  3. Supported persistence saves that state with the project.
  4. Reopening the same saved project restores it.

A local preview is not proof that an account-library or portable package save has completed. Use the intended save workflow.

tip

Settings are saved to your project file. When you export and share your project, recipients will see the same canvas size and background you configured.


Advanced Settings (Debug Mode)

In development mode, additional advanced options are available.

Vector Processor Worker

The development-only Advanced section can expose a vector-processor worker switch used to compare background-worker and synchronous processing. It is a debugging control, not an end-user performance recommendation, and regular production builds do not show it.

note

Advanced settings are only visible in development mode (non-production builds). Regular users won't see these options.


Panel Interaction

Dragging the Panel

Drag only the panel header. Controls inside the panel remain interactive and do not act as a drag handle. Keep the panel within the viewport, then use the live canvas to verify changes. If a stored position leaves it off-screen, reload only after saving the project.

Closing the Panel

MethodAction
× buttonClick the close button in the header
Escape keyPress Esc anywhere while panel is open
Click outsideNot supported (panel is non-modal)
tip

The panel is non-modal — you can interact with the canvas while the settings panel is open. This allows real-time preview of your changes!


Keyboard Shortcuts

ShortcutAction
EscapeClose the Canvas Settings panel

Common Workflows

Workflow 1: Set Up for YouTube Video

  1. Open Canvas Settings.
  2. Choose YouTube (16:9) and verify 1920 × 1080 in the running build.
  3. Choose Whiteboard.
  4. Inspect text and artwork against the live canvas before export.

Workflow 2: Create Educational Chalkboard Video

  1. Open Canvas Settings.
  2. Choose the required aspect ratio, commonly YouTube (16:9).
  3. Select Chalkboard (Green) or Chalkboard (Dark).
  4. Change foreground colors for readable contrast, then preview the scene.

Workflow 3: Create Instagram Reel

  1. Open Canvas Settings.
  2. Choose Vertical (9:16) and verify 1080 × 1920 in the running build.
  3. Select Custom Color only when a brand background is required.
  4. Keep essential content inside the vertical safe area and preview before export.

Troubleshooting

Panel Not Opening

IssueSolution
Settings button not visibleEnsure you're in the main editor view, not preview mode
Panel appears off-screenRefresh the page; panel position resets on reload

Color Changes Not Applying

IssueSolution
Custom color not visibleEnsure "Custom Color" board style is selected
Hex code not workingUse format #RRGGBB (e.g., #3b82f6), not RGB

Canvas Size Issues

IssueSolution
Objects outside canvasManually reposition objects after resizing
Performance slowReduce canvas size; 1920×1080 is optimal
warning

Changing canvas size does not automatically reposition existing objects. You may need to manually adjust element positions after resizing.


Best Practices

Choosing Canvas Size

  1. Decide platform first — YouTube, Instagram, TikTok have different requirements
  2. Use presets when possible — They're optimized for common use cases
  3. Set size before adding content — Avoid repositioning work later

Choosing Board Style

  1. Match your content — Educational → Chalkboard, Corporate → Whiteboard/Glassboard
  2. Consider text contrast — Dark backgrounds need light text colors
  3. Test before committing — Preview your animation with the chosen style

Custom Colors

  1. Use brand colors — Maintain visual consistency with your brand
  2. Ensure contrast — Text and graphics should stand out from background
  3. Test on different displays — Colors may appear differently on various screens
tip

Pro tip: Save your preferred settings as a project template to quickly start new projects with consistent canvas size and background!


Summary

FeatureLocationPurpose
Canvas SizeSettings Panel → TopSet video dimensions and aspect ratio
Board StyleSettings Panel → MiddleChoose visual style and texture
Custom ColorSettings Panel → Board StyleDefine exact background color
AdvancedSettings Panel → BottomDebug options (dev mode only)

The Canvas Settings panel provides all the tools you need to configure your animation's foundation. Set your canvas size for your target platform, choose a board style that matches your content's tone, and customize colors to align with your brand.


Related Documentation:

  • Typography Text Guide — For adding and styling text
  • Images & Vectors Guide — For importing visual assets
  • Export Settings — For rendering your final video