Scaling and sizing
Fixed canvas mode provides several settings for controlling the size and proportions of the converted output. These settings adjust scale factors, enforce canvas boundaries, crop to exact dimensions, and shrink layout containers.
Scaling
Fixed canvas mode applies two scale factors to convert QlikView coordinates into pixel dimensions.
| Setting | CLI argument | Description | Default |
|---|---|---|---|
| Canvas scale | --fixedSheetCanvasScale FACTOR
|
Multiplier for the sheet background and overall canvas dimensions | 1.4
|
| Object scale | --fixedSheetCanvasObjectScale FACTOR
|
Multiplier for object positions and sizes within the canvas | 1.4
|
The default scale of 1.4 compensates for differences in how QlikView and Qlik Sense render content at the same pixel dimensions. Keep canvas scale and object scale at the same value to maintain correct alignment between objects and the background image.
In the user interface, canvas scale and object scale are linked by default. Changing either value updates both. Click the chain icon next to the scale inputs to unlink them and set independent values. Click again to re-link — object scale snaps to the current canvas scale value. The same toggle is available in Mockup Studio.
Canvas size constraints
Fixed canvas mode supports minimum and maximum size constraints that control the final canvas dimensions.
| Setting | CLI argument | Description | Default |
|---|---|---|---|
| Minimum width | --fixedSheetCanvasMinWidthPx PX
|
Canvas expands to at least this width | 1200
|
| Minimum height | --fixedSheetCanvasMinHeightPx PX
|
Canvas expands to at least this height | 700
|
| Maximum width | --maxCanvasWidth PX
|
Canvas shrinks to at most this width. Objects beyond this boundary may be cut off. | 0 (no limit) |
| Maximum height | --maxCanvasHeight PX
|
Canvas shrinks to at most this height. Objects beyond this boundary may be cut off. | 0 (no limit) |
By default, QV2QS calculates a uniform canvas size across all sheets based on the largest sheet in the document. To size each sheet independently based on the content of each sheet, use --perSheetCanvasSize.
Canvas crop
Canvas crop forces exact canvas dimensions. The background is cropped to the specified size (anchored to the top-left corner), and object positions are recalculated to maintain absolute pixel locations within the new boundaries. Objects that fall outside the cropped area overflow the container.
| Setting | CLI argument | Description | Default |
|---|---|---|---|
| Crop width | --cropCanvasWidth PX
|
Exact canvas width in pixels | 0 (off) |
| Crop height | --cropCanvasHeight PX
|
Exact canvas height in pixels | 0 (off) |
Both width and height must be specified together. Canvas crop and --perSheetCanvasSize are mutually exclusive.
Canvas crop overrides minimum size constraints. When crop is enabled, the canvas is set to the specified dimensions regardless of the minimum width or height. Maximum size constraints still apply after crop and can reduce the canvas further if the cropped dimensions exceed the maximum.
Layout shrink
Layout shrink reduces the grid span of layout containers from the right and bottom edges. Objects are compressed into a smaller portion of the canvas, removing excessive whitespace on the right or bottom of the QlikView layout.
| Setting | CLI argument | Description | Default |
|---|---|---|---|
| Shrink X | --layoutShrinkX STEPS
|
Reduce layout container width by this many grid columns (0–23) | 0
|
| Shrink Y | --layoutShrinkY STEPS
|
Reduce layout container height by this many grid rows (0–11) | 0
|