In this article, we will explain how to set up the layouts for a variety of repetitive materials when importing them into Wizart PIM. These materials require specific configurations for proper visualization, as automatic layout generation is not supported. Ensuring the correct setup of these properties is critical for accurate rendering on surfaces within Wizart Visualizer or through the Visualizer API.
The materials covered in this guide include:
Wallpapers
Wall Murals
Wall Decals
Wall Borders
Paint
Plaster
Linoleum
Carpet Rolls
Each material type requires manual configuration of pattern_width and pattern_length to ensure accurate scaling and repetition during rendering.
Important Note on Pattern Dimensions
For all product types mentioned in this article, automatic layout generation is no supported due to the unique nature of these materials and their repetitive patterns. Unlike materials like tiles or planks, these products often involve the user uploading a repeatable section of the material rather than a full sample.
To ensure proper scaling and repetition, it is mandatory to provide accurate values for the following parameters in the import file:
pattern_width: The real-world width of the repeatable texture section in meters.
pattern_length: The real-world length of the repeatable texture section in meters.
These dimensions ensure that the textures are correctly scaled and repeated on surfaces. Missing or incorrect values may lead to unrealistic visualizations of your products.
Wallpaper Layouts
When importing wallpapers, the following options are available for configuring how the wallpaper pattern is applied to surfaces. If no additional values are provided, the wallpaper will default to a no_offset pattern, and the uploaded texture image will be repeated until it covers the entire surface.
reverse: This option determines if each subsequent tile is rotated 180 degrees.
Possible values:
yes
orno
(default isno
)Example: Setting
reverse
toyes
will alternate the orientation of each wallpaper tile.
pattern_offset: Specifies how much the next tile must be shifted vertically to align the pattern properly.
Numeric value in meters
If the wallpaper has a straight or random match, leave this field empty or set it to
0
.Example: Entering
0.5
shifts the next tile by 0.5 meters for proper pattern alignment.
Wall Mural Layouts
For wall murals, you need to configure two parameters that define how the mural is positioned and scaled on the wall.
repeatable: Indicates if the mural should be repeated horizontally.
Possible values:
yes
orno
customized_size: Determines if the mural should be scaled to fit the wall height and width proportionally.
Possible values:
yes
orno
Cases:
repeatable=Yes, customized_size=No
The mural is overlaid from the upper-left corner with horizontal repetition. Vertically, it repeats based on the texture's length.repeatable=Yes, customized_size=Yes
The mural is overlaid from the upper-left corner, scaled to the wall height, and repeated horizontally. The texture's width is scaled proportionally to the height.repeatable=No, customized_size=No
The mural is placed in the center of the wall, with no scaling or repetition.repeatable = No, customized_size = Yes
The mural overlays from the upper left corner. The texture is scaled to fit the size of the larger wall, without any horizontal repetition. Any part of the texture that extends beyond the wall is cut off.
Wall Decal Layouts
Wall decals have only one configuration parameter, making their setup simple.
repeatable: Determines if the decal is repeated or not.
Possible values:
yes
orno
repeatable=No
The decal is applied to the center of the surface with no repetition.repeatable=Yes
The decal is scaled to the wall height and repeated horizontally across the surface.
Wall Border Layouts
Wall borders are straightforward in how they are applied. They are always repeated horizontally at the center of the wall.
Wall borders do not have customizable parameters for layouts.
Visualizing Your Layouts
By correctly setting the layout parameters for your wallpapers, murals, decals, and wall borders, you ensure that they will be visualized as intended when applied to walls in Wizart Visualizer or through the Visualizer API. Keep in mind that these parameters control not just the placement of the materials but also their scale and repetition, which can dramatically affect the visual outcome.