Visible to Intel only — GUID: ldq1662993924719
Ixiasoft
Visible to Intel only — GUID: ldq1662993924719
Ixiasoft
50.3.1. Block Cache Tool
The block cache tool also detects if the configured transform creates a local compression higher than 2:1, which is the maximum supported compression value of the Warp IP. The block cache tool supports both single bounce and double bounce warp IP configurations.
The block cache tool provides a command line interface that allows you to specify the desired warp by using several available options such as rotation, mirroring, keystone, or by using a warp mesh file generated by the Warp SoC Design Example. The tool then estimates block cache usage for all supported block cache sizes. For each size option the tool prints the result in the following form:
Result | Description |
---|---|
Pass | Requested warp is possible using this block cache size per processing engine |
Pass, Block cache usage too high | Requested warp might be possible. However the IP does not guarantee the output quality because of high block cache usage. The configuration requires further evaluation on the target system |
Fail | Requested warp is not possible using this block cache size. The estimation also fails if the warp exceeds a maximum supported local compression of 2:1, in which case it fails for all block cache sizes |
The block cache tool can visualize configured transform by warping a reference image and saving it as a bitmap (bmp) file on the disk.
The block cache tool is delivered with Intel Quartus Prime Software as a Windows command line application at the following location:
<INSTALL_DIR>/ip/altera/vvp/component_library/tcl_cores/intel_vvp_warp/sw/block_cache_tool/windows/bct.exe
where <INSTALL_DIR> is the installation folder of the Intel Quartus Prime software.
Block Cache Tool Options
The block cache tool options:
bct.exe [option]…
Option | Description | Usage |
---|---|---|
-h | Help | Print the tool usage information.
|
-iw -ih -ow -oh | Input width (pixels) Input height (pixels) Output width (pixels) Output height (pixels) |
Set input and output dimensions of the transformed image in pixels. Default image dimensions are 3840x2160 pixels. |
-r | Rotation angle |
Set rotation angle in degrees. Image is rotated around the center. |
-mh | Mirror horizontally |
Mirror image along horizontal axis. |
-mv | Mirror vertically |
Mirror image along vertical axis. |
-ho | Horizontal offset (pixels) |
Set horizontal offset in pixels. |
-vo | Vertical offset (pixels) |
Set vertical offset in pixels. |
-hk | Horizontal keystone angle |
Set horizontal keystone compensation angle in degrees. |
-vk | Vertical keystone angle | Set vertical keystone compensation angle in degrees. |
-z | Zoom | Set image zoom value: less than 1 to zoom out, greater than 1 to zoom in. |
-pb | Radial distortion |
Set radial distortion compensation value in the range: [-0.45..0.45]. |
-f | Mesh file name |
Path to the warp mesh file generated by the Warp SoC Example application |
-e | Number of warp engines. |
Number of the warp processing engines. Supported values: 1 or 2 (default); |
-db | Double bounce |
Assume double bounce Warp IP configuration. By default, the tool assumes Single bounce configuration. Use this option to override default behavior. |
-ec | Enable extra compression |
Enable compression beyond 2:1. The tool ignores higher than 2:1 local compression if detected. |
-s | Run warp simulator |
Warp a reference image using provided settings and save result on disk. The output file name is warp_output.bmp. |
Examples
This command:
bct.exe -iw 1920 -ih 1080 -ow 3840 -oh 2160 -r 15.0 -s
- Sets the input resolution to full HD, output resolution to 4K
- Performs a 15 degree rotation anticlockwise
- Stores warped reference image on the disk.
The console output is:
intel_vvp_warp block cache tool v1.0 Input resolution: 1920x1080 Output resolution: 3840x2160 Warp engines: 2 Bounce: Single Generating warp data.. Cache size Result Warnings 256 PASS 512 PASS 1024 PASS
The console output indicates the IP can perform the configured warp with all available block cache size options.
![](/content/dam/docs/us/en/683329/24-1/hro1663057735100.jpg)
This command:
bct.exe -f flying_flag.owf -ec -s
- Uses the warp mesh file generated by the Warp SoC Example Design, named flying_flag.owf
- Uses default input and output resolution of 4K
- Ignores 2:1 local compression limit
- Stores warped reference image on the disk.
The console output is:
intel_vvp_warp block cache tool v1.0 Input resolution: 3840x2160 Output resolution: 3840x2160 Warp engines: 2 Bounce: Single Generating warp data... Cache size Result Warnings 256 PASS Block cache usage too high 512 PASS 1024 PASS
The console output indicates the IP can perform the warp using block cache sizes of 512 and 1024. With the block cache size of 256, the tool detects a high block cache usage. The IP cannot guarantee the output image quality and requires further evaluation on the actual hardware.
![](/content/dam/docs/us/en/683329/24-1/hdg1663057760920.png)
This command:
bct.exe -z 0.45
- Uses default input and output resolution of 4K
- Scaled the image down by 0.45
The console output is
intel_vvp_warp block cache tool v1.0 Input resolution: 3840x2160 Output resolution: 3840x2160 Warp engines: 2 Bounce: Single Generating warp data.. Cache size Result Warnings 256 FAIL 512 FAIL 1024 FAIL
Fails to generate warp data for the given transform using available cache options. Check the transform does not exceed 2:1 compression limit
The console output indicates you have exceeded the maximum compression of 2:1 and therefore the hardware does not support it.