# CaptureVisionRouter The `CaptureVisionRouter` class is what a user uses to interact with image-processing and semantic-processing products in their applications. It accepts an image source and returns processing results which may contain [Final results](https://www.dynamsoft.com/capture-vision/docs/core/architecture/output.md#final-results) or [Intermediate Results](https://www.dynamsoft.com/capture-vision/docs/core/architecture/output.md#intermediate-results). ## Definition *Namespace:* Dynamsoft.CVR ```csharp public class CaptureVisionRouter : IDisposable ``` ## Thread Safety Instances of `CaptureVisionRouter` are not thread-safe. Do not access the same `CaptureVisionRouter` instance from multiple threads concurrently. Create a separate instance for each thread if concurrent processing is required. ## Constructor and Destructor Methods | Method | Description | | ---------------------------------------------------------------- | ----------------------------------------------------- | | [`CaptureVisionRouter`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/instantiate.md#CaptureVisionRouter) | Default constructor of `CaptureVisionRouter` object. | | [`~CaptureVisionRouter`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/instantiate.md#CaptureVisionRouter-1) | Destructor of `CaptureVisionRouter` object. | | [`Dispose`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/instantiate.md#dispose) | Releases all resources used by current object. | ## Single-File Processing Methods | Method | Description | | ---------------------------------------------- | --------------------------------------------------------- | | [`Capture`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/single-file-processing.md#capture) | Processes an image or file to derive important information. | | [`CaptureMultiPages`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/single-file-processing.md#capturemultipages) | Processes an image or file containing multiple pages to derive important information. | ## Multiple-File Processing Methods | Method | Description | | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | [`SetInput`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#setinput) | Sets an image source to provide images for consecutive process. | | [`GetInput`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#getinput) | Gets the attached image source adapter object of the capture vision router. | | [`AddCaptureStateListener`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#addcapturestatelistener) | Adds an object that listens to the state changes of the capture process. | | [`RemoveCaptureStateListener`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#removecapturestatelistener) | Removes an object which listens to the state changes of the capture process. | | [`AddImageSourceStateListener`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#addimagesourcestatelistener) | Adds an object that listens to state changes of the image source. | | [`RemoveImageSourceStateListener`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#removeimagesourcestatelistener) | Removes an object which listens to state changes of the image source. | | [`AddResultReceiver`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#addresultreceiver) | Adds an object as the receiver of captured results. | | [`RemoveResultReceiver`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#removeresultreceiver) | Removes an object which was added as a receiver of captured results. | | [`AddResultFilter`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#addresultfilter) | Adds an object as the filter of captured results. | | [`RemoveResultFilter`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#removeresultfilter) | Removes an object which was added as a filter of captured results. | | [`StartCapturing`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#startcapturing) | Starts to process images consecutively. | | [`StopCapturing`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#stopcapturing) | Stops the consecutive process. | | [`PauseCapturing`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#pausecapturing) | Pauses the capture process. The current thread will be blocked until the capture process is resumed. | | [`ResumeCapturing`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#resumecapturing) | Resumes the capture process. The current thread will be unblocked after the capture process is resumed. | | [`SwitchCapturingTemplate`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/multiple-file-processing.md#switchcapturingtemplate) | Switches the capturing template during the image processing workflow. | ## Setting Methods | Method | Description | | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | | [`InitSettings`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#initsettings) | Loads and initializes a template from a string. | | [`InitSettingsFromFile`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#initsettingsfromfile) | Loads and initializes a template from a file. | | [`OutputSettings`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#outputsettings) | Exports a specific `CaptureVisionTemplate` to a string. | | [`OutputSettingsToFile`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#outputsettingstofile) | Exports a specific `CaptureVisionTemplate` to a file. | | [`GetSimplifiedSettings`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#getsimplifiedsettings) | Retrieves a `SimplifiedCaptureVisionSettings` object for a specific `CaptureVisionTemplate`. | | [`UpdateSettings`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#updatesettings) | Updates a `CaptureVisionTemplate` with `SimplifiedCaptureVisionSettings` object. | | [`ResetSettings`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#resetsettings) | Resets all templates to factory settings. | | [`GetParameterTemplateCount`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#getparametertemplatecount) | Retrieves the total number of available parameter templates. | | [`GetParameterTemplateName`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/settings.md#getparametertemplatename) | Retrieves the name of a specific parameter template by its index. | ## Auxiliary Methods | Method | Description | | --------------------------------------------- | --------------------------------------------------------- | | [`GetBufferedItemsManager`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#getbuffereditemsmanager) | Gets the manager instance of buffered items. | | [`GetIntermediateResultManager`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#getintermediateresultmanager) | Returns an `IntermediateResultManager` object. | | [`SetGlobalIntraOpNumThreads`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#setglobalintraopnumthreads) | Sets the global number of threads used internally for model execution. | | [`AppendDLModelBuffer`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#appenddlmodelbuffer) | Appends a deep learning model to the memory buffer. | | [`ClearDLModelBuffers`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#cleardlmodelbuffers) | Clears all deep learning models from buffer to free up memory. | | [`AppendModelBuffer`](https://www.dynamsoft.com/capture-vision/docs/server/programming/dotnet/api-reference/capture-vision-router/auxiliary-methods.md#appendmodelbuffer) | Deprecated. Will be removed in future versions. Use `AppendDLModelBuffer` instead. |