dpi

Classes

LogicalPosition

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L214

A position represented in logical pixels. For an explanation of what logical pixels are, see description of LogicalSize.

Since

2.0.0

Constructors

Constructor

new LogicalPosition(x, y): LogicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L219

Parameters

Parameter	Type
x	number
y	number

Returns

LogicalPosition

Constructor

new LogicalPosition(object): LogicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L220

Parameters

Parameter	Type
object	{ Logical: { x: number; y: number; }; }
object.Logical	{ x: number; y: number; }
object.Logical.x	number
object.Logical.y	number

Returns

LogicalPosition

Constructor

new LogicalPosition(object): LogicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L221

Parameters

Parameter	Type
object	{ x: number; y: number; }
object.x	number
object.y	number

Returns

LogicalPosition

Properties

Property	Modifier	Type	Default value	Defined in
type	readonly	"Logical"	'Logical'	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L215
x	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L216
y	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L217

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L261

Returns

object

Name	Type	Defined in
x	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L263
y	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L264

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L268

Returns

object

Name	Type	Defined in
x	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L263
y	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L264

toPhysical()

toPhysical(scaleFactor): PhysicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L257

Converts the logical position to a physical one.

Parameters

Parameter	Type
scaleFactor	number

Returns

PhysicalPosition

Example

import { LogicalPosition } from '@tauri-apps/api/dpi';
import { getCurrentWindow } from '@tauri-apps/api/window';

const appWindow = getCurrentWindow();
const factor = await appWindow.scaleFactor();
const position = new LogicalPosition(400, 500);
const physical = position.toPhysical(factor);

Since

2.0.0

---

LogicalSize

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L16

A size represented in logical pixels. Logical pixels are scaled according to the window’s DPI scale. Most browser APIs (i.e. MouseEvent’s clientX) will return logical pixels.

For logical-pixel-based position, see LogicalPosition.

Since

2.0.0

Constructors

Constructor

new LogicalSize(width, height): LogicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L21

Parameters

Parameter	Type
width	number
height	number

Returns

LogicalSize

Constructor

new LogicalSize(object): LogicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L22

Parameters

Parameter	Type
object	{ Logical: { height: number; width: number; }; }
object.Logical	{ height: number; width: number; }
object.Logical.height	number
object.Logical.width	number

Returns

LogicalSize

Constructor

new LogicalSize(object): LogicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L23

Parameters

Parameter	Type
object	{ height: number; width: number; }
object.height	number
object.width	number

Returns

LogicalSize

Properties

Property	Modifier	Type	Default value	Defined in
height	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L19
type	readonly	"Logical"	'Logical'	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L17
width	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L18

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L63

Returns

object

Name	Type	Defined in
height	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L66
width	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L65

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L70

Returns

object

Name	Type	Defined in
height	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L66
width	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L65

toPhysical()

toPhysical(scaleFactor): PhysicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L59

Converts the logical size to a physical one.

Parameters

Parameter	Type
scaleFactor	number

Returns

PhysicalSize

Example

import { LogicalSize } from '@tauri-apps/api/dpi';
import { getCurrentWindow } from '@tauri-apps/api/window';

const appWindow = getCurrentWindow();
const factor = await appWindow.scaleFactor();
const size = new LogicalSize(400, 500);
const physical = size.toPhysical(factor);

Since

2.0.0

---

PhysicalPosition

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L281

A position represented in physical pixels.

For an explanation of what physical pixels are, see description of PhysicalSize.

Since

2.0.0

Constructors

Constructor

new PhysicalPosition(x, y): PhysicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L286

Parameters

Parameter	Type
x	number
y	number

Returns

PhysicalPosition

Constructor

new PhysicalPosition(object): PhysicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L287

Parameters

Parameter	Type
object	{ Physical: { x: number; y: number; }; }
object.Physical	{ x: number; y: number; }
object.Physical.x	number
object.Physical.y	number

Returns

PhysicalPosition

Constructor

new PhysicalPosition(object): PhysicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L288

Parameters

Parameter	Type
object	{ x: number; y: number; }
object.x	number
object.y	number

Returns

PhysicalPosition

Properties

Property	Modifier	Type	Default value	Defined in
type	readonly	"Physical"	'Physical'	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L282
x	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L283
y	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L284

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L328

Returns

object

Name	Type	Defined in
x	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L330
y	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L331

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L335

Returns

object

Name	Type	Defined in
x	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L330
y	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L331

toLogical()

toLogical(scaleFactor): LogicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L324

Converts the physical position to a logical one.

Parameters

Parameter	Type
scaleFactor	number

Returns

LogicalPosition

Example

import { PhysicalPosition } from '@tauri-apps/api/dpi';
import { getCurrentWindow } from '@tauri-apps/api/window';

const appWindow = getCurrentWindow();
const factor = await appWindow.scaleFactor();
const position = new PhysicalPosition(400, 500);
const physical = position.toLogical(factor);

Since

2.0.0

---

PhysicalSize

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L87

A size represented in physical pixels.

Physical pixels represent actual screen pixels, and are DPI-independent. For high-DPI windows, this means that any point in the window on the screen will have a different position in logical pixels LogicalSize.

For physical-pixel-based position, see PhysicalPosition.

Since

2.0.0

Constructors

Constructor

new PhysicalSize(width, height): PhysicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L92

Parameters

Parameter	Type
width	number
height	number

Returns

PhysicalSize

Constructor

new PhysicalSize(object): PhysicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L93

Parameters

Parameter	Type
object	{ Physical: { height: number; width: number; }; }
object.Physical	{ height: number; width: number; }
object.Physical.height	number
object.Physical.width	number

Returns

PhysicalSize

Constructor

new PhysicalSize(object): PhysicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L94

Parameters

Parameter	Type
object	{ height: number; width: number; }
object.height	number
object.width	number

Returns

PhysicalSize

Properties

Property	Modifier	Type	Default value	Defined in
height	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L90
type	readonly	"Physical"	'Physical'	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L88
width	public	number	undefined	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L89

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L130

Returns

object

Name	Type	Defined in
height	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L133
width	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L132

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L137

Returns

object

Name	Type	Defined in
height	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L133
width	number	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L132

toLogical()

toLogical(scaleFactor): LogicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L126

Converts the physical size to a logical one.

Parameters

Parameter	Type
scaleFactor	number

Returns

LogicalSize

Example

import { getCurrentWindow } from '@tauri-apps/api/window';
const appWindow = getCurrentWindow();
const factor = await appWindow.scaleFactor();
const size = await appWindow.innerSize(); // PhysicalSize
const logical = size.toLogical(factor);

---

Position

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L372

A position represented either in physical or in logical pixels.

This type is basically a union type of LogicalSize and PhysicalSize but comes in handy when using tauri::Position in Rust as an argument to a command, as this class automatically serializes into a valid format so it can be deserialized correctly into tauri::Position

So instead of

import { invoke } from '@tauri-apps/api/core';
import { LogicalPosition, PhysicalPosition } from '@tauri-apps/api/dpi';

const position: LogicalPosition | PhysicalPosition = someFunction(); // where someFunction returns either LogicalPosition or PhysicalPosition
const validPosition = position instanceof LogicalPosition
  ? { Logical: { x: position.x, y: position.y } }
  : { Physical: { x: position.x, y: position.y } }
await invoke("do_something_with_position", { position: validPosition });

You can just use Position

import { invoke } from '@tauri-apps/api/core';
import { LogicalPosition, PhysicalPosition, Position } from '@tauri-apps/api/dpi';

const position: LogicalPosition | PhysicalPosition = someFunction(); // where someFunction returns either LogicalPosition or PhysicalPosition
const validPosition = new Position(position);
await invoke("do_something_with_position", { position: validPosition });

Since

2.1.0

Constructors

Constructor

new Position(position): Position;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L375

Parameters

Parameter	Type
position	| PhysicalPosition | LogicalPosition

Returns

Position

Properties

Property	Type	Defined in
position	| PhysicalPosition | LogicalPosition	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L373

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L391

Returns

object

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L400

Returns

object

toLogical()

toLogical(scaleFactor): LogicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L379

Parameters

Parameter	Type
scaleFactor	number

Returns

LogicalPosition

toPhysical()

toPhysical(scaleFactor): PhysicalPosition;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L385

Parameters

Parameter	Type
scaleFactor	number

Returns

PhysicalPosition

---

Size

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L174

A size represented either in physical or in logical pixels.

This type is basically a union type of LogicalSize and PhysicalSize but comes in handy when using tauri::Size in Rust as an argument to a command, as this class automatically serializes into a valid format so it can be deserialized correctly into tauri::Size

So instead of

import { invoke } from '@tauri-apps/api/core';
import { LogicalSize, PhysicalSize } from '@tauri-apps/api/dpi';

const size: LogicalSize | PhysicalSize = someFunction(); // where someFunction returns either LogicalSize or PhysicalSize
const validSize = size instanceof LogicalSize
  ? { Logical: { width: size.width, height: size.height } }
  : { Physical: { width: size.width, height: size.height } }
await invoke("do_something_with_size", { size: validSize });

You can just use Size

import { invoke } from '@tauri-apps/api/core';
import { LogicalSize, PhysicalSize, Size } from '@tauri-apps/api/dpi';

const size: LogicalSize | PhysicalSize = someFunction(); // where someFunction returns either LogicalSize or PhysicalSize
const validSize = new Size(size);
await invoke("do_something_with_size", { size: validSize });

Since

2.1.0

Constructors

Constructor

new Size(size): Size;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L177

Parameters

Parameter	Type
size	| PhysicalSize | LogicalSize

Returns

Size

Properties

Property	Type	Defined in
size	| PhysicalSize | LogicalSize	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L175

Methods

__TAURI_TO_IPC_KEY__()

__TAURI_TO_IPC_KEY__(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L193

Returns

object

toJSON()

toJSON(): object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L202

Returns

object

toLogical()

toLogical(scaleFactor): LogicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L181

Parameters

Parameter	Type
scaleFactor	number

Returns

LogicalSize

toPhysical()

toPhysical(scaleFactor): PhysicalSize;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/dpi.ts#L187

Parameters

Parameter	Type
scaleFactor	number

Returns

PhysicalSize