XISER Canvas:
XISER_Canvas is a versatile node designed for visual editing within the XISER_Nodes framework, providing a robust platform for creating and manipulating canvas-based images. This node acts as a bridge between legacy systems and modern interfaces, allowing users to seamlessly integrate and edit images with ease. It offers a comprehensive set of features that enable users to define the dimensions, color, and scaling of their canvas, as well as manage image layers and states. The primary goal of XISER_Canvas is to facilitate the creation of complex visual compositions by providing a flexible and user-friendly interface that supports a wide range of image editing tasks. Whether you are looking to create a simple image collage or a detailed layered artwork, XISER_Canvas provides the tools necessary to achieve your artistic vision.
XISER Canvas Input Parameters:
pack_images
This optional parameter allows you to input a collection of images that can be packed onto the canvas. It is useful for creating collages or layered compositions. The function of this parameter is to provide the raw image data that will be manipulated and displayed on the canvas.
board_width
This parameter sets the width of the canvas in pixels. It accepts integer values ranging from 256 to 8192, with a default value of 1024. Adjusting the board width impacts the overall size of the canvas and the space available for image placement.
board_height
Similar to board_width, this parameter defines the height of the canvas in pixels. It also accepts integer values from 256 to 8192, with a default of 1024. The board height determines the vertical space available for your images.
border_width
This parameter specifies the width of the border around the canvas, measured in pixels. It ranges from 10 to 200, with a default value of 120. The border width affects the visual framing of the canvas and can influence the layout of images within the canvas space.
canvas_color
This parameter allows you to choose the background color of the canvas. Options include "black," "white," and "transparent," with "black" as the default. The canvas color sets the initial background tone for your composition and can affect the overall aesthetic of the final image.
display_scale
This parameter controls the scale at which the canvas is displayed, with a range from 0.1 to 1.0 and a default value of 0.5. The display scale affects how the canvas is viewed on the screen, allowing you to zoom in or out for detailed editing or broader overviews.
auto_size
This parameter toggles the automatic resizing of the canvas based on the input images. Options are "off" and "on," with "off" as the default. Enabling auto_size allows the canvas to adjust its dimensions to fit the images, which can be useful for dynamic compositions.
image_states
This parameter accepts a string representation of image states, with a default value of "[]". It is used to define the positions, transformations, and other properties of images on the canvas, enabling precise control over the layout and appearance of each image.
file_data
An optional parameter that allows you to input additional file data for use in the canvas. This can include metadata or other relevant information that may influence the rendering or processing of the canvas.
canvas_config
This optional parameter provides configuration settings for the canvas, allowing for advanced customization and control over the canvas behavior and appearance.
layer_data
An optional parameter that accepts data related to image layers. This is useful for managing complex compositions with multiple layers, enabling you to control the visibility, order, and properties of each layer.
XISER Canvas Output Parameters:
canvas_image
This output provides the final rendered image of the canvas, incorporating all input images, transformations, and settings. It represents the complete visual composition created using the node.
masks
This output generates masks corresponding to the images on the canvas. These masks can be used for further image processing or editing tasks, allowing for selective manipulation of specific areas within the composition.
layer_images
This output delivers the individual images of each layer on the canvas. It allows you to access and manipulate each layer separately, providing flexibility in editing and refining the composition.
layer_data_out
This output provides the data related to the layers on the canvas, including their properties and configurations. It is useful for understanding the structure of the composition and making informed adjustments to the layers.
XISER Canvas Usage Tips:
- To create a balanced composition, start by setting the board_width and board_height to match the dimensions of your intended output. This ensures that your canvas is appropriately sized for your project.
- Utilize the auto_size feature when working with a dynamic set of images to allow the canvas to adjust automatically, saving time on manual resizing.
- Experiment with different canvas_color settings to see how they affect the mood and tone of your composition. A transparent background can be particularly useful for creating overlays or integrating the canvas into other projects.
XISER Canvas Common Errors and Solutions:
Error: "Invalid canvas dimensions"
- Explanation: This error occurs when the board_width or board_height is set outside the allowed range.
- Solution: Ensure that both board_width and board_height are within the range of 256 to 8192 pixels.
Error: "Unsupported canvas color"
- Explanation: This error indicates that an invalid option was selected for the canvas_color parameter.
- Solution: Choose a valid option for canvas_color, such as "black," "white," or "transparent."
Error: "Invalid display scale"
- Explanation: This error arises when the display_scale is set outside the permissible range.
- Solution: Adjust the display_scale to be within the range of 0.1 to 1.0.