linsyking/elm-canvas/2.1.0

NOTE: the latest version is 4.4.0

Canvas.Video

This module exposes the types and functions to load and work with videos.

You can load videos by using toHtmlWith, and use them to draw with Canvas.video.

Loading Videos

From an external source

type alias Source msg =
Source msg

Origin of a texture to load. Passing a List Source to Canvas.toHtmlWith will try to load the textures and send you events with the actual Texture when it is loaded.

loadFromVideoUrl : String -> (Maybe Video -> msg) -> Source msg

Make a Texture.Source from an image URL. When passing this Source to toHtmlWith the image will try to be loaded and stored as a Texture ready to be drawn.

Texture types

type alias Video =
Video

The Texture type. You can use this type with Canvas.texture to get a Renderable into the screen.

Once you have a texture, you can get a new texture with a viewport into an existing one. This is very useful for when you have a sprite sheet with many images in one, but want to have individual sprites to draw.

{ x : Float
, y : Float
, width : Float
, height : Float
}
-> Video
-> Video

Make a sprite from a texture. A sprite is like a window into a bigger texture. By passing the inner coordinates and width and height of the window, you will get a new texture back that is only that selected viewport into the bigger texture.

Very useful for using sprite sheet textures.

Texture information

You can get some information from the texture, like its dimensions:

Video
-> { width : Float
, height : Float
}

Get the width and height of a texture