Function: Image()

Image(srcOrOptions?: string | { align?: Align; alt?: string; blur?: number; brightness?: number; className?: string; color?: string; customPositioned?: boolean; enterDelay?: number; enterDuration?: number; exitDelay?: number; exitDuration?: number; fit?: ImageFit; height?: Size; id?: string; onActivate?: () => void; onDeactivate?: () => void; onMount?: () => void; onUnmount?: () => void; opacity?: number; origin?: ElementAnchor; position?: Position; rotation?: number; scale?: number; size?: Size; src?: string; style?: Properties<0 | string & object, string & object>; theme?: Partial<ThemeConfig>; width?: Size; x?: PositionCoord; y?: PositionCoord; }, maybeOptions?: object): ImageElement

Creates a reactive Image element on stage.

Parameters

Parameter	Type	Description
srcOrOptions	string | { align?: Align; alt?: string; blur?: number; brightness?: number; className?: string; color?: string; customPositioned?: boolean; enterDelay?: number; enterDuration?: number; exitDelay?: number; exitDuration?: number; fit?: ImageFit; height?: Size; id?: string; onActivate?: () => void; onDeactivate?: () => void; onMount?: () => void; onUnmount?: () => void; opacity?: number; origin?: ElementAnchor; position?: Position; rotation?: number; scale?: number; size?: Size; src?: string; style?: Properties<0 | string & object, string & object>; theme?: Partial<ThemeConfig>; width?: Size; x?: PositionCoord; y?: PositionCoord; }	-
maybeOptions	{ align?: Align; alt?: string; blur?: number; brightness?: number; className?: string; color?: string; customPositioned?: boolean; enterDelay?: number; enterDuration?: number; exitDelay?: number; exitDuration?: number; fit?: ImageFit; height?: Size; id?: string; onActivate?: () => void; onDeactivate?: () => void; onMount?: () => void; onUnmount?: () => void; opacity?: number; origin?: ElementAnchor; position?: Position; rotation?: number; scale?: number; size?: Size; src?: string; style?: Properties<0 | string & object, string & object>; theme?: Partial<ThemeConfig>; width?: Size; x?: PositionCoord; y?: PositionCoord; }	-
maybeOptions.align?	Align	-
maybeOptions.alt?	string	Accessible text description.
maybeOptions.blur?	number	Blur in virtual pixels (default: 0).
maybeOptions.brightness?	number	Brightness multiplier (default: 1).
maybeOptions.className?	string	-
maybeOptions.color?	string	Foreground CSS color (default: component/theme color).
maybeOptions.customPositioned?	boolean	Whether this element manages its own CSS transform / positioning (disables stage translate3d).
maybeOptions.enterDelay?	number	Delay in seconds before entering scene transition begins.
maybeOptions.enterDuration?	number	Duration in seconds for entering scene transition.
maybeOptions.exitDelay?	number	Delay in seconds before exiting scene transition begins.
maybeOptions.exitDuration?	number	Duration in seconds for exiting scene transition.
maybeOptions.fit?	ImageFit	Object sizing fit: "contain" (default)
maybeOptions.height?	Size	Height in stage units or CSS length (default: content size).
maybeOptions.id?	string	-
maybeOptions.onActivate?	() => void	-
maybeOptions.onDeactivate?	() => void	-
maybeOptions.onMount?	() => void	-
maybeOptions.onUnmount?	() => void	-
maybeOptions.opacity?	number	Whole-element opacity from 0 to 1 (default: 1).
maybeOptions.origin?	ElementAnchor	Which point of the element sits on its coordinate (default: "top-left").
maybeOptions.position?	Position	-
maybeOptions.rotation?	number	Rotation in degrees (default: 0).
maybeOptions.scale?	number	Scale multiplier (default: 1).
maybeOptions.size?	Size	Both dimensions in stage units or CSS length (default: unset).
maybeOptions.src?	string	Image source URL or path (optional if passed as first argument).
maybeOptions.style?	Properties<0 | string & object, string & object>	-
maybeOptions.theme?	Partial<ThemeConfig>	-
maybeOptions.width?	Size	Width in stage units or CSS length (default: content size).
maybeOptions.x?	PositionCoord	Horizontal position in stage units (default: 0).
maybeOptions.y?	PositionCoord	Vertical position in stage units (default: 0).

Returns

ImageElement

Example

const diagram = Image("./architecture.png", {
  x: "center",
  y: "center",
  scale: 0.8,
});