# ImageManip Tiling Frame tiling could be useful for eg. feeding large frame into a [NeuralNetwork](https://docs.luxonis.com/software/depthai-components/nodes/neural_network.md) whose input size isn't as large. In such case, you can tile the large frame into multiple smaller ones and feed smaller frames to the [NeuralNetwork](https://docs.luxonis.com/software/depthai-components/nodes/neural_network.md). In this example we use 2 [ImageManip](https://docs.luxonis.com/software/depthai-components/nodes/image_manip.md) for splitting the original 1000x500 preview frame into two 500x500 frames. ## Demo ## Setup Please run the [install script](https://github.com/luxonis/depthai-python/blob/main/examples/install_requirements.py) to download all required dependencies. Please note that this script must be ran from git context, so you have to download the [depthai-python](https://github.com/luxonis/depthai-python) repository first and then run the script ```bash git clone https://github.com/luxonis/depthai-python.git cd depthai-python/examples python3 install_requirements.py ``` For additional information, please follow the [installation guide](https://docs.luxonis.com/software/depthai/manual-install.md). ## Source code #### Python ```python #!/usr/bin/env python3 import cv2 import depthai as dai # Create pipeline pipeline = dai.Pipeline() camRgb = pipeline.create(dai.node.ColorCamera) camRgb.setPreviewSize(1000, 500) camRgb.setInterleaved(False) maxFrameSize = camRgb.getPreviewHeight() * camRgb.getPreviewWidth() * 3 # In this example we use 2 imageManips for splitting the original 1000x500 # preview frame into 2 500x500 frames manip1 = pipeline.create(dai.node.ImageManip) manip1.initialConfig.setCropRect(0, 0, 0.5, 1) manip1.setMaxOutputFrameSize(maxFrameSize) camRgb.preview.link(manip1.inputImage) manip2 = pipeline.create(dai.node.ImageManip) manip2.initialConfig.setCropRect(0.5, 0, 1, 1) manip2.setMaxOutputFrameSize(maxFrameSize) camRgb.preview.link(manip2.inputImage) xout1 = pipeline.create(dai.node.XLinkOut) xout1.setStreamName('out1') manip1.out.link(xout1.input) xout2 = pipeline.create(dai.node.XLinkOut) xout2.setStreamName('out2') manip2.out.link(xout2.input) # Connect to device and start pipeline with dai.Device(pipeline) as device: # Output queue will be used to get the rgb frames from the output defined above q1 = device.getOutputQueue(name="out1", maxSize=4, blocking=False) q2 = device.getOutputQueue(name="out2", maxSize=4, blocking=False) while True: if q1.has(): cv2.imshow("Tile 1", q1.get().getCvFrame()) if q2.has(): cv2.imshow("Tile 2", q2.get().getCvFrame()) if cv2.waitKey(1) == ord('q'): break ``` #### C++ ```cpp #include // Includes common necessary includes for development using depthai library #include "depthai/depthai.hpp" int main() { using namespace std; // Create pipeline dai::Pipeline pipeline; auto camRgb = pipeline.create(); camRgb->setPreviewSize(1000, 500); camRgb->setInterleaved(false); auto maxFrameSize = camRgb->getPreviewHeight() * camRgb->getPreviewHeight() * 3; // In this example we use 2 imageManips for splitting the original 1000x500 // preview frame into 2 500x500 frames auto manip1 = pipeline.create(); manip1->initialConfig.setCropRect(0, 0, 0.5, 1); // Flip functionality manip1->initialConfig.setHorizontalFlip(true); manip1->setMaxOutputFrameSize(maxFrameSize); camRgb->preview.link(manip1->inputImage); auto manip2 = pipeline.create(); manip2->initialConfig.setCropRect(0.5, 0, 1, 1); // Flip functionality manip1->initialConfig.setVerticalFlip(true); manip2->setMaxOutputFrameSize(maxFrameSize); camRgb->preview.link(manip2->inputImage); auto xout1 = pipeline.create(); xout1->setStreamName("out1"); manip1->out.link(xout1->input); auto xout2 = pipeline.create(); xout2->setStreamName("out2"); manip2->out.link(xout2->input); dai::Device device(pipeline); auto q1 = device.getOutputQueue("out1", 8, false); auto q2 = device.getOutputQueue("out2", 8, false); while(true) { auto in1 = q1->tryGet(); if(in1) { cv::imshow("Tile 1", in1->getCvFrame()); } auto in2 = q2->tryGet(); if(in2) { cv::imshow("Tile 2", in2->getCvFrame()); } int key = cv::waitKey(1); if(key == 'q' || key == 'Q') return 0; } return 0; } ``` ## Pipeline ### examples/image_manip_tiling.pipeline.json ```json { "pipeline": { "connections": [ { "node1Id": 0, "node1Output": "preview", "node1OutputGroup": "", "node2Id": 1, "node2Input": "inputImage", "node2InputGroup": "" }, { "node1Id": 0, "node1Output": "preview", "node1OutputGroup": "", "node2Id": 2, "node2Input": "inputImage", "node2InputGroup": "" }, { "node1Id": 1, "node1Output": "out", "node1OutputGroup": "", "node2Id": 3, "node2Input": "in", "node2InputGroup": "" }, { "node1Id": 2, "node1Output": "out", "node1OutputGroup": "", "node2Id": 4, "node2Input": "in", "node2InputGroup": "" } ], "globalProperties": { "calibData": null, "cameraTuningBlobSize": null, "cameraTuningBlobUri": "", "leonCssFrequencyHz": 700000000.0, "leonMssFrequencyHz": 700000000.0, "pipelineName": null, "pipelineVersion": null, "sippBufferSize": 18432, "sippDmaBufferSize": 16384, "xlinkChunkSize": -1 }, "nodes": [ [ 0, { "id": 0, "ioInfo": [ [ [ "", "inputConfig" ], { "blocking": false, "group": "", "id": 1, "name": "inputConfig", "queueSize": 8, "type": 3, "waitForMessage": false } ], [ [ "", "raw" ], { "blocking": false, "group": "", "id": 6, "name": "raw", "queueSize": 8, "type": 0, "waitForMessage": false } ], [ [ "", "still" ], { "blocking": false, "group": "", "id": 7, "name": "still", "queueSize": 8, "type": 0, "waitForMessage": false } ], [ [ "", "inputControl" ], { "blocking": true, "group": "", "id": 2, "name": "inputControl", "queueSize": 8, "type": 3, "waitForMessage": false } ], [ [ "", "video" ], { "blocking": false, "group": "", "id": 3, "name": "video", "queueSize": 8, "type": 0, "waitForMessage": false } ], [ [ "", "isp" ], { "blocking": false, "group": "", "id": 4, "name": "isp", "queueSize": 8, "type": 0, "waitForMessage": false } ], [ [ "", "preview" ], { "blocking": false, "group": "", "id": 5, "name": "preview", "queueSize": 8, "type": 0, "waitForMessage": false } ], [ [ "", "frameEvent" ], { "blocking": false, "group": "", "id": 8, "name": "frameEvent", "queueSize": 8, "type": 0, "waitForMessage": false } ] ], "name": "ColorCamera", "properties": { "boardSocket": -1, "cameraName": "", "colorOrder": 0, "fp16": false, "fps": 30.0, "imageOrientation": -1, "initialControl": { "aeLockMode": false, "aeMaxExposureTimeUs": 0, "aeRegion": { "height": 0, "priority": 0, "width": 0, "x": 0, "y": 0 }, "afRegion": { "height": 0, "priority": 0, "width": 0, "x": 0, "y": 0 }, "antiBandingMode": 0, "autoFocusMode": 3, "awbLockMode": false, "awbMode": 0, "brightness": 0, "captureIntent": 0, "chromaDenoise": 0, "cmdMask": 0, "contrast": 0, "controlMode": 0, "effectMode": 0, "expCompensation": 0, "expManual": { "exposureTimeUs": 0, "frameDurationUs": 0, "sensitivityIso": 0 }, "frameSyncMode": 0, "lensPosAutoInfinity": 0, "lensPosAutoMacro": 0, "lensPosition": 0, "lensPositionRaw": 0.0, "lowPowerNumFramesBurst": 0, "lowPowerNumFramesDiscard": 0, "lumaDenoise": 0, "saturation": 0, "sceneMode": 0, "sharpness": 0, "strobeConfig": { "activeLevel": 0, "enable": 0, "gpioNumber": 0 }, "strobeTimings": { "durationUs": 0, "exposureBeginOffsetUs": 0, "exposureEndOffsetUs": 0 }, "wbColorTemp": 0 }, "interleaved": false, "isp3aFps": 0, "ispScale": { "horizDenominator": 0, "horizNumerator": 0, "vertDenominator": 0, "vertNumerator": 0 }, "numFramesPoolIsp": 3, "numFramesPoolPreview": 4, "numFramesPoolRaw": 3, "numFramesPoolStill": 4, "numFramesPoolVideo": 4, "previewHeight": 500, "previewKeepAspectRatio": true, "previewWidth": 1000, "rawPacked": null, "resolution": 0, "sensorCropX": -1.0, "sensorCropY": -1.0, "stillHeight": -1, "stillWidth": -1, "videoHeight": -1, "videoWidth": -1 } } ], [ 1, { "id": 1, "ioInfo": [ [ [ "", "inputConfig" ], { "blocking": true, "group": "", "id": 9, "name": "inputConfig", "queueSize": 8, "type": 3, "waitForMessage": false } ], [ [ "", "inputImage" ], { "blocking": true, "group": "", "id": 10, "name": "inputImage", "queueSize": 8, "type": 3, "waitForMessage": true } ], [ [ "", "out" ], { "blocking": false, "group": "", "id": 11, "name": "out", "queueSize": 8, "type": 0, "waitForMessage": false } ] ], "name": "ImageManip", "properties": { "initialConfig": { "cropConfig": { "cropRatio": 1.0, "cropRect": { "xmax": 0.5, "xmin": 0.0, "ymax": 1.0, "ymin": 0.0 }, "cropRotatedRect": { "angle": 0.0, "center": { "x": 0.0, "y": 0.0 }, "size": { "height": 0.0, "width": 0.0 } }, "enableCenterCropRectangle": false, "enableRotatedRect": false, "normalizedCoords": true, "widthHeightAspectRatio": 1.0 }, "enableCrop": true, "enableFormat": false, "enableResize": false, "formatConfig": { "colormap": 0, "colormapMax": 255, "colormapMin": 0, "flipHorizontal": false, "flipVertical": false, "type": 32 }, "interpolation": -1, "resizeConfig": { "bgBlue": 0, "bgGreen": 0, "bgRed": 0, "enableRotation": false, "enableWarp4pt": false, "enableWarpMatrix": false, "height": 0, "keepAspectRatio": true, "lockAspectRatioFill": false, "normalizedCoords": true, "rotationAngleDeg": 0.0, "warpBorderReplicate": false, "warpFourPoints": [], "warpMatrix3x3": [], "width": 0 }, "reusePreviousImage": false, "skipCurrentImage": false }, "meshHeight": 0, "meshUri": "", "meshWidth": 0, "numFramesPool": 4, "outputFrameSize": 1500000 } } ], [ 2, { "id": 2, "ioInfo": [ [ [ "", "inputConfig" ], { "blocking": true, "group": "", "id": 12, "name": "inputConfig", "queueSize": 8, "type": 3, "waitForMessage": false } ], [ [ "", "inputImage" ], { "blocking": true, "group": "", "id": 13, "name": "inputImage", "queueSize": 8, "type": 3, "waitForMessage": true } ], [ [ "", "out" ], { "blocking": false, "group": "", "id": 14, "name": "out", "queueSize": 8, "type": 0, "waitForMessage": false } ] ], "name": "ImageManip", "properties": { "initialConfig": { "cropConfig": { "cropRatio": 1.0, "cropRect": { "xmax": 1.0, "xmin": 0.5, "ymax": 1.0, "ymin": 0.0 }, "cropRotatedRect": { "angle": 0.0, "center": { "x": 0.0, "y": 0.0 }, "size": { "height": 0.0, "width": 0.0 } }, "enableCenterCropRectangle": false, "enableRotatedRect": false, "normalizedCoords": true, "widthHeightAspectRatio": 1.0 }, "enableCrop": true, "enableFormat": false, "enableResize": false, "formatConfig": { "colormap": 0, "colormapMax": 255, "colormapMin": 0, "flipHorizontal": false, "flipVertical": false, "type": 32 }, "interpolation": -1, "resizeConfig": { "bgBlue": 0, "bgGreen": 0, "bgRed": 0, "enableRotation": false, "enableWarp4pt": false, "enableWarpMatrix": false, "height": 0, "keepAspectRatio": true, "lockAspectRatioFill": false, "normalizedCoords": true, "rotationAngleDeg": 0.0, "warpBorderReplicate": false, "warpFourPoints": [], "warpMatrix3x3": [], "width": 0 }, "reusePreviousImage": false, "skipCurrentImage": false }, "meshHeight": 0, "meshUri": "", "meshWidth": 0, "numFramesPool": 4, "outputFrameSize": 1500000 } } ], [ 3, { "id": 3, "ioInfo": [ [ [ "", "in" ], { "blocking": true, "group": "", "id": 15, "name": "in", "queueSize": 8, "type": 3, "waitForMessage": true } ] ], "name": "XLinkOut", "properties": { "maxFpsLimit": -1.0, "metadataOnly": false, "streamName": "out1" } } ], [ 4, { "id": 4, "ioInfo": [ [ [ "", "in" ], { "blocking": true, "group": "", "id": 16, "name": "in", "queueSize": 8, "type": 3, "waitForMessage": true } ] ], "name": "XLinkOut", "properties": { "maxFpsLimit": -1.0, "metadataOnly": false, "streamName": "out2" } } ] ] } } ``` ### Need assistance? Head over to [Discussion Forum](https://discuss.luxonis.com/) for technical support or any other questions you might have.