Load Image

The Load Image module loads in an external image file (ppm, gif, jpg, etc) from your filesystem and overwrites the current image within the processing pipeline with that image. This module is useful if you need to refer to an external image outside of RoboRealm. For example, the Load Image module can be used to load in an image mask.

Interface

Instructions

1. Filename - Specify the filename of the image to load.

2, Load as Marker - Select the "Load as a Marker only" if you want to load the image into memory but not replace the currently viewed image. If this is unselected the current image in RoboRealm will be replaced with this image.

3. If you want to load multiple images in sequence select the "Read Images in Folder" checkbox and the options below will become enabled. To read in multiple images be sure to have selected an appropriate file in the folder of those images you want to read. RoboRealm will then search the folder for appropriate images and load then in sorted succession.

4. Recursive - Select the checkbox if you want images in subfolders to also be loaded. Selecting this option will search from the specified folder and all other subfolders for images.

5. Numerical Sort - Often images have numbers in them and there is a desire to load in the images in accordance to the number within the filename. Selecting Numerical Sort will ensure that filenames that contain XXX_1.gif, XXX_01.gif, XXX_010.gif are sorted with respect to the numerical 1, 1, and 10 instead of the characters ASCII code.

6. Loop Playback - Select if you want the images to repeat after the last image has been loaded.

4. Frame Delay - To change the playback speed increase or decrease the Frame Delay. That alters how quickly RoboRealm will load in the next frame.

Note that the load image module is different from just loading an image to process in RoboRealm. The load image module will always load in the specified image regardless of what image is being processed or if live video is being played. The load image module can be used to load in images that are used for masking or other overlay techniques. Using the multiple image load capabilities you can also cause RoboRealm to act as if a movie file had be loaded instead.

Also note that the images loaded using the multiple image load are sorted with respect to numeric comparisons. Thus, image2.gif will be recognized as coming after image1.gif instead of image100.gif.

Variables

IMAGE_FILENAME - The currently loaded filename. Removed if no image
  loaded or failed to load.

Load Image

Interface

Instructions

Variables

See Also