スケーリングとサイズ変更
最終更新日時: 2026/10/14固定キャンバスモードでは、変換後の出力のサイズと縦横比を制御するための複数の設定が用意されています。これらの設定は、スケール係数の調整、キャンバス境界の適用、正確な寸法への切り抜き、およびレイアウトコンテナの縮小を行います。
スケーリング
固定キャンバス モードでは、2 つのスケール ファクターを適用して QlikView 座標をピクセル寸法に変換します。
| 設定 | CLI 引数 | 説明 | 初期設定 |
|---|---|---|---|
| キャンバス scale | --fixedSheetCanvasScale FACTOR
|
シートの背景およびキャンバス全体の寸法の倍率 | 1.4
|
| オブジェクト scale | --fixedSheetCanvasObjectScale FACTOR
|
キャンバス内のオブジェクトの位置およびサイズの乗数 | 1.4
|
デフォルトのスケール 1.4 は、QlikView と Qlik Sense が同じピクセル寸法でコンテンツをレンダリングする際の違いを補正します。オブジェクトと背景画像の間の正しい配置を維持するために、キャンバスのスケールとオブジェクトのスケールを同じ値に保ちます。
ユーザーインターフェースでは、デフォルトでキャンバスのスケールとオブジェクトのスケールがリンクされています。いずれかの値を変更すると、両方が更新されます。スケール入力の横にあるチェーンアイコンをクリックしてリンクを解除し、個別の値を設定します。もう一度クリックして再リンクします — オブジェクトのスケールが現在のキャンバスのスケール値にスナップします。同じトグルはMockup Studioでも利用できます。
キャンバスサイズの制約
固定キャンバスモードは、最終的なキャンバスサイズを制御する最小および最大サイズの制約をサポートしています。
| 設定 | CLI 引数 | 説明 | 初期設定 |
|---|---|---|---|
| 最小幅 | --fixedSheetCanvasMinWidthPx PX
|
キャンバスは少なくともこの幅まで拡張されます | 1200
|
| 最小の高さ | --fixedSheetCanvasMinHeightPx PX
|
キャンバスは少なくともこの高さまで拡張されます | 700
|
| 最大幅 | --maxCanvasWidth PX
|
キャンバスは最大でこの幅まで縮小します。この境界の外側にあるオブジェクトは切り取られる可能性があります。 | 0 (無制限) |
| 最大 height | --maxCanvasHeight PX
|
キャンバスは最大でこの高さまで縮小します。この境界の外側にあるオブジェクトは切り取られる可能性があります。 | 0 (無制限) |
デフォルトでは、QV2QS はドキュメント内で最も大きいシートに基づいて、すべてのシートで均一なキャンバス サイズを計算します。各シートのコンテンツに基づいて各シートのサイズを個別に設定するには、--perSheetCanvasSize を使用します。
キャンバスクロップ
キャンバスのクロップにより、正確なキャンバス寸法が強制されます。背景は指定されたサイズにトリミングされ(左上隅を基準)、新しい境界内での絶対ピクセル位置を維持するようにオブジェクトの位置が再計算されます。クロップ領域の外側にあるオブジェクトは、コンテナからはみ出します。
| 設定 | CLI 引数 | 説明 | 初期設定 |
|---|---|---|---|
| トリミング幅 | --cropCanvasWidth PX
|
ピクセル単位での正確なキャンバス幅 | 0 (オフ) |
| 切り抜きの高さ | --cropCanvasHeight PX
|
キャンバスの正確な高さ(ピクセル単位) | 0 (オフ) |
幅と高さの両方を同時に指定する必要があります。キャンバスのトリミングと--perSheetCanvasSizeは相互排他的です。
キャンバスのクロップは、最小サイズの制約よりも優先されます。クロップが有効になっている場合、最小幅または最小高さに関係なく、キャンバスは指定されたサイズに設定されます。クロップ後も最大サイズ制限は引き続き適用され、クロップ後のサイズが最大値を超える場合は、キャンバスがさらに縮小されることがあります。
レイアウト縮小
レイアウト縮小は、レイアウトコンテナのグリッドスパンを右端および下端から減らします。オブジェクトはキャンバスのより小さな領域に圧縮され、QlikView レイアウトの右側または下部の余分な余白が削除されます。
| 設定 | CLI 引数 | 説明 | 初期設定 |
|---|---|---|---|
| Xを縮小 | --layoutShrinkX STEPS
|
レイアウトコンテナの幅をこのグリッド列数 (0–23) 分縮小します | 0
|
| Yを縮小 | --layoutShrinkY STEPS
|
レイアウトコンテナの高さをこのグリッド行数分縮小します (0–11) | 0
|