MotorCortex-Subtitles

Table of Contents

• MotorCortex-Subtitles
  • Demo
• Intro / Features
• Getting Started
  • Installation
  • Importing and Loading
• Creating Incidents
  • ParseText
• Adding Incidents in your clip
• Contributing
• License
• Sponsored by

Demo

Check it out here

Intro / Features

MotorCortex Subtitles takes the capabilities of the parseSRT library for parsing subtitle files. The ParseText Incident can parse supported subtitle files and add them to your clip. The duration is auto-calculated from your subtitles.

This Plugin exposes just one Incident:

• ParseText

Subtitle Formats supported

SRT

Getting Started

Installation

$ npm install @donkeyclip/motorcortex-subtitles
# OR
$ yarn add @donkeyclip/motorcortex-subtitles

Importing and loading

import { loadPlugin } from "@donkeyclip/motorcortex/";
import SubtitleDef from "@donkeyclip/motorcortex-subtitles";
const SubtitlePlugin = loadPlugin(SubtitleDef);

Creating Incidents

ParseText

const clip = new HTMLClip({
  html: `
    <div class="container"></div>`,
  css: `
  .container{
    width:100%;
    height:100%;
    position:relative;
    background:#151515;
  }
`,
  host: document.getElementById("clip"),
  containerParams: {
    width: "720px",
    height: "640px",
  },
});

const subtitle = new Subtitles.ParseText(
  {
    fontSize: 14,
    textColor: "white",
    fontFamily: "Ubuntu",
    subtitles: mySubsTextFile,
    position: "bottom",
    maxWidth: 400,
    paddingBottom: 50,
  },
  {
    selector: ".container",
    containerParams: {
      width: "720px",
      height: "640px",
    },
  }
);

ParseText Attrs

| Name | Description | Default | Type | | --------- |:-----------| :----| ------: | | fontSize | Font size in pixels of the subtitles | 12 | number | | textColor | The color of the subtitles | white | - | | fontFamily | Font family of the subtiltes | 'Ubuntu' | string | | subtitles | The subtitles loaded text | - | string | | position | Position of the subtitles container [top, center, bottom] | bottom | string | | maxWidth | The maximum width of the subtitles container in pixels | "100%" | number | | paddingTop | The padding top value of the subtitles container in pixels | 0 | number | | paddingBottom | The padding bottom value of the subtitles container in pixels | 0 | number |

IMPORTANT

The container params of the subtitles clip should be the same as the parent clip.

Adding Incidents in your clip

clipName.addIncident(incidentName,startTime);

Contributing

In general, we follow the "fork-and-pull" Git workflow, so if you want to submit patches and additions you should follow the next steps:

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

License

MIT License

Sponsored by